write-a-skill

Create structured agent skills with YAML frontmatter and SKILL.md files.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drshailesh88/build_playbook --skill write-a-skill-drshailesh88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/drshailesh88/build_playbook/tree/main/vendor/mattpocock-skills/write-a-skill
Command: npx skills add https://github.com/drshailesh88/build_playbook --skill write-a-skill-drshailesh88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps users create new agent skills with a consistent, discoverable structure so the assistant can reliably choose and execute the right capability.

Core Features & Use Cases

  • Requirements-first drafting: It prompts for domain, use cases, whether scripts are needed, and any reference materials so the skill matches the user’s real task boundaries.
  • Structured skill scaffolding: It guides creation of a root SKILL.md entry point plus optional supporting files (references, examples, and scripts) when content is extensive or deterministic actions are required.
  • Review and refinement loop: It includes a checklist-style review to ensure the description contains clear triggers, stays concise, and avoids missing or ambiguous sections.

Use case example: A user wants an AI to handle “invoice intake” end-to-end; this skill helps them write a new SKILL.md with the right trigger language, include a focused reference doc, and optionally add deterministic helper scripts for validation.

Quick Start

Ask the assistant to draft a new skill named "my-skill" for your specific domain, including clear “Use when …” triggers, a minimal SKILL.md, and any optional reference or script files 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 scaffold a new agent skill with YAML frontmatter?

To scaffold a new agent skill, create a root SKILL.md file containing YAML frontmatter with the name and description, plus an instruction body. This establishes a structured, discoverable entry point for the capability.

How do I write skill triggers for an AI assistant?

Writing skill triggers requires adding clear "Use when …" language to the SKILL.md instruction body. Specifying explicit trigger phrases ensures the assistant reliably chooses and executes the correct capability.

What is progressive disclosure in agent skills?

Progressive disclosure in agent skills is an approach where the root SKILL.md provides operational instructions and clean handoff to optional assets. It supports referencing external files only when content is extensive or deterministic actions are required.

When do I need deterministic scripts in my agent skill?

Deterministic scripts are needed in an agent skill when the task requires precise, repeatable actions like validation. You include these optional helper scripts alongside the SKILL.md file to handle strict operational boundaries.

What is the best way to structure a reusable AI capability?

The best way to structure a reusable AI capability is through requirements-first drafting that defines the domain and use cases, followed by creating a minimal SKILL.md with optional supporting reference docs for clean handoff.

Does scaffolding an agent skill require a review process?

Scaffolding an agent skill includes a checklist-style review process to ensure the description contains clear triggers, stays concise, and avoids missing or ambiguous sections before finalizing the structure.