Back to Skills

issue-worker

verified

Spawn a Claude worker to handle a GitHub issue. Fetches issue details, creates a feature branch, and works autonomously. Use when you want to delegate an issue to a worker.

View on GitHub

Marketplace

karkinos

schmug/karkinos

Plugin

karkinos

development

Repository

schmug/karkinos

karkinos-plugin/skills/issue-worker/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/issue-worker/SKILL.md -a claude-code --skill issue-worker

Installation paths:

Claude
.claude/skills/issue-worker/
Powered by add-skill CLI

Instructions

# Issue Worker Skill

Spawn a Claude worker to handle a GitHub issue.

## Usage

```
/issue-worker <issue-number>
```

## Examples

```
/issue-worker 42
/issue-worker 123
```

## Instructions

When the user invokes `/issue-worker`, follow these steps:

### 1. Fetch Issue Details

```bash
gh issue view <issue-number> --json number,title,body,labels,comments
```

### 2. Generate Branch Name

Create a descriptive branch name from the issue:
- Format: `feat/issue-<number>-<short-description>`
- Example: Issue #42 "Add retry logic" → `feat/issue-42-add-retry-logic`

For bug issues, use `fix/` prefix instead of `feat/`.

### 3. Create Worktree

```bash
BRANCH="feat/issue-<number>-<slug>"
WORKTREE_PATH="../artemis-issue-<number>"
git worktree add "$WORKTREE_PATH" -b "$BRANCH"
```

### 4. Build Task Prompt

Construct a comprehensive prompt for the worker:

```
You are working on GitHub Issue #<number>: <title>

## Issue Description
<body>

## Labels
<labels>

## Comments
<comments if any>

## Your Task
1. Understand the issue requirements
2. Implement the necessary changes
3. Write tests if applicable
4. Commit your changes with message referencing the issue (e.g., "feat: add retry logic (fixes #42)")
5. Push your branch and create a PR

## Guidelines
- Follow existing code patterns in the repository
- Keep changes focused on the issue scope
- Add comments only where logic isn't self-evident
```

### 5. Spawn Worker

```bash
cd "$WORKTREE_PATH" && claude --print --dangerously-skip-permissions "$PROMPT"
```

### 6. Push and Create PR

After the worker completes successfully and has made commits:

```bash
# Push the branch to origin
git push -u origin "$BRANCH"

# Create PR linking to the issue
gh pr create --title "<issue title>" --body "$(cat <<'EOF'
## Summary
<brief description of changes>

Closes #<issue-number>

## Changes
<list of key changes made>

---
šŸ¤– Generated by Claude worker
EOF
)"

# Enable auto-merge (will merge automatically when CI passes)
gh pr merge --aut

Validation Details

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