{
  "markdown": "# claude-skill-validator\n\nValidate and repair [Claude Code](https://claude.ai/code) skills — detect broken references, deprecated tools, syntax errors, and auto-fix issues.\n\nScans `~/.claude/skills/` and `~/.claude/commands/` in bulk to catch skill corruption caused by CLI updates, tool deprecations, or path changes.\n\n[日本語 README](README.ja.md)\n\n## Install\n\n```bash\nnpm install -g claude-skill-validator\n```\n\nOr run without installing:\n\n```bash\nnpx claude-skill-validator\n```\n\n## Usage\n\n```bash\n# Basic scan (scans ~/.claude by default)\nclaude-skill-validator\n\n# Verbose output\nclaude-skill-validator --verbose\n\n# Check for updates from source repositories\nclaude-skill-validator --update-check\n\n# JSON output\nclaude-skill-validator --json\n\n# Scan skills/ only\nclaude-skill-validator --skills-only\n\n# Scan commands/ only\nclaude-skill-validator --commands-only\n\n# Specify a custom Claude config directory\nclaude-skill-validator --dir /path/to/.claude\n\n# Auto-fix fixable issues (with backup)\nclaude-skill-validator --fix\n\n# Preview fixes without applying\nclaude-skill-validator --dry-run\n```\n\n## Check Types\n\n| Check | What it verifies | Severity |\n|-------|-----------------|----------|\n| `frontmatter` | `name` and `description` fields exist in `SKILL.md` | WARN |\n| `file-ref` | Referenced files in `INSTRUCTIONS.md`, `scripts/`, `references/` exist | FAIL |\n| `tool-ref` | Deprecated MCP tool references are detected | FAIL |\n| `cmd-ref` | Bash commands referenced in skills exist in PATH | WARN |\n| `path-ref` | Hardcoded absolute paths exist on disk | WARN |\n| `syntax` | `.js`, `.py`, `.sh` files in `scripts/` have valid syntax | FAIL |\n| `update` | Skill source repositories have newer versions available | WARN |\n\n## Output Example\n\n```\n📦 nano-banana\n  ❌ [tool-ref] Deprecated tool reference: tabs_context_mcp (deprecated — use browser-cli)\n  ❌ [tool-ref] Deprecated tool reference: read_page (deprecated — use browser-cli snapshot)\n\n📦 api-design-reviewer\n  ❌ [syntax] api_linter.py syntax error: SyntaxError: invalid syntax\n\n============================================================\n📊 Scan Summary\n  Target directory: /Users/you/.claude\n  Total checks: 450\n  ✅ PASS: 380  ⚠️ WARN: 60  ❌ FAIL: 10\n```\n\n## Options\n\n| Option | Description |\n|--------|-------------|\n| `--dir <path>` | Claude config directory (default: `~/.claude`) |\n| `--skills-only` | Scan `skills/` directory only |\n| `--commands-only` | Scan `commands/` directory only |\n| `--json` | Output results as JSON |\n| `--verbose` | Show all checks including PASS |\n| `--quiet` | Show FAIL only; WARN count appears in summary |\n| `--strict` | Show frontmatter WARN entries (hidden by default) |\n| `--update-check` | Check for updates from source repositories |\n| `--update` | Apply available updates (implies `--update-check`) |\n| `--fix` | Auto-fix fixable issues (creates backups) |\n| `--dry-run` | Preview fixes without applying changes |\n| `--self-update` | Update `claude-skill-validator` itself to the latest version |\n| `--no-version-check` | Skip npm version check (useful in CI) |\n| `--help`, `-h` | Show help message |\n\n## Plugin Commands (`commands/`)\n\nThis package ships two Claude Code slash commands in `commands/`:\n\n| Command | File | What it does |\n|---------|------|-------------|\n| `/skill-validate` | `commands/skill-validate.md` | Run a full scan (all options exposed) |\n| `/skill-validate-fix` | `commands/skill-validate-fix.md` | Guided dry-run → fix → verify flow |\n\nInstall the package globally and the commands become available in Claude Code immediately:\n\n```bash\nnpm install -g claude-skill-validator\n```\n\n## Exit Codes\n\n| Code | Meaning |\n|------|---------|\n| `0` | No issues (no FAILs) |\n| `1` | FAILs found (action required) |\n| `2` | Tool error |\n\n## Requirements\n\n- Node.js 18+\n- No external dependencies (uses `fs`, `path`, `child_process`, `os` only)\n- Works on Windows, macOS, and Linux\n\n## License\n\nMIT\n",
  "bytes": 3917,
  "sha": "1cc954d82bb33c521189688dd2bf21f9bac12f00c63861b32965ed7828081a45",
  "repo_slug": "aliksir/skill-validator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aliksir_skill_validator_skill_validator_116ac415/readme"
}