What is a Claude Code Skill pattern?

It is a standardized documentation structure for SKILL.md files that ensures consistency and clarity when describing specialized capabilities to AI agents and developers.

When should I use the Executable Skill pattern?

Use this pattern when your skill includes shell scripts or operational tools that require documentation of options, exit codes, performance, and troubleshooting.

How does the Reference Skill pattern differ from the Executable one?

The Reference Skill pattern is a lightweight, 5-section structure designed for documenting patterns, conventions, or guidelines that do not involve running code.

Why is standardized documentation important for Claude Code skills?

Standardization allows AI agents to predictably locate information like command syntax and error codes, which significantly improves their ability to use the tools without errors.

Claude Skill Structure Patterns

Name: Claude Skill Structure Patterns
Author: manifoldlogic

bymanifoldlogic

0•

Learning & Documentation

Standardizes the documentation architecture for Claude Code skills using specialized executable and reference patterns.

This skill provides a formal framework for creating SKILL.md files within the Claude Code ecosystem, ensuring high-quality, predictable documentation for both humans and AI agents. It defines two primary documentation archetypes: a comprehensive 'Executable Skill' pattern for operational tools with scripts, and a lightweight 'Reference Skill' pattern for architectural conventions and coding patterns. By implementing these structures, developers can improve skill discoverability, simplify troubleshooting, and ensure that AI agents have the necessary context to execute tasks correctly.

Key Features

01Defines standardized templates for executable and reference documentation

02Provides a decision tree for selecting the appropriate documentation depth

03Standardizes metadata frontmatter for improved plugin discovery

040 GitHub stars

05Includes validation checklists for documentation completeness

06Offers clear guidance on documenting scripts, exit codes, and troubleshooting

Use Cases

01Standardizing documentation across large multi-plugin repositories

02Improving AI agent reliability by providing structured operational context

03Onboarding new contributors to follow repository-specific documentation styles

Key Features

01Defines standardized templates for executable and reference documentation

02Provides a decision tree for selecting the appropriate documentation depth

03Standardizes metadata frontmatter for improved plugin discovery

040 GitHub stars

05Includes validation checklists for documentation completeness

06Offers clear guidance on documenting scripts, exit codes, and troubleshooting

Use Cases

01Standardizing documentation across large multi-plugin repositories

02Improving AI agent reliability by providing structured operational context

03Onboarding new contributors to follow repository-specific documentation styles