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.

Process

Installs
1
GitHub Stars
2
First Seen
Oct 13, 2026