# Send NextCloud Deck Tracker 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": "openclaw-deck-tracker",
    "name": "NextCloud Deck Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/SkanderHelali/openclaw-deck-tracker",
    "canonicalUrl": "https://clawhub.ai/SkanderHelali/openclaw-deck-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-deck-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-deck-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-deck-tracker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T18:27:24.842Z",
      "expiresAt": "2026-05-07T18:27:24.842Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-deck-tracker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-deck-tracker",
        "contentDisposition": "attachment; filename=\"openclaw-deck-tracker-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "openclaw-deck-tracker"
      },
      "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/openclaw-deck-tracker"
    },
    "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/openclaw-deck-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-deck-tracker",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-deck-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-deck-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-deck-tracker/agent.md"
  }
}
```
## Documentation

### Deck Tracker v1.0.0

Track tasks on a NextCloud Deck board.

### Board Structure

This skill assumes a board with 4 stacks (columns):

StackDefault IDPurposeQueue1New incoming tasksIn Progress2Currently working onWaiting3Blocked/waiting for userDone Today4Completed tasks

### Configuration

Set the following environment variables (e.g. in your .bashrc or OpenClaw config):

export DECK_URL="https://your-nextcloud.com/index.php/apps/deck/api/v1.0"
export DECK_USER="your_username"
export DECK_PASS="your_app_password" # Use an App Password!
export BOARD_ID=1

If your stack IDs differ from the defaults (1, 2, 3, 4), override them:

export STACK_QUEUE=10
export STACK_PROGRESS=11
export STACK_WAITING=12
export STACK_DONE=13

### List all cards on the board

deck list

### Add a new task to Queue

deck add "Task title" "Optional description"

Options:

--progress: Automatically move the new card to "In Progress" immediately.
--stack <id>: Create in a specific stack ID (default: Queue).

Example with auto-start:

deck add "Urgent Fix" "Fixing production bug" --progress

### Move a card to a different stack

deck move <card_id> <queue|progress|waiting|done>

### Get card details

deck get <card_id>

### Update card title/description

deck update <card_id> [--title "New title"] [--description "New desc"]

### Log a status update to a card

deck log <card_id> <status> "Message"

Statuses: progress, success, error, warning, info.

### Start automated heartbeat monitoring

deck monitor <card_id> [target_id]

Spawns a background process that appends a "Still working..." log entry every 60 seconds. Additionally, it sends a chat notification to the specified target_id (defaults to Skander) every 120 seconds. The process terminates automatically when the card is moved out of the "In Progress" stack (to Done or Waiting). Use for tasks expected to take >2 minutes.

### Dump all completed tasks as JSON

deck dump-done

Outputs the JSON payload for all cards in "Done Today". Useful for memory synthesis.

### Archive all completed cards

deck archive-done

Moves all cards in "Done Today" to the archived state. Useful for daily cleanup via cron.

### Delete a card

deck delete <card_id>

### Workflow & Memory Protocol

New task arrives → deck add "Title" "Rich Initial Description" (Use --progress to start immediately).
Detailed Descriptions: Start descriptions with Objective, Plan, and Constraints.
Log updates → deck log <id> progress "Finished step 1".
Closing Task: Use deck update <id> --description "Rich Summary" to include Technical Summary, Operations Performed, and Outcome.
Memory Synthesis: Before archiving, use deck dump-done to parse the day's work and reinforce long-term memory.
Daily cleanup → deck archive-done.

### 🚨 AI Protocol: Complex Descriptions

When updating cards with multi-line markdown descriptions, ALWAYS use the temp file method to prevent shell expansion errors:

# 1. Write rich description to temp file
cat > /tmp/deck_desc_<id>.txt << 'EOF'
[Rich Markdown]
EOF

# 2. Update deck using the temp file
deck update <id> --description "$(cat /tmp/deck_desc_<id>.txt)"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: SkanderHelali
- Version: 0.1.1
## 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-30T18:27:24.842Z
- Expires at: 2026-05-07T18:27:24.842Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-deck-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-deck-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-deck-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-deck-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-deck-tracker)