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.