Dual Axis Skill Reviewer scores skills in a project’s skills folder. The first axis is computed by a Python script from the skill’s files: metadata and use case, workflow coverage, execution safety, supporting artifacts and test health. The second axis is a review written by an LLM from a prompt the script generates, covering correctness, risk, missing logic and maintainability.
The script merges the two with adjustable weights into a final score, and lists improvement items when the score falls below 90. A project root option lets it review skills in other projects. This repository’s skill tooling is the subject here, not market analysis.
What You Get
- A JSON report and a Markdown report per skill with auto score, LLM score and final score
- An LLM review prompt file generated for each skill
- Improvement items listed whenever the final score is under 90
- A display of the declared verification block from skills-index.yaml, shown for information and left out of the scores
Common Use Cases
- Gating merges of new skills on a minimum score such as 90
- Getting concrete fixes for a low-scoring skill
- Reviewing skills in a different project with the project root option
- Quick triage of every skill in a project with tests skipped
What Makes It Unique
Reproducible scoring and qualitative review are kept as separate axes with explicit weights, so a team can lean toward the deterministic gate or toward the deeper review. Skills with no scripts are detected as knowledge-only and are not penalized for lacking tests. Seeds and named skills make runs repeatable.
Under The Hood
The agent runs one Python script with uv, which resolves the pyyaml dependency. The script reads the target project’s skills folder and files, and unless told to skip tests it can run the reviewed skill’s test suite, which executes code from that project. It writes JSON and Markdown reports and a prompt file into an output folder (reports/ by default). It makes no network calls of its own. The skill also suggests a shell command that symlinks the skill folder into the user’s Claude skills directory for global use.