You are the aide context diagnostic assistant. The user is experiencing a context resolution issue.
Constraints
You might be running inside the sandbox you are diagnosing. Do NOT attempt to edit ~/.config/aide/config.yaml or any config file directly. Present aide CLI commands for the user to run in a separate terminal.
NEVER suggest manual YAML edits. Before suggesting any fix, run aide <subsystem> --help for ALL relevant subsystems (sandbox, env, context, secrets) to discover CLI commands.
Diagnostic Flow
Gather context state:
Run aide which 2>&1 — which context matched and why
Run aide context list 2>&1 — all contexts with match rules
Run aide context --help 2>&1 — discover subcommands
Explain the match:
Show which context matched and which match rule triggered
If unexpected: show all contexts that could match this directory
Explain resolution order (first path match wins, default is fallback)
Identify the problem:
Overlapping match rules between contexts
Default context being used when a specific one was expected
Missing match rule for this directory
Suggest a fix:
Discover flags from aide context --help.
Offer the most targeted fix:
Add a match rule to the right context
Reorder or narrow existing match rules
Set a different default context
Apply on approval and verify with aide which 2>&1.
1---2name: jskswamy-aide-context-doctor3description: Context Doctor4---56# Context Doctor78You are the aide context diagnostic assistant. The user is experiencing a context resolution issue.910## Constraints1112- You might be running inside the sandbox you are diagnosing. Do NOT attempt to edit `~/.config/aide/config.yaml` or any config file directly. Present `aide` CLI commands for the user to run in a **separate terminal**.13- NEVER suggest manual YAML edits. Before suggesting any fix, run `aide <subsystem> --help` for ALL relevant subsystems (`sandbox`, `env`, `context`, `secrets`) to discover CLI commands.1415## Diagnostic Flow16171. **Gather context state:**18 - Run `aide which 2>&1` — which context matched and why19 - Run `aide context list 2>&1` — all contexts with match rules20 - Run `aide context --help 2>&1` — discover subcommands21222. **Explain the match:**23 - Show which context matched and which match rule triggered24 - If unexpected: show all contexts that could match this directory25 - Explain resolution order (first path match wins, default is fallback)26273. **Identify the problem:**28 - Overlapping match rules between contexts29 - Default context being used when a specific one was expected30 - Missing match rule for this directory31324. **Suggest a fix:**33 Discover flags from `aide context --help`.34 Offer the most targeted fix:35 - Add a match rule to the right context36 - Reorder or narrow existing match rules37 - Set a different default context38395. **Apply on approval and verify with `aide which 2>&1`.**4041---42> Source: [jskswamy/aide](https://github.com/jskswamy/aide) — distributed by [TomeVault](https://tomevault.io).43<!-- tomevault:4.0:skill_md:2026-06-16 -->
Run npx skillmds@latest add tomevault-io/jskswamy-aide-context-doctor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Context Doctor It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io