shortcut-share-file

Shares iCloud Drive files via the iOS Speed Share shortcut with upload time estimation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sharing files stored on iCloud Drive from a Minis environment requires manual copying, link generation, and clipboard handling. This Skill automates the entire flow by invoking the iOS "Speed Share" shortcut, so the shareable link lands directly on the user's clipboard. ## Core Features & Use Cases - One-command file sharing: Pass any file path under the iCloud Drive backup directory to the Speed Share shortcut via the shortcuts:// URL scheme. - Upload time estimation: Runs an iperf3 speed test (cached in memory for 24 hours) to calculate an estimated upload duration appended as a --<seconds>Second parameter. - Automatic file staging: Copies files from external sources or other iCloud directories into the SpeedShare/ folder before sharing. - Use Case: A user says "share the report.pdf from my backup" — the Skill copies the file, measures upload speed, invokes the shortcut, and the share link is copied to the clipboard ready to paste. ## Quick Start Share the file report.pdf from my iCloud backup using the Speed Share shortcut.

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?

Invoke the Speed Share shortcut via the shortcuts:// URL scheme with the file path as a text parameter. The file must be placed in the iCloud Drive SpeedShare folder, and the shortcut copies the share link to the clipboard automatically.

How to estimate file upload time before sharing?

Run iperf3 against ping.online.net for 3 seconds and parse the JSON output to get upload speed in MB/s. Divide the file size by this speed and add a 20 percent margin to estimate the transfer duration.

Does the Speed Share shortcut work with files outside iCloud Drive?

Yes, files from external sources like attachments are first copied into the iCloud SpeedShare directory before sharing. These files require a calculated time suffix, while existing iCloud files use the --0Second suffix.

Why does the shortcut report the iCloud directory does not exist?

This happens when iCloud external storage is not mounted in Minis or the folder is not named iCloud. Mount the storage first, and the shortcut will create the SpeedShare folder automatically on first run.

What are the limitations of sharing files via iOS shortcuts?

The shortcut depends on the iOS Shortcuts app and requires allowing untrusted shortcuts in settings. Files remain in iCloud Drive after sharing and must be deleted manually if cleanup is needed.