What is a Claude Code Skill?

A skill is a reusable, callable module that encapsulates procedural knowledge for an AI agent, persisting across sessions and providing structured instructions for specific tasks.

Does it identify errors in my existing skills?

Yes, the skill includes a 'Reviewer' protocol that scans for ten common anti-patterns and provides a findings report with severity ratings and suggested fixes.

What design patterns does this skill support?

It supports five primary patterns: Tool Wrapper (knowledge), Generator (templates), Reviewer (evaluation), Inversion (context gathering), and Pipeline (ordered workflows).

Can it help me reduce token costs?

Yes, it implements a three-level progressive disclosure architecture (Discovery, Instructions, Resources) so the agent only loads detailed data when explicitly needed.

How does the Skill Design Guide improve agent performance?

It applies research-backed patterns that can increase agent pass rates by up to 16%, focusing on distilled procedural knowledge rather than exhaustive documentation dumps.

Skill Design Guide

Name: Skill Design Guide
Author: AndyElessar

byAndyElessar

0•

開発者ツール

Designs, reviews, and optimizes high-performance agentic skills using standardized architectural patterns and best practices.

The Skill Design Guide is a specialized framework for developers building agentic workflows in Claude Code. It provides a structured approach to creating SKILL.md files, helping users select between five core design patterns: Tool Wrapper, Generator, Reviewer, Inversion, and Pipeline. By implementing research-backed principles like progressive disclosure and distilled procedural knowledge, this skill helps increase agent pass rates and efficiency. Whether you are architecting a new capability from scratch or auditing existing skills for anti-patterns, this guide ensures your agentic modules are reusable, token-efficient, and highly reliable.

主な機能

01Architectural pattern selection guide for specialized agent workflows

02Three-level progressive disclosure system to optimize context token usage

03Standardized directory structuring for references, assets, and scripts

040 GitHub stars

05Automated quality review and checklist-based evaluation for SKILL.md files

06Anti-pattern detection to prevent agent performance degradation

ユースケース

01Generating templated skill instructions with human-in-the-loop validation

02Auditing and refactoring existing skills to improve success rates

03Building a new specialized domain capability for a Claude Code agent

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add andyelessar/skills skill-guide

For use in Claude.ai and ChatGPT