How do I install the Shortcutscli skill?

Run npx skillmds@latest add tomevault-io/shortcutscli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Shortcutscli safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Shortcutscli?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Shortcutscli free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Shortcutscli?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Shortcutscli by tomevault-io — Agent Skill

Name: Shortcutscli
Author: tomevault-io

File contents

Shortcuts CLI

The shortcuts command manages and runs shortcuts on macOS.

Run

shortcuts run "My Shortcut"
shortcuts run "My Shortcut" -i input.txt
shortcuts run "My Shortcut" -o output.txt
echo "data" | shortcuts run "My Shortcut"

Run by identifier (stable across renames):

shortcuts run "01C97432-525A-4BF6-94DF-C35458FCD21A"

Get identifiers with shortcuts list --show-identifiers.

Headless behavior

Shortcuts with GUI actions (alerts, menus, input prompts) fail with "Running was cancelled" when run from the CLI. Only non-interactive shortcuts work headlessly.

Permissions

First-time actions (notifications, location, contacts, etc.) trigger a macOS permission dialog. The shortcut pauses until the user approves. Inform the user when running a shortcut that may trigger permission prompts.

List

shortcuts list
shortcuts list --show-identifiers
shortcuts list -f "Folder Name"
shortcuts list --folders

View

Opens a shortcut in the Shortcuts app editor:

shortcuts view "My Shortcut"

Sign

Sign a .shortcut file for import (requires network — contacts Apple's signing service):

mkdir -p out
shortcuts sign -i "My Shortcut.shortcut" -o "out/My Shortcut.shortcut"

Sign into an output directory to preserve the unsigned binary. The filename (minus .shortcut) becomes the shortcut name on import — do not add suffixes.

Import

There is no shortcuts import command. Open the signed file to trigger import:

open "out/My Shortcut.shortcut"

The user confirms import in the Shortcuts app GUI.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: shortcutsclidescription: Running and managing Apple Shortcuts via the macOS shortcuts CLI. Use when the user wants to run, list, or inspect shortcuts. Use when this capability is needed.---# Shortcuts CLIThe `shortcuts` command manages and runs shortcuts on macOS.## Run```bashshortcuts run "My Shortcut"shortcuts run "My Shortcut" -i input.txtshortcuts run "My Shortcut" -o output.txtecho "data" | shortcuts run "My Shortcut"```Run by identifier (stable across renames):```bashshortcuts run "01C97432-525A-4BF6-94DF-C35458FCD21A"```Get identifiers with `shortcuts list --show-identifiers`.### Headless behaviorShortcuts with GUI actions (alerts, menus, input prompts) fail with "Running was cancelled" when run from the CLI. Only non-interactive shortcuts work headlessly.### PermissionsFirst-time actions (notifications, location, contacts, etc.) trigger a macOS permission dialog. The shortcut pauses until the user approves. Inform the user when running a shortcut that may trigger permission prompts.## List```bashshortcuts listshortcuts list --show-identifiersshortcuts list -f "Folder Name"shortcuts list --folders```## ViewOpens a shortcut in the Shortcuts app editor:```bashshortcuts view "My Shortcut"```## SignSign a `.shortcut` file for import (requires network — contacts Apple's signing service):```bashmkdir -p outshortcuts sign -i "My Shortcut.shortcut" -o "out/My Shortcut.shortcut"```Sign into an output directory to preserve the unsigned binary. The filename (minus `.shortcut`) becomes the shortcut name on import — do not add suffixes.## ImportThere is no `shortcuts import` command. Open the signed file to trigger import:```bashopen "out/My Shortcut.shortcut"```The user confirms import in the Shortcuts app GUI.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/bendrucker) — claim your Tome and manage your conversions.

Frequently asked questions

Shortcutscli