Skip to content

Context7 Platform -- Up-to-date docs for AI agents

refactor(cli): update CLI documentation and add deprecation warning to skill commands (#2711)

Enes Gules2e97dae44ea0
diff --git a/.changeset/great-apples-like.md b/.changeset/great-apples-like.md
new file mode 100644
index 00000000..12526eb2
--- /dev/null
+++ b/.changeset/great-apples-like.md
@@ -0,0 +1,5 @@
+---
+"ctx7": patch
+---
+
+Add deprecation warning to skill commands
diff --git a/docs/clients/cli.mdx b/docs/clients/cli.mdx
index 0fc373c5..06245363 100644
--- a/docs/clients/cli.mdx
+++ b/docs/clients/cli.mdx
@@ -1,12 +1,11 @@
---
title: CLI
-description: The ctx7 CLI — fetch library documentation, manage skills, and configure Context7 MCP from your terminal
+description: The ctx7 CLI — fetch library documentation and configure Context7 MCP from your terminal
---
The `ctx7` CLI is the command-line interface for Context7. It does three things:
- **Fetch library documentation** — resolve any library by name and query its up-to-date docs directly in your terminal, without opening a browser
-- **Manage AI coding skills** — install, search, generate, and remove skills from the Context7 registry
- **Configure Context7 MCP** — set up the MCP server for Claude Code, Cursor, or OpenCode with a single command
The CLI is useful both as a standalone tool (fetching docs while you code) and as a setup utility (wiring up Context7 for your AI coding agent).
@@ -191,7 +190,7 @@ If you installed the CLI itself with `npm install -g ctx7`, remove that separate
## Authentication
-Most commands work without authentication. Log in to unlock skill generation and higher rate limits on documentation commands.
+Most commands work without authentication. Log in to unlock higher rate limits on documentation commands.
### Commands
@@ -222,178 +221,17 @@ export CONTEXT7_API_KEY=your_key
| Feature | Required |
| -------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `ctx7 library` / `ctx7 docs` | No — login gives higher rate limits |
-| `ctx7 skills install / search / suggest / list / remove` | No |
-| `ctx7 skills generate` | Yes |
| `ctx7 setup` | Yes — unless `--api-key` is passed (`--oauth` also skips login for MCP mode) |
---
-## Skills
-
-Manage AI coding skills from the Context7 registry. See [Skills](/skills) for a full explanation of what skills are, the registry, trust scores, and skill file structure.
-
-### ctx7 skills install
-
-Install skills from any GitHub repository. Repository format is `/owner/repo`.
-
-```bash
-# Interactive — pick from a list
-ctx7 skills install /anthropics/skills
-
-# Install a specific skill by name
-ctx7 skills install /anthropics/skills pdf
-
-# Install all skills without prompting
-ctx7 skills install /anthropics/skills --all
-```
-
-**Target a specific AI coding assistant:**
-
-```bash
-ctx7 skills install /anthropics/skills pdf --claude # Claude Code
-ctx7 skills install /anthropics/skills pdf --cursor # Cursor
-ctx7 skills install /anthropics/skills pdf --universal # Universal (.agents/skills/)
-ctx7 skills install /anthropics/skills pdf --antigravity
-ctx7 skills install /anthropics/skills pdf --all-agents # Universal + all vendor-specific locations
-```
-
-**Install globally** (available across all projects):
-
-```bash
-ctx7 skills install /anthropics/skills pdf --global
-ctx7 skills install /anthropics/skills --all --global
-ctx7 skills install /anthropics/skills pdf --global --universal --yes
-ctx7 skills install /anthropics/skills pdf --global --all-agents --yes
-```
-
-<Note>
- When installing to multiple clients, the skill files are created in your primary client's
- directory and symlinked to the others.
-</Note>
-
-Alias: `ctx7 si /anthropics/skills pdf`
-
-### ctx7 skills search
-
-Find skills across all indexed repositories by keyword. Shows an interactive list — select to install directly.
-
-```bash
-ctx7 skills search pdf
-ctx7 skills search typescript testing
-ctx7 skills search react nextjs
-```
-
-Alias: `ctx7 ss pdf`
-
-### ctx7 skills suggest
-
-Auto-detects your project dependencies and recommends relevant skills from the registry.
-
-```bash
-# Scan current project
-ctx7 skills suggest
-
-# Target a specific client
-ctx7 skills suggest --claude
-ctx7 skills suggest --cursor
-
-# Install suggestions globally
-ctx7 skills suggest --global
-```
-
-Scans: `package.json`, `requirements.txt`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Gemfile`.
-
-Alias: `ctx7 ssg`
-
-### ctx7 skills generate
-
-Generate a custom skill tailored to your stack using AI. **Requires login.**
-
-```bash
-ctx7 skills generate
-
-# Generate and install to a specific client
-ctx7 skills generate --claude
-ctx7 skills generate --cursor
-ctx7 skills generate --universal
-
-# Generate as a global skill
-ctx7 skills generate --global
-```
-
-**Generation flow:**
-
-1. Describe the expertise you want (e.g., "OAuth authentication with NextAuth.js")
-2. Select relevant libraries from search results
-3. Answer 3 clarifying questions to focus the skill
-4. Review the generated skill and request changes if needed
-5. Choose where to install it
-
-<Tip>
- Describe best practices and constraints, not step-by-step tutorials. "TypeScript strict mode
- patterns" generates a more useful skill than "how to write TypeScript."
-</Tip>
-
-**Weekly limits:** Free accounts get 6 generations/week, Pro accounts get 10.
-
-Aliases: `ctx7 skills gen`, `ctx7 skills g`
-
-### ctx7 skills list
-
-View skills installed in your project or globally.
-
-```bash
-ctx7 skills list # All detected clients
-ctx7 skills list --claude
-ctx7 skills list --cursor
-ctx7 skills list --global
-```
-
-### ctx7 skills info
-
-Preview all available skills in a repository without installing.
-
-```bash
-ctx7 skills info /anthropics/skills
-```
-
-### ctx7 skills remove
-
-Uninstall a skill by name.
-
-```bash
-ctx7 skills remove pdf
-ctx7 skills remove pdf --claude
-ctx7 skills remove pdf --global
-```
-
-Aliases: `ctx7 skills rm`, `ctx7 skills delete`
-
----
-
-## Shortcuts
-
-| Shortcut | Full command |
-| ----------------- | ---------------------- |
-| `ctx7 si` | `ctx7 skills install` |
-| `ctx7 ss` | `ctx7 skills search` |
-| `ctx7 ssg` | `ctx7 skills suggest` |
-| `ctx7 skills i` | `ctx7 skills install` |
-| `ctx7 skills s` | `ctx7 skills search` |
-| `ctx7 skills ls` | `ctx7 skills list` |
-| `ctx7 skills rm` | `ctx7 skills remove` |
-| `ctx7 skills gen` | `ctx7 skills generate` |
-| `ctx7 skills g` | `ctx7 skills generate` |
-
----
-
## Telemetry
The CLI collects anonymous usage data to help improve the product. To disable:
```bash
# For a single command
-CTX7_TELEMETRY_DISABLED=1 ctx7 skills search pdf
+CTX7_TELEMETRY_DISABLED=1 ctx7 docs /facebook/react "useEffect examples"
# Permanently — add to ~/.bashrc or ~/.zshrc
export CTX7_TELEMETRY_DISABLED=1
@@ -404,12 +242,6 @@ export CTX7_TELEMETRY_DISABLED=1
## Next Steps
<CardGroup cols={2}>
- <Card title="Browse Skills" icon="magnifying-glass" href="https://context7.com/skills">
- Explore the skills registry
- </Card>
- <Card title="Skills Guide" icon="book" href="/skills">
- Learn about skill file structure, trust scores, and the registry
- </Card>
<Card title="Claude Code" icon="terminal" href="/clients/claude-code">
Set up Context7 in Claude Code
</Card>
diff --git a/docs/docs.json b/docs/docs.json
index 348ce24e..38c37b08 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -28,7 +28,6 @@
"adding-libraries",
"library-updates",
"api-guide",
- "skills",
"tips"
]
},
@@ -234,4 +233,4 @@
}
]
}
-}
\ No newline at end of file
+}
diff --git a/docs/howto/verification.mdx b/docs/howto/verification.mdx
index 7c4f5183..466e9e56 100644
--- a/docs/howto/verification.mdx
+++ b/docs/howto/verification.mdx
@@ -28,7 +28,6 @@ This badge appears on:
- Your library's main page
- Search results
- Library listings and tables
-- Skills associated with your library
## How to Get Verified
@@ -40,7 +39,6 @@ Libraries are automatically verified when they meet certain quality thresholds:
- **High trust score**: Libraries with a trust score of 9 or above. Trust score is calculated based on the GitHub organization/user profile, considering factors like total stars, number of repositories, account age, recent activity, followers, and profile completeness.
- **Top 100 libraries**: Most-used libraries by API requests
-- **Top 100 skills**: Libraries with the most-installed skills
Automatic verification is checked daily. If your library qualifies, it will be verified automatically without any action required.
@@ -121,13 +119,6 @@ You can check your library's verification status on the admin page:
| **Verified** | Green badge displayed, full verification benefits |
| **Not Verified** | No badge, apply to get verified |
-## Skills and Verification
-
-Skills inherit the verification status of their parent library. When your library is verified:
-
-- All skills associated with your library display the verified badge
-- Skills rank higher in skill search results
-
## FAQ
### How long does manual verification take?
@@ -151,7 +142,7 @@ Automatic verification is recalculated daily. If your library no longer meets th
### My library is popular but not verified. Why?
-Automatic verification considers multiple factors including trust score, usage statistics, and skill installs. When you apply manually, Context7 also checks quality criteria like GitHub stars, popularity ranking, and referring domains. If you believe your library meets any of these thresholds, please apply manually and the check will run immediately.
+Automatic verification considers multiple factors including trust score and usage statistics. When you apply manually, Context7 also checks quality criteria like GitHub stars, popularity ranking, and referring domains. If you believe your library meets any of these thresholds, please apply manually and the check will run immediately.
## Need Help?
diff --git a/docs/security/data-safety.mdx b/docs/security/data-safety.mdx
index 61ec6638..7e4e3833 100644
--- a/docs/security/data-safety.mdx
+++ b/docs/security/data-safety.mdx
@@ -12,7 +12,6 @@ Context7 indexes documentation from public and private sources. To prevent malic
- **Robust Detection** — Content is analyzed using a classifier tailored for Context7 to identify prompt injection attempts and malware-related patterns
- **Targeted Validation** — Suspicious content is subjected to additional checks
-- **Skills.md Handling** — A separate but related detection pipeline is used for [Skills](/skills) files, adapted to their distinct structure and intent
- **Continuous Monitoring** — Flagged content is tracked and reviewed on an ongoing basis
- **Regular Updates** — Detection logic is updated to address evolving attack methods and new injection techniques
diff --git a/packages/cli/README.md b/packages/cli/README.md
index eae78084..731da4fa 100644
--- a/packages/cli/README.md
+++ b/packages/cli/README.md
@@ -1,8 +1,6 @@
# ctx7
-CLI for [Context7](https://context7.com) - query up-to-date library documentation and manage AI coding skills.
-
-Skills are reusable prompt instructions that enhance your AI coding assistant with specialized capabilities like working with specific frameworks, libraries, or coding patterns.
+CLI for [Context7](https://context7.com) - query up-to-date library documentation and configure Context7 for AI coding agents.
## Installation
@@ -41,22 +39,6 @@ ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware"
```
-### Skills
-
-```bash
-# Search for skills
-ctx7 skills search pdf
-
-# Install a skill
-ctx7 skills install /anthropics/skills pdf
-
-# Generate a custom skill with AI
-ctx7 skills generate
-
-# List installed skills
-ctx7 skills list --claude
-```
-
## Usage
### Find a library
@@ -133,42 +115,9 @@ ctx7 remove --claude --mcp
If you installed the CLI itself globally with `npm install -g ctx7`, remove that separately with `npm uninstall -g ctx7`. If you use `npx ctx7`, there is no permanent CLI install to remove.
-### Generate skills
-
-Generate custom skills tailored to your use case using AI. Requires authentication.
-
-```bash
-# Log in first
-ctx7 login
-
-# Generate a skill (interactive)
-ctx7 skills generate
-
-# Short aliases
-ctx7 skills gen
-ctx7 skills g
-
-# Generate and install to a specific client
-ctx7 skills generate --cursor
-ctx7 skills generate --claude
-ctx7 skills generate --universal
-
-# Generate globally
-ctx7 skills generate --global
-```
-
-The generate flow:
-
-1. Describe the expertise you want (e.g., "OAuth authentication with NextAuth.js")
-2. Select relevant libraries from search results
-3. Answer 3 clarifying questions to focus the skill
-4. Review the generated skill, request changes if needed, then install
-
-Weekly generation limits apply: free accounts get 6 generations/week, Pro accounts get 10.
-
### Authentication
-Log in to access skill generation and other authenticated features.
+Log in to access authenticated setup and higher documentation rate limits.
```bash
# Log in (opens browser for OAuth)
@@ -181,79 +130,9 @@ ctx7 whoami
ctx7 logout
```
-### Install skills
-
-Install skills from a project repository to your AI coding assistant's skills directory.
-
-```bash
-# Install all skills from a project (interactive selection)
-ctx7 skills install /anthropics/skills
-
-# Install a specific skill
-ctx7 skills install /anthropics/skills pdf
-
-# Install multiple skills at once
-ctx7 skills install /anthropics/skills pdf commit
-
-# Install to a specific client
-ctx7 skills install /anthropics/skills pdf --cursor
-ctx7 skills install /anthropics/skills pdf --claude
-ctx7 skills install /anthropics/skills pdf --universal
-
-# Install globally (home directory instead of current project)
-ctx7 skills install /anthropics/skills pdf --global
-
-# Install non-interactively
-ctx7 skills install /anthropics/skills pdf --global --universal --yes
-
-# Install to all supported agent locations
-ctx7 skills install /anthropics/skills pdf --all-agents
-```
-
-### Search for skills
-
-Find skills across all indexed projects in the registry.
-
-```bash
-ctx7 skills search pdf
-ctx7 skills search typescript
-ctx7 skills search react testing
-```
-
-### List installed skills
-
-View skills installed in your project or globally.
-
-```bash
-ctx7 skills list
-ctx7 skills list --claude
-ctx7 skills list --cursor
-ctx7 skills list --universal
-ctx7 skills list --global
-```
-
-### Show skill information
-
-Get details about available skills in a project.
-
-```bash
-ctx7 skills info /anthropics/skills
-```
-
-### Remove a skill
-
-Uninstall a skill from your project.
-
-```bash
-ctx7 skills remove pdf
-ctx7 skills remove pdf --claude
-ctx7 skills remove pdf --universal
-ctx7 skills remove pdf --global
-```
-
## Supported Clients
-The CLI automatically detects which AI coding assistants you have installed and offers to install skills for them:
+The CLI automatically detects which AI coding assistants you have installed and configures Context7 for them:
| Client | Skills Directory |
| ------------------------------------------------------------------- | ----------------- |
@@ -262,24 +141,13 @@ The CLI automatically detects which AI coding assistants you have installed and
| Cursor | `.cursor/skills/` |
| Antigravity | `.agent/skills/` |
-## Shortcuts
-
-For faster usage, the CLI provides short aliases:
-
-```bash
-ctx7 si /anthropics/skills pdf # skills install
-ctx7 ss pdf # skills search
-ctx7 skills gen # skills generate
-ctx7 skills g # skills generate
-```
-
## Disabling Telemetry
The CLI collects anonymous usage data to help improve the product. To disable telemetry, set the `CTX7_TELEMETRY_DISABLED` environment variable:
```bash
# For a single command
-CTX7_TELEMETRY_DISABLED=1 ctx7 skills search pdf
+CTX7_TELEMETRY_DISABLED=1 ctx7 docs /facebook/react "useEffect examples"
# Or export in your shell profile (~/.bashrc, ~/.zshrc, etc.)
export CTX7_TELEMETRY_DISABLED=1
@@ -287,4 +155,4 @@ export CTX7_TELEMETRY_DISABLED=1
## Learn More
-Visit [context7.com](https://context7.com) to browse the skills registry and discover available skills.
+Visit [context7.com](https://context7.com) for documentation lookup and setup guides.
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 1d65ee89..9e02598e 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,7 +1,7 @@
{
"name": "ctx7",
"version": "0.4.4",
- "description": "Context7 CLI - Manage AI coding skills and documentation context",
+ "description": "Context7 CLI - Fetch documentation context and configure Context7",
"type": "module",
"bin": {
"ctx7": "./dist/index.js"
diff --git a/packages/cli/src/commands/generate.ts b/packages/cli/src/commands/generate.ts
index 3186275b..5e0d83bf 100644
--- a/packages/cli/src/commands/generate.ts
+++ b/packages/cli/src/commands/generate.ts
@@ -35,6 +35,8 @@ interface QueryLogEntry {
results: ToolResultSnippet[];
}
+// TODO(deprecate-skills-phase-2): Remove this deprecated Skill Hub generation
+// subcommand after legacy `ctx7 skills generate` support is dropped.
export function registerGenerateCommand(skillCommand: Command): void {
skillCommand
.command("generate")
diff --git a/packages/cli/src/commands/skill.ts b/packages/cli/src/commands/skill.ts
index 756089f9..72d6ef80 100644
--- a/packages/cli/src/commands/skill.ts
+++ b/packages/cli/src/commands/skill.ts
@@ -57,6 +57,17 @@ import { homedir } from "os";
import { detectProjectDependencies } from "../utils/deps.js";
import { loadTokens, isTokenExpired } from "../utils/auth.js";
+const SKILL_HUB_DEPRECATION_WARNING =
+ "Warning: Skill commands are deprecated and will stop working in the next major release.";
+
+// TODO(deprecate-skills-phase-2): Delete this Skill Hub command tree once the
+// deprecated `ctx7 skills ...` compatibility window closes. Do not remove the
+// setup-installed Context7 skills with it.
+function warnSkillHubDeprecated(): void {
+ console.error(pc.yellow(SKILL_HUB_DEPRECATION_WARNING));
+ console.error("");
+}
+
function logInstallSummary(
targets: InstallTargets,
targetDirs: string[],
@@ -88,7 +99,13 @@ function logInstallSummary(
}
export function registerSkillCommands(program: Command): void {
- const skill = program.command("skills").alias("skill").description("Manage AI coding skills");
+ const skill = program
+ .command("skills", { hidden: true })
+ .alias("skill")
+ .description("Manage AI coding skills")
+ .hook("preAction", () => {
+ warnSkillHubDeprecated();
+ });
// Register generate subcommand
registerGenerateCommand(skill);
@@ -186,6 +203,7 @@ export function registerSkillAliases(program: Command): void {
.option("--antigravity", "Antigravity (.agent/skills/)")
.description("Install skills (alias for: skills install)")
.action(async (project: string, skillName: string | undefined, options: AddOptions) => {
+ warnSkillHubDeprecated();
await installCommand(project, skillName, options);
});
@@ -194,6 +212,7 @@ export function registerSkillAliases(program: Command): void {
.argument("<keywords...>", "Search keywords")
.description("Search for skills (alias for: skills search)")
.action(async (keywords: string[]) => {
+ warnSkillHubDeprecated();
await searchCommand(keywords.join(" "));
});
@@ -206,6 +225,7 @@ export function registerSkillAliases(program: Command): void {
.option("--antigravity", "Antigravity (.agent/skills/)")
.description("Suggest skills (alias for: skills suggest)")
.action(async (options: SuggestOptions) => {
+ warnSkillHubDeprecated();
await suggestCommand(options);
});
}
@@ -319,7 +339,7 @@ async function installCommand(
const popularity = formatPopularity(s.installCount) + " ".repeat(popularityColWidth - 4);
const trust = formatTrust(s.trustScore);
- const skillUrl = `https://context7.com/skills${s.project}/${s.name}`;
+ const skillUrl = s.url || `https://github.com${s.project}`;
const skillLink = terminalLink(s.name, skillUrl, pc.white);
const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc.white);
const metadataLines = [
@@ -496,11 +516,7 @@ async function searchCommand(query: string): Promise<void> {
const popularity = formatPopularity(s.installCount) + " ".repeat(popularityColWidth - 4);
const trust = formatTrust(s.trustScore);
- const skillLink = terminalLink(
- s.name,
- `https://context7.com/skills${s.project}/${s.name}`,
- pc.white
- );
+ const skillLink = terminalLink(s.name, s.url || `https://github.com${s.project}`, pc.white);
const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc.white);
const metadataLines = [
pc.dim("─".repeat(50)),
@@ -871,11 +887,7 @@ async function suggestCommand(options: SuggestOptions): Promise<void> {
const trust = formatTrust(s.trustScore) + " ".repeat(trustColWidth - trustLabel.length);
const matched = pc.yellow(s.matchedDep.padEnd(maxMatchedLen));
- const skillLink = terminalLink(
- s.name,
- `https://context7.com/skills${s.project}/${s.name}`,
- pc.white
- );
+ const skillLink = terminalLink(s.name, s.url || `https://github.com${s.project}`, pc.white);
const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc.white);
const metadataLines = [
pc.dim("─".repeat(50)),
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 76b69ac3..409929d4 100644
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -19,7 +19,7 @@ const program = new Command();
program
.name("ctx7")
- .description("Context7 CLI - Manage AI coding skills and documentation context")
+ .description("Context7 CLI - Fetch documentation context and configure Context7")
.version(VERSION)
.option("--base-url <url>")
.hook("preAction", (thisCommand) => {
@@ -39,21 +39,10 @@ program
"after",
`
Examples:
- ${brand.dim("# Search for skills")}
- ${brand.primary("npx ctx7 skills search pdf")}
- ${brand.primary("npx ctx7 skills search react hooks")}
-
- ${brand.dim("# Install from a repository")}
- ${brand.primary("npx ctx7 skills install /anthropics/skills")}
- ${brand.primary("npx ctx7 skills install /anthropics/skills pdf")}
-
- ${brand.dim("# Install to specific client")}
- ${brand.primary("npx ctx7 skills install /anthropics/skills --cursor")}
- ${brand.primary("npx ctx7 skills install /anthropics/skills --global")}
-
- ${brand.dim("# List and manage installed skills")}
- ${brand.primary("npx ctx7 skills list --claude")}
- ${brand.primary("npx ctx7 skills remove pdf")}
+ ${brand.dim("# Configure Context7 for your coding agent")}
+ ${brand.primary("npx ctx7 setup")}
+ ${brand.primary("npx ctx7 setup --mcp")}
+ ${brand.primary("npx ctx7 setup --cli")}
${brand.dim("# Remove Context7 setup")}
${brand.primary("npx ctx7 remove --cursor")}
@@ -64,8 +53,6 @@ Examples:
${brand.dim("# Query library documentation")}
${brand.primary('npx ctx7 library react "how to use hooks"')}
${brand.primary('npx ctx7 docs /facebook/react "useEffect examples"')}
-
-Visit ${brand.primary("https://context7.com")} to browse skills
`
);
@@ -81,16 +68,15 @@ program.action(() => {
console.log("");
const banner = figlet.textSync("Context7", { font: "ANSI Shadow" });
console.log(brand.primary(banner));
- console.log(brand.dim(" The open agent skills ecosystem"));
+ console.log(brand.dim(" Documentation context for AI coding agents"));
console.log("");
console.log(" Quick start:");
- console.log(` ${brand.primary("npx ctx7 skills search pdf")}`);
- console.log(` ${brand.primary("npx ctx7 skills install /anthropics/skills")}`);
+ console.log(` ${brand.primary("npx ctx7 setup")}`);
+ console.log(` ${brand.primary('npx ctx7 docs /facebook/react "useEffect examples"')}`);
console.log("");
console.log(` Run ${brand.primary("npx ctx7 --help")} for all commands and options`);
- console.log(` Visit ${brand.primary("https://context7.com")} to browse skills`);
console.log("");
});
diff --git a/packages/cli/src/types.ts b/packages/cli/src/types.ts
index 5ed08307..0c74e099 100644
--- a/packages/cli/src/types.ts
+++ b/packages/cli/src/types.ts
@@ -3,6 +3,9 @@ export interface SkillFile {
content: string;
}
+// TODO(deprecate-skills-phase-2): Remove Skill Hub response types when
+// deprecated `ctx7 skills ...` commands are deleted. Keep setup skill directory
+// types below.
export interface Skill {
name: string;
description: string;
diff --git a/packages/cli/src/utils/api.ts b/packages/cli/src/utils/api.ts
index 7abe6cf0..50b039b5 100644
--- a/packages/cli/src/utils/api.ts
+++ b/packages/cli/src/utils/api.ts
@@ -24,6 +24,8 @@ export function setBaseUrl(url: string): void {
baseUrl = url;
}
+// TODO(deprecate-skills-phase-2): Remove the Skill Hub API helpers in this file
+// when deprecated `ctx7 skills ...` commands are deleted.
export async function listProjectSkills(project: string): Promise<ListSkillsResponse> {
const params = new URLSearchParams({ project });
const response = await fetch(`${baseUrl}/api/v2/skills?${params}`);
diff --git a/packages/cli/src/utils/github.ts b/packages/cli/src/utils/github.ts
index 88deb353..5ef14d7f 100644
--- a/packages/cli/src/utils/github.ts
+++ b/packages/cli/src/utils/github.ts
@@ -180,6 +180,8 @@ type GitHubSkillsResult =
| { status: "repo_not_found" }
| { status: "error"; error: string };
+// TODO(deprecate-skills-phase-2): Remove direct GitHub Skill Hub fallback when
+// deprecated `ctx7 skills install/info` commands are deleted.
export async function listSkillsFromGitHub(project: string): Promise<GitHubSkillsResult> {
try {
const parts = project.split("/").filter(Boolean);