Yeachan-Heo

analyze

Deep analysis and investigation

Yeachan-Heo 35,687 3,255 Updated 3mo ago
GitHub

Install

npx skillscat add yeachan-heo/oh-my-claudecode/analyze

Install via the SkillsCat registry.

SKILL.md
Analyze performs deep investigation of architecture, bugs, performance issues, and dependencies. It routes to the architect Claude agent for thorough analysis and returns structured findings with evidence. - User says "analyze", "investigate", "debug", "why does", or "what's causing" - User needs to understand a system's architecture or behavior before making changes - User wants root cause analysis of a bug or performance issue - User needs dependency analysis or impact assessment for a proposed change - A complex question requires reading multiple files and reasoning across them </Use_When> - User wants code changes made -- use executor agents or `ralph` instead - User wants a full plan with acceptance criteria -- use `plan` skill instead - User wants a quick file lookup or symbol search -- use `explore` agent instead - User asks a simple factual question that can be answered from one file -- just read and answer directly </Do_Not_Use_When> Deep investigation requires a different approach than quick lookups or code changes. Analysis tasks need broad context gathering, cross-file reasoning, and structured findings. Routing these to the architect agent or Codex ensures the right level of depth without the overhead of a full planning or execution workflow. </Why_This_Exists> - Route analysis to the architect Claude agent for thorough investigation - Always gather context files before spawning the architect agent for grounded reasoning - Return structured findings, not just raw observations </Execution_Policy> 1. **Identify the analysis type**: Architecture, bug investigation, performance, or dependency analysis 2. **Gather relevant context**: Read or identify the key files involved 3. **Route to analyzer**: `Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="Analyze: ...")` 4. **Return structured findings**: Present the analysis with evidence, file references, and actionable recommendations - Use `Task(subagent_type="oh-my-claudecode:architect", model="opus", ...)` as the primary analysis route - For broad analysis, use `explore` agent first to identify relevant files before routing to architect </Tool_Usage> User: "analyze why the WebSocket connections drop after 30 seconds" Action: Gather WebSocket-related files, route to architect with context, return root cause analysis with specific file:line references and a recommended fix. Why good: Clear investigation target, structured output with evidence. User: "investigate the dependency chain from src/api/routes.ts" Action: Use explore agent to map the import graph, then route to architect for impact analysis. Why good: Uses explore for fact-gathering, architect for reasoning. User: "analyze the auth module" Action: Returning "The auth module handles authentication." Why bad: Shallow summary without investigation. Should examine the module's structure, patterns, potential issues, and provide specific findings with file references. User: "fix the bug in the parser" Action: Running analysis skill. Why bad: This is a fix request, not an analysis request. Route to executor or ralph instead. - If analysis reveals the issue requires code changes, report findings and recommend using `ralph` or executor for the fix - If the analysis scope is too broad ("analyze everything"), ask the user to narrow the focus - If Codex is unavailable and the architect agent also fails, report what context was gathered and suggest manual investigation paths </Escalation_And_Stop_Conditions> - [ ] Analysis addresses the specific question or investigation target - [ ] Findings reference specific files and line numbers where applicable - [ ] Root causes are identified (not just symptoms) for bug investigations - [ ] Actionable recommendations are provided - [ ] Analysis distinguishes between confirmed facts and hypotheses </Final_Checklist>

Task: {{ARGUMENTS}}