shortcut

What This Skill Does

The Shortcut skill provides a comprehensive bridge between your OpenClaw AI agent and your Shortcut.com project management ecosystem. It serves as a command-line interface wrapper that allows you to perform complex Kanban board manipulations without ever leaving your terminal or chat interface. By leveraging the Shortcut API, the skill handles story lifecycle management, ranging from initial creation and description updates to granular checklist management and comment thread interaction. It is specifically designed for developers and project managers who rely on automated workflows to track bugs, maintain features, and manage chores efficiently.

Installation

To integrate this skill, use the command: clawhub install openclaw/skills/skills/catwalksophie/shortcut. After installation, ensure you have an active Shortcut API token. Store this token either as an environment variable SHORTCUT_API_TOKEN or within a local config file at ~/.config/shortcut/api-token. Finally, run scripts/shortcut-init-workflow.sh to map your workspace-specific workflow states, which is critical for accurate status updates.

Use Cases

This skill is perfect for teams looking to automate their DevOps feedback loops. For example, you can automatically create a 'bug' story in Shortcut when an AI-detected error occurs in your logs. It is also highly effective for keeping stand-up meetings efficient by using the list-stories command to generate a summary of current progress. Additionally, it streamlines task delegation by allowing you to create and assign checklist tasks directly to existing user stories from your chat window.

Example Prompts

1. "Check the status of all active stories and list the top 3 priorities for today."
2. "Create a new bug report in Shortcut titled 'Login timeout on mobile' with the description 'Users are reporting a 30s delay during OAuth validation' and mark it as a bug."
3. "For story ID 42, add a comment saying 'Investigating the root cause and will update shortly' and mark task 101 as complete."

Tips & Limitations

Always prioritize running the shortcut-init-workflow.sh script; relying on default IDs can lead to failed updates if your organization uses custom workflow pipelines. Remember that operations are performed via API, so ensure your machine has stable internet access. This tool is designed for programmatic interaction; for heavy configuration changes, you may still prefer the native Shortcut web UI. Keep your API tokens secure, as they provide full read/write access to your company's project data.