skill-development

Create structured SKILL.md frontmatter and documentation for Claude plugin skills.

Updated Aug 27, 2026

Search Tags:#template #documentation #skill-development #SKILL.md #frontmatter #progressive-disclosure #Claude-plugin

Ready to run

npx skills add https://github.com/nthplusio/functional-claude --skill skill-development-nthplusio

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/nthplusio/functional-claude/tree/main/plugins/claude-plugin-dev/skills/skill-development
Command: npx skills add https://github.com/nthplusio/functional-claude --skill skill-development-nthplusio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured template and guidance for writing high-quality SKILL.md files, enabling consistent skill discovery and safe integration.

Core Features & Use Cases

Frontmatter-driven discovery: Enforces mandatory fields like name, description, and version to ensure predictable loading and searchability.
Progressive disclosure: Encourages organizing content from concise frontmatter metadata to detailed body, references, and scripts as needed.
Quality validation: Supports a reviewer step to check structure, wording, and required files before publishing a skill.

Quick Start

Create the skill directory with SKILL.md containing proper frontmatter and body content, then run the skill-reviewer on the skill folder to validate structure and readability.

Frequently Asked Questions about skill-development

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

FAQPage Schema

How do I write a SKILL.md template with proper YAML frontmatter?▼

To write a SKILL.md template, start with YAML frontmatter containing mandatory fields like name, description, and version to ensure predictable loading and searchability for Claude plugin skills.

What is progressive disclosure in skill documentation?▼

Progressive disclosure in skill documentation organizes content from concise frontmatter metadata to detailed body content, references, and optional assets, allowing users to access information progressively as needed.

How do I validate the structure and readability of a SKILL.md file?▼

You validate a SKILL.md file by running a skill-reviewer on the skill folder to check structure, wording, and required files before publishing, ensuring quality and safe integration.

What fields are required in SKILL.md frontmatter for Claude plugin discovery?▼

Required SKILL.md frontmatter fields for Claude plugin discovery include name, description, and version, which enforce predictable loading and ensure your skill is searchable.

Can I add optional scripts and references to my SKILL.md documentation?▼

Yes, you can add optional scripts and references to your SKILL.md documentation, supporting progressive disclosure by extending the body content with additional assets as needed.