A comprehensive integration to manage Shortcut.com stories, epics, and project workflows directly through your AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shortcut-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shortcut-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Shortcut.com Project Management?
The Shortcut.com skill allows developers to bridge the gap between their coding environment and project management. By leveraging the Shortcut REST API v3, this skill enables AI agents to read, create, and update project data with precision. It is designed to be a core part of the Openclaw Skills ecosystem, providing a secure and scriptable way to handle project backlogs, triage bugs, and manage development sprints without leaving the terminal or IDE environment.
This skill emphasizes security and reliability by utilizing jq for safe JSON construction, protecting against shell injection while handling user-supplied content. Whether you are listing your current assignments or wiring complex story dependencies, this tool ensures your Shortcut workspace remains the single source of truth for your development lifecycle.
Shortcut.com Project Management Use Cases
- Triaging and listing stories from the backlog to prioritize daily tasks.
- Creating new feature stories, chores, or bug reports with specific estimates and labels.
- Updating story states, such as moving a ticket from In Development to Ready for Review.
- Managing epics and viewing progress across multiple stories.
- Adding comments to existing stories for better team communication and context sharing.
- Wiring dependencies between stories to clearly identify blockers and project bottlenecks.
How Shortcut.com Project Management Works
- The skill authenticates with Shortcut.com using a member-level API token stored securely in the local environment.
- When a user provides a command or request, the agent identifies the relevant Shortcut action, such as searching for a story or creating an epic.
- The skill constructs a secure JSON payload using jq to ensure all user input is properly escaped.
- A request is sent to the Shortcut REST API v3 using curl, handling operations like GET, POST, or PUT.
- The raw API response is filtered and formatted into developer-friendly Markdown tables or lists to provide clear feedback within the Openclaw Skills interface.
Shortcut.com Project Management Setup
To get started, you must provide your Shortcut API token. Generate one at app.shortcut.com → Settings → API Tokens.
# Create the secrets directory
mkdir -p ~/.openclaw/secrets
# Save your token securely
echo -n "<your_token>" > ~/.openclaw/secrets/shortcut && chmod 600 ~/.openclaw/secrets/shortcut
Ensure that both curl and jq are installed on your system, as they are required dependencies for this skill to function within the Openclaw Skills framework.
Shortcut.com Project Management Data Schema & Taxonomy
The skill interacts with the Shortcut API and returns structured data formatted for readability. Below is how the primary entities are handled:
| Entity | Key Metadata Fields |
|---|---|
| Story | ID (numeric), Name, Type (feature/bug/chore), Estimate (points), Workflow State |
| Epic | ID, Name, State, Total Stories, Statistics |
| Workflow | Workflow Name, State ID, State Name, State Type |
| Group/Team | ID, Name, Mention Name |
Note: When referencing stories, the skill automatically handles the conversion between the display ID (e.g., sc-1234) and the numerical ID required by the API.
Shortcut.com Project Management Advanced Features
- Injection-proof JSON construction using jq -n --arg for all write operations.
- Automatic label creation: Shortcut creates labels on the fly if they do not already exist when creating stories.
- Dependency wiring: Support for creating 'blocks' or 'is blocked by' relationships between different stories.
- Workflow state discovery: Dynamically fetch state IDs to ensure compatibility with customized Shortcut workspaces.
- Bulk operation support: Optimized for workflows involving the creation of multiple dependent stories within a single epic.
SKILL.md
Loading
Related Openclaw Skills
Manim Community Edition Best Practices
A comprehensive guide and rule set for creating high-quality mathematical animations using the Manim Community Edition Python engine.
Manim Composer
A specialized planning agent that transforms educational concepts into structured, scene-by-scene animation scripts for the Manim engine.
X Agent
A phased workflow agent designed to manage X (Twitter) operations through secure monitoring, drafting, and guarded automation.
HTS Classifier
A high-performance tool for identifying HTS codes and calculating current US import duty rates for 2026 trade compliance.
Straker Verify
Straker Verify provides professional AI-powered translation and expert human review for high-stakes localization projects.
Straker Verify
A professional translation and localization tool for Openclaw Skills that provides AI-driven accuracy with enterprise-grade human verification options.
Featured*
