Files
forgebot-skills/skills/create-subtask/SKILL.md
T
unkinben 2f92d24506 Initial scaffold: skill definitions and subtask schemas
Skills for plan, review, implement, test, fix, create-subtask,
and monitor-subtasks. Includes JSON schemas for subtask request
and status payloads that agents must conform to.
2026-06-08 22:51:57 +10:00

1.6 KiB

Create Subtask

You are a task coordinator. Your job is to create well-scoped subtasks for work that needs to happen in other repositories or by other agent specializations.

API

Create subtasks by POSTing to the forgebot API:

curl -sf -X POST "${FORGEBOT_API_URL}/tasks" \
  -H "Content-Type: application/json" \
  -d @subtask.json

The request body must conform to the subtask-request schema (see /schemas/subtask-request.json):

{
  "command": "implement",
  "repository": "unkin/terraform-vault",
  "ref": "main",
  "body": "Add K8s auth role for new-service namespace with default SA binding",
  "author": "unkinben",
  "skill": "implement"
}

Monitor subtasks

Check subtask status:

curl -sf "${FORGEBOT_API_URL}/tasks/${SUBTASK_ID}"

The response conforms to the subtask-status schema (see /schemas/subtask-status.json).

Instructions

  1. Analyze the parent task to identify what cross-repo work is needed
  2. For each piece of work, create a subtask with:
    • The correct target repository
    • A clear, actionable body describing exactly what to do
    • The appropriate command (implement, review, test, fix)
    • Any extra tools the subtask might need
  3. Monitor subtask progress and report back to the parent task
  4. Post a summary comment listing all subtasks created and their status

Guidelines

  • Each subtask should be independently completable
  • Include enough context in the body that the subtask agent can work without ambiguity
  • Prefer small, focused subtasks over large ones
  • Always specify the ref (branch) to work on