clean-copy

v2026.09.24

Reimplement the current branch on a new branch with a clean, narrative-quality git commit history. Use when asked to make a clean copy branch, clean up commit history by replaying work, or rebuild a branch as reviewable commits.

GitHub
Install command
npx skhub add tldraw/clean-copy
Markdown
SKILL.md

Clean copy

Reimplement the current branch on a new branch with a clean, narrative-quality commit history suitable for reviewer comprehension.

Workflow

  1. Gather context:
    • Source branch: git branch --show-current.
    • Working tree: git status --short.
    • Commits since main: git log main..HEAD --oneline.
    • Diff summary: git diff main...HEAD --stat.
  2. Validate the source branch:
    • Ensure there are no uncommitted changes or merge conflicts.
    • Confirm the source branch is up to date with main.
  3. Choose the new branch name:
    • Use the user's requested name when provided.
    • Otherwise use <source-branch>-clean.
  4. Analyze the diff:
    • Study all changes between the source branch and main.
    • Understand the final intended state before recreating it.
  5. Create the clean branch from main.
  6. Plan the commit storyline:
    • Break the implementation into self-contained logical steps.
    • Each step should read like a stage of development in a tutorial.
  7. Reimplement the work:
    • Recreate the final changes step by step.
    • Commit after each coherent idea.
    • Use clear commit subjects and descriptions.
    • Use git commit --no-verify for intermediate commits so hooks do not block temporarily incomplete states.
  8. Verify correctness:
    • Confirm the final clean branch state exactly matches the original source branch.
    • Run the final commit without --no-verify so normal checks run.
  9. Open a pull request using the pr skill.
    • Include a link to the original branch in the PR description.

Rules

  • Never add yourself or an AI tool as an author, contributor, or co-author.
  • Never include AI attribution in commits or PR content.
  • The final clean branch must be identical to the source branch.
  • Do not force push unless the user explicitly asks for it.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

NOASSERTION

Source path

skills/clean-copy

Default branch

main

Latest commit

e8e194c

Tree SHA

9f5d082