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/ghgistcreate
• Managing gists: gh gist list, gh gist edit, gh gist delete
• Agent Skills specification: https://agentskills.io