Back to Skills

workers

verified

List all active Claude workers and their git worktrees. Shows branch status, commits, and suggests next actions. Use to see what workers are running.

View on GitHub

Marketplace

karkinos

schmug/karkinos

Plugin

karkinos

development

Repository

schmug/karkinos

karkinos-plugin/skills/workers/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/schmug/karkinos/blob/main/karkinos-plugin/skills/workers/SKILL.md -a claude-code --skill workers

Installation paths:

Claude
.claude/skills/workers/
Powered by add-skill CLI

Instructions

# Workers Skill

List and manage active Claude workers.

## Usage

```
/workers
```

## Instructions

When the user invokes `/workers`, show the status of all worktrees and workers:

### 1. List Git Worktrees

```bash
git worktree list
```

### 2. Show Worker Details

For each worktree (excluding main):
- Branch name and last commit
- Files changed vs main
- Whether it's ahead/behind main

```bash
# For each worktree branch
git log <branch> --oneline -1
git diff main...<branch> --stat | tail -1
git rev-list --left-right --count main...<branch>
```

### 3. Format Output

Display as a table:

```
| Worktree | Branch | Last Commit | Changes | Status |
|----------|--------|-------------|---------|--------|
| ../artemis-issue-42 | feat/issue-42-retry | abc123 Add retry | 3 files | +2 ahead |
| ../artemis-feat-logging | feat/add-logging | def456 Add logs | 5 files | +1 ahead |
```

### 4. Suggest Actions

Based on status, suggest:
- Workers with commits → "Ready for PR?"
- Stale worktrees (no recent commits) → "Clean up?"
- Workers behind main → "Rebase needed"

### 5. Quick Actions

Offer shortcuts:
- `/worker-cleanup <worktree>` - Remove a specific worktree
- `/worker-pr <branch>` - Create PR from worker branch
- `/worker-continue <worktree> "additional task"` - Send more work

## Notes

- Only shows worktrees in the parent directory (`../artemis-*`)
- Main repo worktree is always excluded from the list
- Worktrees can be filtered by status if needed

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1451 chars