{"id":47694876,"url":"https://github.com/aliksir/skill-validator","last_synced_at":"2026-04-02T16:19:40.156Z","repository":{"id":344997119,"uuid":"1182469541","full_name":"aliksir/skill-validator","owner":"aliksir","description":"Claude Code skill health checker — detect broken skills caused by environment changes","archived":false,"fork":false,"pushed_at":"2026-03-27T13:25:36.000Z","size":66,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-27T23:56:42.513Z","etag":null,"topics":["claude-code","cli","health-check","skill-validation"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aliksir.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-15T15:09:21.000Z","updated_at":"2026-03-27T13:25:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aliksir/skill-validator","commit_stats":null,"previous_names":["aliksir/skill-validator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aliksir/skill-validator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliksir%2Fskill-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliksir%2Fskill-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliksir%2Fskill-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliksir%2Fskill-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aliksir","download_url":"https://codeload.github.com/aliksir/skill-validator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliksir%2Fskill-validator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31309834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","cli","health-check","skill-validation"],"created_at":"2026-04-02T16:19:39.949Z","updated_at":"2026-04-02T16:19:40.148Z","avatar_url":"https://github.com/aliksir.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-skill-validator\n\nClaude Code のスキル・コマンドの健全性を一括チェック・自動修復するCLIツール。\n\n[English README](README.md)\n\n環境変更（CLIアップデート、ツール廃止、パス変更等）起因のスキル破損を早期検知する。\n\n## チェック項目\n\n| チェック | 内容 | 重要度 |\n|---------|------|--------|\n| frontmatter | SKILL.md の name/description 存在確認 | WARN |\n| file-ref | INSTRUCTIONS.md, scripts/, references/ の参照先存在確認 | FAIL |\n| tool-ref | 廃止された MCP ツール参照の検知 | FAIL |\n| cmd-ref | Bash コマンドの PATH 存在確認 | WARN |\n| path-ref | ハードコードされた絶対パスの存在確認 | WARN |\n| syntax | scripts/ 内の .js/.py/.sh の構文チェック | FAIL |\n| update | GitHub リポジトリからのアップデート検知 | WARN |\n\n## 使い方\n\n```bash\n# npx で実行（インストール不要）\nnpx claude-skill-validator\n\n# または基本実行（~/.claude をスキャン）\nclaude-skill-validator\n\n# 詳細出力\nclaude-skill-validator --verbose\n\n# アップデートチェック付き\nclaude-skill-validator --update-check\n\n# JSON出力\nclaude-skill-validator --json\n\n# skills/ のみ\nclaude-skill-validator --skills-only\n\n# commands/ のみ\nclaude-skill-validator --commands-only\n\n# 別ディレクトリを指定\nclaude-skill-validator --dir /path/to/.claude\n\n# FAILのみ表示\nclaude-skill-validator --quiet\n\n# WARNも含めて厳密チェック\nclaude-skill-validator --strict\n```\n\n## 出力例\n\n```\n📦 nano-banana\n  ❌ [tool-ref] 廃止されたツール参照: tabs_context_mcp（廃止済み — browser-cli を使用）\n  ❌ [tool-ref] 廃止されたツール参照: read_page（廃止済み — browser-cli snapshot を使用）\n\n📦 api-design-reviewer\n  ❌ [syntax] api_linter.py 構文エラー: SyntaxError: invalid syntax\n\n============================================================\n📊 スキャン結果サマリー\n  対象ディレクトリ: /Users/you/.claude\n  チェック総数: 450\n  ✅ PASS: 380  ⚠️ WARN: 60  ❌ FAIL: 10\n```\n\n## 終了コード\n\n| コード | 意味 |\n|--------|------|\n| 0 | 問題なし（FAILなし） |\n| 1 | FAILあり（要修正） |\n| 2 | ツール自体のエラー |\n\n## 自動修復\n\n```bash\n# 修正可能な問題を自動修復（バックアップ付き）\nclaude-skill-validator --fix\n\n# 修正内容をプレビュー（実際には変更しない）\nclaude-skill-validator --dry-run\n```\n\n廃止されたMCPツール参照（`tabs_context_mcp` → `browser-cli snapshot` 等）を自動で置換する。\n修復前に `~/.claude/.skill-validator-backup/` にバックアップを作成する。\n\n## アップデートチェック\n\n`--update-check` フラグを付けると、スキルのソースリポジトリとの差分を検知する。\n\nソース情報は以下の優先順で探索：\n1. `.source` ファイル（GitHubリポジトリURL）\n2. `package.json` の `repository` フィールド\n3. `.git/` ディレクトリの `origin` リモート\n\n## オプション一覧\n\n| オプション | 説明 |\n|-----------|------|\n| `--dir \u003cpath\u003e` | Claude設定ディレクトリ（デフォルト: `~/.claude`） |\n| `--skills-only` | `skills/` のみスキャン |\n| `--commands-only` | `commands/` のみスキャン |\n| `--json` | JSON形式で出力 |\n| `--verbose` | PASS含む全結果を表示 |\n| `--quiet` | FAILのみ表示（WARN件数はサマリーのみ） |\n| `--strict` | frontmatter WARNも表示（デフォルト非表示） |\n| `--update-check` | ソースリポジトリからのアップデートチェック |\n| `--update` | アップデートを適用（`--update-check` を含む） |\n| `--fix` | 修正可能な問題を自動修復（バックアップ付き） |\n| `--dry-run` | 修正内容のプレビュー（実際には変更しない） |\n| `--self-update` | `claude-skill-validator` 自体を最新版に更新 |\n| `--no-version-check` | npm バージョンチェックをスキップ（CI環境向け） |\n| `--help`, `-h` | ヘルプを表示 |\n\n## プラグインコマンド（`commands/`）\n\nこのパッケージには Claude Code スラッシュコマンドが同梱されています：\n\n| コマンド | ファイル | 機能 |\n|---------|---------|------|\n| `/skill-validate` | `commands/skill-validate.md` | 全オプション対応の一括スキャン |\n| `/skill-validate-fix` | `commands/skill-validate-fix.md` | dry-run → fix → 確認の3ステップフロー |\n\nグローバルインストール後、Claude Code でそのまま使えます：\n\n```bash\nnpm install -g claude-skill-validator\n```\n\n## 動作環境\n\n- Node.js 18+\n- 外部依存なし（fs/path/child_process のみ使用）\n- Windows / macOS / Linux 対応\n\n## ライセンス\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliksir%2Fskill-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliksir%2Fskill-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliksir%2Fskill-validator/lists"}