What should go into the 'references' directory?

Detailed documentation, API schemas, and domain knowledge that Claude should reference as-needed rather than keeping in the primary context window.

How do I ensure Claude triggers my custom skill correctly?

By providing a specific, third-person description in the YAML frontmatter of your SKILL.md that includes concrete trigger phrases and exact user queries.

Why is Progressive Disclosure important for skills?

It manages context efficiency by using a three-level loading system: metadata, the SKILL.md body, and bundled resources, ensuring Claude only uses tokens for what is relevant to the current task.

What is a Claude Code Skill?

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

What is the benefit of including scripts in a skill?

Scripts allow for deterministic reliability in tasks that are repeatedly performed, saving tokens and preventing the AI from hallucinating code for common procedures.

Claude Code Skill Architect

Name: Claude Code Skill Architect
Author: SwervoJake

bySwervoJake

0•

開発者ツール

Guides developers in creating, organizing, and optimizing specialized skills for Claude Code plugins using standardized best practices.

The Skill Development utility is a meta-capability designed to help developers build high-quality extensions for the Claude Code ecosystem. It provides a structured framework for creating 'onboarding guides' for AI agents, emphasizing modularity through the use of scripts, references, and assets. By enforcing the principle of Progressive Disclosure and an imperative writing style, this skill ensures that new capabilities remain token-efficient, deterministic, and highly effective for specialized domain tasks.

主な機能

010 GitHub stars

02Standardized skill directory structure generation (SKILL.md, scripts, references, assets)

03Progressive disclosure framework for optimized context window management

04Imperative instruction writing guide for AI-optimized performance

05Resource management for bundled scripts and deterministic code execution

06Validation checklists for plugin-ready skill metadata and trigger phrases

ユースケース

01Managing large documentation sets by converting them into efficient reference files

02Building custom domain-specific skills for private organizational workflows

03Optimizing existing AI prompts into modular, reusable Claude Code plugin skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio skill-development

For use in Claude.ai and ChatGPT

主な機能

010 GitHub stars

02Standardized skill directory structure generation (SKILL.md, scripts, references, assets)

03Progressive disclosure framework for optimized context window management

04Imperative instruction writing guide for AI-optimized performance

05Resource management for bundled scripts and deterministic code execution

06Validation checklists for plugin-ready skill metadata and trigger phrases

ユースケース

01Managing large documentation sets by converting them into efficient reference files

02Building custom domain-specific skills for private organizational workflows

03Optimizing existing AI prompts into modular, reusable Claude Code plugin skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio skill-development

For use in Claude.ai and ChatGPT