write-a-skill

Create reusable AI skills with standardized SKILL.md frontmatter and file layout.

1|Updated May 20, 2025
One-click install
npx skills add https://github.com/vessux/dotfiles --skill write-a-skill-vessux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/vessux/dotfiles/tree/main/umbel/skills/pocock/write-a-skill
Command: npx skills add https://github.com/vessux/dotfiles --skill write-a-skill-vessux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Without a clear structure, creating reusable AI skills leads to tangled, hard-to-maintain configurations. This skill provides a validated blueprint to design, document, and assemble new agent skills with consistent structure and resources.

Core Features & Use Cases

  • Provides a standard SKILL.md template and recommended file layout (SKILL.md, REFERENCE.md, EXAMPLES.md, optional scripts/references/assets)
  • Guides users through progressive disclosure for scalable skill design
  • Useful for teams documenting and building new AI skills, prompts, and bundles

Quick Start

Create a new skill by adding SKILL.md with frontmatter and a concise body; add optional references or scripts as 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 an AI skill for maintainable workflows?▼

To structure AI skills, use a standardized SKILL.md file with frontmatter and a concise body, plus optional REFERENCE.md, EXAMPLES.md, scripts, and assets for maintainable workflows.

What is the best way to document reusable AI agent skills?▼

The best way to document reusable AI agent skills is applying a standardized file layout with frontmatter and progressive disclosure, ensuring scalable, predictable skill deployment across teams.

How do I create new AI skills from templates?▼

Create new AI skills from templates by adding a SKILL.md file with required frontmatter and a concise body, then include optional references, scripts, or assets as needed for your use case.

Do I need frontmatter in my SKILL.md for modular skill design?▼

Yes, frontmatter is required in your SKILL.md for modular skill design, as it enforces a standardized structure that ensures scalable, predictable skill deployment.

What files should I include in an AI skill bundle?▼

An AI skill bundle should include a SKILL.md file, and optionally REFERENCE.md, EXAMPLES.md, scripts, and assets, following a recommended file layout for progressive disclosure.

Why does creating reusable AI skills without a template lead to problems?▼

Creating reusable AI skills without a template leads to tangled, hard-to-maintain configurations, making standardized structure and validated blueprints necessary for scalable skill deployment.