GitHub Gist Publisher
github-gist
Publish files or Obsidian notes as GitHub Gists. Use when user wants to share code/notes publicly, create quick shareable snippets, or publish markdown to GitHub. Triggers include "publish as gist", "create gist", "share on github", "make a gist from this".
SKILL.md
Full skill instructions
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