context7

通过 Context7 API 获取最新版的库文档。在以下场景中，应主动运用此技能： (1) 在处理任何外部库（如 React、Next.js、Supabase 等）时； (2) 当用户询问有关库的 API、设计模式或最佳实践时； (3) 在实现依赖第三方包的功能时； (4) 在调试特定于某库的问题时； (5) 当你需要获取超出训练数据截止日期的最新文档时； (6) 最重要的是，在安装依赖项、各类库或框架时，务必始终查阅官方文档，了解最新版本信息。切勿依赖过时的知识。相较于盲目猜测库的 API 或沿用陈旧信息，优先选择查阅官方文档才是更明智的做法。

SKILL.md

--- frontmatter

name: context7
description: |
  Fetch up-to-date library documentation via Context7 API. Use PROACTIVELY when:
  (1) Working with ANY external library (React, Next.js, Supabase, etc.)
  (2) User asks about library APIs, patterns, or best practices
  (3) Implementing features that rely on third-party packages
  (4) Debugging library-specific issues
  (5) Need current documentation beyond training data cutoff
  (6) AND MOST IMPORTANTLY, when you are installing dependencies, libraries, or frameworks you should ALWAYS check the docs to see what the latest versions are. Do not rely on outdated knowledge.
  Always prefer this over guessing library APIs or using outdated knowledge.

Context7 Documentation Fetcher

Retrieve current library documentation via Context7 API.

Authentication

This skill requires a Context7 API key in CONTEXT7_API_KEY.

Recommended setup options:

•Export it in your shell profile (global):

bash

export CONTEXT7_API_KEY="your-context7-key"

•Use a local .env file (per-repo):

bash

cp skills/context7/.env.example .env
set -a; source .env; set +a

Workflow

1. Search for the library

bash

python3 ~/.codex/skills/context7/scripts/context7.py search "<library-name>"

Example:

bash

python3 ~/.codex/skills/context7/scripts/context7.py search "next.js"

Returns library metadata including the id field needed for step 2.

2. Fetch documentation context

bash

python3 ~/.codex/skills/context7/scripts/context7.py context "<library-id>" "<query>"

Example:

bash

python3 ~/.codex/skills/context7/scripts/context7.py context "/vercel/next.js" "app router middleware"

Options:

•--type txt|md - Output format (default: txt)
•--tokens N - Limit response tokens

Quick Reference

Task	Command
Find React docs	`search "react"`
Get React hooks info	`context "/facebook/react" "useEffect cleanup"`
Find Supabase	`search "supabase"`
Get Supabase auth	`context "/supabase/supabase" "authentication row level security"`

When to Use

•Before implementing any library-dependent feature
•When unsure about current API signatures
•For library version-specific behavior
•To verify best practices and patterns