How do I choose between Knowledge and Tool skill types?

Choose 'Knowledge' when there are multiple approaches and high freedom is needed. Choose 'Tool' for deterministic, repeatable operations with low freedom.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances the AI's behavior for specific tasks by providing domain-specific guidance, patterns, and tools.

When should I use a script vs documentation in a skill?

Use scripts for repeatable code, file manipulation, and reliability-critical tasks. Use documentation for high-level guidance, context, and optional recommendations.

What are enforcement hooks?

Hooks are logic triggers (like PreToolUse) used to enforce 'MUST' or 'REQUIRED' behaviors that documentation alone cannot guarantee the AI will follow.

Skill Architecture & Design

Name: Skill Architecture & Design
Author: chkim-su

bychkim-su

Developer Tools

Standardizes the creation and structure of Claude Code skills using proven implementation patterns and enforcement logic.

About

The Skill Architecture & Design skill provides a comprehensive framework for developing custom Claude Code extensions. It offers a standardized directory structure, clear classification of skill types—ranging from flexible knowledge bases to strict tool-based operations—and critical logic for implementing enforcement hooks. By following these best practices, developers can ensure their AI skills are reliable, well-documented, and performant, utilizing scripts for repeatable tasks and hooks for mandatory behavior validation.

Key Features

Decision logic for implementing PreToolUse and PostToolUse enforcement hooks
Framework for identifying four distinct skill types based on required freedom
Pre-configured tool restriction profiles for knowledge and hybrid skills
0 GitHub stars
Standardized directory anatomy for core instructions, scripts, and references
Optimized templates for SKILL.md to ensure high-quality agent performance

Use Cases

Creating custom domain-specific skills for private team development environments
Standardizing automated workflows to ensure consistent code generation and validation
Migrating legacy scripts into structured AI-native skills with strict enforcement rules

About

Key Features

Decision logic for implementing PreToolUse and PostToolUse enforcement hooks
Framework for identifying four distinct skill types based on required freedom
Pre-configured tool restriction profiles for knowledge and hybrid skills
0 GitHub stars
Standardized directory anatomy for core instructions, scripts, and references
Optimized templates for SKILL.md to ensure high-quality agent performance

Use Cases

Creating custom domain-specific skills for private team development environments
Standardizing automated workflows to ensure consistent code generation and validation
Migrating legacy scripts into structured AI-native skills with strict enforcement rules