claude-code-mechanism-selector

The Claude Code Mechanism Selector is a foundational guide and diagnostic tool designed to help developers architect custom functionality within the Claude Code environment. By analyzing technical requirements such as determinism, context isolation, and activation triggers, this skill streamlines the process of choosing between the four primary extension types: Slash Commands, Skills, Subagents, and Hooks. It serves as an internal knowledge repository for maintaining consistency and efficiency when automating development workflows or implementing specialized AI behaviors.

• Enables systematic evaluation of extension requirements using a structured decision matrix.

• Clarifies the distinct operational roles of Slash Commands (user-invoked tasks), Skills (model-invoked capabilities), Subagents (isolated context handlers), and Hooks (deterministic lifecycle triggers).

• Provides clear mapping between architectural intent and implementation logic, such as using Hooks for mandatory security or formatting constraints and Subagents for specialized, high-context tasks like complex debugging or data analysis.

• Facilitates better organization of project resources by identifying whether logic belongs in a simple markdown command file or a complex multi-file resource configuration.

• Use this skill when initiating new feature requests or workflow automations within Claude Code.

• Consult the decision guide to distinguish between AI-decided workflows (Skills) and guaranteed deterministic actions (Hooks).

• Ensure that specialized tasks, such as BigQuery analysis or systematic code review, are delegated to Subagents to maintain context window performance.

• Leverage the Comparison Matrix to quickly audit existing codebase extensions for potential architectural improvements or misalignments.