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