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

0•

개발자 도구

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

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.

주요 기능

01Decision logic for implementing PreToolUse and PostToolUse enforcement hooks

02Framework for identifying four distinct skill types based on required freedom

03Pre-configured tool restriction profiles for knowledge and hybrid skills

040 GitHub stars

05Standardized directory anatomy for core instructions, scripts, and references

06Optimized templates for SKILL.md to ensure high-quality agent performance

사용 사례

01Creating custom domain-specific skills for private team development environments

02Standardizing automated workflows to ensure consistent code generation and validation

03Migrating legacy scripts into structured AI-native skills with strict enforcement rules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chkim-su/forge-editor skill-design

For use in Claude.ai and ChatGPT

Download Skill