Skip to content
cccskills
FreePublished on GitHubEnglish overview

rewrite-plan

Prepare a structured plan for a code rewrite spanning multiple files. It records file responsibilities, ordered changes, and risk levels so later editing, diff review, and build testing can follow a clear, reviewable scope.

OriginalShow the original description

Author a long-running multi-file rewrite plan that subsequent patch-edit + diff-review + build-test stages will execute, with explicit ownership boundaries and patch-safety guarantees.

AI rating90/ 100See how to install

Good for

  • Planning a code rewrite across multiple files
  • Separating component changes from shared infrastructure
  • Ordering changes by scope and risk
  • Preparing a plan for editing, review, and build testing

Overview

What it does

rewrite-plan prepares a work plan before code changes spanning multiple files begin. It classifies files by responsibility: individual components, shared infrastructure, routes, and the overall interface shell. It then orders the work and records the files to change, the reasons, and the risks. Outputs include a human-readable plan.md, plus ownership.json and steps.json for later processing. The plan becomes a reference record for editing, diff review, and build testing.

When it helps

Use it when applying a design direction to existing code, or managing component changes separately from shared infrastructure. Instead of treating an entire component library rewrite as one task, it divides the work by component and places build-test at the end.

Example requests

  • “Plan the changes needed to apply this design direction, including file responsibilities and risks.”
  • “Split the work by component and include build testing at the end.”

Notes

Required inputs are code/index.json from code-import, JSON from token-map, the active DESIGN.md, and your intended changes. Before the later patch-edit stage can edit a file classified as shell, the corresponding step must be marked high risk and receive your explicit confirmation.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt explicitly describes planning before edits and how the plan supports subsequent editing, diff review, and testing.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt specifies inputs, output file structures, completion conditions, component-level task division, and a final build test.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodEditing files classified as shell requires a high-risk designation and explicit user confirmation.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingOutputs from code-import and token-map are required, but instructions for preparing them are absent.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 20, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (2)

  • SKILL.md2.0 KB
  • open-design.json864 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Rewrite plan

Spec §20.3 / §21.3.2: scenario 4 (design → deliverable production code) requires a contract-shaped rewrite plan before the agent starts editing files. The plan is the audit trail every subsequent stage references; without it the patch path slides into "refactor everything that looks wrong" and the build breaks in unreviewable ways.

Inputs

  • code/index.json from code-import.
  • token-map/*.json from token-map.
  • The active design system DESIGN.md (already in prompt).
  • The user's tune intent (typically a short brief).

Output

project-cwd/
└── plan/
    ├── plan.md           # human-readable narrative
    ├── ownership.json    # { file: '...', layer: 'leaf' | 'shared' | 'route' | 'shell' }
    ├── steps.json        # ordered { id, files[], rationale, risk: 'low' | 'medium' | 'high' }[]
    └── meta.json         # { generatedAt, atomDigest, tokenMapDigest }

steps.json is the input patch-edit reads one entry per iteration. ownership.json is the source of truth for "which files belong to a single component vs. shared infrastructure"; patch-edit refuses to touch a shell-tier file unless the matching step has risk: 'high' and the user explicitly confirmed.

Convergence

The atom completes when plan.md is non-empty AND steps.json contains at least one step.

Anti-patterns the prompt fragment forbids

  • Plans that include "rewrite the whole component library" as a single step. Break into per-component steps.
  • Plans that don't classify ownership.
  • Plans that don't list a build-test step at the end.

Status

Implemented by the daemon runner in apps/daemon/src/plugins/atoms/rewrite-plan.ts. It classifies ownership and writes plan.md, steps.json, and ownership.json.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

8-bit-orbit-video-template

FreeSummaryAI rating 90

Create a three-scene video composition in a retro pixel style using a Hyperframes HTML template. Customize titles, labels, and colors while preserving scene transitions, short scene durations, and repeatable animation timing.

  • Create a retro pixel presentation video
  • Customize a three-scene video template
  • Preview scene transitions and motion in HTML
nexu-io/open-design102.8KUpdated Oct 20, 2026

ad-creative

FreeSummaryAI rating 80

Create and revise headlines, descriptions, and main text for paid social and search ads. Use it to develop ad copy options and refine wording through repeated rounds of revision.

  • Drafting headlines for paid social ads
  • Creating descriptions for search ads
  • Revising the main text of an ad
nexu-io/open-design102.8KUpdated Oct 20, 2026

after-hours-editorial-template

FreeSummaryAI rating 80

Create a three-page editorial motion sequence with dark backgrounds, serif typography, staged text reveals, and chapter transitions. The result is a single HTML file suited to fashion-inspired storytelling and short visual presentations.

  • Creating a fashion-inspired motion presentation
  • Presenting a short story across three pages
  • Applying existing brand rules to a dark editorial sequence
nexu-io/open-design102.8KUpdated Oct 20, 2026

agent-browser

FreeSummaryAI rating 100

Inspect and test web pages through a browser automation command-line tool. Navigate, click, enter text, capture screenshots, and extract page details, with a focus on checking local OpenDesign previews and reviewing web app quality.

  • Checking local OpenDesign previews
  • Testing clicks and text entry in web apps
  • Capturing page or element screenshots
nexu-io/open-design102.8KUpdated Oct 20, 2026

ai-music-album

FreeSummaryAI rating 80

Plan an AI music album from its concept through lyric drafts, track order, and export. Intended for independent album experiments and brand soundtracks, with the full production workflow provided through a separately installed upstream bundle.

  • Planning an experimental independent album
  • Drafting lyrics around an album concept
  • Deciding the running order of tracks
nexu-io/open-design102.8KUpdated Oct 20, 2026

algorithmic-art

FreeSummaryAI rating 80

Create generative art, or images made with programmed rules, using p5.js. Fixed random seeds make each rendering reproducible, supporting procedural posters, still images that suggest motion, and studies of artistic frame composition.

  • Posters generated with programmed rules
  • Still images that suggest motion
  • Studies of artistic frame composition
nexu-io/open-design102.8KUpdated Oct 20, 2026

See all skills by nexu-io

Report a problem with this skill