{ "schemaVersion": "1.0", "item": { "slug": "shortcut", "name": "Shortcut", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/catwalksophie/shortcut", "canonicalUrl": "https://clawhub.ai/catwalksophie/shortcut", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/shortcut", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shortcut", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CHANGELOG.md", "README.md", "SKILL.md", "scripts/shortcut-add-comment.sh", "scripts/shortcut-create-story.sh", "scripts/shortcut-create-task.sh" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/shortcut" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/shortcut", "agentPageUrl": "https://openagent3.xyz/skills/shortcut/agent", "manifestUrl": "https://openagent3.xyz/skills/shortcut/agent.json", "briefUrl": "https://openagent3.xyz/skills/shortcut/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Shortcut Kanban Integration", "body": "Manage tasks and stories on Shortcut.com project boards via API." }, { "title": "Prerequisites", "body": "Shortcut API token configured via one of:\n\nEnvironment variable: SHORTCUT_API_TOKEN\nFile: ~/.config/shortcut/api-token\n\n\nAccess to a Shortcut workspace with appropriate permissions" }, { "title": "Setup", "body": "Get your API token from Shortcut.com (Settings → API Tokens)\nStore it either:\n\nAs environment variable: export SHORTCUT_API_TOKEN=\"your-token\"\nIn a file: echo \"your-token\" > ~/.config/shortcut/api-token && chmod 600 ~/.config/shortcut/api-token\n\n\nInitialize workflow states for your workspace:\nscripts/shortcut-init-workflow.sh\n\nThis creates ~/.config/shortcut/workflow-states with your workspace's actual state IDs.\nOptionally add to ~/.bashrc for persistence:\nexport SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\\n')\nsource ~/.config/shortcut/workflow-states" }, { "title": "List Stories", "body": "scripts/shortcut-list-stories.sh [--active|--completed|--all] [--json]\n\nOptions:\n\n--active - Show only incomplete stories (default)\n--completed - Show only completed stories\n--all - Include archived stories\n--json - Output raw JSON" }, { "title": "Show Story Details", "body": "scripts/shortcut-show-story.sh \n\nDisplays full story information including:\n\nStory name and status\nDescription (if present)\nChecklist items with completion status" }, { "title": "Create Story", "body": "scripts/shortcut-create-story.sh \"Story name\" [--description \"text\"] [--type feature|bug|chore]\n\nStory types:\n\nfeature (default) - New functionality\nbug - Bug fix\nchore - Maintenance task" }, { "title": "Update Story", "body": "scripts/shortcut-update-story.sh [--complete|--todo|--in-progress] [--description \"new text\"]\n\nWorkflow 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:\n\nBacklog: 500000006\nTo Do: 500000007\nIn Progress: 500000008\nIn Review: 500000009\nDone: 500000010\n\nNote: Different Shortcut workspaces may use different state IDs. Always run shortcut-init-workflow.sh to configure your workspace's actual IDs." }, { "title": "Manage Checklist Tasks", "body": "Create a task:\n\nscripts/shortcut-create-task.sh \"task description\"\n\nUpdate task completion status:\n\nscripts/shortcut-update-task.sh [--complete|--incomplete]\n\nEdit task description:\n\nscripts/shortcut-edit-task.sh \"new description\"\n\nDelete a task:\n\nscripts/shortcut-delete-task.sh \n\nUse shortcut-show-story.sh to see task IDs." }, { "title": "Manage Comments", "body": "Add a comment:\n\nscripts/shortcut-add-comment.sh \"comment text\"\n\nUpdate a comment:\n\nscripts/shortcut-update-comment.sh \"new text\"\n\nDelete a comment:\n\nscripts/shortcut-delete-comment.sh \n\nUse shortcut-show-story.sh to see comment IDs." }, { "title": "Workflow", "body": "List existing stories to understand current board state\nCreate new stories with descriptive names and appropriate types\nUpdate story status as work progresses" }, { "title": "Notes", "body": "Scripts use SHORTCUT_API_TOKEN environment variable or fall back to ~/.config/shortcut/api-token\nStories are created in \"Unstarted\" state by default (workflow_state_id: 500000006)\nIf your workspace uses different workflow state IDs, you may need to adjust the scripts\nThe token must have permissions for the workspace you want to manage" } ], "body": "Shortcut Kanban Integration\n\nManage tasks and stories on Shortcut.com project boards via API.\n\nPrerequisites\nShortcut API token configured via one of:\nEnvironment variable: SHORTCUT_API_TOKEN\nFile: ~/.config/shortcut/api-token\nAccess to a Shortcut workspace with appropriate permissions\nSetup\nGet your API token from Shortcut.com (Settings → API Tokens)\nStore it either:\nAs environment variable: export SHORTCUT_API_TOKEN=\"your-token\"\nIn a file: echo \"your-token\" > ~/.config/shortcut/api-token && chmod 600 ~/.config/shortcut/api-token\nInitialize workflow states for your workspace:\nscripts/shortcut-init-workflow.sh\n\nThis creates ~/.config/shortcut/workflow-states with your workspace's actual state IDs.\nOptionally add to ~/.bashrc for persistence:\nexport SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\\n')\nsource ~/.config/shortcut/workflow-states\n\nAvailable Operations\nList Stories\nscripts/shortcut-list-stories.sh [--active|--completed|--all] [--json]\n\n\nOptions:\n\n--active - Show only incomplete stories (default)\n--completed - Show only completed stories\n--all - Include archived stories\n--json - Output raw JSON\nShow Story Details\nscripts/shortcut-show-story.sh \n\n\nDisplays full story information including:\n\nStory name and status\nDescription (if present)\nChecklist items with completion status\nCreate Story\nscripts/shortcut-create-story.sh \"Story name\" [--description \"text\"] [--type feature|bug|chore]\n\n\nStory types:\n\nfeature (default) - New functionality\nbug - Bug fix\nchore - Maintenance task\nUpdate Story\nscripts/shortcut-update-story.sh [--complete|--todo|--in-progress] [--description \"new text\"]\n\n\nWorkflow 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:\n\nBacklog: 500000006\nTo Do: 500000007\nIn Progress: 500000008\nIn Review: 500000009\nDone: 500000010\n\nNote: Different Shortcut workspaces may use different state IDs. Always run shortcut-init-workflow.sh to configure your workspace's actual IDs.\n\nManage Checklist Tasks\n\nCreate a task:\n\nscripts/shortcut-create-task.sh \"task description\"\n\n\nUpdate task completion status:\n\nscripts/shortcut-update-task.sh [--complete|--incomplete]\n\n\nEdit task description:\n\nscripts/shortcut-edit-task.sh \"new description\"\n\n\nDelete a task:\n\nscripts/shortcut-delete-task.sh \n\n\nUse shortcut-show-story.sh to see task IDs.\n\nManage Comments\n\nAdd a comment:\n\nscripts/shortcut-add-comment.sh \"comment text\"\n\n\nUpdate a comment:\n\nscripts/shortcut-update-comment.sh \"new text\"\n\n\nDelete a comment:\n\nscripts/shortcut-delete-comment.sh \n\n\nUse shortcut-show-story.sh to see comment IDs.\n\nWorkflow\nList existing stories to understand current board state\nCreate new stories with descriptive names and appropriate types\nUpdate story status as work progresses\nNotes\nScripts use SHORTCUT_API_TOKEN environment variable or fall back to ~/.config/shortcut/api-token\nStories are created in \"Unstarted\" state by default (workflow_state_id: 500000006)\nIf your workspace uses different workflow state IDs, you may need to adjust the scripts\nThe token must have permissions for the workspace you want to manage" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/catwalksophie/shortcut", "publisherUrl": "https://clawhub.ai/catwalksophie/shortcut", "owner": "catwalksophie", "version": "1.4.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/shortcut", "downloadUrl": "https://openagent3.xyz/downloads/shortcut", "agentUrl": "https://openagent3.xyz/skills/shortcut/agent", "manifestUrl": "https://openagent3.xyz/skills/shortcut/agent.json", "briefUrl": "https://openagent3.xyz/skills/shortcut/agent.md" } }