ct-skill-validator

CLEO Skill Validator

Full 3-phase validation loop for CLEO skills. Every phase must reach PASS before the skill is considered ecosystem-ready. Run the phases in order and iterate on failures.

Always end with the HTML report — the final deliverable to the user is the combined report opened in their browser, not terminal output.

---

Phase 1: Structural Compliance (Iterate to Zero Errors)

Run validate.py until the result is PASS or PASS (with warnings) with 0 errors. Warnings are acceptable; errors are not. Fix errors and re-run.

# Full gauntlet — text output
python ${CLAUDE_SKILL_DIR}/scripts/validate.py <skill-dir>

# With manifest checks (Tier 4):
python ${CLAUDE_SKILL_DIR}/scripts/validate.py <skill-dir> \
  --manifest <manifest.json> --dispatch-config <dispatch-config.json>

# JSON output (for scripting):
python ${CLAUDE_SKILL_DIR}/scripts/validate.py <skill-dir> --json

# Deep body quality audit (optional, run alongside validate.py):
python ${CLAUDE_SKILL_DIR}/scripts/audit_body.py <skill-dir>

# Manifest alignment check: bundled into validate.py Tier 4. Use:
#   python validate.py <skill-dir> --manifest <manifest.json> --dispatch-config <dispatch-config.json>

# Progressive-disclosure depth check (T9684 — CI gate):
python ${CLAUDE_SKILL_DIR}/scripts/check_depth.py <skill-dir>

# Repo-wide depth sweep:
python ${CLAUDE_SKILL_DIR}/scripts/check_depth.py <repo-root> --all

# Allowlist audit (CI / cron — exit 1 on findings):
python ${CLAUDE_SKILL_DIR}/scripts/check_depth.py <skill-dir> --audit-allowlist
python ${CLAUDE_SKILL_DIR}/scripts/check_depth.py <skill-dir> --audit-allowlist --json

Depth rule (T9684): A skill PASSES when ANY of:

• SKILL.md body has ≥ 100 content lines, OR
• references/ subdir has ≥ 3 markdown files, OR
• manifest.json references[] array enumerates ≥ 3 files (all on disk)

Pre-existing stubs are allowlisted with follow-up task IDs in scripts/check_depth.py::ALLOWLIST. Gold-standard skills: ct-orchestrator (9 refs) and ct-skill-creator (7 refs).