tool-selection-framework

Select AI tools for development tasks using a decision framework.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/92Bilal26/physical-ai-textbook --skill tool-selection-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-selection-framework
Source: https://github.com/92Bilal26/physical-ai-textbook/tree/main/.claude/skills/tool-selection-framework
Command: npx skills add https://github.com/92Bilal26/physical-ai-textbook --skill tool-selection-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires constitution:v6.0.1.

What problem does it solve?

This Skill provides a systematic decision framework for selecting the right AI tools (e.g., Claude Code vs Gemini CLI) based on context requirements, codebase size, reasoning depth needs, and task complexity. It helps teams start projects with unclear tool requirements, optimize context-constrained workflows, and design multi-phase strategies that leverage multiple tools' strengths.

Core Features & Use Cases

  • Match tool capabilities to task characteristics (context window, reasoning depth, cost)
  • Design multi-phase workflows that combine multiple tools for exploration and implementation
  • Optimize context utilization by selecting the most appropriate tool for codebase size
  • Extensible framework for future tools and evolving capabilities
  • Prevent wasted context and improve development productivity through informed tool choice

Quick Start

Apply this framework to a project with a medium-sized codebase (e.g., 120K lines of code) and a need for broad exploration; decide to allocate Claude Code for implementation and Gemini CLI for exploration, and outline the workflow.

Frequently Asked Questions about tool-selection-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between Claude Code and Gemini CLI for my development project?

Tool selection depends on your codebase size, reasoning depth needs, and task type. Claude Code suits focused implementation with larger context windows; Gemini CLI excels at broad exploration. Match tool capabilities—context window, reasoning depth, cost—to your specific requirements using a systematic decision framework.

When should I use multiple AI tools in a single development workflow?

Multi-phase workflows leverage each tool's strengths: use Gemini CLI for initial exploration and broad analysis, then transition to Claude Code for detailed implementation. This approach optimizes context utilization and prevents wasted capacity while handling complex projects that span exploration and focused coding.

What factors determine the right AI tool for a medium-sized codebase?

Evaluate codebase size (lines of code), task complexity, reasoning depth requirements, and available context windows. For medium codebases (e.g., 120K LOC), allocate tools based on phase: Gemini CLI for broad exploration, Claude Code for concentrated implementation work.

Can I optimize my development workflow when context is limited?

Yes. Select tools strategically based on task characteristics and constraints. Context-constrained workflows benefit from tool segmentation: reserve larger context windows for implementation tasks and use lighter tools for exploratory phases, improving overall productivity.

How does task complexity influence which AI tool to use?

Task complexity—measured by reasoning depth, reasoning breadth, and implementation scope—maps directly to tool selection. High-complexity tasks requiring deep reasoning align with Claude Code; exploratory tasks with broad scope align with Gemini CLI's strengths.

Is this framework extensible for tools beyond Claude Code and Gemini CLI?

Yes. The decision framework evaluates tool capabilities generically—context window, reasoning depth, cost—making it extensible for future tools. Apply the same context and complexity criteria to assess any new AI development tool against your project requirements.