execute-subtask
DEPRECATED: This skill has been renamed. Please use
agkan-subtaskinstead.Skill("agkan-subtask")
execute-subtask
Overview
Workflow to implement a selected task on a fork (worktree), create a PR, and complete the task.
About context: fork in frontmatter
The context: fork field in the frontmatter indicates that this skill is designed to run in an isolated worktree (forked context). When an Agent invokes this skill, it executes in a separate worktree environment rather than the current working directory. This isolation ensures that branch creation and file changes do not interfere with the parent context.
Workflow
1. Create Branch
git checkout -b <branch-name>
Branch name is generated from task ID and title (example: feat/42-add-login-page).
2. Write Branch Name to Task
# First, retrieve the existing body
agkan task get <id> --json
# Write body to tmp file and update using --file to preserve newlines
cat > /tmp/agkan_body_$$.md << 'BODY'
<existing body>
Branch: <branch-name>
BODY
agkan task update <id> --file /tmp/agkan_body_$$.md
3. Implementation
Implement according to the task content.
Refer to /key-guidelines during implementation to maintain code quality.
4. Commit and Push
git add -A
git commit -m "<commit message>"
git push -u origin <branch-name>
5. Create PR
gh pr create --title "<title>" --body "<body>"
6. Add PR Information to Task
# First, retrieve the existing body
agkan task get <id> --json
# Write body to tmp file and update using --file to preserve newlines
cat > /tmp/agkan_body_$$.md << 'BODY'
<existing body>
PR: <PR URL>
BODY
agkan task update <id> --file /tmp/agkan_body_$$.md
7. Update Task to Review
agkan task update <id> --status review
Important Notes
- Do not mark task as done before PR is merged (mark as done after PR review and merge)
- This skill is used after task selection (task selection is done with
execute-taskskill)
More from gendosu/agkan-skills
agkan-planning-subtask
Use when reviewing a single backlog task to assess decomposition, implementation readiness, and priority ordering.
7agkan
Use when managing tasks with the agkan CLI tool - creating, listing, updating tasks, managing tags, blocking relationships, or tracking project progress with the kanban board.
6agkan-review
Use when checking review tasks against GitHub PR status to automatically move them to done or closed.
6agkan-subtask
Use when a task has been selected and you need to implement it in an isolated (forked) context - handles in_progress update, branch creation, implementation, PR creation, and marking review.
6execute-add
[DEPRECATED] Use agkan-add instead. Use when adding a new task to the backlog — collects title, body, tags, priority, and parent task, then creates it with agkan.
6agkan-run-direct
Use when starting a development session to pick the highest priority Todo task from agkan, implement it directly without PR/branch, and mark it done.
6