write-a-skill

Create agent skill directories with SKILL.md files and YAML frontmatter.

Updated May 11, 2026

Search Tags:#documentation #scaffolding #agent skills #workflows #YAML frontmatter #deterministic scripts

Ready to run

npx skills add https://github.com/IsKenKenYa/Commory --skill write-a-skill-iskenkenya

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/IsKenKenYa/Commory/tree/main/.windsurf/skills/write-a-skill
Command: npx skills add https://github.com/IsKenKenYa/Commory --skill write-a-skill-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users create new agent skills with a correct structure and discoverable metadata so the system can load and select them reliably.

Core Features & Use Cases

Skill-ready scaffolding: Guides the user to draft a root SKILL.md with required YAML frontmatter (name, description) and an operational instruction body.
Progressive disclosure layout: Encourages organizing content so Quick start, workflows, and advanced features remain readable and easy to maintain.
Optional resource bundling: Advises adding reference materials and deterministic scripts when the content grows or when repeated validation/transformations are needed.

Quick Start

Use the write-a-skill skill to generate a new skill directory that includes a SKILL.md with frontmatter and clear usage instructions.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema

How do I scaffold a new agent skill directory with proper metadata?▼

To scaffold an agent skill directory, create a root SKILL.md file containing YAML frontmatter with name and description fields, plus operational instructions for progressive disclosure and reference-one-level usage.

What is the required structure for a SKILL.md file to ensure reliable system discovery?▼

A SKILL.md file requires YAML frontmatter containing the skill name and description, followed by an instruction body organized for progressive disclosure with quick start, workflows, and advanced features.

How do I document agent workflows and include deterministic scripts in a skill?▼

Document agent workflows by organizing instruction bodies progressively, and optionally bundle deterministic scripts and reference materials within the skill directory to handle repeated validations or transformations.

Does an agent skill require dependencies or external components to function?▼

No, an agent skill does not require external dependencies or components to function; it relies entirely on a properly structured SKILL.md file with YAML frontmatter and clear usage instructions.

When should I add reference materials to my agent skill scaffolding?▼

Add reference materials to agent skill scaffolding when content grows beyond basic instructions or when repeated validation and transformations require deterministic scripts for consistent execution.

What's the best way to organize agent skill instructions for maintainability?▼

Organize agent skill instructions using progressive disclosure layout, separating quick start guides, workflows, and advanced features so the content remains readable and easy to maintain over time.