shortcut

⚠Review·Scanned 2/17/2026

This skill manages Shortcut.com stories via included shell scripts and CLI helpers. Scripts read SHORTCUT_API_TOKEN / ~/.config/shortcut/api-token, write ~/.config/shortcut/workflow-states, call https://api.app.shortcut.com/api/v3, and instruct running scripts/shortcut-init-workflow.sh.

from clawhub.ai·v1.4.1·22.7 KB·0 installs
Scanned from 1.4.1 at 384f243 · Transparency log ↗
$ vett add clawhub.ai/catwalksophie/shortcutReview findings below

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 from Shortcut.com (Settings → API Tokens)
  • 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

  1. Store your Shortcut API token:

    echo "your-token" > ~/.config/shortcut/api-token
chmod 600 ~/.config/shortcut/api-token

  2. Initialize workflow states for your workspace:

    scripts/shortcut-init-workflow.sh

This will auto-detect your workspace's workflow state IDs and save them to ~/.config/shortcut/workflow-states.

License

MIT

Author

@catwalksophie