skills.rest
raphaelmans
raphaelmansCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Scaffold new agent skills with standardized SKILL.md frontmatter and optional files.

Updated Feb 28, 2026
Search Tags:#automation#template#documentation#guidelines#scripts#skill#frontmatter
One-click install
npx skills add https://github.com/raphaelmans/agent-skills --skill write-a-skill-raphaelmans
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/raphaelmans/agent-skills/tree/main/write-a-skill
Command: npx skills add https://github.com/raphaelmans/agent-skills --skill write-a-skill-raphaelmans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This front-matter driven framework helps skill authors create consistent, well‑documented skills by defining a clear entry point (SKILL.md) and optional resources (references, assets, scripts) to streamline skill creation and maintenance.

Core Features & Use Cases

  • Structured entry point: enforces a single SKILL.md at the skill root with mandatory frontmatter for discovery.
  • Guided organization: supports optional references, assets, and scripts to house detailed docs and deterministic utilities.
  • Repeatable templates: provides a reusable skeleton for building new skills with consistent naming, descriptions, and structure.

Quick Start

Create a new skill folder named after your skill, containing a SKILL.md with proper frontmatter and a concise guide.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I scaffold a new agent skill with consistent documentation?▼

To scaffold a new agent skill, you create a folder containing a SKILL.md file with standardized frontmatter, ensuring consistent documentation and discoverability across multiple skills.

What is the SKILL.md frontmatter format used for?▼

The SKILL.md frontmatter format defines a structured entry point for agent skills, requiring a name and description to enable consistent discovery and maintenance across teams.

Can I include scripts and references when building agent skills?▼

Yes, you can include optional scripts, references, and assets alongside SKILL.md to house detailed documentation and deterministic utilities for your agent skills.

Does this skill scaffolding template work for teams creating multiple skills?▼

Yes, this skill scaffolding template is designed for teams creating multiple skills, providing a reusable skeleton that ensures naming, descriptions, and structure remain consistent.

What is the best way to structure deterministic operations in an agent skill?▼

The best way to structure deterministic operations is by placing executable scripts in an optional scripts directory, keeping the SKILL.md entry point focused on documentation and guidance.

When should I not use a standardized frontmatter template for skill creation?▼

You should avoid using a standardized frontmatter template for skill creation if your project requires highly customized, non-standard documentation structures that break away from centralized discoverability.

Related Skills

Explore More Software Engineering Skills→
kdpa-llckdpa-llc
34

skill-creator

Generate SKILL.md files with YAML frontmatter for MCP server skills.

Official
Basic
balic-AI-ML-R-D-Resourcesbalic-AI-ML-R-D-Resources

skill-creator

Create modular AgentSkills with standardized SKILL.md frontmatter and scaffolded resources.

Official
Intermediate
519lab519lab
2

design-md

Author, validate, and export Google DESIGN.md files to Tailwind or W3C DTCG JSON.

Official
Intermediate
vinhgiangvinhgiang

nx-generate

Generate code artifacts in an Nx monorepo using Nx generators.

Community
Intermediate