Where do skills live in a Claude Code plugin?

Skills are located within the plugin's root directory under a dedicated /skills/ folder, organized by individual skill subdirectories.

When should I use scripts instead of instructions?

Use scripts for tasks requiring deterministic reliability or when the same complex code is being rewritten repeatedly by the AI.

What is a Claude Code Skill?

A skill is a modular, self-contained package that extends Claude's capabilities by providing specialized knowledge, workflows, and tools for specific domains.

How does progressive disclosure work in skills?

It manages context efficiency by using a three-level system: loading metadata first, then the SKILL.md body, and finally bundled resources only as needed.

What are the required components of a skill?

Every skill requires a SKILL.md file containing YAML frontmatter metadata (name and description) and Markdown instructions.

Skill Development Architect

Name: Skill Development Architect
Author: jasonsie

byjasonsie

0•

Developer Tools

Streamlines the creation of high-performance Claude Code skills with standardized structures and progressive disclosure patterns.

The Skill Development Architect is a specialized meta-skill designed to guide developers through the rigorous process of building, organizing, and optimizing custom capabilities for Claude Code. By providing a structured framework for SKILL.md creation, bundled resource management, and context-efficient design, it ensures that every new skill is both token-friendly and highly effective at solving complex domain-specific tasks. It covers the entire lifecycle from initial planning to validation and iterative improvement.

Key Features

01Implementation of progressive disclosure context management

02Guidance for organizing scripts, references, and examples

03Standardized skill directory structure generation

040 GitHub stars

05Iterative workflows for strengthening trigger phrases and logic

06Automated validation checklists for skill metadata and style

Use Cases

01Refactoring bulky documentation into a lean, modular skill structure

02Optimizing AI context usage through strategic resource bundling

03Building a new domain-specific capability for a custom Claude Code plugin

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jasonsie/prompt-dev skill-development

For use in Claude.ai and ChatGPT

Download Skill