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/instructa/planr/planr-loopnpx skills add instructa/planr --skill planr-loopgit clone --depth 1 https://github.com/instructa/planrWhat 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.00034 | $0.01424 |
| Opus 5 | $0.00017 | $0.00712 |
| Sonnet 5 | $0.00007 | $0.00285 |
| Haiku 4.5 | $0.00003 | $0.00142 |
Grade A, and why
planr-loop scanned grade A with 0 findings 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 2d ago.
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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 123 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Planr Loop
This skill is the complete sequential execution contract. Do not reload $planr
or $planr-work after the request has routed here.
The invoking session is the default maker. It inspects and changes product source directly, keeps one stable worker identity, and consumes compatible typed packets until a genuine stop. Do not spawn a coordinator or maker for the default path.
Evaluation subcommands run only when the user requests them, an acceptance criterion requires them, or the maintainer release workflow invokes them. Never run an eval as routine loop work.
Evidence admission guard
Read and apply the canonical Evidence ownership guard before loop execution. Do not duplicate or reinterpret it here.
Execute the loop
Use one plan and a checkable stop condition. The default iteration budget is 10. Refuse a request that combines unrelated goals.
-
Recover the stored
GOAL CONTRACT <plan-id>. If it is absent, store one that requires settled outcomes, binding Evidence, clear approvals, and only the material ReviewGates required by policy or the plan. Runplanr stop activate --plan <plan-id>once for the host thread. Codex hosts let Planr useCODEX_THREAD_ID; other hosts provide one stable explicit session. -
Run
planr plan audit <plan-id> --json. Exit whenholds: true. If scope, the checked build plan, or the map is missing, use$planr-planor$planr-task-graphin this session, then return to the audit. -
Become the maker in this session. Export one stable identity, then lease only plan-scoped outcome work:
export PLANR_WORKER_ID="maker-<stable-session-id>" planr pick --work-type code --plan <plan-id> --jsonRequire
work_packet.execution_state.schema_versionto equalplanr.execution_state.v2. Treat its budget as opaque authority. Branch only onwork_packet.kindand optionalwork_packet.mode.kind: "outcome"is maker work. Read the linked plan, inspect product source, implement the smallest correct slice, run the repository-selected checks once, and settle withplanr done <item-id> ... --next --json.mode: "finding_repair"repairs only the named findings on the same ReviewGate. It creates no fix item. Resolve the findings and stop for re-review.kind: "hold"stops. Never replace policy with host behavior.
What ships with it
4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- 2d ago First seen · 123 lines · 34 tokens per session scan A 1f8359ee2b10
planr-loop is a skill published in the GitHub repository instructa/planr (71 stars, last pushed 5d ago), licensed MIT. It adds 34 tokens to every session and 1,424 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
auth-web-cloudbase
CloudBase Web Authentication Quick Guide for frontend integration after auth-tool has already been checked. Provides concise and practical Web authentication solutions with multiple login methods and complete user management.
fix-codesign-error
Slash command that inspects a macOS signing or entitlement failure and explains the minimum fix path. Invoke explicitly with /fix-codesign-error — this skill never self-triggers.
browse-and-evaluate
Use when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing. Always use --fields to limit output size and --dry-run before committing to an install.
specflow-use
To connect Rosetta with Grid Dynamics SpecFlow MCP; only when SpecFlow is mentioned and the MCP is installed.
loop-engineering
Shared loop-engineering reference for COG skills - the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns. Invoke when designing or debugging a skill that iterates (search-verify-retry, scan-until-dry, fetch-retry-gate).
telnyx-messaging-hosted-curl
Set up hosted SMS numbers, toll-free verification, and RCS messaging. Use when migrating numbers or enabling rich messaging features. This skill provides REST API (curl) examples.