skill-development

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

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nthplusio/functional-claude --skill skill-development-nthplusio
Or copy as Structured Prompt for Agent
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.