grade-skills

Validate SKILL.md frontmatter and generate quality assessments with remediation steps.

Updated Sep 1, 2025
One-click install
npx skills add https://github.com/walsh-investment/clean-slate-import --skill grade-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grade-skills
Source: https://github.com/walsh-investment/clean-slate-import/tree/main/.claude/skills/grade-skills
Command: npx skills add https://github.com/walsh-investment/clean-slate-import --skill grade-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This metadata grading Skill ensures Skills meet minimum structural quality before deployment by validating frontmatter, identifying gaps, and standardizing evaluation criteria across the Skill library.

Core Features & Use Cases

  • Frontmatter validation: checks presence of name and description and enforces required formats.
  • Quality scoring: applies major/minor error rules with thresholds to guide revisions.
  • Remediation guidance: provides actionable fixes and revision prompts for editors.

Quick Start

Grade the SKILL.md to generate a quality assessment and remediation plan.

Frequently Asked Questions about grade-skills

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

FAQPage Schema
How do I validate YAML frontmatter in a SKILL.md file for deployment readiness?

YAML frontmatter validation checks your SKILL.md for required fields like name and description, enforcing correct formats and identifying structural gaps before distribution. This process applies major and minor error rules to ensure readiness.

What is quality assurance scoring for skill frontmatter and how does it work?

Quality assurance scoring for skill frontmatter applies major and minor error rules to evaluate structural correctness, generating a quality assessment score. It uses scoring thresholds to guide revisions and communicate remediation steps for editors.

How do I fix frontmatter errors flagged during a skill audit?

Fix frontmatter errors flagged during a skill audit by following the actionable remediation guidance provided by the grading assessment. It communicates specific revision prompts and steps to correct major and minor frontmatter mistakes.

Do I need any dependencies to grade and audit skills across a library?

You do not need any dependencies to grade and audit skills across a library. The grading process operates independently to verify frontmatter correctness and evaluate eligibility for distribution across new or edited skills.

What are the limitations of automated frontmatter validation for skill distribution?

Automated frontmatter validation focuses strictly on structural quality and required field presence. It evaluates metadata readiness for deployment but does not assess the functional logic or execution behavior of the actual skill implementation.