dual-axis-skill-reviewer

Run deterministic and LLM checks on SKILL.md files to produce weighted scores.

5|4|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/takusaotome/claude-skills-library --skill dual-axis-skill-reviewer-takusaotome
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dual-axis-skill-reviewer
Source: https://github.com/takusaotome/claude-skills-library/tree/main/skills/dual-axis-skill-reviewer
Command: npx skills add https://github.com/takusaotome/claude-skills-library --skill dual-axis-skill-reviewer-takusaotome

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, pytest, uv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Dual-axis skill reviewer eliminates subjective, inconsistent skill evaluations by combining deterministic checks with structured LLM review, producing a single weighted score and actionable improvement items.

Core Features & Use Cases

  • Dual-axis scoring: runs deterministic review for structure, examples, safety/reproducibility, and test health, then merges an LLM JSON review into a weighted final score.
  • Merge-ready improvement items: when the final score is below 90, it requires concrete fixes and lists improvement items derived from both axes.
  • Cross-project review: supports reviewing skills in another repository via --project-root from the command line.

Quick Start

Run the reviewer for the current project by executing a command like: uv run skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py --project-root . --emit-llm-prompt --output-dir reports/

Frequently Asked Questions about dual-axis-skill-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate skill quality review with weighted scoring across multiple projects?

Automate skill quality review by running run_dual_axis_review.py with the --project-root argument, which executes deterministic checks and LLM evaluation to produce a weighted score for one or more project repositories.

What is dual-axis evaluation for code quality and how does it work?

Dual-axis evaluation combines deterministic checks on repository artifacts and SKILL.md with structured LLM JSON review, merging both axes into a single weighted score with actionable improvement items for skills scoring below 90.

Can I run cross-project skill reviews from the command line?

Cross-project skill reviews are supported using the --project-root command line argument, allowing you to target and evaluate skills located in another local repository directory.

Do I need pytest and uv to execute deterministic test health checks?

Yes, pytest and uv are required dependencies for executing test health checks and running the reviewer script, which requires Python 3.9 or higher to parse YAML frontmatter and inventory repository artifacts.

What are the limitations of automated LLM evaluation for skill metadata?

Automated LLM evaluation requires strict JSON merging for weighted score computation and depends on valid YAML frontmatter parsing, meaning malformed metadata or non-compliant LLM JSON output can disrupt the scoring process.