GitHub Gist

Publish any file as a GitHub Gist for easy sharing.

Prerequisites

Uses gh CLI by default. Ensure you're authenticated:

gh auth status
# If not authenticated: gh auth login

Fallback: Set GITHUB_GIST_TOKEN env var with gist scope.

Usage

# Publish file as secret (unlisted) gist - DEFAULT
python3 scripts/publish_gist.py /path/to/file.md

# Publish as public gist (visible in your profile)
python3 scripts/publish_gist.py /path/to/file.md --public

# Custom description
python3 scripts/publish_gist.py /path/to/file.md -d "My awesome note"

# Override filename in gist
python3 scripts/publish_gist.py /path/to/file.md -f "readme.md"

# From stdin
echo "Hello" | python3 scripts/publish_gist.py - -f "hello.txt"

# Just get URL
python3 scripts/publish_gist.py /path/to/file.md --url-only

# Create and open in browser
python3 scripts/publish_gist.py /path/to/file.md --open

Options

| Flag | Description | |------|-------------| | --public | Create public gist (default is secret/unlisted) | | -d, --description | Gist description | | -f, --filename | Override filename | | --url-only | Output only URL | | --open | Open in browser | | --api | Force API instead of gh CLI |

Output

{
  "url": "https://gist.github.com/user/abc123",
  "id": "abc123",
  "public": false,
  "filename": "file.md"
}

Example

Session log published with this skill: https://gist.github.com/glebis/3faaae6b907123929220e81add51a567