What is the Hybrid Agent anti-pattern?

A Hybrid Agent anti-pattern occurs when an agent performs execution work (like direct file manipulation or API calls) instead of delegating those tasks to specialized skills.

How does this skill help reduce context usage?

By identifying and extracting execution logic into skills, the main agent prompt is trimmed down to orchestration logic only, significantly reducing the tokens consumed per invocation.

Will this skill automatically modify my project files?

No, the Hybrid Agent Detector performs a read-only analysis. It provides recommendations and data for you to review and implement manually.

How is the hybrid score calculated?

The score is a ratio of execution tool usage (Read, Write, Bash) versus orchestration tool usage (Skill invocation). A higher score indicates a stronger need for refactoring.

Hybrid Agent Detector

Name: Hybrid Agent Detector
Author: fractary

$fractary$ byfractary

•

Analytics & Monitoring

Identifies and audits agents that perform execution tasks directly instead of delegating to specialized skills to prevent context bloat.

The Hybrid Agent Detector is an architectural audit tool designed to maintain clean separation of concerns within Claude Code projects. It scans for the 'Hybrid Agent' anti-pattern—where orchestration logic and execution tasks are combined in a single agent—which often leads to bloated prompts and reduced code reusability. By analyzing tool usage patterns and file operations, this skill provides a quantitative 'hybrid score' and actionable recommendations for refactoring execution logic into standalone, testable skills.

Key Features

01Automated scanning of agent files for execution-heavy patterns

02Severity-based reporting with detailed evidence for each detection

032 GitHub stars

04Context optimization calculator to estimate token savings

05Quantitative analysis of orchestration vs. execution tool usage

06Read-only auditing that ensures project files are never modified

Use Cases

01Reducing context window usage in high-frequency AI agent calls

02Refactoring monolithic agents into modular, skill-based architectures

03Auditing complex agentic workflows for architectural technical debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins hybrid-agent-detector

For use in Claude.ai and ChatGPT

Download Skill