skill-development

Organize SKILL.md, references, examples, and scripts into a progressive disclosure layout.

3|1|Updated Dec 30, 2025

Search Tags:#templates #skill-development #claude-code #frontmatter #references #progressive-disclosure #plugin-skills

Ready to run

npx skills add https://github.com/hughescr/isambard --skill skill-development-hughescr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/hughescr/isambard/tree/main/agents-skills-plugins/skills/skill-development
Command: npx skills add https://github.com/hughescr/isambard --skill skill-development-hughescr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured blueprint and best practices for creating Claude Code plugin skills, enabling teams to design modular, self-contained skills with lean SKILL.md frontmatter and well-organized bundled resources.

Core Features & Use Cases

Define SKILL.md frontmatter with name and description to enable auto-discovery.
Organize bundled resources in scripts/, references/, and assets/ to support deterministic tasks, context loading, and output templates.
Apply progressive disclosure to load content progressively: metadata, SKILL.md body, then references/assets as needed.
Provide templates, examples, and tooling guidance for skill creation, validation, and packaging.
Emphasize imperative writing style, third-person descriptions, and precise trigger phrases to improve discovery.

Quick Start

To create a new skill, add SKILL.md with proper frontmatter and a skeleton directory structure, then populate references and examples and iterate.

Frequently Asked Questions about skill-development

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

FAQPage Schema

How do I create a Claude Code plugin skill with progressive disclosure?▼

To create a Claude Code plugin skill, add a SKILL.md file with proper frontmatter and a skeleton directory structure, then populate bundled resources in scripts, references, and assets to load content progressively.

What should be included in SKILL.md frontmatter for reliable skill activation?▼

SKILL.md frontmatter should include the skill name and description to enable auto-discovery, using an imperative writing style and precise trigger phrases to improve discovery and reliable skill activation.

How do I organize bundled resources in a Claude Code plugin skill directory?▼

Organize bundled resources by placing deterministic scripts in the scripts directory, context loading files in references, and output templates in assets to support progressive disclosure and reliable task execution.

Does progressive disclosure improve Claude Code skill performance?▼

Progressive disclosure improves Claude Code skill performance by loading content sequentially: metadata first, then the SKILL.md body, and finally references or assets as needed, keeping the core context lean.

What is the best way to structure templates and examples for skill development?▼

The best way to structure templates and examples for skill development is to apply progressive disclosure layout principles, ensuring frontmatter quality, lean SKILL.md content, and well-referenced resources for reliable activation.

Why are my Claude Code plugin skills not triggering reliably?▼

Claude Code plugin skills may not trigger reliably if the SKILL.md frontmatter lacks precise trigger phrases, uses non-imperative writing styles, or contains overly verbose content instead of a lean structure with well-referenced resources.