write-a-skill

Create agent skills with SKILL.md structure and drafting-review workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create new agent skills with proper structure, progressive disclosure, and bundled resources to help teams design, document, and reuse skills reliably.

Core Features & Use Cases

  • Skill structure guidance including SKILL.md, optional REFERENCE.md and EXAMPLES.md, and a scripts folder for deterministic operations.
  • A repeatable drafting workflow: gather requirements, draft the skill, and review with the user to ensure alignment.
  • Guidance on when to create extra resources (REFERENCE.md, EXAMPLES.md, and scripts) to support complex skills.

Quick Start

Draft the skill by gathering requirements, then create SKILL.md (and optional references and scripts) and review with the user.

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 an agent skill with proper structure and bundled resources?

To create an agent skill, you draft a SKILL.md file with frontmatter, then add optional REFERENCE.md, EXAMPLES.md, and scripts directories to bundle resources and document complex behaviors.

What is progressive disclosure when developing agent skills?

Progressive disclosure in skill development separates core instructions in SKILL.md from detailed references and examples, exposing complexity only when needed to support reliable team design and reuse.

Do I need frontmatter metadata to build a new agent skill?

Yes, the skill builder enforces a frontmatter containing the name and description to ensure proper structure and alignment when you create new agent skills.

What is the best way to draft and review agent skills for team reuse?

The best way to draft agent skills is following a repeatable workflow: gather requirements, draft the skill structure, and review with the user to ensure alignment before finalizing.

When should I add scripts and reference files to my skill documentation?

You should add scripts, REFERENCE.md, and EXAMPLES.md to your skill documentation when creating extra resources to support complex skills that require deterministic operations and detailed context.