write-a-skill

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates structured, reusable agent skills by guiding users through proper file layout, documentation, and optional resources, reducing setup time and errors.

Core Features & Use Cases

  • Provides a standard SKILL.md structure with optional REFERENCE.md, EXAMPLES.md, and scripts/.
  • Guides users to draft skill templates, validate frontmatter, and organize assets for deterministic tasks.
  • Use case: when you want to design a new skill template for agents that can be shared across projects.

Quick Start

Create a new skill folder with a SKILL.md frontmatter and minimal body to start.

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 reusable AI skills for automation workflows?

Structure reusable AI skills by creating a standard SKILL.md frontmatter and optional resources like REFERENCE.md, EXAMPLES.md, and scripts. This enforces frontmatter validation, modular file layout, and an optional assets workflow to reduce setup time and errors across projects.

What is the standard file layout for scaffolding agent skill templates?

The standard file layout for scaffolding agent skill templates requires a SKILL.md file with validated frontmatter. It optionally supports modular file organization by adding REFERENCE.md, EXAMPLES.md, and a scripts directory for deterministic task execution.

How do I validate frontmatter for documentation when creating a new skill?

Validate frontmatter for documentation by applying a standard SKILL.md structure during skill creation. This enforces proper frontmatter validation, guides you to draft skill templates, and organizes assets to ensure deterministic task execution.

Does the skill scaffolding process support optional references and scripts directories?

Yes, the skill scaffolding process supports optional references and scripts directories. You can design workflows using an optional scripts, references, and assets directory structure alongside the core SKILL.md file to organize resources effectively.

What's the best way to document and bundle reusable AI skills across projects?

Document and bundle reusable AI skills by generating a standard SKILL.md frontmatter paired with optional EXAMPLES.md and REFERENCE.md files. This approach enforces a modular file layout, ensuring structured documentation and seamless sharing across multiple projects.