skills.rest
stellarone
stellaroneOFFICIAL
Explore all skills by this author →
GitHub

Skill Development

Structure SKILL.md files with YAML frontmatter and organized resources.

Updated Aug 27, 2026
Search Tags:#claude code#skill creation#plugin development#progressive disclosure#yaml frontmatter#workflow guidance#documentation architecture
One-click install
npx skills add https://github.com/stellarone/evaluate --skill skill-development-stellarone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/stellarone/evaluate/tree/main/.agents/skills/skill-development
Command: npx skills add https://github.com/stellarone/evaluate --skill skill-development-stellarone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reduces trial-and-error when creating Claude Code skills by providing a clear, best-practice process for structuring SKILL.md, defining high-quality discovery metadata, and organizing supplemental materials.

Core Features & Use Cases

  • Skill structure guidance: Defines the required SKILL.md entry point and the optional scripts/, references/, and assets/ resource conventions for modular, on-demand loading.
  • Metadata and trigger quality: Improves discovery reliability by instructing how to write YAML frontmatter with a precise name and a third-person description containing concrete trigger phrases.
  • Progressive disclosure design: Balances context efficiency by keeping SKILL.md lean while placing deeper patterns, advanced techniques, and detailed workflows into references/ for later loading.
  • Skill authoring workflow: Guides end-to-end development from understanding concrete examples to planning reusable content and validating the final skill.

Quick Start

Use the Skill Development skill when you want to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", or "organize skill content".

Frequently Asked Questions about Skill Development

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

FAQPage Schema
How do I structure a Claude Code skill package for progressive disclosure?▼

Claude Code skill packages require a lean SKILL.md entry point for core instructions, placing deeper patterns and detailed workflows into references/ for on-demand loading to balance context efficiency.

What should be included in the YAML frontmatter for a Claude Code plugin skill?▼

YAML frontmatter for a Claude Code plugin skill requires a precise name and a third-person description containing concrete trigger phrases to ensure reliable discovery and invocation.

How do I organize optional resources like scripts and assets when creating a skill?▼

Organize optional skill resources by placing reusable scripts in a scripts/ directory, detailed documentation in references/, and static media in assets/, ensuring modular and consistent package structure.

What is the best way to write trigger phrases for Claude Code skill discovery metadata?▼

Write trigger phrases by embedding concrete, imperative action verbs directly into the third-person YAML frontmatter description, ensuring the skill matches specific user intents like 'create a skill' or 'organize skill content'.

Can I use SKILL.md for advanced workflows or should I split content into separate files?▼

Keep SKILL.md lean with essential instructions and split advanced workflows into separate files within the references/ directory, allowing the skill to load detailed patterns only when needed.

Related Skills

Explore More Software Engineering Skills→
gauravprwl14gauravprwl14

skill-scaffold

Create a Claude Code skill directory with SKILL.md, README.md, and plugin.json.

Community
Intermediate
nano-stepnano-step
3

skill-creator

Create, validate, and package Claude skills with template-driven frontmatter.

Official
Advanced
jwintzjwintz
24

Vault Sanitization

Sanitize Obsidian vault frontmatter by fixing unescaped quotes and malformed YAML.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate