open-board

Files (1)

• SKILL.md

SKILL.md (first lines)

# Open the Cowork Tasks board

Always reuse the same artifact id. The flow has no failed steps in any path.

## Canonical identifiers

| Field | Value |
|---|---|
| Artifact id | `cowork-tasks` |
| Artifact name | `Cowork Tasks` |
| Output filename | `cowork-tasks-board.html` |

## Steps

1. **Pick the session output path** (the writable directory Cowork exposes
   for generated files). Build:

   ```
   <outputs>/cowork-tasks-board.html
   ```

2. **Write the HTML** (one MCP call):

   ```
   cowork-tasks:prepare_board_artifact { "outPath": "<outputs>/cowork-tasks-board.html" }
   ```

   Returns `{path, bytes, tasks, version, pluginVersion}`. The HTML is on
   disk; the response does NOT include the body.

3. **Optional version check** (cached):

   ```
   cowork-tasks:check_version { }
   ```

4. **List artifacts**:

   ```
   cowork.list_artifacts { }
   ```

   Look for `id == "cowork-tasks"`.

   If the list is non-empty, derive `artifactsDir` from any returned path:
   it's the parent directory of the per-artifact folder. For example,
   `/Users/foo/Documents/Claude/Artifacts/some-id/index.html` →
   `artifactsDir = /Users/foo/Documents/Claude/Artifacts`.

5. **Branch on existence**:

   ### A. `cowork-tasks` IS in the manifest

   Update directly. Always pass the same `mcp_tools` allowlist on
   update, in case Cowork ever clears it on update_artifact:

   ```
   cowork.update_artifact {
     "id": "cowork-tasks",
     "html_path": "<outputs>/cowork-tasks-board.html",
     "mcp_tools": [
       "mcp__cowork-tasks__list_tasks",
       "mcp__cowork-tasks__get_task",
       "mcp__cowork-tasks__get_tasks_bulk",
       "mcp__cowork-tasks__create_task",
       "mcp__cowork-tasks__create_tasks",
       "mcp__cowork-tasks__update_task",
       "mcp__cowork-tasks__move_task",
       "mcp__cowork-tasks__archive_task",
       "mcp__cowork-tasks__delete_task",
       "mcp__cowork-tasks__restore_task",
       "mcp__cowork-tasks__rename_label",
       "mcp__cowork-tasks__list_config",
       "mcp__cowork-tasks__update_config",
       "mcp__cowork-tasks__is_processed",
       "mcp__cowork-tasks__mark_processed"
     ]
   }
   ```

   Done. Total: 4 tool calls.

   ### B. `cowork-tasks` is NOT in the manifest

   Cowork's UI deletes manifest entries but leaves folders on disk.
   **Proactively** clear any stale folder before create. The tool
   no-ops cleanly when nothing exists:

   ```
   cowork-tasks:clear_artifact_folder {
     "artifactsDir": "<derived-dir>",
     "id": "cowork-tasks"
   }
   ```

   Returns `{existed, deleted, path}`. Either result is fine - no error.

   Then create. **`mcp_tools` is the allowlist** of MCP calls the
   artifact's HTML is permitted to make at runtime via
   `window.cowork.callMcpTool`. Without this, every read/write from the
   board fails silently. Always include the full set:

   ```
   cowork.create_artifact {
     "id": "cowork-tasks",
     "name": "Cowork Tasks",
     "html_path": "<outputs>/cowork-tasks-board.html",
     "mcp_tools": [
       "mcp__cowork-tasks__list_tasks",
       "mcp__cowork-tasks__get_task",
       "mcp__cowork-tasks__get_tasks_bulk",
       "mcp__cowork-tasks__create_task",
       "mcp__cowork-tasks__create_tasks",
       "mcp__cowork-tasks__update_task",
       "mcp__cowork-tasks__move_task",
       "mcp__cowork-tasks__archive_task",
       "mcp__cowork-tasks__delete_task",
       "mcp__cowork-tasks__restore_task",
       "mcp__cowork-tasks__rename_label",

From sabbah13/cowork-tasks, MIT.

More from sabbah13/cowork-tasks