write-a-skill

Generate agent skill directories with SKILL.md entry points and YAML frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users design and write new agent skills with consistent structure and clear operational guidance.

Core Features & Use Cases

  • Guided Requirements Gathering: Prompts the user to clarify the skill’s domain, use cases, whether scripts are needed, and what references to include.
  • Structured Skill Drafting: Produces a complete skill directory layout centered on a valid SKILL.md entry point, with optional reference and example files when content grows.
  • Progressive Disclosure: Encourages concise main instructions in SKILL.md while linking deeper details to separate files (e.g., REFERENCE.md) for maintainability.

Quick Start

Ask it to draft a new skill for writing meeting recap reports for weekly leadership check-ins, including a SKILL.md, a brief workflow, and references 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 create a new agent skill with valid YAML frontmatter?

To create an agent skill, draft a SKILL.md entry point containing YAML frontmatter with name and description fields, followed by concise operational instructions. This skill generator produces that directory structure automatically.

What is the best way to organize agent skill directories and reference files?

To organize agent skill directories, center the layout on a SKILL.md entry point and add separate reference or example files as content grows. This progressive disclosure approach keeps operational instructions concise and maintainable.

Can I include deterministic scripts and examples when writing agent skills?

Yes, you can include deterministic scripts, supporting references, and examples when writing agent skills. The generator prompts you to clarify whether scripts are needed and what references to include for your specific domain.

Do I need prior YAML frontmatter knowledge to build a workflow skill?

No prior YAML frontmatter knowledge is needed to build a workflow skill. The guided requirements gathering process prompts you for the skill domain and use cases, then automatically generates the valid YAML frontmatter structure.

When should I split agent skill instructions into separate files?

You should split agent skill instructions into separate files when operational content grows too large for a single SKILL.md. The progressive disclosure approach links deeper details to REFERENCE.md to keep the main entry point concise.