AgentSkillsCN

context7

通过 Context7 API 获取软件库、框架和组件的最新文档。适用于查询编程库或框架的文档、查找特定 API 或功能的代码示例、验证库函数的正确使用方式，或获取关于库 API 的最新信息——这些 API 可能在训练之后发生了变化。

SKILL.md
--- frontmatter
name: context7
description: >
  Retrieve up-to-date documentation for software libraries, frameworks, and
  components via the Context7 API. Use when looking up documentation for
  programming libraries or frameworks, finding code examples for specific APIs
  or features, verifying correct usage of library functions, or obtaining
  current information about library APIs that may have changed since training.

Context7

Overview

The Context7 skill enables retrieval of current documentation for software libraries and components by querying the Context7 API via curl. Preferred when training data may be outdated.

Workflow

Step 1: Search for the Library

Find the Context7 library ID by querying the search endpoint:

bash
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/libs/search?libraryName=LIBRARY_NAME&query=TOPIC" | jq '.results[0]'

Parameters:

  • •libraryName (required): The library name to search for (e.g., "react", "nextjs", "fastapi", "axios")
  • •query (required): A description of the topic for relevance ranking

Response fields:

  • •id: Library identifier for the context endpoint (e.g., /websites/react_dev_reference)
  • •title: Human-readable library name
  • •description: Brief description of the library
  • •totalSnippets: Number of documentation snippets available

Step 2: Fetch Documentation

Retrieve documentation with the library ID from step 1:

bash
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=TOPIC&type=txt"

Parameters:

  • •libraryId (required): The library ID from search results
  • •query (required): The specific topic to retrieve documentation for
  • •type (optional): Response format - json (default) or txt (plain text, more readable)

Examples

React hooks documentation

bash
# Find React library ID
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/libs/search?libraryName=react&query=hooks" | jq '.results[0].id'
# Returns: "/websites/react_dev_reference"

# Fetch useState documentation
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/context?libraryId=/websites/react_dev_reference&query=useState&type=txt"

Next.js routing documentation

bash
# Find Next.js library ID
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/libs/search?libraryName=nextjs&query=routing" | jq '.results[0].id'

# Fetch app router documentation
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/context?libraryId=/vercel/next.js&query=app+router&type=txt"

FastAPI dependency injection

bash
# Find FastAPI library ID
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/libs/search?libraryName=fastapi&query=dependencies" | jq '.results[0].id'

# Fetch dependency injection documentation
curl -s -H "Authorization: Bearer $CONTEXT7_API_KEY" "https://context7.com/api/v2/context?libraryId=/fastapi/fastapi&query=dependency+injection&type=txt"

Tips

  • •Prefer type=txt for more readable output
  • •Use jq to filter and format JSON responses
  • •Be specific with the query parameter to improve relevance ranking
  • •If the first search result is not correct, check additional results in the array
  • •URL-encode query parameters containing spaces (use + or %20)