shortcut-share-file

Shares iCloud Drive files via the iOS Instant Share Shortcut URL scheme.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/lsongdev/skills --skill shortcut-share-file-lsongdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shortcut-share-file
Source: https://github.com/lsongdev/skills/tree/main/shortcut-share-file
Command: npx skills add https://github.com/lsongdev/skills --skill shortcut-share-file-lsongdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sharing files from an iCloud Drive backup directory normally requires manual copying, uploading, and link generation. This Skill automates the entire flow by invoking the iOS "Instant Share" Shortcut, which produces a shareable link copied directly to the clipboard. ## Core Features & Use Cases - One-command file sharing: Pass any file path under the iCloud Drive backup directory and trigger the Shortcut via the shortcuts:// URL scheme. - Upload time estimation: Measures upload speed with iperf3 (cached in memory for 24 hours) and appends a --<seconds>Second parameter so the Shortcut waits the right amount of time. - Automatic file staging: Copies files from external sources (such as attachments) into the iCloud/Instant Share/ directory before sharing. - Use Case: You receive a large video as an attachment and want to send it to a colleague. The Skill copies it to iCloud, estimates upload time, runs the Shortcut, and the share link lands on your clipboard ready to paste. ## Quick Start Share the file report.pdf from my iCloud backup with the Instant Share Shortcut and give me the link.

Frequently Asked Questions about shortcut-share-file

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

FAQPage Schema
How do I share an iCloud Drive file using an iOS Shortcut?▼

Install the Instant Share Shortcut from its iCloud link, then invoke it via the shortcuts://run-shortcut URL scheme with the file path as text input. The Shortcut uploads the file and copies the share link to your clipboard automatically.

How to measure upload speed with iperf3 before sharing files?▼

Run iperf3 against a public server such as ping.online.net with a 3-second test and parse the JSON output for bits_per_second. Divide by 8,000,000 to get MB/s, then cache the result for 24 hours to avoid repeated tests.

Does the Instant Share Shortcut work with files outside iCloud Drive?▼

Yes, but the file must first be copied into the iCloud/Instant Share/ directory. For external sources like attachments, the Skill calculates an estimated upload time and appends it as a --<seconds>Second parameter suffix.

Why does the Shortcut say the iCloud directory does not exist?▼

This happens when iCloud is not mounted as external storage or the folder is not named "iCloud". Mount iCloud and rename the folder accordingly; the Shortcut creates the Instant Share subfolder automatically on first run.

What are the limitations of sharing files via iOS Shortcuts?▼

The approach requires an iOS device with the Shortcut installed, a mounted iCloud Drive, and network access for upload. It does not verify file existence or integrity before sharing, and files remain in iCloud Drive until manually deleted.