skills.rest
babually
babuallyCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Create agent skill definitions with SKILL.md frontmatter and optional supporting files.

1|Updated Jun 27, 2026
Search Tags:#scaffolding#metadata#skill authoring#progressive disclosure#references#agent instructions
One-click install
npx skills add https://github.com/babually/bongo-template --skill write-a-skill-babually
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/babually/bongo-template/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/babually/bongo-template --skill write-a-skill-babually

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps create well-structured agent skills that are easy to discover, load, and maintain, reducing ambiguity when building new capabilities.

Core Features & Use Cases

  • Skill Scaffolding: Defines the required SKILL.md frontmatter, instructions, and folder layout.
  • Progressive Disclosure: Guides when to keep content inline versus split into references or scripts.
  • Skill Design Review: Helps validate descriptions, triggers, and organization before publishing.
  • Use Case: A developer wants to add a new capability for document processing and needs a consistent template with optional supporting files.

Quick Start

Use the write-a-skill skill to draft a new skill for my target task with the right structure, triggers, and supporting files.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I create agent skills with the correct SKILL.md metadata structure?▼

To create agent skills, you need a root SKILL.md file with YAML frontmatter defining required metadata, clear usage triggers, and instruction structure for concise activation.

What is progressive disclosure in skill authoring and when should I use it?▼

Progressive disclosure in skill authoring keeps concise activation text inline while splitting extensive content into auxiliary references or scripts, reducing ambiguity when loading new capabilities.

How to scaffold a new agent capability with supporting files and references?▼

Scaffolding a new agent capability requires defining the folder layout, SKILL.md frontmatter, and instructions, then splitting bundled resources into optional references or scripts when needed.

Does my agent skill need YAML frontmatter and usage triggers to function?▼

Yes, a functional agent skill requires a root SKILL.md with YAML frontmatter and clear usage triggers to ensure it is easy to discover, load, and maintain.

When should I split skill instructions into auxiliary files instead of keeping them inline?▼

You should split skill instructions into auxiliary files when content exceeds concise activation text, applying progressive disclosure to maintain clear structure and reduce loading ambiguity.

What's the best way to validate skill descriptions and organization before publishing?▼

The best way to validate skill descriptions is through a skill design review, which checks triggers, metadata, and folder organization to ensure the agent capability is easy to discover and maintain.

Related Skills

Explore More Software Engineering Skills→
Nickalus12Nickalus12
2

perf-check

Identify performance hotspots and regressions in Loom-style codebases.

Community
Intermediate
Leonardo-CorteLeonardo-Corte
1

maestro-skill-author

Create or repair Maestro built-in skill definitions with validated SKILL.md frontmatter and registry rebuilding.

Community
Intermediate
dalagerdalager
1

Skill Builder

Generate Claude Code Skills with YAML frontmatter and progressive disclosure.

Community
Advanced
fmindfmind
1.4k

MLOps Initialization

Automate MLOps project bootstrap with uv, git, and VS Code configuration.

Community
Advanced