write-a-skill

Generate SKILL.md frontmatter and scaffolding for new agent skills.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/brandtam/rubber-ducky --skill write-a-skill-brandtam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/brandtam/rubber-ducky/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/brandtam/rubber-ducky --skill write-a-skill-brandtam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a clear, repeatable process for defining and packaging new agent skills, ensuring consistent structure and bundled resources.

Core Features & Use Cases

  • Provides a standardized SKILL.md template with mandatory frontmatter (name, description) and optional references, scripts, and assets.
  • Guides the creation of accompanying documentation (REFERENCE.md, EXAMPLES.md) and scaffolds for deterministic scripts if needed.
  • Useful for teams designing new skills or codifying best practices for skill authorship.

Quick Start

Describe your desired skill and I will draft a structured SKILL.md with optional references and scripts.

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 with markdown and frontmatter?

To structure an agent skill, you need a SKILL.md file with mandatory frontmatter like name and description, supplemented by optional references, scripts, and assets to ensure consistent packaging.

What is the best way to create a standardized SKILL.md template for a team?

The best way to create a standardized SKILL.md template is to automate scaffolding for required frontmatter, component mappings, and dependencies, ensuring consistent structure across all new agent skills.

How do I document optional references and scripts for a new skill?

To document optional references and scripts, generate accompanying files like REFERENCE.md and EXAMPLES.md alongside your SKILL.md to organize bundled resources and codify best practices.

What frontmatter is required when authoring a new agent skill?

Required frontmatter when authoring a new agent skill includes the name and description fields, which enforce clear structure and enable deterministic component mappings within the SKILL.md file.

Can I add deterministic scripts to my skill documentation?

Yes, you can add deterministic scripts by using scaffolding guidelines that organize optional references and assets within your skill structure, ensuring scripts are properly mapped and documented.

When do I need to generate scaffolding for skill components?

You need to generate scaffolding for skill components when designing new agent skills that require bundled resources, ensuring frontmatter, dependencies, and optional scripts are consistently structured.