Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/phuonghx/aim-cli/plan-writingnpx skills add phuonghx/aim-cli --skill plan-writinggit clone --depth 1 https://github.com/phuonghx/aim-cliWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00087 | $0.01054 |
| Opus 5 | $0.00044 | $0.00527 |
| Sonnet 5 | $0.00017 | $0.00211 |
| Haiku 4.5 | $0.00009 | $0.00105 |
Grade A, and why
plan-writing scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
| "Test the endpoint" | "`curl localhost:3000/api/orders` returns 200 with a JSON array" | How it starts
The opening of the file, as written. The whole thing — 108 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Writing Plans
A good plan is a thinking tool, not paperwork. It exists to make the next actions obvious and to tell you when you are finished. Each plan is shaped to its task -- there is no master template to fill in.
What makes a task good
- Bite-sized. A step should be completable in a couple of minutes and produce one clear result.
- Checkable. You should be able to say exactly how you would confirm it worked -- a command to run, output to see, a value to inspect.
- Ordered sensibly. Note what depends on what, run independent steps in parallel, and call out the critical path. The verification step always comes last.
Where the file lives
Save the plan in the project root as {task-slug}.md, with the slug pulled from the task itself -- "add billing webhooks" becomes billing-webhooks.md. Do not bury it in .aim-agents/, docs/, or a scratch directory.
Five habits to keep
These are habits, not boilerplate. Every plan is unique to its task.
Keep it short
A handful of meaningful steps beats an exhaustive tree of sub-sub-tasks. List only things you will actually do, one line each. If the plan runs past a single page, it is doing too much -- cut it down or split it.
Be concrete
Vague steps stall; specific ones move.
| Too vague | Concrete |
|---|---|
| "Set up the project" | "Run npm create vite@latest" |
| "Add login" | "Install Lucia, add src/lib/auth.ts and the session middleware" |
| "Polish the UI" | "Apply spacing + dark-mode classes to Sidebar.tsx" |
The test: does the step have an outcome you could point at and verify?
Let the task type drive the content
New project: decide the stack first, define the smallest shippable slice, sketch the file layout.
Adding a feature: identify which files change, list new dependencies, decide how you will confirm it works.
Fixing a bug: pin down the root cause, name the exact file and line to change, state the test that proves it is fixed.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 108 lines · 87 tokens per session scan A b2abc687c2b6
plan-writing is a skill published in the GitHub repository phuonghx/aim-cli (1 stars, last pushed 2mo ago), licensed MIT. It adds 87 tokens to every session and 1,054 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
hs-release
Cut a core Hindsight release (vX.Y.Z) and open the changelog + blog PR. Use when asked to cut/start a release, bump the version, or publish a new Hindsight version.
hindsight-local
Store user preferences, learnings from tasks, and procedure outcomes. Use to remember what works and recall context before new tasks. (user).
research-repository
Build a repository that makes findings findable, reusable, and cumulative across teams. Use when the same research keeps getting redone. For synthesising one study, use affinity-diagram.
design-negotiation
Advocate for design quality, scope, and timeline with partners and leadership using evidence and shared goals. Use in the conversation itself. For the commercial vocabulary behind it, use business-design (ux-strategy).
user-persona
Build research-grounded personas with goals, frustrations, and behavioural patterns. Use when decisions need a consistent user reference. For one session's emotional snapshot use empathy-map; for motivation framing use jobs-to-be-done.
version-control-strategy
Define version control for design files, components, and libraries — branching, naming, and release. Use when file history is chaotic. For design system contribution rules, use design-system-governance (design-systems).