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".
Resources
1Install
npx skillscat add glebis/claude-skills/github-gist Install via the SkillsCat registry.
This skill publishes files or Obsidian notes as GitHub Gists, enabling easy sharing of code, notes, or markdown snippets. It solves the problem of quickly creating public or unlisted gists without manual GitHub steps. Use it when needing a shareable link for technical content or versioned notes.
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 loginFallback: 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 --openOptions
| 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
Install
npx skillscat add glebis/claude-skills/github-gist Install via the SkillsCat registry.