# Use Ctx7

> Fetch up-to-date library documentation via the ctx7 CLI. Use PROACTIVELY whenever any code change, feature design, or implementation or user request involves a project dependency — always query the matching version's docs first before writing code.

- Skill: `discountry/use-ctx7` (Agent Skill)
- Install (CLI): `npx skillmds@latest add discountry/use-ctx7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/discountry/use-ctx7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: discountry (https://skillmd.com/u/discountry)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/discountry/use-ctx7

---


Query indexed library documentation via the `ctx7` CLI. Always follow the two-step process below.

## 1.Resolve Library ID

```bash
ctx7 library <name> "<specific question>"
```

The query ranks results by relevance — be descriptive, not single-keyword.

**Pick the best match** by: closest name, highest snippet count, strongest reputation.

| Field            | Description                                              |
| ---------------- | -------------------------------------------------------- |
| Library ID       | Identifier for Step 2 (format: `/org/project`)          |
| Code Snippets    | Number of indexed examples — higher = better coverage    |
| Source Reputation | Authority: High, Medium, Low, Unknown                   |
| Benchmark Score  | Quality score 0–100                                      |
| Versions         | Version-specific IDs (format: `/org/project/version`)   |

For a specific version, use the version ID from results (e.g. `/vercel/next.js/v14.3.0-canary.87`).

## 2.Fetch Documentation

```bash
ctx7 docs <library-id> "<specific question>"
```

Library IDs **always start with `/`**. Using a bare name like `react` will fail.

Write specific queries describing what you want to accomplish — `"How to set up authentication with JWT in Express.js"` >> `"auth"`.

### Output formats

```bash
# Structured JSON
ctx7 docs /facebook/react "How to use hooks for state management" --json

# Pipe-friendly (no spinners/colors outside TTY)
ctx7 docs /vercel/next.js "middleware for route protection" | head -50
```

## Examples

```bash
# Next.js app router
ctx7 library nextjs "How to set up app router with middleware"
ctx7 docs /vercel/next.js "How to set up app router with middleware"

# Scripting: resolve ID then fetch
ctx7 library react "hooks" --json | jq '.[0].id'
```

## Checklist

- [ ] Always run `ctx7 library` first to get the correct ID
- [ ] Use the full `/org/project` ID — never a bare name
- [ ] Write descriptive queries, not single keywords
- [ ] Pick version-specific ID when the user needs docs for a particular version

