analyze-problem

SkillAI & models

Lets your agent break down a problem into its root cause, a proposed fix, and steps to verify it.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the analyze-problem skill

About this capability

Analyze a problem and provide a detailed explanation of the issue, root cause, proposed fix, and verification steps.

What this skill tells your AI

The instructions your AI receives, as published by latitude-dev/latitude-llm in .agents/skills/analyze-problem/SKILL.md and read by ahel’s review.

Read the provided bug report/issue/task.

Then thoroughly investigate the codebase to understand the relevant context:

Find the entry points involved (routes/handlers/jobs/commands) and trace the execution path that leads to the reported behavior.
Identify the data flow and state involved (inputs, validation, persistence, caching, permissions, feature flags, side effects).
Locate the expected behavior (specs/tests/docs) and compare it to the actual behavior in code.
If the report includes steps to reproduce, map each step to the corresponding code path and decision points.
Consider common edge cases (null/empty values, timing/race conditions, retries, idempotency, pagination, timezones, auth, stale cache).

Deliverable: Explain, in your own words:

What you believe the issue is (observable behavior + when it happens),
Why you believe it is happening (root cause and the specific assumption/logic that breaks),
How you would fix it (proposed approach and what behavior/logic should change),
What you would verify (minimal set of checks/tests/logs to confirm the fix and prevent regressions).

Constraints:

Do not apply any changes automatically.
Avoid listing files/components/services unless strictly necessary to support the explanation.
If the codebase does not contain enough context to be confident, explicitly say what’s missing and what evidence would confirm the hypothesis.

Advanced