skills.rest
bjornslib
bjornslibCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Skill Development

Create consistent Claude Code skill structures with SKILL.md frontmatter and optional resources.

Updated Aug 23, 2026
Search Tags:#documentation#plugin#skill-development#skill#claude-code#progressive-disclosure
One-click install
npx skills add https://github.com/bjornslib/cobuilder-harness --skill skill-development-bjornslib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/bjornslib/cobuilder-harness/tree/main/.claude/skills/skill-development
Command: npx skills add https://github.com/bjornslib/cobuilder-harness --skill skill-development-bjornslib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and maintaining Claude Code skills requires a consistent structure, clear frontmatter, and organized resources. This guide helps teams design, document, and reuse skills efficiently, ensuring progressive disclosure and robust tooling for plugin development.

Core Features & Use Cases

  • Define a canonical skill layout with SKILL.md frontmatter, body instructions, and optional resources (scripts/, references/, assets/).
  • Promote progressive disclosure by placing detailed references and assets in dedicated folders loaded only when needed.
  • Provide templates and conventions for plugin skills to accelerate creation and ensure consistency across teams.

Quick Start

Create the references/ and scripts/ directories and begin documenting and implementing reusable resources following the SKILL.md guidelines.

Frequently Asked Questions about Skill Development

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

FAQPage Schema
How do I structure SKILL.md for Claude Code plugins?▼

Structure SKILL.md with YAML frontmatter containing name and description, a lean body for core instructions, and optional bundled resources in directories like scripts/, references/, and assets/ to support progressive disclosure.

What is progressive disclosure in skill development?▼

Progressive disclosure in skill development organizes detailed references and assets into dedicated folders loaded only when needed, keeping the main SKILL.md lean while making comprehensive documentation available on demand.

How do I organize references and scripts for Claude Code skills?▼

Organize references and scripts by creating dedicated references/ and scripts/ directories alongside SKILL.md, placing detailed documentation and reusable resources in these folders to be loaded dynamically when required.

Do I need YAML frontmatter for every Claude Code plugin skill?▼

Yes, YAML frontmatter with name and description is required for Claude Code plugin skills to ensure consistency, proper metadata parsing, and standardized organization across teams.

What's the best way to ensure consistency across multiple Claude Code plugin skills?▼

Use canonical skill layout templates with standardized SKILL.md frontmatter, body instructions, and organized resource directories to ensure consistency and accelerate creation across teams developing Claude Code plugins.

Can I bundle assets and scripts directly within a Claude Code skill?▼

Yes, you can bundle assets and scripts by creating assets/ and scripts/ directories within the skill structure, keeping them separate from SKILL.md while maintaining organized access to all resources.

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
joncranglejoncrangle
8

skill-development

Create Claude Code plugin skills with SKILL.md structure and validation.

Community
Intermediate
rkz91rkz91
264

create-skill

Create and validate Cursor Skills with SKILL.md frontmatter and documentation templates.

Community
Intermediate
anthropicsanthropics
23.4k

cowork-plugin-customizer

Customize Claude Code plugins by replacing placeholders with organizational tools and workflows.

Official
Intermediate