Home / coco-research / coco · skills/writing-plans/SKILL.md · GitHub

writing-plans skillA

writing-plans is agent-read markdown (skill) from coco-research/coco: Use when you have a spec or requirements for a multi-step task, before touching code.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Writing Plans

## Overview

Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.

Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well.

**Announce at start:** "I'm using the writing-plans skill to create the implementation plan."

**Context:** This should be run in a dedicated worktree (created by brainstorming skill).

**Save plans to:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`
- (User preferences for plan location override this default)

## Scope Check

If the spec covers multiple independent subsystems, it should have been broken into sub-project specs during brainstorming. If it wasn't, suggest breaking this into separate plans — one per subsystem. Each plan should produce working, testable software on its own.

## File Structure
…

Read the whole file at its exact version.

How to install

Latest version
mdr add coco-research/coco/writing-plans@git:20260802.1479e32
Exact content
mdr add coco-research/coco/writing-plans@sha256:7918561e537aa0f5

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260802.1479e32 latest2026-08-02 1479e32 5,482 BA view · diff
git:20260426.d53cc6c2026-04-26 d53cc6c 5,461 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (5482 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

coco-research/coco · 478 stars · license NOASSERTION · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_re7cootamgiyh7y5
GET https://markdownregistry.com/api/v1/resolve?ref=coco-research/coco/writing-plans
GET https://markdownregistry.com/api/v1/blob/7918561e537aa0f5baec21f1900484f539d29de4e9c5e1bef207ac5ad2590f94

Your agent 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.

More from coco-research/coco

create-rule skill
coco-research/coco · adapters/cursor/skills/create-rule/SKILL.md · Create Cursor rules for persistent AI guidance. Use when the user wants to create a rule, add coding standards, set up…
git:20260426.d53cc6c · audit A · 478 stars
create-skill skill
coco-research/coco · adapters/cursor/skills/create-skill/SKILL.md · Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a…
git:20260426.d53cc6c · audit A · 478 stars
create-subagent skill
coco-research/coco · adapters/cursor/skills/create-subagent/SKILL.md · Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up…
git:20260426.d53cc6c · audit A · 478 stars
migrate-to-skills skill
coco-research/coco · adapters/cursor/skills/migrate-to-skills/SKILL.md · Convert 'Applied intelligently' Cursor rules (.cursor/rules/*.mdc) and slash commands (.cursor/commands/*.md) to Agent…
git:20260426.d53cc6c · audit A · 478 stars
update-cursor-settings skill
coco-research/coco · adapters/cursor/skills/update-cursor-settings/SKILL.md · Modify Cursor/VSCode user settings in settings.json. Use when the user wants to change editor settings, preferences…
git:20260426.d53cc6c · audit A · 478 stars
agent-lightning skill
coco-research/coco · skills/agent-lightning/SKILL.md · Train and optimize AI agents using Microsoft's Agent Lightning framework with reinforcement learning. Use when setting…
git:20260802.1479e32 · audit A · 478 stars
agent-self-eval skill
coco-research/coco · skills/agent-self-eval/SKILL.md · Post-run self-evaluation system that scores agent output on correctness, clarity, actionability, and conciseness. Use…
v0.1.0 · audit A · 478 stars
ai-marketing-videos skill
coco-research/coco · skills/ai-marketing-videos/SKILL.md · Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for…
git:20260914.57d3294 · audit A · 478 stars
ai-product skill
coco-research/coco · skills/ai-product/SKILL.md · Use when building AI features into a product: LLM integration, RAG pipelines, guardrails, streaming, AI UX, prompt…
v0.1.0 · audit A · 478 stars
api-design-principles skill
coco-research/coco · skills/api-design-principles/SKILL.md · Use when designing a new REST or GraphQL API, reviewing an API spec before implementation, setting team API standards…
git:20260914.e75f220 · audit A · 478 stars
pmstudio-arb skill
coco-research/coco · skills/arb-review/SKILL.md · Generate an Architecture Review Board (ARB) presentation in Coco Inc's standard 11-slide format. Use when someone asks…
git:20260802.1479e32 · audit A · 478 stars
arch-index skill
coco-research/coco · skills/arch-index/SKILL.md · Build and validate .arch/index.json — a committed map from each architectural component of this repository to the real…
v1.0.0 · audit A · 478 stars

Every file in coco-research/coco

Other files named writing-plans

writing-plans skill
obra/superpowers · skills/writing-plans/SKILL.md · Use when you have a spec or requirements for a multi-step task, before touching code
git:20260919.5bf4e78 · audit A · 291,204 stars
writing-plans skill
jnmetacode/superpowers-zh · skills/writing-plans/SKILL.md · 当你有规格说明或需求用于多步骤任务时使用,在动手写代码之前
v1.0.0 · audit A · 8,203 stars
writing-plans skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/writing-plans/SKILL.md · Use when you have a spec or requirements for a multi-step task, before touching code. Creates bite-sized TDD…
git:20260601.da7723a · audit A · 1,809 stars
writing-plans skill
ganyuanran/aegis · skills/writing-plans/SKILL.md · Use when you have an approved spec or written requirements for a multi-step task that needs a durable plan document…
git:20260916.9a51c7a · audit A · 1,280 stars
writing-plans skill
mateaix/mateclaw · mateclaw-server/src/main/resources/skills/writing-plans/SKILL.md · Write implementation plans: bite-sized tasks, paths, code.
v1.1.0 · audit A · 1,127 stars
writing-plans skill
jamditis/claude-skills-journalism · superjawn/skills/writing-plans/SKILL.md · Use when you have a spec or requirements for a multi-step task, before touching code
git:20260818.3e0e3a8 · audit A · 401 stars
writing-plans skill
dev-toolings/superpowers-symfony · content/skills/writing-plans/SKILL.md · Create structured implementation plans for Symfony features with clear steps, dependencies, and acceptance criteria
git:20260917.3d83f4c · audit A · 216 stars
writing-plans skill
arbiterforge/codearbiter · plugins/ca-codex/routines/writing-plans/SKILL.md · The spec-to-plan bridge. /feature supplies an approved spec; initial full-lane HTML sprint review may supply a ready…
git:20260924.cf90ce4 · audit A · 145 stars

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