Claude-skill-registry clean-project
Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/pnpm) are in an inconsistent state.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/clean-project" ~/.claude/skills/majiayu000-claude-skill-registry-clean-project && rm -rf "$T"
manifest:
skills/data/clean-project/SKILL.mdsource content
Clean Project (Hard Reset)
This skill provides a destructive but thorough way to repair a "broken" development environment by removing all cached artifacts and re-initializing from scratch.
When to Use
fails repeatedly with checksum or resolution errors.pnpm install
reports internal errors that persist aftertrunk
.trunk install- "Ghost" errors occur (failures that don't match the current code).
Workflow
-
Clean Dependencies:
- Recursively delete
:node_modules
.find . -name "node_modules" -type d -prune -exec rm -rf '{}' + - Remove global lockfile:
.rm pnpm-lock.yaml
- Recursively delete
-
Clean Tooling Cache:
- Clear Trunk cache:
.trunk clean - Prune pnpm store:
.pnpm store prune
- Clear Trunk cache:
-
Re-initialize Environment:
- Invoke the
skill to reinstall everything.setup-dev-env
- Invoke the
-
Verify Health:
- Invoke the
subagent (../../agents/verifier.md) to ensure the project is back to a clean, working state.verifier
- Invoke the
Safety Note
This process is destructive to the local environment but safe for the repository. It will require a full download of all dependencies, which may take several minutes depending on network speed.
Resources
- pnpm Commands for Node.js: Common pnpm maintenance commands.
- Trunk CLI Reference: Commands for managing Trunk artifacts.