Skip to content
Back to search

generate-shortcuts-skill

a little skill that explains the shortcuts plist format to claude

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/drewocarr--generate-shortcuts-skill/badge.svg)](/listings/drewocarr--generate-shortcuts-skill)

HTML

<a href="/listings/drewocarr--generate-shortcuts-skill"><img src="/api/listings/drewocarr--generate-shortcuts-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Create the skills directory (if it doesn't exist)

mkdir -p ~/.claude/skills

2. Clone or copy this repository

cd ~/.claude/skills
git clone https://github.com/drewocarr/shortcuts-generator.git

Or download and extract the files manually into `~/.claude/skills/shortcuts-generator/`.

3. Verify the installation

Your directory structure should look like:

~/.claude/
└── skills/
    └── shortcuts-generator/
        ├── SKILL.md          # Required - skill definition
        ├── ACTIONS.md
        ├── APPINTENTS.md
        ├── CONTROL_FLOW.md
        ├── EXAMPLES.md
        ├── FILTERS.md
        ├── PARAMETER_TYPES.md
        ├── PLIST_FORMAT.md
        └── VARIABLES.md

4. Restart Claude Code

The skill will be automatically detected on the next conversation.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: shortcuts-generator
  3. description: Generate macOS/iOS Shortcuts by creating plist files. Use when asked to create shortcuts, automate workflows, build .shortcut files, or generate Shortcuts plists. Covers 1,155 actions (427 WF*Actions + 728 AppIntents), variable references, and control flow.
  4. allowed-tools: Write, Bash
  5. ---
  6. # macOS Shortcuts Generator
  7. Generate valid `.shortcut` files that can be signed and imported into Apple's Shortcuts app.
  8. ## Quick Start
  9. A shortcut is a binary plist with this structure:
  10. ```xml
  11. <?xml version="1.0" encoding="UTF-8"?>
  12. <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  13. <plist version="1.0">
  14. <dict>
  15. <key>WFWorkflowActions</key>
  16. <array>
  17. <!-- Actions go here -->
  18. </array>
  19. <key>WFWorkflowClientVersion</key>
  20. <string>2700.0.4</string>
  21. <key>WFWorkflowHasOutputFallback</key>
  22. <false/>
  23. <key>WFWorkflowIcon</key>
  24. <dict>
  25. <key>WFWorkflowIconGlyphNumber</key>
  26. <integer>59511</integer>
  27. <key>WFWorkflowIconStartColor</key>
  28. <integer>4282601983</integer>
  29. </dict>
  30. <key>WFWorkflowImportQuestions</key>
  31. <array/>
  32. <key>WFWorkflowMinimumClientVersion</key>
  33. <integer>900</integer>
  34. <key>WFWorkflowMinimumClientVersionString</key>
  35. <string>900</string>
  36. <key>WFWorkflowName</key>
  37. <string>My Shortcut</string>
  38. <key>WFWorkflowOutputContentItemClasses</key>
  39. <array/>
  40. <key>WFWorkflowTypes</key>
  41. <array/>
  42. </dict>
  43. </plist>
  44. ```
  45. ### Minimal Hello World
  46. ```xml
  47. <dict>
  48. <key>WFWorkflowActionIdentifier</key>
  49. <string>is.workflow.actions.gettext</string>
  50. <key>WFWorkflowActionParameters</key>
  51. <dict>
  52. <key>UUID</key>
  53. <string>A1B2C3D4-E5F6-7890-ABCD-EF1234567890</string>
  54. <key>WFTextActionText</key>
  55. <string>Hello World!</string>
  56. </dict>
  57. </dict>
  58. <dict>
  59. <key>WFWorkflowActionIdentifier</key>
  60. <string>is.workflow.actions.showresult</string>
  61. <key>WFWorkflowActionParameters</key>
  62. <dict>
  63. <key>Text</key>
  64. <dict>
  65. <key>Value</key>
  66. <dict>
  67. <key>attachmentsByRange</key>
  68. <dict>
  69. <key>{0, 1}</key>
  70. <dict>
  71. <key>OutputName</key>
  72. <string>Text</string>
  73. <key>OutputUUID</key>
  74. <string>A1B2C3D4-E5F6-7890-ABCD-EF1234567890</string>
  75. <key>Type</key>
  76. <string>ActionOutput</string>
  77. </dict>
  78. </dict>
  79. <key>string</key>
  80. <string></string>
  81. </dict>
  82. <key>WFSerializationType</key>
  83. <string>WFTextTokenString</string>
  84. </dict>
  85. </dict>
  86. </dict>
  87. ```
  88. ## Core Concepts
  89. ### 1. Actions
  90. Every action has:
  91. - **Identifier**: `is.workflow.actions.<name>` (e.g., `is.workflow.actions.showresult`)
  92. - **Parameters**: Action-specific configuration in `WFWorkflowActionParameters`
  93. - **UUID**: Unique identifier for referencing this action's output
  94. ### 2. Variable References
  95. To use output from a previous action:
  96. 1. The source action needs a `UUID` parameter
  97. 2. Reference it using `OutputUUID` in an `attachmentsByRange` dictionary
  98. 3. Use `` (U+FFFC) as placeholder in the string where the variable goes
  99. 4. Set `WFSerializationType` to `WFTextTokenString`
  100. ### 3. Control Flow
  101. Control flow actions (repeat, conditional, menu) use:
  102. - `GroupingIdentifier`: UUID linking start/middle/end actions
  103. - `WFControlFlowMode`: 0=start, 1=middle (else/case), 2=end
  104. ## Common Actions Quick Reference
  105. | Action | Identifier | Key Parameters |
  106. |--------|------------|----------------|
  107. | Text | `is.workflow.actions.gettext` | `WFTextActionText` |
  108. | Show Result | `is.workflow.actions.showresult` | `Text` |
  109. | Ask for Input | `is.workflow.actions.ask` | `WFAskActionPrompt`, `WFInputType` |
  110. | Use AI Model | `is.workflow.actions.askllm` | `WFLLMPrompt`, `WFLLMModel`, `WFGenerativeResultType` |
  111. | Comment | `is.workflow.actions.comment` | `WFCommentActionText` |
  112. | URL | `is.workflow.actions.url` | `WFURLActionURL` |
  113. | Get Contents of URL | `is.workflow.actions.downloadurl` | `WFURL`, `WFHTTPMethod` |
  114. | Get Weather | `is.workflow.actions.weather.currentconditions` | (none required) |
  115. | Open App | `is.workflow.actions.openapp` | `WFAppIdentifier` |
  116. | Open URL | `is.workflow.actions.openurl` | `WFInput` |
  117. | Alert | `is.workflow.actions.alert` | `WFAlertActionTitle`, `WFAlertActionMessage` |
  118. | Notification | `is.workflow.actions.notification` | `WFNotificationActionTitle`, `WFNotificationActionBody` |
  119. | Set Variable | `is.workflow.actions.setvariable` | `WFVariableName`, `WFInput` |
  120. | Get Variable | `is.workflow.actions.getvariable` | `WFVariable` |
  121. | Number | `is.workflow.actions.number` | `WFNumberActionNumber` |
  122. | List | `is.workflow.actions.list` | `WFItems` |
  123. | Dictionary | `is.workflow.actions.dictionary` | `WFItems` |
  124. | Repeat (count) | `is.workflow.actions.repeat.count` | `WFRepeatCount`, `GroupingIdentifier`, `WFControlFlowMode` |
  125. | Repeat (each) | `is.workflow.actions.repeat.each` | `WFInput`, `GroupingIdentifier`, `WFControlFlowMode` |
  126. | If/Otherwise | `is.workflow.actions.conditional` | `WFInput`, `WFCondition`, `GroupingIdentifier`, `WFControlFlowMode` |
  127. | Choose from Menu | `is.workflow.actions.choosefrommenu` | `WFMenuPrompt`, `WFMenuItems`, `GroupingIdentifier`, `WFControlFlowMode` |
  128. | Find Photos | `is.workflow.actions.filter.photos` | `WFContentItemFilter` (see FILTERS.md) |
  129. | Delete Photos | `is.workflow.actions.deletephotos` | `photos` (**NOT** `WFInput`!) |
  130. ## Detailed Reference Files
  131. For complete documentation, see:
  132. - [PLIST_FORMAT.md](PLIST_FORMAT.md) - Complete plist structure
  133. - [ACTIONS.md](ACTIONS.md) - All 427 WF*Action identifiers and parameters
  134. - [APPINTENTS.md](APPINTENTS.md) - All 728 AppIntent actions
  135. - [PARAMETER_TYPES.md](PARAMETER_TYPES.md) - All parameter value types and serialization formats
  136. - [VARIABLES.md](VARIABLES.md) - Variable reference system
  137. - [CONTROL_FLOW.md](CONTROL_FLOW.md) - Repeat, Conditional, Menu patterns
  138. - [FILTERS.md](FILTERS.md) - Content filters for Find/Filter actions (photos, files, etc.)
  139. - [EXAMPLES.md](EXAMPLES.md) - Complete working examples
  140. ## Signing Shortcuts
  141. Shortcuts MUST be signed before they can be imported. Use the macOS `shortcuts` CLI:
  142. ```bash
  143. # Sign for anyone to use
  144. shortcuts sign --mode anyone --input MyShortcut.shortcut --output MyShortcut_signed.shortcut
  145. # Sign for people who know you
  146. shortcuts sign --mode people-who-know-me --input MyShortcut.shortcut --output MyShortcut_signed.shortcut
  147. ```
  148. The signing process:
  149. 1. Write your plist as XML to a `.shortcut` file
  150. 2. Run `shortcuts sign` to add cryptographic signature (~19KB added)
  151. 3. The signed file can be opened/imported into Shortcuts.app
  152. ## Workflow for Creating Shortcuts
  153. 1. **Define actions** - List what the shortcut should do
  154. 2. **Generate UUIDs** - Each action that produces output needs a unique UUID
  155. 3. **Build action array** - Create each action dictionary with identifier and parameters
  156. 4. **Wire variable references** - Connect outputs to inputs using `OutputUUID`
  157. 5. **Wrap in plist** - Add the root structure with icon, name, version
  158. 6. **Write to file** - Save as `.shortcut` (XML plist format is fine)
  159. 7. **Sign** - Run `shortcuts sign` to make it importable
  160. ## Key Rules
  161. 1. **UUIDs must be uppercase**: `A1B2C3D4-E5F6-7890-ABCD-EF1234567890`
  162. 2. **WFControlFlowMode is an integer**: Use `<integer>0</integer>` not `<string>0</string>`
  163. 3. **Range keys use format**: `{position, length}` - e.g., `{0, 1}` for first character
  164. 4. **The placeholder character**: `` (U+FFFC) marks where variables are inserted
  165. 5. **Control flow needs matching ends**: Every repeat/if/menu start needs an end action with same `GroupingIdentifier`
