How do I install the Shortcut skill?

Run npx skillmds@latest add dvcrn/shortcut in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Shortcut safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Shortcut?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Shortcut free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Shortcut?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Shortcut by dvcrn — Agent Skill

Name: Shortcut
Rating: 4.2 (5 reviews)
Author: dvcrn

Shortcut

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. Includes full checklist task management and comment support.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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

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

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

---name: shortcutdescription: 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. Includes full checklist task management and comment support.---# Shortcut Kanban IntegrationManage 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### Setup1. Get your API token from Shortcut.com (Settings → API Tokens)2. 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`3. Initialize workflow states for your workspace: ```bash scripts/shortcut-init-workflow.sh ``` This creates `~/.config/shortcut/workflow-states` with your workspace's actual state IDs.4. Optionally add to `~/.bashrc` for persistence: ```bash export SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\n') source ~/.config/shortcut/workflow-states ```## Available Operations### List Stories```bashscripts/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```bashscripts/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```bashscripts/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```bashscripts/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:**```bashscripts/shortcut-create-task.sh <story-id> "task description"```**Update task completion status:**```bashscripts/shortcut-update-task.sh <story-id> <task-id> [--complete|--incomplete]```**Edit task description:**```bashscripts/shortcut-edit-task.sh <story-id> <task-id> "new description"```**Delete a task:**```bashscripts/shortcut-delete-task.sh <story-id> <task-id>```Use `shortcut-show-story.sh` to see task IDs.### Manage Comments**Add a comment:**```bashscripts/shortcut-add-comment.sh <story-id> "comment text"```**Update a comment:**```bashscripts/shortcut-update-comment.sh <story-id> <comment-id> "new text"```**Delete a comment:**```bashscripts/shortcut-delete-comment.sh <story-id> <comment-id>```Use `shortcut-show-story.sh` to see comment IDs.## Workflow1. List existing stories to understand current board state2. Create new stories with descriptive names and appropriate types3. 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

Frequently asked questions