skills.rest
isaac-scarrott
isaac-scarrottCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Create structured agent skills with SKILL.md, REFERENCE.md, EXAMPLES.md, and scripts/.

1|Updated Jul 19, 2019
Search Tags:#skill development#skill creation#agent skills#description writing#structured guidance
One-click install
npx skills add https://github.com/isaac-scarrott/dev-files --skill write-a-skill-isaac-scarrott
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/isaac-scarrott/dev-files/tree/main/.claude/skills/write-a-skill
Command: npx skills add https://github.com/isaac-scarrott/dev-files --skill write-a-skill-isaac-scarrott

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you create new agent skills with a proper structure, progressive disclosure, and bundled resources, making it easier to create, write, or build a new skill.

Core Features & Use Cases

  • Structured Skill Creation: Offers a clear process for gathering requirements, drafting the skill, and reviewing it with the user.
  • Skill Structure: Defines the expected directory layout and content for a skill, including SKILL.md, REFERENCE.md, EXAMPLES.md, and scripts/.
  • Description Writing Guide: Provides a template and best practices for writing effective skill descriptions.

Quick Start

Run the write-a-skill to create a new skill with the correct structure and content.

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 an agent skill for progressive disclosure?▼

To structure an agent skill for progressive disclosure, organize your directory with SKILL.md, REFERENCE.md, EXAMPLES.md, and scripts/ to separate core logic from bundled resources.

What is the best way to write an effective agent skill description?▼

The best way to write an agent skill description is to follow a structured template that clearly defines the problem solved and outlines core features, ensuring proper requirement gathering and review.

How do I create a new agent skill from scratch?▼

You create a new agent skill from scratch by following a structured process: gathering requirements, drafting the content and directory layout, and reviewing the final output with stakeholders.

What files do I need to build a complete agent skill?▼

To build a complete agent skill, you need a defined directory layout including SKILL.md, REFERENCE.md, EXAMPLES.md, and a scripts/ folder to hold bundled resources and logic.

Can I use structured guidance for team-based skill creation?▼

Yes, structured guidance for skill creation is suitable for both individuals and teams looking to streamline the drafting, requirement gathering, and review phases of building agent skills.

Related Skills

Explore More Education & Research Skills→
itda-skillsitda-skills

itda-setup

Detect and configure environment variables and API keys for skills.

Official
Intermediate
selfagencyselfagency

make-skill-template

Generate SKILL.md frontmatter and a valid skill directory layout.

Community
Basic
kartikkabadikartikkabadi

write-a-skill

Create reusable agent skills with frontmatter, instructions, and bundled resources.

Community
Basic
aldasorolauti-pixelaldasorolauti-pixel

skill-creator

Guide developers through creating custom Claude skills with initialization and packaging steps.

Community
Intermediate