task-storelisted

# Task Store — Skill Use this skill to interact with the Shipwright task store via its HTTP API. The task store is a REST service — call it with curl, no script discovery needed. > **The HTTP API is the only interface.** Never edit the underlying database directly. > The unit you work with is the **task** (see [task-schema.md](references/task-schema.md)). --- ## Setup Before using this skill, verify the required environment variables are set: ```bash echo "URL: ${SHIPWRIGHT_TASK_STORE_URL:-(missing)}" echo "Token: ${SHIPWRIGHT_TASK_STORE_TOKEN:+(set)}" ``` **`SHIPWRIGHT_TASK_STORE_URL` missing?** Contact your administrator — this URL is provisioned at deployment time and is not something you generate yourself. **`SHIPWRIGHT_TASK_STORE_TOKEN` missing?** Create a scoped token: 1. Open your Shipwright admin UI at `<admin-url>/admin/tokens` 2. Click **Create token** and enter a descriptive label (e.g. `my-local-agent`) 3. **Agent ID field** — leave blank for local or HITL use; enter your agent's ID for managed Shipwright agents 4. Copy the generated token and wire it up: - **Local plugin / shell:** `export SHIPWRIGHT_TASK_STORE_TOKEN=<token>` - **Managed Shipwright agent:** add `SHIPWRIGHT_TASK_STORE_TOKEN=<token>` as an agent env var via the Shipwright admin UI — it takes effect within 60 seconds, no restart needed **HITL note:** For local HITL execution (`/shipwright:hitl`), create an admin token with **Agent ID left blank** — this keeps the token unscoped so