Skip to content

fresh-clone 1.0

Latest

Choose a tag to compare

@vSkyfall vSkyfall released this 03 Nov 21:13

Does your README still work? Claude tries it and tells you.

fresh-clone is a Claude Code skill that clones your repo into a throwaway folder, follows your README like a brand-new user, really runs every command, and reports where people get stuck.

demo

What's in 1.0

  • Runs your README for real: every command, in a fresh clone, with timeouts. Servers are started, their URLs checked, then stopped.
  • Time to first run: one headline number per report. Fix your README and watch it go from never to 9s.
  • Add / remove, with evidence: every suggestion cites the commit, file or error behind it.
  • One fix at a time: each fix is a Yes / No question, with Other to say it your own way. Nothing changes until you say yes.
  • Pull request: accepted fixes go on a new branch; your current branch is never touched.
  • Clean-machine mode: optional Docker run that catches prerequisites your README forgets.
  • Translation check: finds README.tr.md, README.zh.md… that still say the old commands.

Install

git clone https://github.com/vSkyfall/fresh-clone ~/.claude/skills/fresh-clone

Then type /fresh-clone in any repo.