richfrem/issue-worktree-agent
plugins/dev-utils/skills/issue-worktree-agent/SKILL.md
Skill for creating and managing isolated git worktrees (`.worktrees/issue-NNN`) for issue execution branches. USE ONLY when setting up or cleaning up isolated git worktrees for specific issue execution. DO NOT USE for managing local task files (use `task-agent`) or escalating tasks to issues (use `github-issue-backlog-agent`).
$ install --global
skillsauthnpx skillsauth add richfrem/agent-plugins-skills issue-worktree-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 29, 2026, 3:33 AM210.1s4 files scanned
SKILL.md
- name:
- issue-worktree-agent
- plugin:
- dev-utils
- description:
- >
Issue Worktree Agent (issue-worktree-agent)
Routing Directive: USE ONLY when setting up, listing, or removing isolated git worktrees (
.worktrees/issue-NNN) for issue execution branches. DO NOT USE for managing local scratch tasks (usetask-agentinstead) or managing GitHub PR lifecycles (useissue-pr-lifecycle-agentinstead).
The issue-worktree-agent skill manages isolated workspace environments using git worktree. It ensures agent work on specific issues takes place in isolated branches under .worktrees/issue-NNN without dirtying or interfering with the main working directory.
Safety & Security Contracts
- Path Isolation: All worktrees created by this skill are strictly scoped within
.worktrees/issue-NNN. - Branch Management: Automatically creates feature branches named
issue-NNN(or a custom branch name) off a specified base branch (default:main). - Safe Cleanup: Worktree removal requires explicit call; supports
--forceflag for uncommitted change cleanup.
Usage catalog
Create, List, and Remove Worktrees
- Helper Script:
plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py - CLI Usage:
# Create a worktree for Issue #123: python3 plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py create --issue 123 --base main # List active worktrees: python3 plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py list # Remove a worktree for Issue #123: python3 plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py remove --issue 123
Python API Interface
from plugins.dev_utils.skills.issue_worktree_agent.scripts.issue_worktree_manage import (
create_worktree,
list_worktrees,
remove_worktree,
)
# Create worktree
res = create_worktree(issue_number=123, branch_name="fix-issue-123", base_branch="main")
# List worktrees
worktrees = list_worktrees()
# Remove worktree
remove_worktree(issue_number=123, force=False)
Related Skills
richfrem/issue-pr-lifecycle-agent
data-ai
VerifiedTrustedCommunity
Skill for orchestrating the end-to-end GitHub issue lifecycle flow: Issue -> Worktree -> Implementation -> PR Creation -> Resolution Closure. USE ONLY when running or dry-running full lifecycle orchestration for resolving an issue with a PR. DO NOT USE for isolated worktree management only (use `issue-worktree-agent`) or logging issues (use `github-issue-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-prioritizer
tools
VerifiedTrustedCommunity
Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-backlog-agent
testing
VerifiedTrustedCommunity
Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-agent
testing
VerifiedTrustedCommunity
Agent skill for safe, dry-run-first, deduplicated, root-cause-consolidated, evidence-validated, and secret-redacted logging of repository execution friction into GitHub Issues. USE ONLY for durable repository bugs, execution friction (T1-T3), map debt, and architectural improvements. DO NOT USE for temporary intra-session checklists (use task-agent instead).
4SKILL.mdUpdated Jul 29, 2026