# Refine Context

> Iteratively improve a context document.

- Skill: `tomeraberbach/refine-context` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tomeraberbach/refine-context`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomeraberbach/refine-context/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: TomerAberbach (https://skillmd.com/u/tomeraberbach)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tomeraberbach/refine-context

---


Iteratively improve the given context document.

# Target

```!
jj show --git
```

Arguments: $ARGUMENTS

Refine the target named in the arguments if given. Otherwise refine the document
changed in the current commit shown above. If there are no arguments and the
commit has no changes, ask the user what to refine and stop.

# Prepare

- Break prose into point form before iterating. One claim per bullet

# Iterate

- What are the ambiguities?
- What are the internal contradictions?
- Can any parts be merged?
- Are the most important things first?
- Is the document specific?
- Is the document concise?
- What would the reader already know?

# Apply

- One question per iteration