write-a-skill

Name: write-a-skill
Availability: InStock
Author: raphaelmans

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

Ready to run

npx skills add https://github.com/raphaelmans/agent-skills --skill write-a-skill-raphaelmans

💬 Prompt for ChatGPT / Claude Chat▼

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.