context7-cli

Files (1)

• SKILL.md

SKILL.md (first lines)

# Context7 CLI

## What this skill is for

Use this skill when you need Context7 documentation lookup but do **not** want MCP tool registration.

Typical cases:
- 라이브러리/프레임워크 공식 문서 기반 답변이 필요할 때
- 패키지 사용법, API, 버전별 예시를 빠르게 찾을 때
- searcher가 bash로 Context7를 직접 호출해야 할 때

## Preferred flow

1. **Check how to run Context7 CLI**
   - Prefer `ctx7` if it is already installed.
   - Otherwise retry with `npx -y ctx7`.
2. **Resolve the library ID**
   - Run `ctx7 library <name> [query]`
3. **Fetch docs with the resolved ID**
   - Run `ctx7 docs <library-id> <query>`
4. **Prefer JSON when machine-readable output helps**
   - Add `--json`
   - If JSON is malformed, sparse, or hard to parse, retry without `--json`
5. **Report fallback path clearly**
   - If Context7 fails, fall back to official docs / `web_search` / `fetch_content`
   - State that confidence is reduced

If you already know the exact library ID, skip `library` and go straight to `docs`.

## Command patterns

### 1) Check availability

```bash
ctx7 --help
```

If that fails:

```bash
npx -y ctx7 --help
```

### 2) Resolve a library ID

```bash
ctx7 library react
ctx7 library nextjs "app router authentication"
ctx7 library prisma "relations"
```

JSON mode:

```bash
ctx7 library react --json
```

### 3) Query docs

```bash
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
```

JSON mode:

```bash
ctx7 docs /facebook/react "hooks" --json
```

## Bash usage guidance

When you are unsure whether `ctx7` is installed, prefer a bash pattern like this:

```bash
if command -v ctx7 >/dev/null 2>&1; then
  ctx7 library react --json
else
  npx -y ctx7 library react --json
fi
```

For doc queries:

```bash
if command -v ctx7 >/dev/null 2>&1; then
  ctx7 docs /facebook/react "useEffect cleanup" --json
else
  npx -y ctx7 docs /facebook/react "useEffect cleanup" --json
fi
```

## Authentication

For automation, prefer environment-variable auth when needed:

```bash
export CONTEXT7_API_KEY=your_key_here
```

Interactive auth may also be available:

```bash
ctx7 login
ctx7 whoami
ctx7 logout
```

Optional telemetry disable:

```bash
export CTX7_TELEMETRY_DISABLED=1
```

If unauthenticated access works but appears rate-limited, mention that limitation in the report.

## Output handling rules

From Jonghakseo/my-pi, MIT.

More from Jonghakseo/my-pi