About github-gist
GitHub Gist Publisher is a skill for publishing a local file as a GitHub Gist. It uses the `gh` CLI by default, supports token-based API access, and creates unlisted gists unless public visibility is requested.
Key features
- 01Publish files as secret or public gists
- 02Set description and filename
- 03Return URL-only output
- 04Open the published gist in a browser
- 05Use `gh` CLI or API
Use cases
- 01Share a session log
- 02Publish a Markdown note
- 03Create a public file snippet
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ glebis/ claude-skills --skill github-gistAfter installing, type/github-gistin Claude Code to confirm it loaded.
Bundled files.claude-plugin/plugin.jsonscripts/publish_gist.py
Details
From the project READMEGitHub 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
Comments
Markdown supported