What is the main purpose of bd-skill-reviewing?

It provides a structured framework for auditing and improving the quality, clarity, and effectiveness of Claude agent skills through systematic evaluation.

Who should use the bd-skill-reviewing skill?

It is designed for developers, architects, and QA engineers who are building or maintaining a library of specialized AI agent capabilities.

Can this help fix underperforming skills?

Yes, it includes specific guides for detecting anti-patterns and applying improvement patterns to resolve common issues like vague instructions or trigger failures.

How does this skill help with PR reviews?

It offers standardized feedback templates and severity guidelines to help development teams provide consistent, actionable feedback on skill-related pull requests.

What dimensions of a skill does this framework evaluate?

The framework focuses on four primary areas: Correctness (specification compliance), Clarity (unambiguous instructions), Effectiveness (proper triggering), and Maintainability (organization).

Agent Skill Quality Reviewer

Name: Agent Skill Quality Reviewer
Author: bitsydarel

bybitsydarel

0•

Collaboration Tools

Audits and improves AI agent skills to ensure they meet high standards for clarity, correctness, and effectiveness.

The bd-skill-reviewing skill provides a comprehensive framework for evaluating and optimizing Claude Code agent skills. It guides users through a systematic review process focusing on four key dimensions: correctness, clarity, effectiveness, and maintainability. By utilizing standardized checklists and identifying common anti-patterns, this skill helps developers troubleshoot underperforming agents, provide constructive feedback on pull requests, and ensure all skills adhere to organizational quality standards and technical specifications.

Key Features

01Standardized feedback templates for consistent and actionable PR reviews

02Improvement guidance with actionable before-and-after implementation patterns

03Detailed quality checklists for structure and frontmatter validation

040 GitHub stars

05Systematic review framework across four critical quality dimensions

06Anti-pattern detection to identify and fix common skill weaknesses

Use Cases

01Troubleshooting and optimizing underperforming or ambiguous agent instructions

02Performing quality assurance on new AI agent skills before deployment

03Conducting structured peer reviews on skill-related pull requests

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bitsydarel/bdskills bd-skill-reviewing

For use in Claude.ai and ChatGPT

Download Skill