jsonlee12138/solo-ops
skills/solo-ops/SKILL.md
AI team role manager for multi-agent development workflows. Use when the user wants to create/delete team roles, open role sessions in WezTerm tabs, assign tasks to roles, check team status, or merge role branches. Triggers on /solo-ops commands, "create a team role", "open role session", "assign task to role", "show team status", "merge role branch".
$ install --global
skillsauthnpx skillsauth add jsonlee12138/prompts solo-opsInstall 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: Apr 24, 2026, 9:03 PM1.7s1 file scanned
SKILL.md
- name:
- solo-ops
- description:
- >
solo-ops
Manages AI team roles using git worktrees + WezTerm tabs. Each role runs in its own isolated worktree (branch team/<name>) and opens as a full-permission AI session in a new WezTerm tab.
For directory layout, task format, and bidirectional communication details, see references/details.md.
Usage
The skill base directory is shown at the top when this skill loads. Run directly with:
python3 <base-dir>/scripts/solo_ops.py <command>
Use tmux backend directly with:
python3 <base-dir>/scripts/solo_ops_tmux.py <command>
Commands
Always run from within the project git repository.
Create a role
python3 <base-dir>/scripts/solo_ops.py create <name>
Creates team/<name> git branch + worktree at .worktrees/<name>/. Generates:
agents/teams/<name>/config.yaml— provider, description, pane trackingagents/teams/<name>/prompt.md— role system prompt (edit this to define the role)agents/teams/<name>/tasks/pending/andtasks/done/
After creating, guide the user to edit prompt.md to define the role's expertise and behavior.
Open a role session
python3 <base-dir>/scripts/solo_ops.py open <name> [claude|codex]
- Copies
prompt.md→CLAUDE.mdin worktree root (auto-injected as system context) - Spawns a new WezTerm tab titled
<name>runningclaude --dangerously-skip-permissions(orcodex --dangerously-bypass-approvals-and-sandbox) - Provider priority: argument >
config.yaml default_provider> claude
tmux variant:
python3 <base-dir>/scripts/solo_ops_tmux.py open <name> [claude|codex|opencode] [--model <model>]
Open all sessions
python3 <base-dir>/scripts/solo_ops.py open-all [claude|codex]
tmux variant:
python3 <base-dir>/scripts/solo_ops_tmux.py open-all [claude|codex|opencode] [--model <model>]
Opens every role that has a config.yaml.
Assign a task
python3 <base-dir>/scripts/solo_ops.py assign <name> "<task description>" [claude|codex]
- Writes
agents/teams/<name>/tasks/pending/<timestamp>-<slug>.md - Auto-opens the role session if not running
- Sends a notification message to the running session via
wezterm cli send-text
tmux variant:
python3 <base-dir>/scripts/solo_ops_tmux.py assign <name> "<task description>" [claude|codex|opencode] [--model <model>]
Reply to a role
python3 <base-dir>/scripts/solo_ops.py reply <name> "<answer>"
Sends a reply to a role's running session. Used when a role has asked a question via ask claude and the main controller wants to respond. The message is prefixed with [Main Controller Reply] so the role AI can identify it.
tmux variant:
python3 <base-dir>/scripts/solo_ops_tmux.py reply <name> "<answer>"
Check status
python3 <base-dir>/scripts/solo_ops.py status
Shows all roles, whether their session is running (by pane-id), and pending task count.
Merge completed work
python3 <base-dir>/scripts/solo_ops.py merge <name>
Merges team/<name> into the current branch with --no-ff. Run delete afterward to clean up.
Delete a role
python3 <base-dir>/scripts/solo_ops.py delete <name>
Removes the worktree and deletes the team/<name> branch.
Related Skills
jsonlee12138/makefile
development
VerifiedTrustedCommunity
Use when creating, editing, or validating Makefiles. Provides templates for Go, Node, Python, Docker, and Monorepo projects with self-documenting help targets. Also validates existing Makefiles against conventions. Triggers on: Makefile, makefile, make help, validate makefile, lint makefile.
2SKILL.mdUpdated May 12, 2026
jsonlee12138/claude-design
development
VerifiedTrustedCommunity
Unified design workflow router for critique, accessibility review, developer handoff, design system work, UX copy, user research, and research synthesis. Use when users ask naturally for design feedback, mockup review, a11y audit, handoff specs, UX writing, research planning, research synthesis, or mention Figma, Pencil, or HTML design workflows and should not need to invoke separate sub-skills manually.
2SKILL.mdUpdated May 12, 2026
jsonlee12138/actions-npm
development
VerifiedTrustedCommunity
Use when creating or debugging GitHub Actions workflows that publish npm packages with trusted publishing / OIDC. Triggers on npm publish in CI, ENEEDAUTH, E404 or E422 during publish, tag-triggered releases, setup-node auth behavior, or provenance issues in public vs private GitHub repositories.
2SKILL.mdUpdated Apr 17, 2026
jsonlee12138/vite-tanstack
tools
VerifiedTrustedCommunity
TanStack (Router/Query/Form/Table) configuration guide for Vite + React projects. Covers Vite plugin setup, main.tsx registration, DevTools configuration, and editor settings. Use when setting up or reviewing TanStack config in a Vite project. Triggers on: vite-tanstack, tanstack config, tanstack router setup, tanstack query setup, tanstack form setup, tanstack table setup.
1SKILL.mdUpdated Apr 17, 2026