plan-writing SKILL.md skillA

plan-writing from muaaz9329/cheap-ag is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add muaaz9329/cheap-ag/plan-writing@git:20261102.b2d456f

Pins git:20261102.b2d456f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
muaaz9329/cheap-ag
Path
plugin/skills/plan-writing/SKILL.md
Versions recorded
6
Latest version
git:20261102.b2d456f, committed Nov 2, 2026
First version recorded
Oct 27, 2026
Size
4,585 bytes
Repository stars
274
License
MIT

Write or fix a Cheap Agent plan file before calling the cheapag delegate tool. Use when planning a change of more than ~20 lines or several files for the cheap worker, splitting work into steps, or after delegate rejects a plan.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Writing a Cheap Agent plan

The cheap worker sees the whole plan, then implements the steps you name in `delegate`. It works in an isolated copy of the repo and does only what a step says, so each step must stand on its own: exact files, what to build, and a check that proves it works.

Save plans under `.plan/` in the repository, e.g. `.plan/rate-limit.md` (the developer may read, edit or commit them). Pass the path relative to the repository root.

## Grammar

```
# <plan title>                              ← required, exactly one H1
<shared context, optional, ≤ ~15 lines>
## <id> <short title>                       ← id = integer or integer+letter (3, 3a; s3, step-3 also work)
files: <path>, <dir/>, ...                  ← required; scope + overlap key
do: <what to build; continuation lines indented 2+ spaces>
done-when: <condition>; <condition>         ← required; `backticked` = executed
dont: <constraint>; <constraint>
needs: <step id>, ...
difficulty: easy | medium | hard            ← picks the worker model; wins over delegate's
model: <model>
deps: <package@range>                       ← the step needs a new package
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add muaaz9329/cheap-ag/plan-writing@sha256:71b67d6b14ef647b

The line at the top of this page pins the label git:20261102.b2d456f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_uxzzfs7pz6k2e3d2.svg)](https://markdownregistry.com/a/art_uxzzfs7pz6k2e3d2)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Oct 27, 2026 and Nov 2, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261102.b2d456f latest2026-11-02 b2d456f 4,585 BA view · diff
git:20261029.8d92f4a2026-10-29 8d92f4a 4,306 BA view · diff
git:20261029.d84f1d62026-10-29 d84f1d6 4,155 BA view · diff
git:20261028.56c27b22026-10-28 56c27b2 4,133 BA view · diff
git:20261028.92ba6ff2026-10-28 92ba6ff 3,918 BA view · diff
git:20261027.33079712026-10-27 3307971 3,825 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4585 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

muaaz9329/cheap-ag · 274 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uxzzfs7pz6k2e3d2
GET https://markdownregistry.com/api/v1/resolve?ref=muaaz9329/cheap-ag/plan-writing
GET https://markdownregistry.com/api/v1/blob/71b67d6b14ef647bcd5df0db4acf4a97fbcde5e6b368592c5c650945eb0c02c3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from muaaz9329/cheap-ag

allow SKILL.md skill
muaaz9329/cheap-ag · plugin/skills/allow/SKILL.md · Opt this repository in to sending code to Cheap Agent's worker models - all models, --zdr-only (zero-retention only)…
git:20261102.7b1ee74 · audit A · 274 stars
clean SKILL.md skill
muaaz9329/cheap-ag · plugin/skills/clean/SKILL.md · Remove Cheap Agent's old worktrees and job logs now; --all removes everything not in flight.
git:20261102.7b1ee74 · audit A · 274 stars
hook SKILL.md skill
muaaz9329/cheap-ag · plugin/skills/hook/SKILL.md · Turn Cheap Agent's edit guard on or off for this repo - when on, Claude's large edits (or a 3rd edit to one file in a…
git:20261102.7b1ee74 · audit A · 274 stars
status SKILL.md skill
muaaz9329/cheap-ag · plugin/skills/status/SKILL.md · Show Cheap Agent's status for this repo - running jobs, recent results, consent, and tracked spend against OpenCode Go…
git:20261102.7b1ee74 · audit A · 274 stars

Every file in muaaz9329/cheap-ag

Other files named plan-writing

plan-writing SKILL.md skill
a5c-ai/babysitter · library/methodologies/rpikit/skills/plan-writing/SKILL.md · Transform research findings into actionable implementation plans with stakes-based rigor, test-first strategy, and…
git:20260601.da7723a · audit A · 1,896 stars
plan-writing SKILL.md skill
vodailocz/kilo-kit-mcp · skills/productivity/plan-writing/SKILL.md · Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing…
git:20260502.38d5305 · audit A · 27 stars

Browse by kind, by grade A, or by owner.