shortcut

Create signed macOS Shortcut files from workflow specifications.

2|Updated May 13, 2026
One-click install
npx skills add https://github.com/mujtaba3B/gstack-extensions --skill shortcut-mujtaba3b
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shortcut
Source: https://github.com/mujtaba3B/gstack-extensions/tree/main/eng/skills/shortcut
Command: npx skills add https://github.com/mujtaba3B/gstack-extensions --skill shortcut-mujtaba3b

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of hand-building Apple Shortcuts in Shortcuts.app by turning a spec into a signed, importable workflow that can be installed with one manual click.

Core Features & Use Cases

  • Programmatic shortcut authoring: Build a Shortcut as plist XML with the correct workflow structure, UUID wiring, and action parameters.
  • Signing and import handoff: Sign the workflow into a .shortcut file, open it in Shortcuts.app, and stop for the mandatory Add Shortcut click.
  • Run Shell Script bridges: Create shortcuts that launch your existing CLI or script from the menu bar, a hotkey, Siri, or a shortcuts:// URL.
  • Verification and safety checks: Confirm the shortcut was built, signed, imported, and runnable, while handling common pitfalls like stripped PATH, input wiring, and duplicate names.

Quick Start

Ask the skill to turn your command or workflow spec into a signed macOS Shortcut, then open it for import and verify it after you click Add Shortcut.

Frequently Asked Questions about shortcut

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

FAQPage Schema
How do I create signed macOS Shortcuts from a spec without using Shortcuts.app?

To create signed macOS Shortcuts from a spec, you define a .shortcut-formatted input with correct workflow metadata and input-class declarations. The process authoring plist XML, wires UUIDs, and uses Shortcuts CLI signing to produce an installable workflow file.

Can I build Run Shell Script bridges in macOS Shortcuts to launch my CLI?

Yes, you can build Run Shell Script bridges in macOS Shortcuts to launch your existing CLI or script. These signed workflows can be triggered from the menu bar, a hotkey, Siri, or a shortcuts:// URL.

What is the process for programmatically authoring an Apple Shortcut plist?

Programmatically authoring an Apple Shortcut plist involves writing XML with the correct workflow structure, wiring UUID connections, and defining action parameters. This bypasses manual assembly in Shortcuts.app by generating the underlying plist directly.

How do I verify a macOS Shortcut was built and signed correctly for import?

To verify a macOS Shortcut was built and signed correctly, you check if the signing process produced a valid .shortcut file and confirm import handoff. Verification ensures the shortcut is runnable and handles pitfalls like stripped PATH or duplicate names.

Does generating a .shortcut file require manual interaction in Shortcuts.app?

Generating a .shortcut file requires a mandatory manual Add Shortcut click during import handoff. While authoring and signing are automated via the Shortcuts CLI, the final installation step requires user interaction within the Shortcuts.app interface.

Why does my shell script bridge fail when imported as a signed macOS Shortcut?

A shell script bridge might fail when imported as a signed macOS Shortcut due to common pitfalls like a stripped PATH environment, incorrect input wiring, or duplicate workflow names. Verification checks confirm the shortcut is runnable and safely handle these errors.