Share Markdown via Gist with Auto-Delete

Turn a local markdown file into a shareable link backed by a secret GitHub Gist, optionally scheduling automatic deletion after a custom TTL via launchd.

When to use

Use this skill whenever the user wants any markdown file (.md, .markdown) made available at a URL — for a teammate, an agent that will fetch it, or themselves on another machine. Always offer the auto-delete option unless the user says otherwise; ephemeral sharing is the safer default for sensitive content.

What you need first

Before running, confirm:

1. The user provides a path to a markdown file (or content to write to one).
2. gh CLI is installed and authenticated. Check with gh auth status. If not, stop and tell the user to run gh auth login.
3. The TTL the user wants. If they don't specify, ask: "How long should this link live? Examples: 1h, 24h, 7d, or never (no auto-delete)."

The workflow

Run scripts/share.sh with the file path and TTL. The script handles everything: creates the secret gist, captures the IDs, schedules the launchd cleanup if a TTL was given, and prints both URLs.