claude-skills/scripts
Claude 507f62610f
feat(scripts): add audit_skills.py — repo-wide write-a-skill validator runner
Adds a small stdlib-only orchestration script that runs the
skill_review_checklist_runner.py (shipped in v2.6.0) across every SKILL.md
in the repo and aggregates results.

Output:
- Total skills audited (PASS / WARN / FAIL / ERROR counts + percentages)
- Failure breakdown by rule (which of Matt's 6 checklist items fail most)
- Top-10 worst offenders (skill folder + specific failing rules)

Excludes auto-generated tool-specific symlinks (.gemini, .codex, .cursor,
.cline, /site/, /.git/) and template fixtures (templates/, assets/sample-skill).

Use case: periodic audit of skill-library hygiene. Re-run after each batch
of new skills to catch drift early. Produced the punch list that informed
the v2.6.1 cleanup planning (40% of repo skills miss "Use when" triggers;
88% exceed Matt's 100-line ceiling — both flagged for triage).

Stdlib-only. No external dependencies. Runs in ~30s on a 298-skill repo.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 23:25:55 +00:00
..
audit_skills.py feat(scripts): add audit_skills.py — repo-wide write-a-skill validator runner 2026-05-13 23:25:55 +00:00
check_plugin_json.py chore(phase-0): add dual-publish + plugin.json validation tools 2026-05-09 05:54:15 +00:00
codex-install.bat Dev (#44) 2026-01-23 09:09:42 +01:00
codex-install.sh Dev (#44) 2026-01-23 09:09:42 +01:00
convert.sh fix(integrations): update find depth in convert.sh for new repo structure 2026-05-12 09:56:39 +03:00
gemini-install.sh feat: add Gemini CLI + OpenClaw support, fix Codex missing 25 skills 2026-03-09 14:58:41 +01:00
generate-docs.py fix(docs): render orphan sub-skills (recover 79 missing skill pages) 2026-05-13 12:49:00 +00:00
install.sh feat(integrations): change Augment from flat rules to skill bundles 2026-04-25 04:48:41 +05:30
openclaw-install.sh fix(ci): fix workflow errors + add OpenClaw support (#222) 2026-02-24 17:33:21 +01:00
review-new-skills.sh feat(ci): add automated Tessl skill quality review on PRs 2026-04-07 12:21:30 +02:00
sync-codex-skills.py fix(ci): update test paths and sync script for new ./skills/ layout 2026-05-02 23:15:33 +02:00
sync-gemini-skills.py feat: add Gemini CLI + OpenClaw support, fix Codex missing 25 skills 2026-03-09 14:58:41 +01:00
sync-hermes-skills.py feat(cross-tool): add Hermes Agent sync script (#520) 2026-04-12 14:18:35 +02:00
sync_skill_bundles.py chore(phase-0): add dual-publish + plugin.json validation tools 2026-05-09 05:54:15 +00:00