Skill Development

Validate SKILL.md frontmatter and resources for Claude Code plugins.

Updated Mar 17, 2026

Search Tags:#development #documentation #plugin #skill #claude-code #frontmatter #progressive-disclosure

Ready to run

npx skills add https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE --skill skill-development-akbarfarooq2006

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE/tree/main/.qwen/skills/skill-development
Command: npx skills add https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE --skill skill-development-akbarfarooq2006

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Development guidance helps teams design, document, and validate Skill Units for Claude Code plugins by ensuring SKILL.md frontmatter is present, resources are organized, and progressive disclosure is applied to keep context lean.

Core Features & Use Cases

Define SKILL.md frontmatter with a clear, third-person description and specific trigger phrases.
Organize reusable resources in references/, scripts/, and assets/ to support future maintenance and loading-on-demand.
Validate skills with a structured workflow, enabling predictable discovery, loading, and execution in plugin environments.
Use cases include creating new skills, updating descriptions, reorganizing content, and providing troubleshooting templates for plugin developers.

Quick Start

Review the Skill Development SKILL.md and prepare references/ and assets/ for validation.

Frequently Asked Questions about Skill Development

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

FAQPage Schema

How do I write SKILL.md frontmatter for Claude Code plugins?▼

Organize reusable resources into references/, scripts/, and assets/ directories. This structure supports future maintenance and enables loading-on-demand, applying progressive disclosure to keep the context lean.

How does progressive disclosure keep plugin context lean?▼

Progressive disclosure keeps context lean by organizing optional resources into references, examples, and scripts directories, loading them on-demand only when triggered. This prevents overwhelming the plugin environment with unnecessary data.

What fields are required in SKILL.md frontmatter for skill validation?▼

Skill validation requires name and description fields in the SKILL.md frontmatter. Additional metadata fields include tagline, category, keywords, dependencies, and components, ensuring a lean body and proper resource structure.

Can I use existing scripts and references when developing Claude Code skills?▼

Existing scripts and references can be used when developing Claude Code skills by placing them in the respective scripts/ and references/ directories. The validation workflow checks for their presence and structure to ensure proper loading.

Why is my Claude Code skill not triggering or loading on demand?▼

Skills fail to trigger or load on demand when the SKILL.md frontmatter lacks a specific description or trigger phrases. Validation ensures the frontmatter is properly structured for predictable discovery and execution.