Shortcut CLI Skill

Manage Shortcut stories, epics, objectives, iterations, docs, labels, teams, and more via the short CLI tool.

Instructions

When invoked with /shortcut $ARGUMENTS:

1. Check Prerequisites

Verify the short CLI is installed and authenticated:

which short && short --version

• If not found: Guide user through installation (see Prerequisites), then STOP
• If found but version < 5.0.0: Warn user to upgrade (brew upgrade shortcut-cli or npm update -g @shortcut-cli/shortcut-cli)
• If found and >= 5.0.0: Continue to step 2

2. Parse $ARGUMENTS

Route based on argument pattern (in priority order):

Create supports stories, epics, iterations, objectives, docs, and labels — see references/commands.md for each.

Always quote user-provided strings and escape double quotes in input.

3. Present Results

• Story/epic details: Show ID, title, state, owner, description, URL
• Search results: Numbered list with ID, title, state
• Creation: Success message with new item URL
• Lists (teams, labels, iterations, etc.): Clean formatted table

Suggest relevant follow-up actions after presenting results.

4. Handle Errors

Prerequisites

• Node.js >= 20.19.0 (required by shortcut-cli v5+)

# Install via Homebrew (preferred)
brew install shortcut-cli

# Or via npm (fallback)
npm install -g @shortcut-cli/shortcut-cli

# Verify version (expect >= 5.0.0)
short --version

# Authenticate
short install
# Or: export SHORTCUT_API_TOKEN="your-api-token"

Reference