write-a-skill

Create consistent agent skills with a canonical SKILL.md and directory layout.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/fray-cloud/coin --skill write-a-skill-fray-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/fray-cloud/coin/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/fray-cloud/coin --skill write-a-skill-fray-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This capability helps teams standardize how new agent skills are defined and packaged, ensuring consistent structure, documentation, and resources.

Core Features & Use Cases

  • Establishes a canonical SKILL.md frontmatter (name and description) and a minimal skill directory layout.
  • Recommends optional references, assets, and scripts to support deterministic tasks and on-demand resources.
  • Guides building and validating skills for reuse across multiple agents, teams, or projects.

Quick Start

Create a new skill by adding SKILL.md with name and description, then fill out its outline and optionally include references or scripts.

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 agent skill for consistent reuse across multiple projects?

To standardize an agent skill for reuse, create a canonical SKILL.md file with YAML frontmatter defining the name and description, then organize optional references, scripts, and assets into a clear directory layout.

What is included in a standard agent skill package?

A standard agent skill package includes a canonical SKILL.md with YAML frontmatter, a defined directory layout, and optional resources like references, scripts, and assets to support deterministic tasks and on-demand documentation.

Do I need YAML frontmatter when creating a new agent skill?

Yes, YAML frontmatter is required when creating an agent skill. You must include at least the name and description fields in the SKILL.md file to establish a valid and consistent skill package.

What's the best way to document deterministic tasks in an agent skill?

The best way to document deterministic tasks in an agent skill is by adding optional references and scripts within the skill directory layout, providing on-demand resources that support precise execution alongside the SKILL.md.

Can I refine an existing agent skill without breaking its directory structure?

Yes, you can refine an existing agent skill by updating the SKILL.md outline or adding optional resources like scripts and assets into the established directory layout without breaking the standard package structure.