GitHub Gist Management Skill

This skill provides operations for managing GitHub Gists - simple way to share code snippets, notes, and small files.

Available Operations

1. Create Gist

Create new gists (public or secret).

2. List Gists

View your gists or public gists.

3. View Gist

Display gist content.

4. Edit Gist

Update gist files and description.

5. Delete Gist

Remove a gist.

6. Clone Gist

Clone gist as a Git repository.

7. Star/Unstar Gist

Star gists to save them.

8. Fork Gist

Fork someone else's gist.

Usage Examples

Create Gist

Create from file:

gh gist create myfile.js --desc "Useful JavaScript function"

Create public gist:

gh gist create myfile.py --public --desc "Python script"

Create secret gist:

gh gist create config.yaml --desc "Configuration file"

Create from multiple files:

gh gist create file1.js file2.js file3.js --desc "Project files"

Create from stdin:

echo "console.log('Hello')" | gh gist create --filename hello.js --desc "Hello world"

Create in browser:

gh gist create myfile.txt --web

List Gists

List your gists:

gh gist list

Limit results:

gh gist list --limit 50

List public gists only:

gh gist list --public

List secret gists only:

gh gist list --secret

View Gist

View gist content:

gh gist view abc123def456

View specific file:

gh gist view abc123def456 --filename myfile.js

View in browser:

gh gist view abc123def456 --web

View raw content:

gh gist view abc123def456 --raw

Edit Gist

Edit gist file:

gh gist edit abc123def456 --filename myfile.js

Add file to gist:

gh gist edit abc123def456 --add newfile.js

Update description:

# Use API
gh api gists/abc123def456 -X PATCH -f description="Updated description"

Delete Gist

Delete gist:

gh gist delete abc123def456

Delete with confirmation:

gh gist delete abc123def456 --confirm

Clone Gist

Clone gist as Git repo:

gh gist clone abc123def456

Clone to specific directory:

gh gist clone abc123def456 my-gist-folder

Star Gist

Using API to star:

gh api gists/abc123def456/star -X PUT

Unstar:

gh api gists/abc123def456/star -X DELETE

Check if starred:

gh api gists/abc123def456/star

List starred gists:

gh api gists/starred --jq '.[] | {id, description, files: .files | keys}'

Fork Gist

Fork using API:

gh api gists/abc123def456/forks -X POST --jq '{id, url: .html_url}'

Common Patterns

Quick Code Sharing

# Share a code snippet
cat script.sh | gh gist create --filename script.sh --desc "Deployment script" --public

# Get the URL
gh gist list --limit 1

Backup Configuration

# Backup dotfiles
gh gist create ~/.bashrc ~/.vimrc --desc "My dotfiles backup"

Collaborative Gist

# Create gist
gh gist create notes.md --public --desc "Meeting notes"

# Others can fork and modify
# gh gist fork abc123def456

Best Practices

1. Use descriptive names: Make filenames and descriptions clear
2. Public vs Secret: Use secret for sensitive (not private!) content
3. Version control: Gists are Git repos, commit history is preserved
4. Organize: Use consistent naming and descriptions
5. Clean up: Delete unused gists periodically

Integration with Other Skills

• Use repository-management for full projects
• Share code snippets from code-review discussions
• Quick prototypes before creating full repos

References

• GitHub CLI Gist Documentation
• GitHub Gists Guide
• Gists API