Dual Axis Skill Reviewer

Run the dual-axis reviewer script and save reports to reports/.

The script supports:

• Random or fixed skill selection
• Auto-axis scoring with optional test execution
• LLM prompt generation
• LLM JSON review merge with weighted final score
• Cross-project review via --project-root
• Non-scoring display of skills-index.yaml production verification declarations

When to Use

• Need reproducible scoring for one skill in skills/*/SKILL.md.
• Need improvement items when final score is below 90.
• Need both deterministic checks and qualitative LLM code/content review.
• Need to review skills in a different project from the command line.

Prerequisites

• Python 3.9+
• uv (recommended, auto-resolves pyyaml dependency via inline metadata)
• For tests: uv sync --extra dev or equivalent in the target project
• For LLM-axis merge: JSON file that follows the LLM review schema (see Resources)

Workflow

Determine the correct script path based on your context:

• Same project: skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py
• Global install: ~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

The examples below use REVIEWER as a placeholder. Set it once:

# If reviewing from the same project:
REVIEWER=skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

# If reviewing another project (global install):
REVIEWER=~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

Step 1: Run Auto Axis + Generate LLM Prompt

uv run "$REVIEWER" \
  --project-root . \
  --emit-llm-prompt \
  --output-dir reports/

When reviewing a different project, point --project-root to it:

uv run "$REVIEWER" \
  --project-root /path/to/other/project \
  --emit-llm-prompt \
  --output-dir reports/