skill-evaluator

Evaluate SKILL.md artifacts against Anthropic best practices and generate reports.

406|31|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/gotalab/skillport --skill skill-evaluator-gotalab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-evaluator
Source: https://github.com/gotalab/skillport/tree/main/.agent/skills/skill-evaluator
Command: npx skills add https://github.com/gotalab/skillport --skill skill-evaluator-gotalab

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures AI skills meet Anthropic's best practices, providing a structured evaluation to identify weaknesses and offer concrete recommendations for improvement. This saves time in manual review and ensures high-quality skill development.

Core Features & Use Cases

  • Automated Validation: Runs a script to check structural requirements, naming conventions, and basic content limits.
  • Manual Evaluation Criteria: Provides a detailed rubric for assessing naming, description, content quality, structure, degrees of freedom, and anti-patterns.
  • Actionable Reports: Generates comprehensive evaluation reports with scores, strengths, areas for improvement, and prioritized recommendations.
  • Use Case: A developer has created a new Claude Skill and wants to ensure it adheres to best practices before publishing. This skill will provide a thorough review and a report with specific steps to enhance its quality.

Quick Start

Evaluate the 'pdf-processor' skill located at './skills/pdf-processor' for compliance with Anthropic's best practices and provide a detailed report.

Frequently Asked Questions about skill-evaluator

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

FAQPage Schema
How do I evaluate an AI skill against best practices before publishing?

Skill evaluation applies automated validation and manual review criteria to audit SKILL.md artifacts for naming conventions, description quality, content structure, and references. The Skill generates a comprehensive report with dimension scores, actionable recommendations, and a pre-publication checklist to ensure compliance with Anthropic's standards.

What does a skill evaluation report include?

The evaluation report scores skills across multiple dimensions—naming, description quality, content density, structure, and anti-patterns—then provides strengths, areas for improvement, and prioritized recommendations. A pre-publication checklist summarizes next steps for refinement before release.

Can I automate quality checks for multiple skills in a publishing workflow?

Yes. The Skill runs automated structural validation to check naming conventions and content limits, reducing manual review burden. It supports batch evaluation across skills to ensure consistent quality standards across your publishing pipeline.

What are the prerequisites for evaluating a skill?

You need a completed SKILL.md artifact with title, description, features, and use cases defined. PyYAML is the only dependency required to run the evaluation script against your skill's metadata and content.

What happens if my skill has structural or naming issues?

The evaluation identifies specific deficiencies in structure, naming, and content quality, then returns concrete recommendations to fix each issue. The report prioritizes improvements by impact to help you address the most critical problems first.

Does this work for skills at different stages of development?

Yes. The Skill evaluation applies to review, audit, and improvement workflows for skills in any state—from draft to pre-publication. It adapts to varying content density and maturity levels while maintaining consistent best-practice benchmarks.