Make Skill Template#

A meta-skill for creating new Agent Skills. Use this skill when you need to scaffold a new skill folder, generate a SKILL.md file, or help users understand the Agent Skills specification.

When to Use This Skill#

• User asks to "create a skill", "make a new skill", or "scaffold a skill"
• User wants to add a specialized capability to their GitHub Copilot setup
• User needs help structuring a skill with bundled resources
• User wants to duplicate this template as a starting point

Prerequisites#

• Understanding of what the skill should accomplish
• A clear, keyword-rich description of capabilities and triggers
• Knowledge of any bundled resources needed (scripts, references, assets, templates)

Creating a New Skill#

Step 1: Create the Skill Directory#

Create a new folder with a lowercase, hyphenated name:

text

skills/<skill-name>/
└── SKILL.md          # Required

Step 2: Generate SKILL.md with Frontmatter#

Every skill requires YAML frontmatter with name and description:

yaml

---
name: <skill-name>
description: '<What it does>. Use when <specific triggers, scenarios, keywords users might say>.'
---

Frontmatter Field Requirements

FieldRequiredConstraintsnameYes1-64 chars, lowercase letters/numbers/hyphens only, must match folder namedescriptionYes1-1024 chars, must describe WHAT it does AND WHEN to use itlicenseNoLicense name or reference to bundled LICENSE.txtcompatibilityNo1-500 chars, environment requirements if neededmetadataNoKey-value pairs for additional propertiesallowed-toolsNoSpace-delimited list of pre-approved tools (experimental)

Description Best Practices

CRITICAL: The description is the PRIMARY mechanism for automatic skill discovery. Include:

1. WHAT the skill does (capabilities)
2. WHEN to use it (triggers, scenarios, file types)
3. Keywords users might mention in prompts

Good example:

yaml

description: 'Toolkit for testing local web applications using Playwright. Use when asked to verify frontend functionality, debug UI behavior, capture browser screenshots, or view browser console logs. Supports Chrome, Firefox, and WebKit.'

Poor example:

yaml

description: 'Web testing helpers'

Step 3: Write the Skill Body#

After the frontmatter, add markdown instructions. Recommended sections:

SectionPurpose# TitleBrief overview## When to Use This SkillReinforces description triggers## PrerequisitesRequired tools, dependencies## Step-by-Step WorkflowsNumbered steps for tasks## TroubleshootingCommon issues and solutions## ReferencesLinks to bundled docs

Step 4: Add Optional Directories (If Needed)#

FolderPurposeWhen to Usescripts/Executable code (Python, Bash, JS)Automation that performs operationsreferences/Documentation agent readsAPI references, schemas, guidesassets/Static files used AS-ISImages, fonts, templatestemplates/Starter code agent modifiesScaffolds to extend

Example: Complete Skill Structure#

text

my-awesome-skill/
├── SKILL.md                    # Required instructions
├── LICENSE.txt                 # Optional license file
├── scripts/
│   └── helper.py               # Executable automation
├── references/
│   ├── api-reference.md        # Detailed docs
│   └── examples.md             # Usage examples
├── assets/
│   └── diagram.png             # Static resources
└── templates/
    └── starter.ts              # Code scaffold

Quick Start: Duplicate This Template#

1. Copy the make-skill-template/ folder

2. Rename to your skill name (lowercase, hyphens)

3. Update SKILL.md:

   • Change name: to match folder name
   • Write a keyword-rich description:
   • Replace body content with your instructions

4. Add bundled resources as needed

5. Validate with npm run skill:validate

Validation Checklist#

• Folder name is lowercase with hyphens
• name field matches folder name exactly
• description is 10-1024 characters
• description explains WHAT and WHEN
• description is wrapped in single quotes
• Body content is under 500 lines
• Bundled assets are under 5MB each

Troubleshooting#

IssueSolutionSkill not discoveredImprove description with more keywords and triggersValidation fails on nameEnsure lowercase, no consecutive hyphens, matches folderDescription too shortAdd capabilities, triggers, and keywordsAssets not foundUse relative paths from skill root

References#

• Agent Skills official spec: https://agentskills.io/specification