AgentSkillsCN

github-gist

快速从文件、代码片段或文本内容创建 GitHub gists。当用户想通过 GitHub gists 分享代码或导出内容为 gist 格式时使用。

SKILL.md
--- frontmatter
name: github-gist
description: 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.
license: MIT
metadata:
  author: Kenny Gatdula
  version: "1.0.0"
  tags: github, gist, export, sharing, utility, universal
  compatibility: Any agentskills.io-compatible agent

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:

bash
gist.sh path/to/file.js

Create a public gist from a file:

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

Create a gist with a custom description:

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

Create a gist from multiple files:

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

Create a gist with stdin:

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

Advanced Usage

Combine options:

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

Specify custom filename (when using stdin):

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

Don't open browser automatically:

bash
gist.sh --no-browser file.js

Use with GitHub Enterprise:

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

Or set the GH_HOST environment variable:

bash
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:

bash
gist.sh src/components/Button.tsx

Quick snippet sharing:

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

Export multiple related files:

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

"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