skill-reviewer

Installation
SKILL.md

Skill PR Reviewer

Performs thorough, structured code reviews of skill PRs β€” severity-classified findings with actionable fixes, positive acknowledgment, and a summary table.

When to Use

  • Reviewing a PR that adds or modifies a skill under plugin/skills/ or .github/skills/
  • Checking skill compliance before submitting a PR
  • Auditing an existing skill for quality issues

πŸ’‘ Note: .github/skills/ meta-skills have different conventions β€” checklist sections 8-9 apply only to plugin/skills/ service skills.

Review Workflow

  1. Collect β€” Identify all changed skill files (SKILL.md, references, tests, scripts)
  2. Check β€” Run each category from the review checklist
  3. Classify β€” Assign severity per the severity guide
  4. Analyze Routing β€” Check triggers for conflicts per routing analysis
  5. Draft β€” Write the review per the output format
  6. Validate β€” Verify suggested fixes are actionable with accurate file/line references

Error Handling

Error Remediation
Cannot determine changed files Ask user for the file list or PR number
Token counting unavailable Estimate at ~4 chars per token

References

Weekly Installs
87
GitHub Stars
202
First Seen
Today