apple-shortcuts

List, view, and run macOS Shortcuts via the shortcuts CLI with user confirmation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/g-shudy/claude-plugins --skill apple-shortcuts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-shortcuts
Source: https://github.com/g-shudy/claude-plugins/tree/main/plugins/macos-apple-apps/skills/apple-shortcuts
Command: npx skills add https://github.com/g-shudy/claude-plugins --skill apple-shortcuts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill lets you trigger and manage macOS Shortcuts from Claude Code, enabling automated workflows to run by name with a safety prompt.

Core Features & Use Cases

  • List shortcuts: List available shortcuts.
  • Run a shortcut: Execute a shortcut by name with optional input.
  • View details: Inspect a shortcut before running.
  • Safety: Always require user confirmation before executing any shortcut.

Quick Start

Use the CLI: shortcuts list; shortcuts view "Name"; confirm with AskUserQuestion; then shortcuts run "Name".

Frequently Asked Questions about apple-shortcuts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run macOS Shortcuts from the command line?

You can run macOS Shortcuts via the shortcuts CLI using this Skill, which executes named shortcuts with optional input file support. The Skill lists available shortcuts, displays their details, and runs them after a mandatory user confirmation prompt to ensure safety.

Can I automate macOS Shortcuts through Claude Code?

Yes. This Skill triggers and manages macOS Shortcuts from Claude Code by invoking the shortcuts CLI. It enables automated workflows to execute by shortcut name with a built-in safety confirmation step, supporting list, view, and run commands.

What's the safest way to execute shortcuts programmatically?

This Skill enforces user confirmation before executing any shortcut, preventing accidental or unintended automation. It prompts for explicit approval after you select a shortcut, balancing automation convenience with safety requirements.

How do I view shortcut details before running them?

The Skill provides a view command to inspect shortcut details before execution. You can list all available shortcuts and examine a specific shortcut's configuration without running it, then decide whether to proceed.

Does this work with input files for shortcuts?

Yes. The Skill supports optional input file paths when running shortcuts, allowing you to pass data into your macOS automation workflows. Combined with the confirmation step, this enables flexible, safe data-driven shortcut execution.

What permissions do I need to run shortcuts from Claude Code?

The Skill handles common permissions errors when invoking the shortcuts CLI. You must have macOS Shortcuts installed and configured; the Skill manages error handling for typical permission and access issues that arise during execution.