mirror of
https://github.com/anthropics/claude-plugins-official.git
synced 2026-03-17 22:43:09 +00:00
c7ba9d4c43
- Update skill/agent/command to use new query-docs tool (replaces get-library-docs) - Add query parameter usage for intelligent reranking - Add version pinning support (e.g., /vercel/next.js/v15.1.8) - Add tools and model metadata to agent - Simplify docs to focus on workflow, not parameter details - Add README.md with usage examples
120 lines
2.9 KiB
Markdown
120 lines
2.9 KiB
Markdown
# Context7 Plugin
|
|
|
|
Up-to-date, version-specific documentation and code examples for any library, directly in your AI coding assistant.
|
|
|
|
## What is Context7?
|
|
|
|
Context7 solves the problem of outdated training data and hallucinated APIs by providing real-time library documentation. Instead of relying on potentially outdated knowledge, Context7 fetches current documentation straight from source repositories.
|
|
|
|
**Without Context7:**
|
|
- Code examples based on outdated training data
|
|
- Hallucinated APIs that don't exist
|
|
- Generic answers for old package versions
|
|
|
|
**With Context7:**
|
|
- Current documentation from source repositories
|
|
- Working code examples
|
|
- Version-specific information
|
|
- Intelligent query-based context selection
|
|
|
|
## Available Tools
|
|
|
|
### `resolve-library-id`
|
|
|
|
Search and resolve library names to Context7-compatible library IDs.
|
|
|
|
```
|
|
Parameters:
|
|
- libraryName: Library name to search for (e.g., "react", "next.js")
|
|
- query: Your question for relevance ranking
|
|
|
|
Returns:
|
|
- id: Context7-compatible ID (e.g., "/vercel/next.js")
|
|
- title: Display name
|
|
- description: Short description
|
|
- totalSnippets: Documentation coverage
|
|
- benchmarkScore: Quality indicator (0-100)
|
|
- versions: Available versions
|
|
```
|
|
|
|
### `query-docs`
|
|
|
|
Fetch documentation with intelligent, query-based reranking.
|
|
|
|
```
|
|
Parameters:
|
|
- libraryId: Context7-compatible library ID
|
|
- Format: /org/project (e.g., /vercel/next.js)
|
|
- With version: /org/project/version (e.g., /vercel/next.js/v15.1.8)
|
|
- query: Specific question or task
|
|
|
|
Features:
|
|
- LLM-driven reranking based on query intent
|
|
- Deduplicated snippet selection
|
|
- Limited to 3 calls per question
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Automatic (Skill)
|
|
|
|
The `documentation-lookup` skill triggers automatically when you:
|
|
- Ask "how do I..." for any library
|
|
- Need code generation with a specific library
|
|
- Ask about setup or configuration
|
|
- Mention any framework (React, Next.js, Vue, etc.)
|
|
|
|
### Manual (Command)
|
|
|
|
Use the `/context7:docs` command:
|
|
|
|
```
|
|
/context7:docs react hooks
|
|
/context7:docs next.js how to set up authentication
|
|
/context7:docs /vercel/next.js/v15.1.8 app router
|
|
```
|
|
|
|
### Agent
|
|
|
|
Use the `docs-researcher` agent for focused documentation lookups that don't bloat the main conversation:
|
|
|
|
```
|
|
Spawn a docs-researcher agent to find React Query mutation examples
|
|
```
|
|
|
|
## Version Pinning
|
|
|
|
For consistent, reproducible results, use version-specific library IDs:
|
|
|
|
```
|
|
/vercel/next.js/v15.1.8
|
|
/facebook/react/v18.3.0
|
|
/prisma/prisma/v5.0.0
|
|
```
|
|
|
|
## Examples
|
|
|
|
**Basic usage:**
|
|
```
|
|
How do I set up authentication in Next.js?
|
|
→ Automatically fetches Next.js auth documentation
|
|
```
|
|
|
|
**With specific version:**
|
|
```
|
|
/context7:docs /vercel/next.js/v15.1.8 middleware
|
|
→ Fetches Next.js 15.1.8 middleware documentation
|
|
```
|
|
|
|
**Multiple libraries:**
|
|
```
|
|
How do I use Prisma with Next.js API routes?
|
|
→ Fetches relevant docs from both Prisma and Next.js
|
|
```
|
|
|
|
## Links
|
|
|
|
- [Context7 Website](https://context7.com)
|
|
- [GitHub Repository](https://github.com/upstash/context7)
|
|
- [Upstash](https://upstash.com)
|