drewocarr/generate-shortcuts-skill

a little skill that explains the shortcuts plist format to claude

License:UnknownLanguage:N/A1088

Deep Analysis

一个让 Claude Code 能够生成 macOS/iOS Shortcuts 快捷指令的技能,可创建有效的 .shortcut plist 文件并自动签名导入

Highly Recommended

Core Features

快捷指令生成

通过自然语言描述生成 macOS/iOS Shortcuts 的 plist XML 文件

自动签名

使用 macOS shortcuts CLI 工具自动签名生成的 .shortcut 文件

完整 Action 文档

包含 427 个 WFAction 和 728 个 AppIntent 的完整参数文档

变量系统

支持快捷指令的变量引用系统

控制流支持

支持 Repeat、Conditional、Menu 等控制流模式

Technical Implementation

Architecture:基于文档的 Claude Code Skill,通过多个 Markdown 文件提供快捷指令格式的专业知识,让 Claude 能够生成符合 Apple plist 规范的 shortcut 文件
Execution Flow:
用户描述需求

用户用自然语言描述想要创建的快捷指令功能

Skill 自动激活

Claude Code 根据描述匹配到该 Skill 并加载相关文档

生成 plist XML

Claude 根据 ACTIONS.md、APPINTENTS.md 等文档生成正确格式的 plist

写入文件

将生成的 XML 写入 .shortcut 文件

签名导入

使用 macOS shortcuts CLI 签名文件,可直接导入 Shortcuts 应用

Key Components:
Apple plist 格式快捷指令的底层存储格式
macOS shortcuts CLI签名和导入 .shortcut 文件
WFActionApple Shortcuts 的内置动作标识符
AppIntentiOS/macOS 应用提供的意图动作
Highlights
  • 覆盖 427 个 WFAction 和 728 个 AppIntent,文档完整详尽
  • 生成的文件可直接签名导入,无需手动配置
  • 包含多个完整工作示例,便于学习参考
  • 支持复杂的控制流和过滤器功能
Use Cases
  • 快速创建自动化快捷指令而无需了解 plist 格式细节
  • 批量生成多个相似的快捷指令
  • 学习 Shortcuts 的底层 plist 结构
  • 程序化生成复杂的多步骤快捷指令
Limitations
  • 仅支持 macOS 平台(需要 shortcuts CLI 工具)
  • 需要用户熟悉基本的 Shortcuts 概念才能描述清楚需求
  • 部分 AppIntent 可能因系统版本差异而不可用
Tech Stack
Markdown 文档Apple plist XMLmacOS shortcuts CLIClaude Code Skill 系统

Shortcuts Generator Skill for Claude Code

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.

Installation

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.

Usage

Once installed, simply ask Claude Code to create a shortcut:

  • "Create a shortcut that shows the current weather"
  • "Build a shortcut that asks for text input and shows it"
  • "Make a shortcut that opens Safari and navigates to a URL"

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.

What's Included

File Description
SKILL.md Skill definition with quick start guide
ACTIONS.md All 427 WF*Action identifiers and parameters
APPINTENTS.md All 728 AppIntent actions
PARAMETER_TYPES.md Parameter value types and serialization formats
VARIABLES.md Variable reference system
CONTROL_FLOW.md Repeat, Conditional, Menu patterns
FILTERS.md Content filters for Find/Filter actions
EXAMPLES.md Complete working examples

Requirements

  • macOS with the shortcuts CLI tool (included with macOS)
  • Claude Code CLI

How Skills Work

Skills are collections of markdown files that provide Claude Code with specialized knowledge and capabilities. The SKILL.md file defines:

  • name: Identifier for the skill
  • description: When to use this skill (triggers automatic invocation)
  • allowed-tools: Which tools Claude can use when the skill is active

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.

License

MIT