Repository navigation
Releases
Releases · vSkyfall/fresh-clone
fresh-clone 1.0
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.
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
neverto9s. - 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.
