skills.rest
mahmoud20138
mahmoud20138COMMUNITY
Explore all skills by this author →
GitHub

skill-development

Standardize Claude Code plugin skills with frontmatter-backed SKILL.md files.

10|2|Updated Mar 8, 2026
Search Tags:#governance#skill-development#claude-code#frontmatter#progressive-disclosure#skill-structure#plugin-development
One-click install
npx skills add https://github.com/mahmoud20138/Tradecraft --skill skill-development-mahmoud20138
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/mahmoud20138/Tradecraft/tree/main/plugins/tradecraft/skills/skill-development
Command: npx skills add https://github.com/mahmoud20138/Tradecraft --skill skill-development-mahmoud20138

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill development for Claude Code plugins provides a standardized approach to creating, organizing, and governing skills within a Claude Code plugin. It clarifies the anatomy of a skill (SKILL.md frontmatter, body, optional references/scripts/assets) and prescribes progressive disclosure so that core guidance loads immediately while detailed information is loaded on demand. This structure helps teams maintain consistency, reduce cognitive load, and accelerate plugin capability growth.

Core Features & Use Cases

  • Establishes a repeatable skill template: a frontmatter-defined entry point (name, description) with a lean body and comprehensive references.
  • Encourages progressive disclosure: move advanced techniques, migration notes, and API references to the references/ folder for on-demand loading.
  • Defines optional resource bundles: scripts/ for deterministic utilities, references/ for in-context docs, assets/ for templates and artifacts.
  • Supports plugin governance: aligns with best practices for Claude Code plugin skills, validation workflow, and testing in the plugin environment.
  • Targets end-to-end skill development: from writing SKILL.md to packaging reusable resources and validating structure.

Quick Start

Create a new skill directory under plugin-name/skills/skill-name, add SKILL.md with proper frontmatter, and begin structuring references, examples, and scripts as needed.

Quick Start (Single Sentence)

Create a new skill directory under plugin-name/skills/skill-name, add SKILL.md with proper frontmatter, and begin structuring references, examples, and scripts as needed.

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 SKILL.md file for Claude Code plugin development?▼

Structure a SKILL.md file for Claude Code plugin development by defining frontmatter with name and description, keeping the body lean with triggers, and moving detailed material to references, scripts, and assets folders for progressive disclosure.

What is progressive disclosure in Claude Code skills and when should I use it?▼

Progressive disclosure in Claude Code skills is an organizational approach that loads core guidance immediately while moving in-depth material like API references to the references folder for on-demand loading, reducing cognitive load. Use it to maintain consistency as plugin capabilities grow.

How do I organize optional resources like scripts and assets in a Claude Code plugin?▼

Organize optional resources in a Claude Code plugin by placing deterministic utilities in a scripts folder, in-context documentation in a references folder, and templates or artifacts in an assets folder. This structure supports reusable guidance and on-demand loading.

Can I validate the frontmatter and structure of a Claude Code skill during plugin testing?▼

Yes, you can validate the frontmatter and structure of a Claude Code skill during plugin testing. The standardized skill development workflow enforces a lean SKILL.md body with triggers in the description and validates the overall directory structure during plugin skill testing.

What's the best way to standardize skill creation across multiple Claude Code plugins?▼

Standardize skill creation across multiple Claude Code plugins by establishing a repeatable template: a frontmatter-defined entry point with a lean body and comprehensive references. This enforces plugin governance, aligns with best practices, and accelerates capability growth.

Related Skills

Explore More Software Engineering Skills→
jpoutrinjpoutrin
14

create-plugin

Create a Claude Code plugin scaffold with plugin.json and optional components.

Community
Intermediate
tilework-techtilework-tech
149

Creating-Skills

Create custom profile skills with SKILL.md checklists and Bash scripts.

Official
Basic
ronniegeraghtyronniegeraghty
3

agent-conduct

Enforce product isolation and test verification rules across squad agents.

Community
Intermediate
LGuguiLGugui

Skill Builder

Create Claude Code Skills with YAML frontmatter and directory organization.

Community
Intermediate