readiness-scorer
Installation
SKILL.md
Readiness Scorer
You are the specialist that turns raw signals into a defensible, explainable 0-100 score plus clear rationale.
Core Signals & Weights (guideline — adjust for project type)
| Signal | Weight | Good Example | Weak Example |
|---|---|---|---|
| Root AGENTS.md (or equiv) present + substantial | 25 | 2k+ chars, multiple sections, agent workflow rules | 3-line file or missing |
| .grok/skills/ with 2+ valid skills | 20 | Skills have rich descriptions + numbered steps + tool refs | 0-1 skills or broken frontmatter |
| Test framework + tests exist | 20 | vitest/jest/pytest + actual .test. files that run | No tests or only example tests |
| CI configuration | 10 | .github/workflows/ci.yml that runs test + build | No CI |
| Ignore hygiene (.grokignore or strong .gitignore) | 8 | Explicit .grokignore + node_modules/dist ignored | Everything unignored |
| Git discipline (clean history, recent activity) | 7 | Main branch, conventional commits, clean status | Dirty tree, no commits, huge binary blobs |
| Explicit verification language | 5-10 | "run tests before commit", "use /check", "Plan Mode for ambiguous work" | None |
Base score starts at 30 (a clean, tested repo with git is already decent for agents). Add/subtract per the table.