ai-agents-architect

Evaluate task suitability and select AI agent architecture patterns like ReAct or Plan-Execute.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sharkitect-solutions/sharkitect-claude-toolkit --skill ai-agents-architect-sharkitect-solutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-agents-architect
Source: https://github.com/sharkitect-solutions/sharkitect-claude-toolkit/tree/main/skills/ai-agents-architect
Command: npx skills add https://github.com/sharkitect-solutions/sharkitect-claude-toolkit --skill ai-agents-architect-sharkitect-solutions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you make informed decisions about whether to build an AI agent, select the right architecture pattern, design effective tool schemas, and debug common agent failures.

Core Features & Use Cases

  • Agent Suitability Assessment: Determine if a task truly requires an agent or if a simpler pipeline/chain suffices, considering the "Agent Tax" (latency, cost, unpredictability).
  • Architecture Pattern Selection: Choose between ReAct, Plan-Execute, Routing, Multi-Agent, and OODA patterns based on task requirements.
  • Tool Design Best Practices: Learn to write clear, effective tool descriptions and manage tool count to improve agent reliability.
  • Debugging Agent Failures: Understand and fix common issues like infinite loops, hallucinated tool calls, and plan abandonment.
  • Multi-Agent Decision Framework: Decide when multiple agents are necessary and choose appropriate communication patterns.

Quick Start

Use the ai-agents-architect skill to decide if your task requires an AI agent.

Frequently Asked Questions about ai-agents-architect

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

FAQPage Schema
How do I decide if my task requires an AI agent or a simpler LLM pipeline?

To decide if your task requires an AI agent, assess the "Agent Tax" of latency, cost, and unpredictability against the complexity of your task. If a simpler LLM pipeline or chain suffices, skip the agent architecture.

What is the best way to choose between ReAct and Plan-Execute patterns for AI agents?

Choosing between ReAct and Plan-Execute architecture patterns depends on your specific task requirements. Evaluate whether dynamic reasoning or structured planning better suits the complexity of your AI agent workflow.

How do I write effective tool schemas to improve AI agent reliability?

Write clear, effective tool descriptions and manage tool count to improve AI agent reliability. Proper tool design ensures the LLM selects the right tools and reduces hallucinated tool calls during execution.

Why does my AI agent get stuck in infinite loops and how do I debug it?

AI agents get stuck in infinite loops due to reasoning failures or tool output misinterpretation. Debug common agent failures by analyzing reasoning steps, validating tool schemas, and correcting plan abandonment.

When should I use a multi-agent architecture instead of a single agent?

Use a multi-agent architecture when task complexity exceeds a single agent's capacity. Apply a multi-agent decision framework to determine when multiple agents are necessary and select appropriate communication patterns.

How do I fix hallucinated tool calls in my LLM agent?

Fix hallucinated tool calls in your LLM agent by optimizing tool schemas and refining descriptions. Clear tool design reduces LLM confusion and ensures accurate tool selection during agent execution.