README.md · README · 85 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Shortcuts Generator Skill for Claude Code
  2. A Claude Code skill that enables AI-assisted generation of macOS/iOS Shortcuts. Create valid `.shortcut` plist files that can be signed and imported into Apple's Shortcuts app.
  3. ## Installation
  4. ### 1. Create the skills directory (if it doesn't exist)
  5. ```bash
  6. mkdir -p ~/.claude/skills
  7. ```
  8. ### 2. Clone or copy this repository
  9. ```bash
  10. cd ~/.claude/skills
  11. git clone https://github.com/drewocarr/shortcuts-generator.git
  12. ```
  13. Or download and extract the files manually into `~/.claude/skills/shortcuts-generator/`.
  14. ### 3. Verify the installation
  15. Your directory structure should look like:
  16. ```
  17. ~/.claude/
  18. └── skills/
  19. └── shortcuts-generator/
  20. ├── SKILL.md # Required - skill definition
  21. ├── ACTIONS.md
  22. ├── APPINTENTS.md
  23. ├── CONTROL_FLOW.md
  24. ├── EXAMPLES.md
  25. ├── FILTERS.md
  26. ├── PARAMETER_TYPES.md
  27. ├── PLIST_FORMAT.md
  28. └── VARIABLES.md
  29. ```
  30. ### 4. Restart Claude Code
  31. The skill will be automatically detected on the next conversation.
  32. ## Usage
  33. Once installed, simply ask Claude Code to create a shortcut:
  34. - "Create a shortcut that shows the current weather"
  35. - "Build a shortcut that asks for text input and shows it"
  36. - "Make a shortcut that opens Safari and navigates to a URL"
  37. Claude will generate the plist XML, write it to a `.shortcut` file, and sign it so you can import it directly into the Shortcuts app.
  38. ## What's Included
  39. | File | Description |
  40. |------|-------------|
  41. | `SKILL.md` | Skill definition with quick start guide |
  42. | `ACTIONS.md` | All 427 WF*Action identifiers and parameters |
  43. | `APPINTENTS.md` | All 728 AppIntent actions |
  44. | `PARAMETER_TYPES.md` | Parameter value types and serialization formats |
  45. | `VARIABLES.md` | Variable reference system |
  46. | `CONTROL_FLOW.md` | Repeat, Conditional, Menu patterns |
  47. | `FILTERS.md` | Content filters for Find/Filter actions |
  48. | `EXAMPLES.md` | Complete working examples |
  49. ## Requirements
  50. - macOS with the `shortcuts` CLI tool (included with macOS)
  51. - Claude Code CLI
  52. ## How Skills Work
  53. Skills are collections of markdown files that provide Claude Code with specialized knowledge and capabilities. The `SKILL.md` file defines:
  54. - **name**: Identifier for the skill
  55. - **description**: When to use this skill (triggers automatic invocation)
  56. - **allowed-tools**: Which tools Claude can use when the skill is active
  57. When you ask Claude Code to do something that matches the skill's description, it automatically loads the skill's documentation to provide accurate, specialized assistance.
  58. ## License
  59. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.