{"slug":"context7-2","title":"context7","summary":"Fetch up-to-date library/framework/API documentation from Context7, bypassing training-cutoff limits. Use when: (1) User asks how to use/configure/install a library, framework, or SDK, (2) Code examples or API reference needed for a specific package, (3) Version-specific behavior","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-15T18:23:46.406555Z","repo":{"url":"https://github.com/Dianel555/DSkills","stars":65,"forks":8,"license":"MIT","updatedAt":"2026-09-23T12:19:20Z"},"bodyHtml":"
\n

name: context7\ndescription: |\nFetch up-to-date library/framework/API documentation from Context7, bypassing training-cutoff limits. Use when: (1) User asks how to use/configure/install a library, framework, or SDK, (2) Code examples or API reference needed for a specific package, (3) Version-specific behavior questions (e.g., \"React 19\", \"Next.js 15\"), (4) Any npm package, GitHub repo, or framework mention (React/Vue/Next/Prisma/Tailwind/Supabase/...). Triggers: \"如何实现\", \"怎么写\", \"配置\", \"安装\", \"文档\", \"How do I\", \"Show me how\", \"generate code\", library/framework names. Differentiator: Real-time authoritative docs via Context7 API, complements grok-search (real-time news) and exa (semantic web research) — use this for library/API specifics, not general web search.

\n

Context7

\n

Fetch current library/framework/API documentation from the Context7 API, so answers cite authoritative docs instead of relying on outdated training data. This skill uses the co-located Node CLI in context7-api.cjs; no MCP dependency is required.

\n

Architecture

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PieceRoleRecommended Use
context7 (this file)Intent detection, library selection, answer integrationDefault path
context7-fetcherOptional low-context wrapper around the same CLIUse only if your runtime truly supports isolated workers/subtasks
\n

The canonical execution path is to run the co-located CLI directly. Do not require a Task/Bash-specific subtask mechanism, and do not hardcode repo-relative paths like skills/context7/context7-api.cjs — that breaks when the skill is installed globally outside the source repo.

\n

Call Flow

\n
User Query → context7 (detect trigger + extract library)\n    ↓ shell / worker → node <context7-skill-dir>/context7-api.cjs search <library> <query>\n                         → JSON libraries[] (+ raw results[])\ncontext7 (select best match: name / trustScore / version)\n    ↓ shell / worker → node <context7-skill-dir>/context7-api.cjs context <libraryId> <query>\n                         → JSON results[] (+ raw codeSnippets[] / infoSnippets[])\ncontext7 (integrate relevant snippets into answer)\n
\n

Implementation Layout

\n\n

Execution Method

\n
# Prerequisites: Node.js 18+ (no npm install needed; stdlib only)\n# Environment: CONTEXT7_API_KEY (optional; public rate limits apply if unset)\n\n# Run from the context7 skill directory\nnode ./context7-api.cjs search \"<library-name>\" \"<user-query>\"\nnode ./context7-api.cjs context \"<library-id>\" \"<specific-query>\"\n
\n
\n

Safe default: resolve the actual context7 skill directory first, cd into it, then run node ./context7-api.cjs ....

\n
\n

Stable Output Contract

\n

The Context7 HTTP API payload changed shape, so context7-api.cjs now exposes a compatibility contract:

\n\n

Prefer the normalized aliases (libraries[], results[]) in downstream logic.

\n

Tool Capability Matrix

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CommandRequired ArgsOutput
search<libraryName>, <query>{libraries:[...], results:[...], searchFilterApplied?:boolean}
context<libraryId>, <query>{results:[...], codeSnippets?:[...], infoSnippets?:[...]}
\n

Library IDs are Context7 slugs (for example /reactjs/react.dev, /vercel/next.js, /vercel/next.js/v15.1.8). If the user specifies a version, prefer a version-pinned ID returned by search.

\n

Research Workflow

\n

Step 1: Extract Library Information

\n

From the user query, identify:

\n\n

Step 2: Search for the Library

\n
cd <context7-skill-dir>\nnode ./context7-api.cjs search \"<library>\" \"<full user question>\"\n
\n

Step 3: Select the Best Match

\n

Choose from libraries[] by:

\n
    \n
  1. Exact name match to the user's query
    2. \n
  2. Highest trustScore
    3. \n
  3. Version match if specified
    4. \n
  4. Official packages over community forks
    5. \n
\n

Step 4: Fetch Documentation

\n
cd <context7-skill-dir>\nnode ./context7-api.cjs context \"<libraryId>\" \"<feature query>\"\n
\n

Step 5: Integrate into the Answer

\n
    \n
  1. Answer accurately with fetched current information
    2. \n
  2. Include code examples drawn from the docs
    3. \n
  3. Cite the version when relevant
    4. \n
  4. Quote only the relevant snippet instead of dumping entire documentation
    5. \n
\n
\n

If your runtime can spawn generic workers/subagents, pass the exact shell commands above. Do not assume a special Task API or a subagent_type: Bash feature exists.

\n
\n

Environment Setup

\n

The CLI loads the API key in this order:

\n
    \n
  1. CONTEXT7_API_KEY environment variable
    2. \n
  2. .env file in the skill directory
    3. \n
\n
cp .env.example .env\n# Edit .env: CONTEXT7_API_KEY=<your-key>\n
\n

Get a key at context7.com/dashboard. Without a key, the API falls back to public rate limits.

\n

Error Handling

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ErrorRecovery
search returns no librariesBroaden the library name; suggest alternatives
API 429 (rate limit)Retry once after a short delay; if it still fails, say Context7 is rate-limited
API 5xx / network failureCLI exits non-zero after writing the error to stderr; retry once, then fall back to training data and say it may be outdated
Library ID path mangled (Windows Git Bash)context7-api.cjs auto-fixes MSYS path conversion
Search/context payload shape driftUse normalized libraries[] / results[] aliases from context7-api.cjs
Global skill install + path issuesResolve the actual skill directory first; never blindly run node skills/context7/...
\n

Best Practices

\n\n

Anti-Patterns

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ProhibitedCorrect
node skills/context7/context7-api.cjs ... from an arbitrary project rootResolve the skill directory, then run node ./context7-api.cjs ... there
Depending on raw results / codeSnippets onlyRead normalized libraries[] / results[] first
Requiring a Task / Bash-only subtask APIUse direct CLI execution or a generic worker that runs the same command
Dumping entire fetched documentationExtract only the relevant snippet
Silently falling back to training dataTell the user the fallback may be outdated
Hardcoding library IDs across versionsRe-run search when version uncertainty exists
\n

Example Workflows

\n

Example 1: React Hook

\n

User: How do I use useEffect to fetch data in React 19?

\n
    \n
  1. Detect React 19 + useEffect + fetch data
    2. \n
  2. search \"react\" \"How do I use useEffect to fetch data in React 19?\"
    3. \n
  3. Choose the best version-aware result from libraries[]
    4. \n
  4. context \"<selected-library-id>\" \"useEffect data fetching\"
    5. \n
  5. Respond with current React guidance
    6. \n
\n

Example 2: Next.js Configuration

\n

User: 配置 Next.js 15 的中间件

\n
    \n
  1. Detect Next.js 15 + middleware
    2. \n
  2. search \"next.js\" \"middleware configuration\"
    3. \n
  3. Choose the version-pinned result if present
    4. \n
  4. context \"<selected-library-id>\" \"middleware\"
    5. \n
  5. Respond with current Next.js 15 setup
    6. \n
\n

Limitations

\n\n","files":[{"path":"context7-api.cjs","sizeBytes":7127,"isText":false},{"path":"context7-fetcher.md","sizeBytes":1039,"isText":true},{"path":".env.example","sizeBytes":125,"isText":false},{"path":"SKILL.md","sizeBytes":2680,"isText":true},{"path":"tests/test_context7_api.cjs","sizeBytes":4092,"isText":false}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"notes-only","suspicious":0,"notes":14,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-28T20:56:27.706408Z","sha256":"6C9328A1D03AC2A7F920E9E5E605DD4B204B8D3F923604960FF00B04060588DB","sizeBytes":6253},"review":null,"source":{"repositoryUrl":"https://github.com/Dianel555/DSkills","path":"skills/context7","license":"MIT","commit":"ec87a40f59b74d489967083036ed862665a985c5","subtreeSha":"9FDFAD05CFA8E0D25EE12EF375F80733092A1755EF921A06856CA385A87B8131","lastSyncedAt":"2026-09-28T20:56:07.363731Z"},"reviewedAt":"2026-09-28T20:56:46.736204Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Dianel555/DSkills/tree/main/skills/context7"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install dianel555-dskills@llmmart"},{"target":"git","command":"git clone https://github.com/Dianel555/DSkills.git"}]}