write-a-skill

Draft new agent skills with SKILL.md templates and YAML frontmatter.

36|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/cagdotin/agents --skill write-a-skill-cagdotin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/cagdotin/agents/tree/main/skills/productivity/write-a-skill
Command: npx skills add https://github.com/cagdotin/agents --skill write-a-skill-cagdotin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

Core Features & Use Cases

  • Draft the skill by creating SKILL.md with concise instructions, and adding REFERENCE.md and EXAMPLES.md if content exceeds 500 lines.
  • Provide optional utilities in scripts/ when deterministic operations are needed.
  • Follow the Skill Structure template to organize skill-name/SKILL.md, REFERENCE.md, EXAMPLES.md, and scripts/ as needed.

Quick Start

Draft your new skill using the provided template and place any extra files in the appropriate subdirectories.

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 a new agent skill template for consistent reuse?

To structure an agent skill template, create a SKILL.md file with YAML frontmatter containing the name and description, then add optional REFERENCE.md, EXAMPLES.md, and scripts/ directories to organize content and deterministic operations for reuse.

What's the best way to draft a SKILL.md file for progressive disclosure?

The best way to draft a SKILL.md file for progressive disclosure is to write concise instructions directly in the file, then move detailed content into REFERENCE.md and EXAMPLES.md if the total exceeds 500 lines.

When do I need to create REFERENCE.md and EXAMPLES.md files for my skill?

You need to create REFERENCE.md and EXAMPLES.md files for your skill when the content in your SKILL.md file exceeds 500 lines, ensuring progressive disclosure and structured onboarding.

How do I add deterministic scripts to an agent skill directory?

To add deterministic scripts to an agent skill directory, create a scripts/ subdirectory within your skill folder and place your executable utilities there to handle deterministic operations needed by the skill.

What YAML frontmatter is required in a SKILL.md file?

A SKILL.md file requires YAML frontmatter that includes the skill name and description, ensuring proper skill identification and structured onboarding for agent execution.

Can I build a new skill without adding optional directories?

Yes, you can build a new skill with only a SKILL.md file, as the REFERENCE.md, EXAMPLES.md, and scripts/ directories are optional and should only be added when content limits are exceeded or deterministic operations are needed.