Summary
A straightforward way to publish files or notes as GitHub Gists directly from Claude. It wraps the gh CLI (or falls back to the GitHub API) and handles both public and secret gists with options for custom descriptions, filenames, and browser opening. Useful when you're iterating with Claude on code or markdown and want to quickly share a snapshot without creating a full repo. Defaults to secret gists, which is the right call since most throwaway shares don't need to clutter your public profile. The JSON output and URL-only mode make it easy to pipe into other workflows. Works with stdin too, so you can echo content straight into a gist.
Install to Claude Code
npx -y skills add glebis/claude-skills --skill github-gist --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Files
SKILL.mdView on GitHub
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →First SeenJun 3, 2026
