skill-development

Create modular Claude Code plugin skills with standardized SKILL.md structure.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/phpmac/skills --skill skill-development-phpmac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/phpmac/skills/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/phpmac/skills --skill skill-development-phpmac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the creation of modular Claude Code plugin skills by providing a standardized structure, clear frontmatter requirements, and best practices for organizing resources and documentation.

Core Features & Use Cases

  • Standardized SKILL.md frontmatter with required name and description
  • Guidelines for optional resources: scripts/, references/, assets/ to support deterministic tasks and contextual information
  • Progressive disclosure design to keep SKILL.md concise while moving detail to references/

Quick Start

Initialize a new skill directory, complete the SKILL.md frontmatter, add optional resources as needed, and validate before packaging.

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 plugin skill for modular resource organization?

Structure a Claude Code plugin skill using a concise SKILL.md for core logic and separate directories for scripts, references, and assets to maintain modular resource organization and progressive disclosure.

What is progressive disclosure when building plugin skills?

Progressive disclosure in plugin skills keeps the SKILL.md file concise by moving detailed contextual information and deterministic tasks into bundled resources like the references directory.

What frontmatter is required for a SKILL.md file?

A SKILL.md file requires standardized frontmatter including a name and description to ensure the plugin skill is properly identified and ready for validation and packaging.

How do I validate Claude Code skills before packaging and deployment?

Validate Claude Code skills by checking the SKILL.md frontmatter, verifying progressive disclosure limits, and ensuring bundled resources like scripts and assets meet the standardized structure before deployment.

Does skill development require specific dependencies for bundled scripts?

Skill development does not require external dependencies, allowing you to organize bundled scripts, references, and assets independently within the plugin skill directory structure.

What is the best way to write documentation for Claude Code plugin skills?

The best way to write plugin skill documentation is using an imperative writing style in the SKILL.md file, keeping it concise while offloading detailed references to the bundled resources directory.