Agent skill · operations · tradermonty
dual-axis-skill-reviewer
Review skills in any project using a dual-axis method: (1) deterministic code-based checks (structure, scripts, tests, execution safety) and (2) LLM deep review findings. Use when you need reproducible quality scoring for `skills/*/SKILL.md`, want to gate merges with a score threshold (for example 90+), or need concrete improvement items for low-scoring skills. Works across projects via --project-root.
Why this skill is useful
Adds a comprehensive dual-axis review process that combines deterministic checks with qualitative LLM insights, enhancing skill evaluation accuracy.
What it needs
Requires python, uv installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 2,581 stars on the source repository.
What this skill does
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/rundualaxisreview.py Global install: ~/.claude/skills/dual-axis-skill-reviewer/scripts/rundualaxisreview.py The examples below use REVIEWER as a placeholder. Set it once: Step 1: Run Auto Axis + Generate LLM Prompt When reviewing a different project, point --project-root to it: Step 2: Run LLM Review Use the generated prompt file in reports/skillreviewprompt<skill><timestamp>.md. Ask the LLM to return strict JSON output. When running inside Claude Code, let Claude act as orchestrator: read the generated prompt, produce the LLM review JSON, and save it for the merge step. Step 3: Merge Auto + LLM Axes Step 4: Optional Controls Fix selection for reproducibility: --skill <name> or --seed <int> Review all skills at once: --all Skip tests for quick triage: --skip-tests Change report location: --output-dir <dir> Increase --auto-weight for stricter deterministic gating. Increase --llm-weight when qualitative/code-review depth is prioritized. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills tradermonty/dual-axis-skill-reviewer