skills.rest
kileroppo
kileroppoCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Create agent skills with SKILL.md frontmatter and operational guidance.

Updated Aug 27, 2026
Search Tags:#documentation#prompt design#skill authoring#progressive disclosure#YAML frontmatter#agent workflows#deterministic scripts
One-click install
npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill write-a-skill-kileroppo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/kileroppo/AI-Coding-Guidance-Skills/tree/main/skills/write-a-skill
Command: npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill write-a-skill-kileroppo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users define and write new agent skills in a consistent, discoverable format so other parts of the system can select and use them correctly.

Core Features & Use Cases

  • Requirement gathering: Prompts the user to clarify domain, use cases, and whether executable scripts are needed.
  • Structured skill authoring: Produces a root SKILL.md with a proper YAML frontmatter plus an operational instruction body that follows the expected conventions.
  • Optional packaging guidance: Recommends when to add REFERENCE.md, EXAMPLES.md, and deterministic scripts for reliability and progressive disclosure.

Quick Start

Tell an AI: "Write a new skill named 'xyz-skill' for handling [your task/domain], include the YAML frontmatter with a clear description and write the operational sections with quick start and workflows."

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I write an AI agent skill with YAML frontmatter?▼

To write an AI agent skill, create a root SKILL.md file with YAML frontmatter for the name and description, then add an operational instruction body in Markdown that defines the workflow.

What is progressive disclosure in skill authoring?▼

Progressive disclosure in skill authoring is packaging optional references, examples, and deterministic helper scripts alongside SKILL.md so the agent loads detailed instructions only when needed.

When do I need to add deterministic scripts to my AI workflow skill?▼

You need to add deterministic scripts to your AI workflow skill when the task requires reliable, repeatable execution of specific operations that should not rely on generative LLM behavior.

How to structure documentation for agent capabilities?▼

Structure documentation for agent capabilities by using a root SKILL.md for core operational guidance, then add REFERENCE.md and EXAMPLES.md files to provide deeper context and usage patterns.

Does writing a new skill require executable scripts?▼

Writing a new skill does not require executable scripts by default, but the authoring process will prompt you to clarify your domain and use cases to determine if deterministic helper scripts are necessary.

What is the best way to package references for AI-driven coding workflows?▼

The best way to package references for AI-driven coding workflows is to use optional files like REFERENCE.md and EXAMPLES.md alongside your SKILL.md, enabling progressive disclosure for on-demand usage.

Related Skills

Explore More Content & Communication Skills→
estebandrgestebandrg

skill-creator

Create AI agent skills with SKILL.md frontmatter and template directories.

Community
Basic
GolferGeekGolferGeek

Create New Skills

Create new Agent Skills with YAML frontmatter and multi-file structure.

Community
Advanced
gaogg521gaogg521
33

1ONE-skills

Browse, download, and manage AI agent skills from the 1ONE Skills registry.

Community
Intermediate
Pranil9699Pranil9699

skill-authoring

Create reusable skills with SKILL.md and YAML frontmatter.

Community
Intermediate