github-gist

glebis's avatarfrom glebis

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".

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 6, 2026

When & Why to Use This Skill

The GitHub Gist Publisher skill allows users to instantly transform local files, code snippets, or Obsidian notes into GitHub Gists. It supports both public and secret gists, providing a streamlined workflow for developers and writers to share content, document code, and manage snippets directly from their environment via the GitHub CLI or API.

Use Cases

  • Code Snippet Sharing: Quickly convert local code blocks into shareable GitHub Gist URLs for collaboration, debugging, or community support.
  • Obsidian Note Publishing: Seamlessly export Markdown notes from Obsidian to GitHub, making personal knowledge easily accessible or shareable as web-based documents.
  • Technical Documentation & Logs: Create unlisted Gists for configuration files, error logs, or READMEs to streamline bug reporting and technical tutorials.
  • Automated Workflow Integration: Utilize the CLI-based publishing to automatically upload script outputs or build logs to GitHub for remote monitoring and persistent storage.
namegithub-gist
descriptionPublish 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".

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