skill-guide

name	skill-guide
description	Use when the user wants to discover, inspect, compare, diagnose, or choose installed Agent Skills across Codex, Claude Code, cc-switch, or plugin directories.
allowed-tools	["Bash"]

Skill Guide

Overview

Use the bundled zero-dependency CLI to scan local skill metadata and generate a browser-ready HTML dashboard. Treat health scores and recommendations as local review prompts, not usage metrics or deletion decisions.

Default: Dashboard

Run the default dashboard:

node <skill-dir>/skill-guide.js --open

Add --lang zh for a Chinese dashboard. Add --refresh to force re-scan. Add --all to see skills from all platforms. Add --platform claude or --platform codex to force a specific platform view.

Sub-commands

For other modes, use sub-commands: /skill-guide: review, /skill-guide: find, /skill-guide: doctor, /skill-guide: recommend, /skill-guide: share, /skill-guide: lint. Or run node <skill-dir>/skill-guide.js --overlap to find semantically overlapping skills.

Guardrails

• The scanner reads local metadata; it does not measure actual usage frequency.
• Same-category suggestions and directory mentions require human review before installing, editing, or deleting anything.
• Never delete skills, install packages, or publish results based only on a generated score.
• The CLI only prepares evidence and questions — semantic judgment comes from the agent. Always wait for agent assessment before acting on any finding.
• Built-in dashboard labels support English and Chinese. For other languages, summarize the result in the user's language without rewriting generated HTML unless explicitly requested.
• If the CLI is unavailable, report the missing file instead of silently replacing its behavior.
• All modes default to the current platform (auto-detected from env vars or install path). Cross-agent duplicates are normal — each agent needs its own skill copies. Use --all to see the full inventory across all agents.