AgentSkillsCN

documentation-lookup

当用户询问有关库、框架、API参考,或需要代码示例时,应使用此技能。在解答设置疑问、生成涉及库的代码,或提及特定框架如React、Vue、Next.js、Prisma、Supabase等时自动激活。

SKILL.md
--- frontmatter
name: documentation-lookup
description: This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

When the user asks about libraries, frameworks, or needs code examples, use Context7 to fetch current documentation instead of relying on training data.

When to Use This Skill

Activate this skill when the user:

  • Asks setup or configuration questions ("How do I configure Next.js middleware?")
  • Requests code involving libraries ("Write a Prisma query for...")
  • Needs API references ("What are the Supabase auth methods?")
  • Mentions specific frameworks (React, Vue, Svelte, Express, Tailwind, etc.)

How to Fetch Documentation

Step 1: Resolve the Library ID

Call resolve-library-id with:

  • libraryName: The library name extracted from the user's question
  • query: The user's full question (improves relevance ranking)

Step 2: Select the Best Match

From the resolution results, choose based on:

  • Exact or closest name match to what the user asked for
  • Higher benchmark scores indicate better documentation quality
  • If the user mentioned a version (e.g., "React 19"), prefer version-specific IDs

Step 3: Fetch the Documentation

Call query-docs with:

  • libraryId: The selected Context7 library ID (e.g., /vercel/next.js)
  • query: The user's specific question

Step 4: Use the Documentation

Incorporate the fetched documentation into your response:

  • Answer the user's question using current, accurate information
  • Include relevant code examples from the docs
  • Cite the library version when relevant

When NOT to Use This Skill

Do not activate when:

  • User asks about internal/proprietary code (use codebase exploration instead)
  • Question is about general programming concepts not tied to a specific library
  • User explicitly says they want to use training data or offline knowledge
  • The library is obscure and unlikely to be in Context7 (try once, then fall back)

Constraints

MUST DO

  • Always resolve library ID before querying docs
  • Pass the user's full question for better relevance
  • Prefer official packages over community forks
  • Cite library version when providing examples
  • Fall back gracefully if library not found in Context7

MUST NOT DO

  • Query docs without resolving library ID first
  • Assume library names (verify with resolve-library-id)
  • Ignore version requirements when user specifies them
  • Mix documentation from different library versions
  • Skip Context7 when current docs would help

Guidelines

  • Be specific: Pass the user's full question as the query for better results
  • Version awareness: When users mention versions ("Next.js 15", "React 19"), use version-specific library IDs if available from the resolution step
  • Prefer official sources: When multiple matches exist, prefer official/primary packages over community forks
  • Graceful fallback: If Context7 doesn't have the library, acknowledge and use training data with a disclaimer