# Send Shortcut 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": "shortcut",
    "name": "Shortcut",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/catwalksophie/shortcut",
    "canonicalUrl": "https://clawhub.ai/catwalksophie/shortcut",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/shortcut",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shortcut",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "scripts/shortcut-add-comment.sh",
      "scripts/shortcut-create-story.sh",
      "scripts/shortcut-create-task.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/shortcut"
    },
    "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/shortcut",
    "downloadUrl": "https://openagent3.xyz/downloads/shortcut",
    "agentUrl": "https://openagent3.xyz/skills/shortcut/agent",
    "manifestUrl": "https://openagent3.xyz/skills/shortcut/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/shortcut/agent.md"
  }
}
```
## Documentation

### Shortcut Kanban Integration

Manage tasks and stories on Shortcut.com project boards via API.

### Prerequisites

Shortcut API token configured via one of:

Environment variable: SHORTCUT_API_TOKEN
File: ~/.config/shortcut/api-token


Access to a Shortcut workspace with appropriate permissions

### Setup

Get your API token from Shortcut.com (Settings → API Tokens)
Store it either:

As environment variable: export SHORTCUT_API_TOKEN="your-token"
In a file: echo "your-token" > ~/.config/shortcut/api-token && chmod 600 ~/.config/shortcut/api-token


Initialize workflow states for your workspace:
scripts/shortcut-init-workflow.sh

This creates ~/.config/shortcut/workflow-states with your workspace's actual state IDs.
Optionally add to ~/.bashrc for persistence:
export SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\\n')
source ~/.config/shortcut/workflow-states

### List Stories

scripts/shortcut-list-stories.sh [--active|--completed|--all] [--json]

Options:

--active - Show only incomplete stories (default)
--completed - Show only completed stories
--all - Include archived stories
--json - Output raw JSON

### Show Story Details

scripts/shortcut-show-story.sh <story-id>

Displays full story information including:

Story name and status
Description (if present)
Checklist items with completion status

### Create Story

scripts/shortcut-create-story.sh "Story name" [--description "text"] [--type feature|bug|chore]

Story types:

feature (default) - New functionality
bug - Bug fix
chore - Maintenance task

### Update Story

scripts/shortcut-update-story.sh <story-id> [--complete|--todo|--in-progress] [--description "new text"]

Workflow states: The script uses state IDs from ~/.config/shortcut/workflow-states (created by shortcut-init-workflow.sh). If not configured, it falls back to common defaults:

Backlog: 500000006
To Do: 500000007
In Progress: 500000008
In Review: 500000009
Done: 500000010

Note: Different Shortcut workspaces may use different state IDs. Always run shortcut-init-workflow.sh to configure your workspace's actual IDs.

### Manage Checklist Tasks

Create a task:

scripts/shortcut-create-task.sh <story-id> "task description"

Update task completion status:

scripts/shortcut-update-task.sh <story-id> <task-id> [--complete|--incomplete]

Edit task description:

scripts/shortcut-edit-task.sh <story-id> <task-id> "new description"

Delete a task:

scripts/shortcut-delete-task.sh <story-id> <task-id>

Use shortcut-show-story.sh to see task IDs.

### Manage Comments

Add a comment:

scripts/shortcut-add-comment.sh <story-id> "comment text"

Update a comment:

scripts/shortcut-update-comment.sh <story-id> <comment-id> "new text"

Delete a comment:

scripts/shortcut-delete-comment.sh <story-id> <comment-id>

Use shortcut-show-story.sh to see comment IDs.

### Workflow

List existing stories to understand current board state
Create new stories with descriptive names and appropriate types
Update story status as work progresses

### Notes

Scripts use SHORTCUT_API_TOKEN environment variable or fall back to ~/.config/shortcut/api-token
Stories are created in "Unstarted" state by default (workflow_state_id: 500000006)
If your workspace uses different workflow state IDs, you may need to adjust the scripts
The token must have permissions for the workspace you want to manage
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: catwalksophie
- Version: 1.4.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/shortcut)
- [Send to Agent page](https://openagent3.xyz/skills/shortcut/agent)
- [JSON manifest](https://openagent3.xyz/skills/shortcut/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/shortcut/agent.md)
- [Download page](https://openagent3.xyz/downloads/shortcut)