Write a Skill

Scaffold agent skills adhering to best practices in progressive disclosure and modular file organization.

Authoring Methodology

• Requirement Gathering: Define domain boundaries, interactive workflows, utility script needs, and reference documentation.
• SKILL.md Structure: Keep main instructions concise (under 500 lines) and delegate detailed background to separate reference documents.
• Trigger Alignment: Draft clear, high-intent descriptions in frontmatter to ensure reliable invocation by agent planners.
• Deterministic Helpers: Bundle deterministic operations (formatting, schema checks) as executable scripts rather than long LLM instructions.

Installation

Add this skill to your workspace:

npx skills add https://github.com/mattpocock/skills --skill write-a-skill

Quick Start

Ask your AI assistant to generate a new skill structure:

Use write-a-skill to scaffold a new skill for Kubernetes cluster troubleshooting.