write-a-skill

Create agent skills with SKILL.md frontmatter and bundled resources.

16|Updated Jun 6, 2026

Search Tags:#workflow #templates #documentation #packaging #skill-development #frontmatter #agent-skills

Ready to run

npx skills add https://github.com/Insik-Han/han-monorepo-template --skill write-a-skill-insik-han

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/Insik-Han/han-monorepo-template/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/Insik-Han/han-monorepo-template --skill write-a-skill-insik-han

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create standardized, well-documented agent skills by providing a simple structure, frontmatter template, and bundled resources, enabling repeatable skill creation.

Core Features & Use Cases

Defines the required SKILL.md frontmatter with name and description
Encourages optional references/scripts/assets for extended capabilities
Guides drafting SKILL.md, REFERENCE.md, and EXAMPLES.md for scalable skills

Quick Start

Draft SKILL.md following the template and place it at the skill root, adding REFERENCE.md, EXAMPLES.md, or scripts/ only if content requires.

Frequently Asked Questions about write-a-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is the required structure for creating agent skills?▼

Creating agent skills requires a root SKILL.md file with YAML frontmatter containing name and description, alongside optional references, examples, and bundled scripts for extended capabilities. This standardization ensures proper packaging for reuse across projects.

How do I write SKILL.md frontmatter for a new agent skill?▼

To write SKILL.md frontmatter, include required name and description fields, then add structured metadata like tagline, keywords, dependencies, components, and toxicity checks to formalize the skill creation process and enable repeatable packaging.

When do I need to add REFERENCE.md and EXAMPLES.md to my skill?▼

Add REFERENCE.md and EXAMPLES.md when your skill requires extended documentation or usage demonstrations. These optional resources scale your skill's capabilities, while scripts and assets can be bundled only if the content requires them.

Can I bundle scripts and assets with my agent skill documentation?▼

Yes, you can bundle optional scripts, references, and assets with your agent skill. Place them at the skill root alongside SKILL.md, ensuring the package includes everything needed for the skill to function across different projects.

What's the best way to package agent skills for reuse across projects?▼

The best way to package agent skills is to draft a standardized SKILL.md with proper frontmatter, then bundle optional references, examples, and scripts. This approach ensures skills are well-documented, structured, and repeatable across multiple project environments.

Why does my agent skill need a tagline and keywords in its metadata?▼

Agent skills need tagline and keywords in their metadata to enforce structured documentation and improve discoverability. These fields, along with dependencies and components, standardize the skill creation process and ensure robust packaging for reuse.