From 2ca340be22e549db1a1750dc6af7a00873480dd5 Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Tue, 17 Mar 2026 20:42:32 +0100 Subject: [PATCH] =?UTF-8?q?feat(skills):=20add=20ctx7=20CLI=20registry-bas?= =?UTF-8?q?ed=20discovery=20section=20=C2=A75.5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - New subsection in §5.5: ctx7 skills suggest/install/setup workflow - Clarifies agentskills.io (spec) vs context7.com/skills (registry) - Cross-reference note in mcp-servers-ecosystem.md Context7 entry - Resource evaluation: 2026-03-17-context7-cli.md (score 4/5) Co-Authored-By: Claude Sonnet 4.6 --- CHANGELOG.md | 4 ++ .../2026-03-17-context7-cli.md | 34 ++++++++++ guide/ecosystem/mcp-servers-ecosystem.md | 2 + guide/ultimate-guide.md | 63 +++++++++++++++++++ 4 files changed, 103 insertions(+) create mode 100644 docs/resource-evaluations/2026-03-17-context7-cli.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 18abc4e..c559ac9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] +- **New guide section §5.5 — Registry-based Discovery: ctx7 CLI** (`guide/ultimate-guide.md`): Context7's CLI companion (`npx ctx7`) for automated skill discovery and MCP setup. Documents `ctx7 skills suggest` (dependency-aware skill recommendations), `ctx7 skills install owner/repo`, `ctx7 setup --claude` wizard, and `ctx7 docs` terminal lookup. Clarifies agentskills.io (open spec) vs context7.com/skills (registry) relationship. Cross-reference note added to `guide/ecosystem/mcp-servers-ecosystem.md` Context7 section. Resource evaluation: `docs/resource-evaluations/2026-03-17-context7-cli.md` (score 4/5). + +- **Doc audit — stats sync**: corrected stale counts across guide + landing. Templates: 204/216/217/218/222/232 → unified to 217 (per `check-landing-sync.sh` logic). Guide lines: "22K" → "23K+" (actual: 23,422). Quiz: reference.yaml `quiz_count` and llms*.txt had 311 → corrected to 271 (actual count). Version in llms.txt / llms-full.txt / machine-readable/llms.txt bumped 3.36.0 → 3.37.0. Landing updated: FeaturesGrid, GuideComparison, WhyGuide, McpDemo, cheatsheet page, index.astro, compare page, and guide content files (00-introduction, index, 09-advanced-patterns, 12-appendices). + ## [3.37.0] - 2026-03-17 - **ICM v0.5.0 — setup guide + session starter template**: corrected `icm init` documentation (3 explicit modes: `--mode mcp`, `--mode hook`, `--mode skill` — not a single interactive command); fixed CLI syntax (`--importance` is an enum `critical|high|medium|low`, not a float; no `memory` subcommand); added `examples/memory/icm-session-starter.md` ready-to-use onboarding prompt to paste at the start of any session. diff --git a/docs/resource-evaluations/2026-03-17-context7-cli.md b/docs/resource-evaluations/2026-03-17-context7-cli.md new file mode 100644 index 0000000..5d45664 --- /dev/null +++ b/docs/resource-evaluations/2026-03-17-context7-cli.md @@ -0,0 +1,34 @@ +# Resource Evaluation: Context7 CLI (ctx7) + +**URL**: https://context7.com/docs/clients/cli +**Date**: 2026-03-17 +**Evaluator**: Claude Sonnet 4.6 +**Score**: 4/5 + +## Summary + +CLI companion to the Context7 MCP server (Upstash). Covers three functions: fetch library docs in terminal, manage skills (install/search/suggest/generate), configure Context7 for Claude Code. + +Key commands: +- `npx ctx7 skills suggest` — auto-detects project deps, recommends matching skills +- `npx ctx7 skills install owner/repo` — install from any GitHub repository +- `npx ctx7 setup --claude` — wizard for MCP or CLI+Skills mode configuration +- `npx ctx7 library [name]` / `ctx7 docs [id] [query]` — doc lookup without browser + +## Decision + +**Integrated** into `guide/ultimate-guide.md` §5.5 as new subsection "Registry-based Discovery: ctx7 CLI" (~60 lines) and a cross-reference note in `guide/ecosystem/mcp-servers-ecosystem.md` Context7 section. + +## Key Finding + +The existing workflow (curl/unzip from GitHub) is replaced by `ctx7 skills suggest` + `ctx7 skills install`, which adds dependency-awareness and trust scores. The guide was documenting a 2024 manual workflow for a 2025 ecosystem. + +## Fact-Check Note + +First WebFetch call hallucinated "Built by Anthropic" for Context7 — this is false. Context7 is an Upstash product (confirmed via mcp-servers-ecosystem.md: `@upstash/context7-mcp`). Corrected before integration. + +## Registry Relationship + +- `agentskills.io` = open spec (30+ platforms, defined skill format) — guide §5.1 +- `context7.com/skills` = hosted registry of conforming skills with trust scores +- These are complementary, not competing. Documented in the guide integration. diff --git a/guide/ecosystem/mcp-servers-ecosystem.md b/guide/ecosystem/mcp-servers-ecosystem.md index ff247d9..26e0e45 100644 --- a/guide/ecosystem/mcp-servers-ecosystem.md +++ b/guide/ecosystem/mcp-servers-ecosystem.md @@ -910,6 +910,8 @@ Result: Official Python SDK docs + example code for streaming - **Official Site**: https://context7.com - **LobeHub Registry**: https://lobehub.com/mcp/upstash-context7 +**ctx7 CLI companion**: Context7 also ships a CLI (`npx ctx7`) that handles skill discovery and MCP setup from the terminal. `ctx7 skills suggest` auto-detects project dependencies and recommends matching skills; `ctx7 setup --claude` runs a wizard that configures MCP or CLI+Skills mode automatically. See §5.5 of the ultimate guide for the full workflow. + --- ### Project Management diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index a97a2c0..6607b5d 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -7576,6 +7576,69 @@ This skill is now installed in the Méthode Aristote repository at: ## 5.5 Community Skill Repositories +### Registry-based Discovery: ctx7 CLI + +Before diving into specific repositories, Context7 provides a CLI companion (`ctx7`) that automates skill discovery and installation. Instead of manually cloning repos, `ctx7 skills suggest` analyzes your project's dependencies and recommends matching skills from the [context7.com/skills](https://context7.com/skills) registry — with trust scores to help evaluate quality. + +**Install**: + +```bash +npx ctx7 --help # No install required (npx) +npm install -g ctx7 # Global install +``` + +**Discovery workflow**: + +```bash +# Auto-detect project deps and suggest matching skills +npx ctx7 skills suggest + +# Search by keyword +npx ctx7 skills search terraform + +# Install from any GitHub repository +npx ctx7 skills install antonbabenko/terraform-skill +npx ctx7 skills install owner/repo + +# List / remove installed skills +npx ctx7 skills list +npx ctx7 skills remove skill-name +``` + +**Setup wizard** (replaces manual `claude mcp add`): + +```bash +# Configure Context7 for Claude Code — detects editor, picks MCP or CLI+Skills mode +npx ctx7 setup --claude +``` + +`ctx7 setup` runs a wizard that configures Context7 in the right mode for your editor. Use it when setting up Context7 for the first time instead of writing `claude mcp add` manually. The `--claude` flag targets Claude Code specifically; `--cursor` and `--universal` are available for other editors. + +**Registry vs. agentskills.io**: The [agentskills.io](https://agentskills.io) specification is the open standard defining the skill format (supported by 30+ platforms — see §5.1). The [context7.com/skills](https://context7.com/skills) registry is a hosted directory of skills conforming to that standard. The two are complementary: agentskills.io defines the format, context7.com/skills is one place to discover and share conforming skills. Skills installed via `ctx7` land in `~/.claude/skills/` and work identically to manually installed ones. + +**Skill generation** (authenticated, rate-limited): + +```bash +npx ctx7 skills generate # AI-generated custom skill + # Free: 6 generations/week — Pro: 10/week +``` + +Generation is best reserved for skills with no equivalent in the registry. For team onboarding at scale, the `suggest` + `install` workflow is more practical than generation. + +**CLI doc lookup** (alternative to MCP): + +```bash +# Search available libraries +npx ctx7 library react + +# Fetch docs for a specific library + query +npx ctx7 docs /facebook/react "useEffect cleanup" +``` + +This is the terminal equivalent of what the Context7 MCP server does. Useful when you want to look something up yourself without invoking Claude, or in environments where MCP is not configured. Claude Code users who already have the MCP server active don't need this — Claude handles it automatically. + +--- + ### Cybersecurity Skills Repository The Claude Code community has created specialized skill collections for specific domains. One notable collection focuses on cybersecurity and penetration testing.