shortcut

Create, update, search, and delete Shortcut resources via CLI with token-based authentication.

5|1|Updated Aug 18, 2024
One-click install
npx skills add https://github.com/jbuckmccready/dotfiles --skill shortcut
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shortcut
Source: https://github.com/jbuckmccready/dotfiles/tree/main/claude/.claude/skills/shortcut
Command: npx skills add https://github.com/jbuckmccready/dotfiles --skill shortcut

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the manual overhead of managing projects in Shortcut, allowing you to automate repetitive tasks like creating stories, updating statuses, or searching for specific items across multiple filters. It frees up project managers and teams to focus on strategic work rather than administrative burden.

Core Features & Use Cases

  • Comprehensive Project Management: Create, update, search, and delete stories, epics, iterations, objectives, and documents directly from your AI.
  • Team & Workflow Insights: Quickly retrieve information about teams, members, and workflows to gain context and make informed decisions.
  • Use Case: Automatically create a new feature story in Shortcut based on a user request, assign it to the correct team and iteration, and then generate a git branch name for it, all in one seamless AI interaction.

Quick Start

Use the Shortcut skill to create a new feature story titled 'Implement user profile page' for the 'Frontend Team' in the current active iteration, and assign it to me.

Frequently Asked Questions about shortcut

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate story creation and updates in Shortcut from the command line?

Automate story creation, updates, and searches in Shortcut using CLI commands with token-based authentication. The Skill enables programmatic read and write access to stories, epics, iterations, and workflows, returning JSON responses for integration into larger automation workflows.

Can I create, search, and delete Shortcut stories, epics, and iterations programmatically?

Yes. The Skill provides full CRUD operations on Shortcut resources including stories, epics, iterations, objectives, teams, and documents through CLI commands with JSON-based responses and error handling built in.

What authentication does Shortcut project automation require?

Shortcut automation requires token-based authentication via the SHORTCUT_API_TOKEN environment variable. Set this token to enable read and write access to all Shortcut resources through the CLI.

How can I retrieve team and workflow information from Shortcut to inform story assignment?

Query Shortcut teams, members, and workflows directly through CLI commands to retrieve context data. Use this information to automatically assign stories to the correct team and iteration in a single workflow.

Does Shortcut automation support batch operations across multiple stories and epics?

The Skill handles create, update, search, and delete operations on individual and multiple Shortcut resources. Search with multiple filters to target stories and epics, then execute read or write operations across results.

Can I generate derived outputs like git branch names from Shortcut story data?

Yes. After creating or retrieving story data via the CLI, you can process the JSON response to generate downstream outputs like git branch names, commit messages, or other formatted artifacts in your automation pipeline.