trouble-shooting

• Risk level: Low
• Analyzed: Apr 24, 2026, 7:47 AM
• Findings: 0
• Version: 1.0.0

Overview

This skill's behavior (creating git worktrees or subagents, saving snapshots, applying or discarding changes) is consistent with its stated purpose, but it assumes git and will modify the repository working tree/branches and write local files — review and back up your repo before use.

Before installing or running this skill: 1) Be aware it expects git to be available (scripts call git commands) though git is not declared; install git if needed. 2) The scripts will create a .trouble-shooting directory, temporary worktree folders, and temporary git branches (named trouble/<id>), and may merge changes into your current branch or delete branches — back up or commit/uncommitted-work stash before using. 3) Review the three included Python scripts (start/finish/list) — they run local subprocesses and modify the repo; ensure you trust them in your environment. 4) During 'apply' the tool attempts an automatic merge (git merge --no-edit) and will fail if conflicts exist; be prepared to resolve conflicts manually. 5) If you need stricter safety, run start_troubleshoot.py in 'subagent' mode (no worktree) or run the scripts in a disposable clone first. If you want higher assurance, ask the author to declare git as a required binary and to add explicit confirmation prompts before destructive operations.