Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage software development sprints and stories in Bolt. Use for creating/updating stories, moving tasks through the Kanban workflow (waiting → in_progress →...
Manage software development sprints and stories in Bolt. Use for creating/updating stories, moving tasks through the Kanban workflow (waiting → in_progress →...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Bolt is a collaborative software development platform built for human-AI teamwork. This skill lets you manage projects, sprints, and stories through Bolt's REST API.
Set these environment variables before using this skill: export BOLT_BASE_URL="http://localhost:4000" # Your Bolt API base URL export BOLT_API_TOKEN="your-token-here" # Optional: only needed if server was started with BOLT_API_TOKEN The base curl pattern for authenticated requests: curl -s \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/..." Check connectivity before starting: curl -s "$BOLT_BASE_URL/health" # → {"ok":true}
curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/projects"
curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/projects/$PROJECT_ID/sprints"
curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/digests/sprint/$SPRINT_ID"
# All stories in a sprint curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/stories?sprintId=$SPRINT_ID&limit=100" # Only blocked stories curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/stories?sprintId=$SPRINT_ID&blocked=true" # Delta sync — only stories changed since a timestamp curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/stories?updated_since=2024-01-01T00:00:00Z" # Request only specific fields to reduce token usage curl -s \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ "$BOLT_BASE_URL/api/v1/stories?sprintId=$SPRINT_ID&fields=id,title,status,blocked,priority"
curl -s -X POST \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{ "title": "Story title", "projectId": "'"$PROJECT_ID"'", "sprintId": "'"$SPRINT_ID"'", "description": "What needs to be done", "acceptanceCriteria": "Definition of done", "priority": "high", "status": "waiting", "points": 3 }' \ "$BOLT_BASE_URL/api/v1/stories"
curl -s -X PATCH \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{"blocked": true, "priority": "urgent"}' \ "$BOLT_BASE_URL/api/v1/stories/$STORY_ID"
# Single story curl -s -X POST \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{"status": "in_progress"}' \ "$BOLT_BASE_URL/api/v1/stories/$STORY_ID/move" # Batch move multiple stories at once curl -s -X POST \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{ "items": [ {"id": "story-1", "status": "completed"}, {"id": "story-2", "status": "completed"} ], "all_or_nothing": true }' \ "$BOLT_BASE_URL/api/v1/stories/batch/move"
curl -s -X POST \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{"body": "Note content here", "author": "AI", "kind": "note"}' \ "$BOLT_BASE_URL/api/v1/stories/$STORY_ID/notes"
# Post an event to the agent session (creates session if it doesn't exist) curl -s -X POST \ -H "Content-Type: application/json" \ ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \ -d '{"message": "Analyzing codebase to implement story", "type": "action"}' \ "$BOLT_BASE_URL/api/v1/agent/sessions/$SESSION_ID/events"
StatusMeaningwaitingNot started — in the backlog/queuein_progressActively being worked oncompletedDone
low · med · high · urgent
Idempotency: Include Idempotency-Key: <uuid> header on POST/PATCH to safely retry without duplicates (48-hour TTL). Pagination: Responses include page.nextCursor and page.hasMore. Pass cursor=<value> to fetch the next page. Default limit 50, max 200. Field projection: Use ?fields=id,title,status to request only the fields you need — reduces payload size and token cost. Delta sync: Use ?updated_since=<ISO8601> to fetch only items changed since a timestamp — efficient for polling. Error format: All errors return { "error": { "code": "...", "message": "..." } }. Rate limits: Write methods capped at 120 requests/minute per IP.
Full API endpoint reference: references/api-reference.md Workflow patterns and recipes: references/workflows.md
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.