shortcut – OpenClaw Skill

---

name: shortcut version: 1.0.0 description: Manage stories on Shortcut.com kanban boards. Use when creating, updating, or listing tasks/stories on Shortcut project management boards. Supports creating stories with descriptions and types (feature/bug/chore), updating story status, and listing active/completed stories.

Shortcut Kanban Integration

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

Prerequisites

• Shortcut API token stored at /root/secrets/shortcut-api-token
• Access to a Shortcut workspace with appropriate permissions

Available Operations

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

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> [--state started|done|unstarted] [--description "new text"]

Workflow state IDs vary by workspace. Common defaults:

• Unstarted (typically 500000006)
• Started (typically 500000007)
• Done (typically 500000008)

To find your workspace's state IDs, use the Shortcut API or check your board settings.

Workflow

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

Notes

• All scripts require sudo access to read the API token from /root/secrets/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

Shortcut Skill for OpenClaw

Manage stories on Shortcut.com kanban boards directly from your OpenClaw agent.

Features

• List stories - View active, completed, or all stories on your board
• Create stories - Add new tasks with descriptions and types (feature/bug/chore)
• Update stories - Change story status and descriptions

Installation

# Install via OpenClaw skills system
openclaw skills install shortcut

Or manually:

1. Download shortcut.skill from releases
2. Place in your OpenClaw skills directory
3. Restart OpenClaw gateway

Prerequisites

• Shortcut.com account with API access
• API token stored at /root/secrets/shortcut-api-token
• Token must have permissions for the workspace(s) you want to manage

Usage

Once installed, your OpenClaw agent can handle requests like:

• "Add a story to the board: Fix login bug"
• "Show me active stories on Shortcut"
• "Mark story #38 as started"

Scripts

The skill includes three bash scripts:

• shortcut-list-stories.sh - List stories with filters
• shortcut-create-story.sh - Create new stories
• shortcut-update-story.sh - Update existing stories

All scripts use the Shortcut API v3.

Configuration

The skill expects:

• Shortcut API token at /root/secrets/shortcut-api-token
• Access to a Shortcut workspace with appropriate permissions

Note: Default workflow state IDs (500000006 for Unstarted, etc.) may vary by workspace. If stories aren't appearing in the expected state, check your workspace's workflow configuration.

License

MIT

Author

Sophie Bobbins (@catwalksophie)