Skill Development

Standardize Claude Code plugin skill structure, metadata, and content organization.

11|2|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ajsai47/holyclaude --skill skill-development-ajsai47
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/ajsai47/holyclaude/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/ajsai47/holyclaude --skill skill-development-ajsai47

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the common problem of creating inconsistent, poorly triggered, or context-bloating Claude Code plugin skills by providing standardized best practices for skill structure, metadata quality, content organization, and progressive disclosure design.

Core Features & Use Cases

  • End-to-End Creation Workflow: Step-by-step guidance for planning, structuring, validating, and iterating on plugin skills, from initial concept to production-ready deployment.
  • Best Practice Guidance: Clear rules for writing effective trigger phrases, using imperative/infinitive form, organizing bundled resources (scripts, references, assets), and avoiding common mistakes that reduce skill effectiveness.
  • Use Case: If you are building a Claude Code plugin and need to add a custom skill for PDF processing, hook development, or domain-specific task automation, this Skill guides you through creating a lean, auto-discoverable skill that loads only when needed to save context window space.

Quick Start

Use the Skill Development skill to create a new custom skill for your Claude Code plugin that follows all best practices for structure, triggering, and progressive disclosure.

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 auto-discovery?

To structure a Claude Code plugin skill for auto-discovery, you must follow a standardized directory structure and compliant metadata format. This ensures the skill is recognized and loaded correctly by the Claude Code plugin system only when triggered.

What is progressive disclosure in Claude Code skills?

Progressive disclosure in Claude Code skills is a content organization strategy that keeps the SKILL.md body lean. It loads bundled resources like scripts and references only when needed, saving context window space.

How do I write effective trigger phrases for a custom plugin skill?

Writing effective trigger phrases for a custom plugin skill requires using imperative or infinitive verb forms. This standardizes metadata and prevents the skill from triggering inconsistently or bloating the context window.

Why is my Claude Code plugin skill not triggering correctly?

Claude Code plugin skills fail to trigger correctly due to non-compliant metadata, poor trigger phrases, or avoiding imperative writing style. Standardizing skill structure and metadata resolves these activation issues.

What are the best practices for organizing bundled resources in a skill?

Best practices for organizing bundled resources in a skill involve separating scripts, references, and assets into a correct directory structure. This simplifies validation testing and supports progressive disclosure design.