skills.rest
hgxszhj
hgxszhjCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Design and package agent skills with SKILL.md templates and directory layouts.

Updated May 7, 2026
Search Tags:#automation#template#documentation#frontmatter#project-structure#skill-writing
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill write-a-skill-hgxszhj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/productivity/write-a-skill
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill write-a-skill-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a standardized starting point for building agent skills, ensuring consistency and reusability across projects.

Core Features & Use Cases

  • Provides a standard SKILL.md frontmatter template (name and description) and a recommended directory layout (skill-name/, SKILL.md, REFERENCE.md, EXAMPLES.md, scripts/).
  • Guides the inclusion of optional files such as REFERENCE.md and EXAMPLES.md, and the optional scripts/ folder for deterministic helpers.
  • Enables rapid scaffolding of new skills with clear structure and documentation for onboarding and maintenance.

Quick Start

Create a new skill named "your-skill" with a SKILL.md frontmatter, optional REFERENCE.md and EXAMPLES.md, and a scripts/ folder if deterministic helpers are needed.

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 template for consistent project automation?▼

To structure an agent skill template, use a recommended directory layout containing a SKILL.md file, optional REFERENCE.md and EXAMPLES.md, and a scripts/ folder for deterministic helpers.

What is the best way to scaffold a new agent skill quickly?▼

The best way to scaffold a new agent skill is using a standardized template that generates a SKILL.md frontmatter with name and description, ensuring consistency and reusability across projects.

Do I need frontmatter in my SKILL.md file for agent skill creation?▼

Yes, you need frontmatter in your SKILL.md file for agent skill creation. The template requires a frontmatter section containing the name and description to ensure clear usage guidance.

When should I include a scripts folder in my agent skill directory layout?▼

You should include a scripts folder in your agent skill directory layout when you need deterministic helpers. This optional folder supports automation scripts alongside your SKILL.md and reference files.

Can I add optional documentation files to my agent skill project structure?▼

Yes, you can add optional documentation files to your agent skill project structure. The template guides the inclusion of REFERENCE.md and EXAMPLES.md to provide clear documentation for onboarding and maintenance.

Why does standardizing agent skill packaging improve project maintainability?▼

Standardizing agent skill packaging improves maintainability by providing a consistent starting point with modular files. This ensures clear usage guidance and deterministic behavior across reusable project components.

Related Skills

Explore More Software Engineering Skills→
thomasholknielsenthomasholknielsen
2

claude-tweaks:codebase-onboarding

Generate CLAUDE.md, rules, and skills from observed project patterns.

Community
Advanced
aws-samplesaws-samples
12

good-skill

Validate skill-eval pipelines with a standards-compliant test Skill Unit.

Official
Basic
CuriousCrow123CuriousCrow123

compound-docs

Generate categorized Markdown documents with YAML frontmatter for solved problems.

Community
Advanced
cuembycuemby

create-skill

Scaffold standardized AI agent skill directories with template files.

Official
Basic