shortcut-skill
by incognos
Browser & AutomationBrief
Access and manage Shortcut.com (formerly Clubhouse) project management.
Description
What This Skill Does
Connects to Shortcut.com (formerly Clubhouse) via the REST API v3 to read and write stories, epics, and workflows. Supports listing, searching, creating, updating, and commenting on work items, plus wiring story dependencies.
Lets you query and update Shortcut directly from a terminal or agent without opening the web app, which reduces context-switching during development.
When to Use It
- Look up a specific story by sc-XXXX ID
- List all stories currently assigned to you
- Create a bug report with labels and estimate
- Move a story to a different workflow state
- Set one story as a blocker for another
Example Workflow
User asks: create a feature story titled 'Add dark mode toggle' under the UI epic with a 3-point estimate
- 1
Verify SHORTCUT_API_TOKEN is available
- 2
Fetch workflows to get the target workflow state ID
- 3
Fetch epics to find the UI epic ID
- 4
Build request body using jq -n --arg to safely escape user input
- 5
POST to /stories and return the new story ID and app_url
sc-5678 — Add dark mode toggle [feature, 3pts] created at app.shortcut.com/...
Requirements
- SHORTCUT_API_TOKEN — generate at app.shortcut.com → Settings → API Tokens
Installation
clawhub install incognos/shortcut-skillRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.