write-a-skill

Package modular agent skills with SKILL.md frontmatter defining name and description.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill write-a-skill-v36372
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/v36372/pi-stuff/tree/main/skills/write-a-skill
Command: npx skills add https://github.com/v36372/pi-stuff --skill write-a-skill-v36372

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams create, organize, and deploy new agent skills with a consistent structure, reducing ambiguity and accelerating integration.

Core Features & Use Cases

  • Standardized SKILL.md frontmatter with name and description.
  • Guidance for adding optional files like REFERENCE.md, EXAMPLES.md, and scripts to support deterministic tasks.
  • A clear, repeatable workflow: gather requirements, draft the skill, and review with the user.
  • Guidance on when to split content into multiple files to keep SKILL.md concise.

Quick Start

Create a new skill folder named write-a-skill containing SKILL.md with frontmatter and a concise description, then add optional REFERENCE.md and scripts/ if needed.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I structure a new AI agent skill for deployment?▼

To structure an agent skill, create a folder containing a SKILL.md file with frontmatter defining its name and description, then add optional REFERENCE.md or scripts to support deterministic tasks.

What is the purpose of SKILL.md frontmatter in skill development?▼

SKILL.md frontmatter defines the name and description of an agent skill, ensuring standardized organization, reducing ambiguity, and accelerating integration for discovery.

How do I validate the structure of my agent skill before shipping?▼

Validate your agent skill structure by checking it against skill guidelines, ensuring the SKILL.md frontmatter is correct, and preparing Quick Start descriptions for discovery.

Do I need to include scripts when packaging modular agent skills?▼

Scripts are optional when packaging agent skills; include them only to support deterministic tasks, alongside a concise SKILL.md and optional references or examples.

What is the best way to organize skill documentation to keep SKILL.md concise?▼

The best way to organize skill documentation is separating detailed content into REFERENCE.md and EXAMPLES.md files, keeping SKILL.md concise with only frontmatter and a quick start guide.