Shortcut Automation

Shortcut Automation - Claude Code Project Management Automation Skills

Skill Overview

Shortcut Automation lets you directly control the Shortcut workspace in Claude Code using natural-language commands. You can create stories, manage tasks, add comments, and perform bulk operations—completing full project management workflows without leaving the terminal.

Use Cases

1. Sprint Planning and Requirements Management

During iteration planning meetings, quickly create multiple feature stories, bug stories, and chore stories. Support bulk adding of estimates, labels, and task lists. Automatically associate epics and iterations, greatly improving the efficiency of requirements entry.

2. Daily Workflow Automation

Throughout development, use command-line commands to quickly add story comments, create subtasks, and update statuses—without switching to the Shortcut web interface. This keeps you focused on coding while maintaining synchronized project tracking.

3. Bulk Project Operations and Maintenance

When performing maintenance work such as organizing projects, bulk migrating stories, and managing labels in a unified way, create and update multiple stories at once using bulk create/update APIs. This avoids inefficient manual one-by-one operations.

Core Features

1. Story Creation and Management

Supports creating single or bulk stories. You can configure complete fields such as workflow status, story type (feature/bug/chore), estimate value, labels, assignees, and due dates. It also supports adding task lists and comments inline, enabling full story initialization with a single API call.

2. Task Checklist and Comment Management

Create tasks (checklists) under a story to track sub-work. Assign task owners and completion statuses. Use the comment feature for code review discussions, requirement clarifications, and team collaboration. Threaded replies support building structured conversations.

3. Workflow and Project Discovery

Provides workflow status lists and project list query capabilities to help you quickly find the correct workflow_state_id (recommended) or project_id, solving the ID-matching problem when creating stories. It also supports listing all stories for a given project along with their descriptions.

FAQs

What prerequisites does Shortcut Automation require?

You need to configure a Rube MCP server for Claude Code with the URL https://rube.app/mcp, and then complete Shortcut account authorization using the provided connection link. After configuration, you can operate the Shortcut workspace in Claude Code via natural-language commands.

What is the difference between workflow_state_id and project_id?

Both are used to specify where stories are created, but you can only use one of them. workflow_state_id is the recommended option because it points to a specific workflow state (e.g., Backlog, Ready for Development). project_id is being deprecated by Shortcut and in the future will only support workflow-based organization. When creating a story, be sure to provide only one of these fields.

Is there a limit on how many stories can be created in bulk?

There is no hard limit on bulk operations, but creating too many stories in a single request may cause API timeouts. It’s recommended to keep each bulk creation to within 25 stories; if you need more, run multiple batches. During bulk creation, each story must provide at least the name field; other fields are optional.