skill-reviewer

Audit Agent Skills against a 10-rule quality rubric and generate compliant scaffolds.

24|Updated May 11, 2026
One-click install
npx skills add https://github.com/Liu-PenPen/skill-review --skill skill-reviewer-liu-penpen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-reviewer
Source: https://github.com/Liu-PenPen/skill-review/tree/main
Command: npx skills add https://github.com/Liu-PenPen/skill-review --skill skill-reviewer-liu-penpen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Agent Skills often suffer from inconsistent quality, missing critical best practices like progressive disclosure, confirmation nodes for irreversible actions, and proper trigger keyword density in descriptions. These gaps lead to context bloat, missed auto-triggers, unexpected behavior during execution, and poor user experience for both developers and end users of the Skill.

Core Features & Use Cases

  • Rubric-based quality review: Audits existing Agent Skills against 10 evidence-based quality rules, outputs P0-P3 graded reports with concrete evidence and fix suggestions for each gap.
  • Compliant scaffold generation: Creates pre-validated new Skill directory structures that already pass the quality rubric, eliminating manual setup of required checklists, frontmatter fields, and workflow patterns.
  • CI/CD integration: Includes a zero-dependency lint script that can be run in GitHub Actions, pre-commit hooks, or local command lines to automate Skill quality checks as part of development workflows.
  • Use case example: A developer building a custom Cursor Skill for design system lookups can use skill-reviewer to audit their initial build, identify missing confirmation nodes and too-long inline code blocks, then generate a new scaffold that already includes all required quality guardrails.

Quick Start

Ask the AI to use the skill-reviewer skill to audit the Agent Skill located at .cursor/skills/my-design-skill and receive a graded quality report with actionable fix recommendations.

Frequently Asked Questions about skill-reviewer

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

FAQPage Schema
How do I audit Cursor Agent Skills for quality and compliance gaps?

You can audit Cursor Agent Skills by checking them against a 10-rule quality rubric to identify compliance gaps. This process outputs P0-P3 graded findings with concrete evidence and fix suggestions for issues causing context bloat or missed auto-triggers.

Why does my Agent Skill miss auto-triggers and cause context bloat during execution?

Agent Skills miss auto-triggers and cause context bloat due to missing critical best practices like proper trigger keyword density in descriptions and progressive disclosure. Auditing the Skill against a quality rubric identifies these exact structural gaps.

How do I generate a pre-validated Agent Skill scaffold that passes quality checks?

To generate a pre-validated Agent Skill scaffold, use a rubric-based tool to create a new directory structure that already includes required checklists, frontmatter fields, and workflow patterns. This ensures the scaffold complies with quality rules out of the box.

Can I run an Agent Skill code review in GitHub Actions or pre-commit hooks?

Yes, you can run an Agent Skill code review in GitHub Actions or pre-commit hooks using a zero-dependency lint script. This automates Skill quality checks as part of your standard CI/CD workflows without requiring external packages.

What are the limitations of using a rubric-based approach for Agent Skill quality audits?

A rubric-based approach for Agent Skill quality audits is limited to structural and metadata checks like progressive disclosure, confirmation nodes, and trigger keyword density. It does not evaluate the runtime execution logic or semantic accuracy of the Skill's internal code.

Do I need to install external dependencies to lint Agent Skills for missing confirmation nodes?

No, you do not need to install external dependencies to lint Agent Skills for missing confirmation nodes. The lint script operates with zero external dependencies, enforcing pre-delivery self-checks and confirming irreversible actions directly from the command line.