skills.rest
skill-tools
skill-toolsOFFICIAL
Explore all skills by this author →
GitHub

skill-quality

Provides guidance for writing well-structured, effective skill definitions.

Updated Feb 12, 2026
Search Tags:#documentation#markdown#guidelines#SKILL.md#lint#frontmatter#skill-quality
One-click install
npx skills add https://github.com/skill-tools/skill-tools-plugin --skill skill-quality
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-quality
Source: https://github.com/skill-tools/skill-tools-plugin/tree/main/skills/skill-quality
Command: npx skills add https://github.com/skill-tools/skill-tools-plugin --skill skill-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill quality directly impacts how agents select and execute skills. When SKILL.md frontmatter is incomplete or the body lacks clear instructions, agents may misinterpret intent or fail to perform tasks correctly. This guide helps maintainers ensure SKILL.md files are actionable, precise, and consistently structured.

Core Features & Use Cases

  • Frontmatter validity: Enforces presence and correctness of name and description fields to ensure reliable skill discovery.
  • Instruction clarity: Guides on writing concrete steps, examples, and robust error handling to improve execution.
  • Documentation hygiene: Recommends organizing long skills with references/, assets/, and scripts/ for scalable maintenance.
  • Use Case: When updating a skill to handle new prompts, apply these guidelines to preserve discoverability and execution accuracy.

Quick Start

Apply the skill-quality guidelines to your SKILL.md to improve clarity, structure, and testability.

Frequently Asked Questions about skill-quality

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

FAQPage Schema
How do I improve SKILL.md frontmatter validity for reliable agent selection?▼

Improve SKILL.md frontmatter validity by enforcing the presence and correctness of name and description fields in YAML, ensuring agents can accurately discover and select your skills.

What is the best way to structure markdown documentation for agent execution?▼

The best way to structure markdown documentation for agent execution is using a three-section description, proper heading hierarchy, and concrete examples to deliver actionable and precise skill instructions.

How do I validate SKILL.md files for documentation hygiene and linting?▼

Validate SKILL.md files by applying skill-quality guidelines that check frontmatter correctness, heading structure, and robust error handling guidance, as validated by skill-tools.

Why does my agent fail to select the correct skill from the repository?▼

Agents fail to select the correct skill when SKILL.md frontmatter is incomplete or the body lacks clear instructions, causing misinterpretation of intent and execution failures.

Can I use references and assets directories for long markdown skill files?▼

Yes, you can use references, assets, and scripts directories to organize long markdown skill files, ensuring scalable maintenance and preserving discoverability when updating skills.

Related Skills

Explore More Content & Communication Skills→
WayneWalterBerryWayneWalterBerry

{skill-name}

Identify Skill units by locating SKILL.md frontmatter and extracting name and description.

Community
Advanced
Srain021Srain021

kestrel-mcp-audit-rfc

Validate RFC front-matter, section order, and step instructions for execution readiness.

Community
Intermediate
N4M3ZN4M3Z
5

MarkdownSchema

Derive and validate markdown schemas for frontmatter fields and heading rules.

Community
Intermediate
Albatross679Albatross679

latex

Generate LaTeX documents for ACL conference papers and academic reports.

Community
Intermediate