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.