# Send Bolt Sprint to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bolt-skill",
    "name": "Bolt Sprint",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ndhill84/bolt-skill",
    "canonicalUrl": "https://clawhub.ai/ndhill84/bolt-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bolt-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bolt-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/api-reference.md",
      "references/workflows.md",
      "scripts/bolt.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "bolt-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T15:34:37.167Z",
      "expiresAt": "2026-05-07T15:34:37.167Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bolt-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bolt-skill",
        "contentDisposition": "attachment; filename=\"bolt-skill-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "bolt-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/bolt-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bolt-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/bolt-skill",
    "agentUrl": "https://openagent3.xyz/skills/bolt-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bolt-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bolt-skill/agent.md"
  }
}
```
## Documentation

### Bolt Sprint Management Skill

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.

### Configuration

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}

### List Projects

curl -s \\
  ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \\
  "$BOLT_BASE_URL/api/v1/projects"

### List Sprints for a Project

curl -s \\
  ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \\
  "$BOLT_BASE_URL/api/v1/projects/$PROJECT_ID/sprints"

### Get Sprint Digest (blockers, story counts, assignee breakdown)

curl -s \\
  ${BOLT_API_TOKEN:+-H "x-bolt-token: $BOLT_API_TOKEN"} \\
  "$BOLT_BASE_URL/api/v1/digests/sprint/$SPRINT_ID"

### List Stories

# 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"

### Create a Story

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"

### Update a Story

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"

### Move a Story (Kanban transition)

# 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"

### Add a Note to a Story

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"

### Log AI Activity

# 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"

### Story Status Values

StatusMeaningwaitingNot started — in the backlog/queuein_progressActively being worked oncompletedDone

### Priority Values

low · med · high · urgent

### Key API Behaviors

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.

### References

Full API endpoint reference: references/api-reference.md
Workflow patterns and recipes: references/workflows.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ndhill84
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T15:34:37.167Z
- Expires at: 2026-05-07T15:34:37.167Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/bolt-skill)
- [Send to Agent page](https://openagent3.xyz/skills/bolt-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/bolt-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bolt-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/bolt-skill)