Agent-Harness-Kit: Skill for Claude Code

.agents/skills/writing-plans/SKILL.md

writing-plans is a skill for Claude Code, Codex from Eduardo-Salvador/Agent-Harness-Kit. It costs 45 tokens per session (542 once invoked), scanned A, original, MIT.

A set of instructions for turning non-trivial coding work into small, executable units based on a written specification. It also defines when a task is simple enough to complete directly.

In plain words
What is it for?
It is for classifying tasks, creating implementation plans when needed, breaking work into independently checkable steps, and preparing handoffs or reviews.
Why use it?
It helps prevent large implementation requests from becoming vague or difficult to verify, while avoiding unnecessary planning for small edits.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is Eduardo-Salvador/Agent-Harness-Kit's own configuration. It tells Claude Code and Codex how to work on Agent-Harness-Kit itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Agent-Harness-Kit configures →

Reuse

Borrowing it

Nothing to install: this file belongs to Eduardo-Salvador/Agent-Harness-Kit. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Eduardo-Salvador/Agent-Harness-Kit/main/.agents/skills/writing-plans/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/Eduardo-Salvador/Agent-Harness-Kit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for writing-plans

README.md
[![agentmods](https://agentmods.dev/badge/skills/eduardo-salvador/agent-harness-kit/writing-plans/github.svg)](https://agentmods.dev/skills/eduardo-salvador/agent-harness-kit/writing-plans)
Your own site
<a href="https://agentmods.dev/skills/eduardo-salvador/agent-harness-kit/writing-plans"><img src="https://agentmods.dev/badge/skills/eduardo-salvador/agent-harness-kit/writing-plans/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for writing-plans

Your own site · 80×15
<a href="https://agentmods.dev/skills/eduardo-salvador/agent-harness-kit/writing-plans"><img src="https://agentmods.dev/badge/skills/eduardo-salvador/agent-harness-kit/writing-plans.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 542 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.00542
Opus 5 $0.00023 $0.00271
Sonnet 5 $0.00009 $0.00108
Haiku 4.5 $0.00005 $0.00054

Measured yesterday against content hash 62aba171ce6e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

writing-plans 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 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.

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.

.agents/skills/writing-plans/SKILL.md · 17 lines

What it actually says

Writing plans

Before graph creation, apply the playbook's delegation assessment: inspect actual host capacity, identify worthwhile independent specialist outcomes, pin shared contracts, and assign exclusive write sets. Do not collapse independent workstreams into one broad node and then use the lack of ready nodes as a reason to work solo. Dispatch eligible branches through parallel-dispatch; otherwise record the concrete sequential reason inline. Keep trivial work lean and keep RED/GREEN with each implementation.

  1. Read ../../../harness/playbooks/writing-plans.md before creating implementation nodes or task briefs. Run its mandatory agent-harness preflight before decomposition and stop on missing declared prerequisites.
  2. First apply the direct-trivial gate in the playbook. If it passes, edit directly without loading planning artifacts, creating a SPEC/TASK, graphing, TDD, handoff, or review. Otherwise activate automatically after approved first-run discovery, approved feature discovery, or any later request that introduces non-trivial implementation work. The user may invoke this skill explicitly but does not need to.
  3. Use a compact inline spec for bounded same-context work and a plan for larger work. Assign assurance: none|light|full independently. Create TASK/handoff/review packets only for actual separate consumers.
  4. Decompose planned work into ordered, independently checkable units targeting 15–30 minutes of active agent work each. Tool wait time and independent review are outside that target. Justify units outside the range by atomicity, runtime cost, or risk.
  5. Generate a self-contained TASK.md when a separate executor will consume it; a same-context inline node uses a compact inline spec and graph transition. Pin plan revision/step, outcome, owned paths, scoped context, non-goals, acceptance, verification, assurance, stop/replan triggers, and test_strategy. Behavior changes and bug fixes keep focused RED/GREEN in the same unit.
  6. Do not dispatch a non-simple task without an approved/ready plan and complete spec. Do not let the implementer choose product behavior, broaden scope, add dependencies, or improvise around missing decisions; it must stop, persist evidence, and request spec revision.
  7. Optimize planning context: use approved context/feature briefs and scoped source evidence, avoid broad rescans, do not duplicate prose across plan and task, and do not create a separate plan file for simple work.
Changes

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.

  1. yesterday Changed · +2 lines 62aba171ce6e
  2. 6d ago Changed d6ff5bb1b1a6
  3. 11d ago First seen · 15 lines · 45 tokens per session scan A 79d6b2737460

Subscribe to this mod's changes

writing-plans is a skill published in the GitHub repository Eduardo-Salvador/Agent-Harness-Kit (6 stars, last pushed 2d ago), licensed MIT. It adds 45 tokens to every session and 542 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-31.

Related

Other skills, from other repositories

qa

Run scalable, isolated live QA for nac development. The top-level local orchestrator must parse n (default 4), dispatch one setup worker with this skill, copy its n assignment contracts verbatim into exactly n parallel test workers with this skill, then dispatch one aggregate worker with this skill using all test…

arcee-ai/nac · 100 tokens

release

Cut and publish a full stable NAC release after main, release-PR, and publication CI pass. Use when a maintainer asks for a stable version bump, tag, or GitHub Release. Never use for release candidates; NAC RC releases are automated.

arcee-ai/nac · 53 tokens

openrig-user

Use when a specific rig command, subcommand, or flag is already known and you need its exact syntax, JSON shape, defaults, or error meaning. NOT for natural capability discovery, open-ended how-do-I questions, or choosing which OpenRig move applies.

mvschwarz/openrig · 58 tokens

triage

Triage a GitHub repository's open issues by finding exact duplicates, rejecting evidenceably off-base requests, requesting concrete clarification, applying only existing labels, and opening a linked root-cause issue when multiple reports share one underlying invariant failure. Use when a maintainer asks to triage…

arcee-ai/nac · 65 tokens

orienting-to-an-inherited-seat

Use when you have just been primed into an EXISTING seat through a planned handover — a different agent retired and handed you the seat plus its earned context — and you need a world model of what just happened to you. Covers how a handover differs from compaction and from a fresh launch, the…

mvschwarz/openrig · 207 tokens

forming-an-openrig-mental-model

Use when the system around you does not make sense yet: you just booted into a seat and do not know how the pieces fit; someone said rig, pod, seat, fleet, topology, or slice and you are not certain what they mean here; you are unsure what kind of rig you are in or what it is for; you do not know how skills reach you…

mvschwarz/openrig · 117 tokens