context-intelligence-hill-climbing
Skill5 starsChanged 5 days agoMITView on GitHub
Use when an investigation needs more than one step — track it in todo as a hill climb so progress and dead leads leave an audit trail. Governs HOW you track the climb, not how you query or extract — that stays in graph-query / session-navigation.
In this repository12 other files it gives its agents.
- AGENTS.mdAGENTS.md
- context-intelligence-derived-metricsSkill
- context-intelligence-eval-designSkill
- context-intelligence-evaluation-methodologySkill
- context-intelligence-gdsSkill
- context-intelligence-graph-querySkill
- context-intelligence-server-data-opsSkill
- context-intelligence-session-navigationSkill
- context-intelligence-session-reconstructionSkill
- context-intelligence-tool-designSkill
- transcriptSkill
- workflow-pattern-analysisSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 5 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 28
Seed the open questions: Before your first real probe, turn the task into todo items — one per open question you must answer.
- Distinctive: line 32
Take the next best step, then record: After each probe, update the list immediately:
- Distinctive: line 35
if the probe opened a new question, add a todo for it.
- Distinctive: line 36
if a lead was a dead end, mark it dead with one line of why (so you — and the reader — don't re-walk it).
- Distinctive: line 39
Adjust out loud: When a finding changes the plan (a lead dies, the shape is different than assumed, you must escalate the tool tier), the …
- Distinctive: line 46
The final todo state IS the audit trail: Before answering, the list should read as a legible account of the climb: questions asked, …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Context Intelligence Hill-Climbing
You already navigate well — bounded probes, count-first, SKIP/LIMIT, jq | head, and the
budget discipline. This skill does not change any of that. Its one job is to make a multi-step
investigation track itself in the todo tool so that (a) you always know the next best step and
when the plan needs adjusting, and (b) anyone reading the run afterwards can see exactly how the
answer was reached.
Think of the todo list as your climb log / belief-state: the open questions you're climbing toward, the findings you've banked, and the leads you've abandoned.
When to use this
- Use it for any investigation that will take more than one probe — provenance tracing, cross-session synthesis ("how do we work?"), anything where you'll refine or escalate.
- Skip it for a genuine single-shot lookup (one count, one bounded query, done). Do not add todo ceremony to a one-liner — that's overhead, not an audit trail.
The climb, tracked in todo
- Seed the open questions. Before your first real probe, turn the task into
todoitems — one per open question you must answer. This is the belief-state at the start of the climb. (e.g. "Identify the root cause", "Find who FIRST produced the design", "Reconstruct the causal chain".) - Take the next best step, then record. After each probe, update the list immediately:
- mark an open question answered, and write the finding into the item (the fact + where you found it — the citation), not just a checkmark;
- if the probe opened a new question, add a todo for it;
- if a lead was a dead end, mark it dead with one line of why (so you — and the reader — don't re-walk it). Do not silently drop it.
- Adjust out loud. When a finding changes the plan (a lead dies, the shape is different than assumed, you must escalate the tool tier), the todo list is where that pivot is recorded. Drift that isn't in the log is drift nobody can audit.
- Converge and stop. You're done when every open-question todo is answered or the budget is hit. On genuinely absent data, mark the item resolved-as-absent — do not spin.
- The final todo state IS the audit trail. Before answering, the list should read as a legible account of the climb: questions asked, findings banked (with citations), leads abandoned. Your final answer should be consistent with it.
What this skill does NOT do
- It does not tell you how to query, page, bound, or extract. For the graph surface, that's
context-intelligence-graph-query(+context-intelligence-gdsfor topology). For the JSONL surface, that'scontext-intelligence-session-navigation+ the navigation-budget discipline. This skill sits above those and only governs the climb log. - It does not add analytical steps you wouldn't otherwise take. If you'd answer in one probe, answer in one probe.
Why it's worth the keystrokes
The todo trail turns an ephemeral investigation into a reviewable one: a later reader (or you, resuming) can see which leads were tried, which were dead, and what evidence backs each finding — without re-running the whole climb. Keep it lean; the log should help the work, never become the work.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

