levalencia GitHub Gist Publisher
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