{"skill":{"slug":"openclaw-skill-shortcuts-automator","displayName":"Shortcuts Automator","summary":"Manage and run macOS Shortcuts from OpenClaw: list, execute, view details, and sign shortcuts for automation via CLI commands.","description":"---\nname: shortcuts-automator\ndescription: Run and manage macOS Shortcuts directly from OpenClaw. Use when user wants to: (1) Run a specific shortcut by name, (2) List all available shortcuts, (3) View details of a shortcut, (4) Sign/unsign shortcuts for automation, (5) Execute any macOS Shortcut workflow. Triggers include \"run shortcut\", \"execute shortcut\", \"list shortcuts\", \"run automation\", \"show shortcuts\", \"what shortcuts do I have\".\n---\n\n# Shortcuts Automator\n\n## Overview\n\nThis skill enables OpenClaw to interact with macOS Shortcuts (formerly Automator) directly from conversation. It provides CLI commands to list, run, view, and manage shortcuts.\n\n## Quick Start\n\n```bash\n# List all available shortcuts\nshortcuts list\n\n# Run a specific shortcut by name\nshortcuts run \"My Shortcut Name\"\n\n# View details of a shortcut\nshortcuts view \"My Shortcut Name\"\n\n# Sign a shortcut for automation (if needed)\nshortcuts sign \"My Shortcut Name\"\n```\n\n## Commands\n\n### shortcuts list\n\nLists all shortcuts available in the user's Shortcuts library.\n\n```bash\nshortcuts list\n```\n\n**Output:** Returns a list of all shortcut names with folder information.\n\n**Use when:** User asks \"what shortcuts do I have\", \"list shortcuts\", \"show me my shortcuts\", \"what automations can I run\".\n\n### shortcuts run <name>\n\nRuns a shortcut by its exact name. The shortcut must exist in the user's Shortcuts folder.\n\n```bash\nshortcuts run \"Morning Routine\"\nshortcuts run \"Send Email\"\n```\n\n**Parameters:**\n- `<name>`: Exact name of the shortcut (use quotes if name contains spaces)\n\n**Use when:** User says \"run shortcut X\", \"execute shortcut X\", \"run automation X\", \"trigger shortcut X\".\n\n**Notes:**\n- Some shortcuts require input (text, files, etc.) - will prompt or pass through\n- Shortcuts run with user permissions\n- Output from the shortcut is returned as text\n\n### shortcuts view <name>\n\nShows detailed information about a shortcut, including its actions and workflow.\n\n```bash\nshortcuts view \"Morning Routine\"\n```\n\n**Output:** Returns the shortcut's description, actions, and workflow steps.\n\n**Use when:** User asks \"what does shortcut X do\", \"show me shortcut X\", \"view automation X\", \"tell me about shortcut X\".\n\n### shortcuts sign <name>\n\nSigns a shortcut to allow it to run from the command line (required for some automation scenarios).\n\n```bash\nshortcuts sign \"My Shortcut\"\n```\n\n**Use when:** Shortcut fails to run with \"not signed\" error, or user wants to enable CLI execution.\n\n## Error Handling\n\n### \"No shortcuts found\"\n\n**Cause:** Shortcuts library is empty or inaccessible.\n\n**Solution:** \n- Create shortcuts in the Shortcuts app\n- Check Shortcuts app permissions in System Settings > Privacy & Security\n\n### \"Shortcut not found\" / \"Could not find shortcut\"\n\n**Cause:** Shortcut name doesn't match exactly or shortcut was deleted.\n\n**Solution:**\n- Run `shortcuts list` to see exact names\n- Use the exact name including capitalization\n- Check if the shortcut is in a specific folder (use folder name: \"Folder/Shortcut Name\")\n\n### \"Not allowed to run\" / \"Shortcut not signed\"\n\n**Cause:** Shortcut needs to be signed for CLI execution.\n\n**Solution:**\n```bash\nshortcuts sign \"Shortcut Name\"\n```\nOr enable in Shortcuts app: Right-click shortcut > Toggle \"Allow Running from Command Line\"\n\n### \"Permission denied\" / \"Automation access denied\"\n\n**Cause:** OpenClaw doesn't have permission to control Shortcuts.\n\n**Solution:**\n- Open System Settings > Privacy & Security > Automation\n- Enable OpenClaw/your app in the list\n\n### Shortcut hangs or times out\n\n**Cause:** Shortcut may be waiting for input or stuck in a loop.\n\n**Solution:**\n- Use `shortcuts view` to inspect the shortcut's actions\n- Check if the shortcut requires user interaction\n- Add timeout when calling: `timeout 30 shortcuts run \"Name\"`\n\n## Examples\n\n**User says:** \"Run my morning routine shortcut\"\n```bash\nshortcuts run \"Morning Routine\"\n```\n\n**User shortcuts do I have?\"\n```bash\nshortcuts list\n```\n\n**User says:** \"Show me what the email shortcut does\"\n```bash\nshortcuts view \"Send Daily Email\"\n```\n\n**User says:** \"I need to sign a shortcut for automation\"\n```bash\nshortcuts sign \"My Automation Shortcut\"\n```\n\n## Security Considerations\n\n⚠️ **Important:** Shortcuts can execute shell commands, access files, and control other apps.\n\n- **Only run trusted shortcuts** — Review your shortcuts before running them\n- Shortcuts have access to your files, emails, calendar, and other data depending on their actions\n- Be cautious with shortcuts from unknown sources or those that include shell commands\n- Regularly review your shortcuts in the Shortcuts app\n- Shortcuts run with your user permissions, so they can access anything you can\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":680,"installsAllTime":25,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1772931059391,"updatedAt":1778491768590},"latestVersion":{"version":"1.0.0","createdAt":1772931059391,"changelog":"Skills Factory publish","license":null},"metadata":null,"owner":{"handle":"ppopen","userId":"s1776beyb8vpcscv8f3t21d54x885pdn","displayName":"pp","image":"https://avatars.githubusercontent.com/u/263042322?v=4"},"moderation":null}