writing-skills

Guide SKILL.md documentation, naming, descriptions, and iterative testing.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Draft-Official/draft-web --skill writing-skills-draft-official
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Draft-Official/draft-web/tree/main/.agents/superpowers/4.3.0/skills/writing-skills
Command: npx skills add https://github.com/Draft-Official/draft-web --skill writing-skills-draft-official

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides guidance for writing clear, structured, and testable documentation for skills, ensuring they are discoverable and effective in systems.

Core Features & Use Cases

  • Structured Documentation: Guides the creation of SKILL.md files with proper frontmatter and content organization.
  • Best Practices: Offers instructions on naming, description writing, and optimizing descriptions for discovery.
  • Verification: Emphasizes the importance of testing skills via pressure scenarios and iterative refinement for robustness.
  • Use Case: A developer creating a new code review skill uses this guide to ensure descriptions are concise and discoverable, and documentation enables effective testing.

Quick Start

Use this skill to learn how to organize skill documentation and improve discoverability before creating new skills.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write effective skill documentation for agent discoverability?

Effective skill documentation requires structured SKILL.md files with proper YAML frontmatter, clear naming conventions, and concise descriptions optimized for system discoverability. This guide provides the exact structure and best practices needed.

What are the best practices for naming and describing new agent skills?

Best practices for skill naming and description involve creating concise, structured content that clearly communicates the skill's function. This guide offers specific instructions on writing descriptions optimized for discovery and effective agent usage.

How do I test agent skills using pressure scenarios?

Testing agent skills via pressure scenarios involves executing iterative refinement processes to ensure robustness. This guide emphasizes verifying skill behavior through structured testing workflows to validate documentation and performance.

What should be included in a SKILL.md file?

A SKILL.md file should include proper YAML frontmatter, organized content sections, and optimized descriptions for system discoverability. This guide provides the structural blueprint for creating clear and testable skill documentation.

Why does skill documentation need iterative refinement?

Skill documentation needs iterative refinement to ensure robustness and effective testing under pressure scenarios. This process validates that the skill's naming, description, and structure remain accurate and discoverable during execution.

Do I need YAML frontmatter to make my skill discoverable?

YAML frontmatter is required to structure skill documentation properly and optimize system discoverability. This guide instructs on integrating frontmatter within SKILL.md files to ensure effective agent creation and verification.