200+ agent skills installed but you only use 3? One command scans everything — Claude Code, Codex, cc-switch, plugins — and generates a beautiful slide deck so you actually know what you have.
Live Demo · Try it now · Install · How it works
npx skill-guide --open # ← that's it. HTML slides open in your browser.skill-guide reads every skill from Claude Code, Codex, ~/.cc-switch/skills/, and plugin marketplaces, then generates a polished slide deck you can view in any browser.
4 modes:
| Mode | Command | Output |
|---|---|---|
| Discovery | /skill-guide or npx skill-guide --open |
Stats, category map, highlights, quick reference |
| Deep-dive | /skill-guide investigate or npx skill-guide --skill investigate --open |
How it works, when to use, limitations, triggers |
| Tool-selection | "Which skill for security?" | Ranked recommendations with comparison |
| Full manual | /skill-guide all or npx skill-guide --full --open |
One page per skill, complete reference |
| Doctor | npx skill-guide --doctor |
Environment and source diagnostics |
| Platform | Status | Scanned paths |
|---|---|---|
| Claude Code | Supported | ~/.claude/skills, ~/.claude/plugins/marketplaces |
| Codex | Supported | ~/.codex/skills, $CODEX_HOME/skills, Codex plugin cache |
| OpenAI system skills | Supported | $CODEX_HOME/skills/.system as a separate source |
| cc-switch | Supported | ~/.cc-switch/skills |
| Agent Skills | Compatible | Standard SKILL.md skill folders |
 |
 |
| Cover — total count & sources | Category map — grouped cards |
 |
 |
| Top picks — best skills | Quick reference table |
1. Try instantly — no install needed:
npx skill-guide --open2. Install for Claude Code:
npx skills add gtskevin/skill-guide3. Use it — type /skill-guide in Claude Code, or use the CLI:
npx skill-guide --open # Discover all skills
npx skill-guide --search security --open # Find skills for a task
npx skill-guide --skill tdd --open # Deep-dive one skill
npx skill-guide --full --open # Generate a full manual
npx skill-guide --doctor # Diagnose your setup# Claude Code: npx skills (recommended)
npx skills add gtskevin/skill-guide
# Claude Code: manual symlink
git clone https://github.com/gtskevin/skill-guide.git
ln -s $(pwd)/skill-guide ~/.claude/skills/skill-guide
# Claude Code: direct download
mkdir -p ~/.claude/skills/skill-guide
curl -sL https://github.com/gtskevin/skill-guide/archive/refs/heads/main.tar.gz | tar xz --strip-components=1 -C ~/.claude/skills/skill-guide
# Codex: manual symlink
git clone https://github.com/gtskevin/skill-guide.git
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s "$(pwd)/skill-guide" "${CODEX_HOME:-$HOME/.codex}/skills/skill-guide"npx skill-guide --open
npx skill-guide --search security --open
npx skill-guide --skill test-driven-development --open
npx skill-guide --format json
npx skill-guide --doctor/skill-guide
Or say: "What skills do I have?" / "帮我看看我有哪些技能"
In Codex, you can also say: "What Codex skills do I have?"
/skill-guide investigate
Or say: "Tell me about the TDD skill" / "介绍一下 investigate 技能"
Which skill should I use for code review?
Or: "帮我推荐一个做测试的技能"
/skill-guide all
skill-guide/
├── SKILL.md # Skill definition + HTML generation rules
├── agents/openai.yaml # Codex/OpenAI skill UI metadata
├── skill-guide.js # Deterministic CLI + HTML generator
├── scan-skills.js # Zero-dependency Node.js scanner
├── demo.html # Demo presentation (this is what you see above)
└── LICENSE # MIT
scan-skills.jsscans Claude Code, Codex, cc-switch, and plugin skill directories; parses YAML frontmatter; extracts sections and key paragraphsskill-guide.jsturns scanner JSON into deterministic HTML slides with scroll-snap navigation, keyboard controls, and animationsSKILL.mdlets Claude Code and Codex invoke the same CLI from natural language- Output opens in your browser — zero config, zero dependencies
| Flag | Purpose | Data |
|---|---|---|
--list |
Discovery | Name + description + category |
--skill <name> |
Deep-dive | Full metadata + sections + key paragraphs |
--search <query> |
Recommendations | Matching skills with full data |
--full |
Complete manual | All skills with full data |
--refresh |
Force re-scan | Ignores 5-min cache |
| Flag | Purpose |
|---|---|
--open |
Open the generated HTML in your browser |
--output <file> |
Save HTML to a specific path |
--format html,json |
Choose HTML slides or raw scanner JSON |
--search <query> |
Generate recommendations for a task |
--skill <name> |
Generate a deep-dive for one skill |
--full |
Generate a complete manual |
--lang <code> |
UI language (en, zh, or any — auto-translated) |
--doctor |
Check paths, sources, and scan counts |
npx skill-guide --doctor reports Node.js version, Claude Code and Codex skill paths, source counts, duplicate skill names, malformed skill files, and suggested install paths.
Skills are automatically sorted into 9 categories: testing, design, security, documentation, automation, deployment, code-quality, development, other.
Automatic — ask in any language, get output in that language. No configuration needed.
- English — default
- Chinese — built-in (
--lang zh) - Japanese, Korean, French, German, Spanish, ... — agent-side translation (works in Claude Code and Codex)
- The only skill that maps your skills — scans Claude Code, Codex, cc-switch, and plugin sources in one visual overview
- Zero dependencies — pure Node.js with
fs,path,os. Nonpm installneeded - Beautiful output — scroll-snap slides with keyboard nav, animations, and responsive design
- Any language — ask in Chinese, get Chinese. Ask in Japanese, get Japanese. Auto-detected.
- Smart caching — 5-minute TTL so repeated queries are instant
- 5 seconds to "wow" —
npx skill-guide --openis all you need
See CONTRIBUTING.md for guidelines.
-
--share— generate a shareable standalone HTML or Markdown summary - Gemini CLI skill scanning (
~/.gemini/skills) -
--diff— show recently added/removed skills since last scan -
--export markdown— output a Markdown table for pasting into issues and docs - Skill health scores based on frontmatter completeness
Have an idea? Open a feature request.
MIT