Thomashighbaugh/context7-docs

Context7 Docs - Library Documentation

Fetch up-to-date library documentation via the Context7 MCP server. Use this skill when you need to research any npm library, framework, or tool.

Quick Reference

| Action | Command | Description | |--------|---------|-------------| | search | ./scripts/docs.sh search <library> | Find library ID for a given name | | docs | ./scripts/docs.sh docs <library> [topic] [--tokens N] | Get documentation for a library | | help | ./scripts/docs.sh help | Show usage help |

How to Use

Natural Language

• "Get React hooks documentation"
• "Search for Next.js App Router docs"
• "Find Vue 3 composition API documentation"
• "Look up Tailwind CSS utilities"

Script Commands

# Search for a library
./scripts/docs.sh search react
./scripts/docs.sh search "next.js"

# Get documentation (automatically resolves library ID)
./scripts/docs.sh docs react hooks
./scripts/docs.sh docs next.js "app router"
./scripts/docs.sh docs tailwindcss utilities

# Get general documentation without topic filter
./scripts/docs.sh docs vue

Available Actions

search

Find the Context7-compatible library ID for a given library name.

Parameters:

• library (required): Library name to search for (e.g., "react", "next.js")

Example:

./scripts/docs.sh search react
# Returns: /npm/react, /websites/react_dev, etc.

docs

Get documentation for a library, optionally filtered by topic.

Parameters:

• library (required): Library name (will be resolved to ID automatically)
• topic (optional): Topic to filter documentation (e.g., "hooks", "routing")

Example:

# Get React hooks documentation
./scripts/docs.sh docs react hooks

# Get general Next.js documentation
./scripts/docs.sh docs next.js

# Get specific Vue documentation
./scripts/docs.sh docs vue "composition api"

Workflow

This skill encodes the Context7 two-step workflow:

1. Check ID cache first: Before calling resolve-library-id, check .opencode/context/research/_library-ids.json for a cached library ID. If found and less than 30 days old, skip the resolve step entirely.
2. Check doc cache: Check .opencode/context/research/{library-slug}/ for existing cached docs matching the library and query. If a cached result exists and is less than 7 days old, use it directly — skip the API call entirely.
3. Resolve Library ID (if not cached): Converts human-readable library name to Context7 ID
4. Fetch Documentation (if not cached): Gets documentation using the resolved ID
5. Cache both: After resolving, save the library ID to _library-ids.json. After fetching, save results to .opencode/context/research/{library-slug}/{query-hash}.md.

ID Cache Format

.opencode/context/research/_library-ids.json:

{
  "react": { "id": "/npm/react", "resolved": "2026-06-26T00:00:00Z" },
  "next.js": { "id": "/vercel/next.js", "resolved": "2026-06-26T00:00:00Z" },
  "tailwindcss": { "id": "/tailwindlabs/tailwindcss", "resolved": "2026-06-26T00:00:00Z" }
}

ID cache TTL: 30 days. Library IDs rarely change.

Cache Structure

.opencode/context/research/
├── react/
│   ├── hooks-abc123.md
│   ├── server-components-def456.md
│   └── _index.json          # maps query → file + timestamp
├── nextjs/
│   ├── app-router-ghi789.md
│   └── _index.json
└── tailwindcss/
    └── ...

Cache format (_index.json):

{
  "hooks-abc123": { "file": "hooks-abc123.md", "query": "React hooks", "fetched": "2026-06-26T00:00:00Z", "ttl": "7d" }
}

Cache check logic:

1. Compute library-slug from the library name (lowercase, hyphens, no special chars)
2. Compute query-hash from the query string (first 8 chars of SHA256)
3. Check .opencode/context/research/{library-slug}/_index.json for a matching entry
4. If found and fetched + 7d > now, read the cached file and return its content
5. If not found or expired, proceed with the API call, then save the result

Supported Libraries

Context7 supports thousands of libraries including:

• Frontend: React, Vue, Angular, Svelte, Solid
• Meta-frameworks: Next.js, Nuxt, Remix, Astro, SvelteKit
• Styling: Tailwind CSS, styled-components, Emotion
• State: Redux, Zustand, Jotai, Pinia
• Backend: Express, Fastify, Hono, Nest.js
• Databases: Prisma, Drizzle, TypeORM, Mongoose
• Testing: Jest, Vitest, Playwright, Cypress
• And many more...

Prerequisites

• Node.js 18+ installed
• curl installed
• Option A: Install MCPorter via Homebrew: brew tap steipete/tap && brew install mcporter
• Option B: Use via npx (no install required): npx mcporter

Note: Context7 server configuration is optional. The skill automatically falls back to the Context7 public URL (https://mcp.context7.com/mcp) if no local server is configured.

Environment Variables

• CONTEXT7_SERVER: MCP server name (default: context7)
• CONTEXT7_API_BASE: Direct Context7 REST base URL (default: https://context7.com/api/v2)
• CONTEXT7_REST_FALLBACK: Enable direct REST fallback when MCP calls fail (default: 1)
• MCPORTER_TIMEOUT: Timeout in seconds for MCPorter calls (default: 20)

Notes

• Use this skill BEFORE searching external documentation
• Topic filtering helps reduce context size - use specific topics when possible
• Use --tokens N to control response size when context budget is tight
• If a library isn't found, try alternative names (e.g., "nextjs" vs "next.js")
• For generic MCP access, use the mcporter skill instead
• Falls back to Context7 public MCP URL when server not configured locally
• If MCP calls fail (including quota exhaustion), falls back to direct Context7 REST API when enabled