# Docs Seeker

> Find documentation for APIs, libraries, and error messages. Looks up official docs, changelog entries, and migration guides.

- **Type:** Skill
- **Install:** `agentstack add skill-rune-kit-rune-docs-seeker`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Rune-kit](https://agentstack.voostack.com/s/rune-kit)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Rune-kit](https://github.com/Rune-kit)
- **Source:** https://github.com/Rune-kit/rune/tree/master/skills/docs-seeker

## Install

```sh
agentstack add skill-rune-kit-rune-docs-seeker
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# docs-seeker

## Purpose

Documentation lookup utility. Receives a library name, API reference, or error message, resolves the correct documentation, and returns API signatures, usage examples, and known issues. Stateless — no memory between calls.

## Calls (outbound)

None — pure L3 utility using `WebSearch`, `WebFetch`, and Context7 MCP tools directly.

## Called By (inbound)

- `debug` (L2): lookup API docs for unclear errors
- `fix` (L2): check correct API usage before applying changes
- `review` (L2): verify API usage is current and correct
- `adversary` (L2): verify framework/API assumptions in plan are correct

## Execution

### Input

```
target: string         — library name, API endpoint, or error message
version: string        — (optional) specific version to look up
query: string          — specific question about the target (e.g., "how to configure retry")
```

### Step 1 — Identify Target

Parse the input to extract:
- Library or framework name (e.g., "react-query", "fastapi", "prisma")
- Version if specified
- The specific API, method, or error to look up

### Step 2 — Try Context7 MCP (fastest)

Attempt Context7 MCP lookup first (faster, higher quality):

1. Call `mcp__plugin_context7_context7__resolve-library-id` with the library name and query
2. Select the best matching library ID from results (prioritize: name match, source reputation, snippet count)
3. Call `mcp__plugin_context7_context7__query-docs` with the resolved library ID and the specific query
4. If Context7 returns a satisfactory answer with code examples, proceed to Step 5

### Step 3 — Try llms.txt Discovery

If Context7 MCP is unavailable or insufficient, try llms.txt (AI-optimized documentation):

**For GitHub repos** — pattern: `https://context7.com/{org}/{repo}/llms.txt`
```
github.com/vercel/next.js    → context7.com/vercel/next.js/llms.txt
github.com/shadcn-ui/ui      → context7.com/shadcn-ui/ui/llms.txt
```

**For doc sites** — pattern: `https://context7.com/websites/{normalized-domain}/llms.txt`
```
docs.imgix.com               → context7.com/websites/imgix/llms.txt
ffmpeg.org/doxygen/8.0        → context7.com/websites/ffmpeg_doxygen_8_0/llms.txt
```

**Topic-specific** — append `?topic={query}` for focused results:
```
context7.com/shadcn-ui/ui/llms.txt?topic=date-picker
context7.com/vercel/next.js/llms.txt?topic=cache
```

**Traditional llms.txt fallback**: `WebSearch "[library] llms.txt"` → common paths: `docs.[lib].com/llms.txt`, `[lib].dev/llms.txt`

Use `WebFetch` on the resolved llms.txt URL. If it contains multiple section URLs (3+), launch parallel Explorer agents (one per section, max 5).

### Step 4 — Fallback to Web Search

If neither Context7 nor llms.txt available:

1. Use `WebSearch` with queries:
   - "[library] [api/method] official documentation"
   - "[library] [version] [query]"
   - "[error message] [library] fix"
2. Identify official documentation URLs (docs.*, official GitHub, npm/pypi pages)
3. Call `WebFetch` on the top 1-3 official sources

**Repository analysis fallback** (when docs are sparse but code is available):
```bash
npx repomix --output /tmp/repomix-output.xml   # in the cloned repo
```
Read the repomix output to extract API patterns, usage examples, and internal documentation.

### Step 5 — Extract Answer

From Context7, llms.txt, or fetched pages, extract:
- Exact API signature with parameter types and return type
- Minimal working code example
- Version-specific notes (deprecated in X, changed in Y)
- Known issues or common pitfalls mentioned in docs

### Step 6 — Report

Return structured documentation in the output format below.

## Constraints

- Prefer Context7 MCP → llms.txt → WebSearch (in that priority order)
- Only fall back to web if Context7 and llms.txt both lack coverage
- Use `?topic=` parameter on llms.txt URLs for targeted results
- Always include source URL so callers can verify
- If the API is deprecated, say so explicitly and link to the replacement
- For parallel fetching: 1-3 URLs = single agent, 4-10 = 3-5 Explorer agents, 11+ = 5-7 agents

## Output Format

```
## Documentation: [Library/API]
- **Version**: [detected or "latest"]
- **Source**: [official docs URL or "Context7"]

### API Reference
- **Signature**: `functionName(param1: Type, param2: Type): ReturnType`
- **Parameters**:
  - `param1` — description
  - `param2` — description
- **Returns**: description

### Usage Example
```[lang]
[minimal working code snippet from official docs]
```

### Known Issues / Deprecations
- [relevant warning, deprecation notice, or common mistake]
```

## Sharp Edges

Known failure modes for this skill. Check these before declaring done.

| Failure Mode | Severity | Mitigation |
|---|---|---|
| Returning deprecated API without flagging it | HIGH | Must explicitly state "deprecated in X.Y, use Z instead" with replacement link |
| Wrong version docs returned when version specified | HIGH | Verify version match — if version-specific docs unavailable, state that explicitly |
| Skipping Context7 and going directly to web search | MEDIUM | Constraint: Context7 MCP → llms.txt → WebSearch — follow the priority chain |
| Not using ?topic= on llms.txt for focused queries | LOW | Topic parameter dramatically reduces noise — always append when query is specific |
| Returning docs without source URL | MEDIUM | Constraint: always include source URL so callers can verify |

## Done When

- Context7 attempted first (resolve-library-id + query-docs)
- If Context7 insufficient: top 1-3 official doc URLs fetched via WebFetch
- API signature extracted with parameter types and return type
- Minimal working code example included
- Deprecation/version notes included if applicable
- Source URL provided
- Documentation emitted in output format

## Returns

| Artifact | Format | Location |
|----------|--------|----------|
| API reference (signature + params) | Markdown | inline |
| Minimal working code example | Code block | inline |
| Deprecation / version notes | Markdown | inline |
| Source URL | Plain text | inline |

## Cost Profile

~300-600 tokens input, ~200-400 tokens output. Haiku. Fast lookup.

**Scope guardrail:** docs-seeker looks up documentation only — it does not apply changes, write code, or interpret whether the API fits the caller's use case.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Rune-kit](https://github.com/Rune-kit)
- **Source:** [Rune-kit/rune](https://github.com/Rune-kit/rune)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rune-kit-rune-docs-seeker
- Seller: https://agentstack.voostack.com/s/rune-kit
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.