superpowers-isolated-workspace

What This Skill Does

The superpowers-isolated-workspace skill is an essential developer tool designed for OpenClaw agents to manage feature development with surgical precision. It automates the creation of isolated git environments by enforcing a rigorous workflow: checking for existing workspace structures, verifying directory exclusion via .gitignore, and automatically configuring project dependencies. Instead of relying on complex git worktree configurations which can be volatile in WSL-based OpenClaw environments, this skill uses a stable git branch and directory management strategy. It ensures that every new feature starts from a clean, validated baseline, drastically reducing the risk of environment contamination and 'it works on my machine' bugs.

Installation

To integrate this into your agent, run the following command in your terminal: clawhub install openclaw/skills/skills/axelhu/superpowers-isolated-workspace

Use Cases

• Starting a new feature development session after a brainstormed design is approved.
• Refactoring existing codebases where you need a 'sandbox' that is isolated from the main branch.
• Onboarding to a new project where dependency installation and environment validation are repetitive manual tasks.
• Rapidly pivoting between multiple feature branches without polluting the root workspace or causing dependency conflicts.

Example Prompts

1. "I've finished the design for the new authentication module. Can you use isolated-workspace to set up the environment and start on the implementation?"
2. "We need to fix a critical bug in the legacy parser. Please create an isolated workspace for this work and ensure the test suite is passing before I start coding."
3. "Let's begin the refactor of the API layer. Please initialize a new feature branch and set up the local project dependencies."

Tips & Limitations

• Safety First: Always allow the agent to verify your .gitignore. If the agent requests that a directory be added to your ignore file, approve it to prevent local build artifacts from being committed to the repository.
• Dependency Detection: The skill detects package.json, requirements.txt, Cargo.toml, and go.mod. If you use custom build tools or nix-shells, you may need to supplement the initial setup manually.
• Baseline Testing: Always pay attention to the test output. If the baseline fails, the skill will halt. It is better to debug the base branch than to pile new features on top of a broken build.
• Environment Compatibility: This skill is optimized specifically for OpenClaw (WSL). If you find yourself in a non-standard shell environment, ensure your git configuration supports the branch-based isolation pattern.