Smithery Logo
MCPsSkillsDocsPricing
Login
Smithery Logo

Accelerating the Agent Economy

Resources

DocumentationPrivacy PolicySystem Status

Company

PricingAboutBlog

Connect

© 2026 Smithery. All rights reserved.

    kennyg

    github-gist

    kennyg/github-gist
    Coding
    1 installs

    About

    SKILL.md

    Install

    Install via Skills CLI

    or add to your agent
    • Claude Code
      Claude Code
    • Codex
      Codex
    • OpenClaw
      OpenClaw
    • Cursor
      Cursor
    • Amp
      Amp
    • GitHub Copilot
      GitHub Copilot
    • Gemini CLI
      Gemini CLI
    • Kilo Code
      Kilo Code
    • Junie
      Junie
    • Replit
      Replit
    • Windsurf
      Windsurf
    • Cline
      Cline
    • Continue
      Continue
    • OpenCode
      OpenCode
    • OpenHands
      OpenHands
    • Roo Code
      Roo Code
    • Augment
      Augment
    • Goose
      Goose
    • Trae
      Trae
    • Zencoder
      Zencoder
    • Antigravity
      Antigravity
    ├─
    ├─
    └─

    About

    Create GitHub gists quickly from files, code snippets, or text content. Use when the user wants to share code via GitHub gists or export content to gist format.

    SKILL.md

    GitHub Gist Creation

    Create GitHub gists quickly from files, code snippets, or text content. This skill simplifies the process of sharing code and conversations via GitHub gists.

    Features

    • Create private or public gists
    • Support for single or multiple files
    • Custom descriptions and filenames
    • Automatic browser opening to view created gist
    • GitHub Enterprise support via --host option
    • GitHub CLI integration

    Prerequisites

    • GitHub CLI (gh) must be installed and authenticated
    • Run gh auth login if not already authenticated

    Usage

    Basic Examples

    Create a private gist from a file:

    gist.sh path/to/file.js
    

    Create a public gist from a file:

    gist.sh --public path/to/file.js
    

    Create a gist with a custom description:

    gist.sh --desc "My awesome code snippet" file.js
    

    Create a gist from multiple files:

    gist.sh file1.js file2.md file3.txt
    

    Create a gist with stdin:

    echo "console.log('hello')" | gist.sh --filename "hello.js"
    

    Advanced Usage

    Combine options:

    gist.sh --public --desc "React component example" component.jsx
    

    Specify custom filename (when using stdin):

    cat script.sh | gist.sh --filename "deploy.sh" --desc "Deployment script"
    

    Don't open browser automatically:

    gist.sh --no-browser file.js
    

    Use with GitHub Enterprise:

    gist.sh --host github.mycompany.com file.js
    

    Or set the GH_HOST environment variable:

    GH_HOST=github.mycompany.com gist.sh file.js
    

    Script Arguments

    • --public - Create a public gist (default is private)
    • --desc "description" - Add a description to the gist
    • --filename "name" - Specify filename when using stdin
    • --no-browser - Don't open the gist in browser after creation
    • --host "hostname" - GitHub Enterprise host (or set GH_HOST env var)
    • Any other arguments are treated as file paths

    Compatibility

    This skill works with any agent that supports the agentskills.io format:

    • ✅ OpenCode
    • ✅ Claude Code
    • ✅ Cursor
    • ✅ VS Code with agentskills support
    • ✅ Any agentskills.io-compatible agent

    How It Works

    The skill uses the GitHub CLI (gh gist create) to create gists. It automatically:

    1. Checks if you're authenticated with GitHub
    2. Parses your arguments to build the appropriate gh command
    3. Creates the gist with your specified options
    4. Opens the gist in your browser (unless --no-browser is specified)

    Common Use Cases

    Share a code file:

    gist.sh src/components/Button.tsx
    

    Quick snippet sharing:

    echo "SELECT * FROM users WHERE active = true;" | gist.sh --filename "query.sql" --public
    

    Export multiple related files:

    gist.sh --desc "API documentation" api.md examples.js tests.js
    

    Agent Integration: Works in any agent that can execute shell scripts and supports agentskills.io.

    Tips

    • Use --public sparingly - private gists are safer for sensitive code
    • Add meaningful descriptions to make gists easier to find later
    • You can edit or delete gists later via gh gist edit or gh gist delete
    • View all your gists with gh gist list

    Troubleshooting

    "gh: command not found"

    • Install GitHub CLI: https://cli.github.com/

    "authentication required"

    • Run gh auth login and follow the prompts

    "failed to create gist"

    • Check that the file paths are correct
    • Ensure you have an internet connection
    • Verify GitHub CLI is properly authenticated

    See Also

    • GitHub CLI documentation: https://cli.github.com/manual/gh_gist_create
    • Managing gists: gh gist list, gh gist edit, gh gist delete
    • Agent Skills specification: https://agentskills.io
    Recommended Servers
    GitHub
    GitHub
    Vercel Grep
    Vercel Grep
    Bitbucket
    Bitbucket
    Repository
    kennyg/agent-toolkit
    Files