write-a-skill

Create self-contained AI skills with a SKILL.md template and YAML frontmatter.

5|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/kenlck/skills --skill write-a-skill-kenlck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/kenlck/skills/tree/main/ken-skills/skills/write-a-skill
Command: npx skills add https://github.com/kenlck/skills --skill write-a-skill-kenlck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams to create AI skills with proper structure, progressive disclosure, and bundled resources, reducing ambiguity and ensuring consistency for activation.

Core Features & Use Cases

  • Enforces a SKILL.md at the root with YAML frontmatter for name and description.
  • Supports optional files and directories (references/, assets/, scripts/) to accompany the skill.
  • Provides a standard SKILL.md template and recommended workflow for drafting and review.

Quick Start

Create a new skill folder named my-skill and place SKILL.md at its root following the template.

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 AI skill for consistent discovery and activation?

To structure an AI skill, create a root SKILL.md file with YAML frontmatter defining its name and description. This enforces a concise metadata surface and standardizes discovery for automated loading. Optional directories like references/ and assets/ can bundle supporting resources.

What is progressive disclosure in skill creation and why is it needed?

Progressive disclosure in skill creation separates the core SKILL.md metadata from optional bundled resources like scripts/ and references/. This reduces ambiguity during activation by loading only necessary context, ensuring consistent workflows without overwhelming the system.

How do I write a concise description for AI skill YAML frontmatter?

Writing a concise description for YAML frontmatter involves defining the skill's core task directly in the SKILL.md file. The enforced format mandates a clear, standardized metadata surface to support reliable discovery and activation across different workflows.

Can I bundle scripts and reference files when creating a self-contained AI skill?

Yes, you can bundle scripts and reference files when creating a self-contained AI skill. The structure supports optional directories such as scripts/, references/, and assets/ alongside the root SKILL.md to be loaded dynamically upon activation.

What's the best way to document workflows for an AI automation skill?

The best way to document workflows for an AI automation skill is using a structured SKILL.md template. This template enforces consistent formatting, frontmatter-driven metadata, and progressive disclosure to guide team drafting and review processes effectively.

Do I need external dependencies to create a skill with a SKILL.md template?

No, you do not need external dependencies to create a skill with a SKILL.md template. The skill creation process is self-contained, relying solely on a root SKILL.md file with YAML frontmatter and optional local resource directories.