Thanks to visit codestin.com
Credit goes to github.com

Skip to content

pigfoot/gemini-cli-hubs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

pigfoot's Gemini Cli Hubs

A curated collection of plugins, skills, and configuration templates for Claude Code, plus integration with recommended third-party marketplaces.

What's Inside

πŸ”Œ Plugins

From this marketplace (pigfoot):

  • commit - Smart commit message generation with conventional commits, emoji prefixes, and GPG signing support
  • context7 - Access up-to-date documentation and code examples for any library or framework

Recommended third-party plugins (available in this marketplace):

  • superpowers - Comprehensive skills library with proven development workflows (TDD, debugging, code review)

🎯 Skills

Reusable workflow patterns included in plugins - automatically available after plugin installation.

βš™οΈ Configuration Templates

  • .GEMINI.md - Comprehensive development guidelines template (save as GEMINI.md in your project)

Prerequisites

Required Tools

Before using this marketplace, ensure you have these tools installed:

macOS (using Homebrew)

Recommended to use Homebrew:

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install required tools
brew install jq
brew install oven-sh/bun/bun
brew install uv

Linux

Use apt, apt-get, yum, pacman, apk or any native package manager tool.

Example (Debian/Ubuntu):

sudo apt-get update && sudo apt-get install -y jq

# bun for javascript/typescript
curl -fsSL https://bun.sh/install | bash
# uv for python
curl -LsSf https://astral.sh/uv/install.sh | sh
Running Gemini Cli on Windows

For the best experience, we recommend using Windows Terminal:

  • Windows 11: Windows Terminal is pre-installed. Just open it and run gemini.
  • Windows 10: Install Windows Terminal first:
    # Using winget
    winget install Microsoft.WindowsTerminal
    
    # Or using Scoop
    scoop install windows-terminal
Windows (Scoop)

Install tools using Scoop:

# Install Scoop if you don't have it
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

# Install required tools
scoop install jq
scoop install bun
scoop install uv

Note: Windows built-in winget is also possible, however Scoop is recommended for better compatibility with command line tools.

Install Gemini Cli

Follow the official installation guide or use one of the methods below:

Homebrew (macOS, Linux):

brew install gemini-cli

macOS, Linux, WSL, Git Bash:

bun install -g @google/gemini-cli

Custom Settings for Optimal Workflow (Optional)

This one-time setup gemini cli configures GEMINI.md for optimal workflow.

Step 1: Custom Configure

Run these commands to optimize gemini cli settings

# Create settings file if it does not exist
[[ ! -r "${HOME}/.gemini/settings.json" ]] && mkdir -p "${HOME}/.gemini" && echo "{}" > "${HOME}/.gemini/settings.json"
jq "$(cat <<'EOF'
  .contextFileName = (((.contextFileName // []) + ["GEMINI.md", "AGENTS.md"])
  | unique)
  | .general.previewFeatures = true
  | .security.auth.selectedType = "gemini-api-key"
  | .ui.hideTips = true
  | .usageStatisticsEnabled = false
EOF
)" ${HOME}/.gemini/settings.json > /tmp/temp.json && mv -f /tmp/temp.json ${HOME}/.gemini/settings.json

Step 2: Install Extensions

Run these commands to install extensions from pigfoot/gemini-cli-hubs:

mkdir -p "${HOME}/.skillz"
gemini extensions install https://github.com/pigfoot/gemini-cli-hubs

Step 3: Setup GEMINI.md Template (Optional but Recommended)

The .GEMINI.md template provides comprehensive development guidelines that work with installed extensions.

Option 1: Apply to current project (Recommended) This ensures Gemini follows these rules for this specific project.

macOS, Linux, WSL, Git Bash:

curl -fsSL https://raw.githubusercontent.com/pigfoot/gemini-cli-hubs/main/.GEMINI.md -o "./GEMINI.md"

Option 2: Save as global template Useful for copying to new projects later.

mkdir -p "${HOME}/.gemini"
curl -fsSL https://raw.githubusercontent.com/pigfoot/gemini-cli-hubs/main/.GEMINI.md -o "${HOME}/.gemini/GEMINI.md"

Usage

🎯 commit Plugin - Smart Git Commits

mkdir -p "${HOME}/.skillz/commit"
curl -fsSL https://raw.githubusercontent.com/pigfoot/claude-code-hubs/refs/heads/main/plugins/commit/skills/commit/SKILL.md -o "${HOME}/.skillz/commit/SKILL.md"

What it does: Automates the tedious parts of creating well-formatted commits.

Benefits:

  • βœ… No more commit message writer's block - Analyzes your changes and suggests appropriate messages
  • βœ… Consistent format - Automatic conventional commits with emoji (✨ feat:, πŸ› fix:, etc.)
  • βœ… Multi-concern detection - Suggests splitting commits when you've mixed different types of changes
  • βœ… GPG signing made easy - Handles passphrase caching automatically
  • βœ… DCO compliance - Always includes --signoff for projects requiring it

Usage: Just say "commit changes" and Claude will handle the rest.

Example:

User: "commit changes"
β†’ Claude analyzes: auth changes + UI updates + docs
β†’ Suggests: Split into 3 commits?
β†’ Creates: ✨ feat: add JWT authentication
         πŸ’„ style: update login UI
         πŸ“ docs: update auth documentation

πŸ“š context7 Plugin - Up-to-Date Library Docs

/plugin install context7@pigfoot

What it does: Fetches current documentation and code examples from any library or framework.

Benefits:

  • βœ… Always current - Gets latest docs, not outdated LLM training data
  • βœ… Better suggestions - Claude works with actual API docs and best practices
  • βœ… Faster learning - No need to manually browse documentation sites
  • βœ… Accurate examples - Real code snippets from official sources
  • βœ… Version-specific - Can target specific library versions

Usage: Ask Claude about any library naturally.

Examples:

  • "Show me the latest Next.js routing docs"
  • "How do I use MongoDB aggregation pipeline?"
  • "What are the best practices for React hooks?"
  • "How to configure Vite for a library?"

Behind the scenes: Claude automatically fetches documentation from Context7's curated database.


🦸 superpowers Plugin - Proven Development Workflows

/plugin install superpowers@pigfoot

Note: This is a third-party plugin originally from obra/superpowers, available in this marketplace for convenient installation

What it does: Provides a comprehensive library of battle-tested skills that enforce systematic development practices.

Benefits:

  • βœ… TDD enforcement - Test-Driven Development skill ensures you write tests first
  • βœ… Systematic debugging - Four-phase framework (investigate β†’ analyze β†’ test β†’ implement) instead of guess-and-fix
  • βœ… Code review automation - Built-in review checkpoints before completing major tasks
  • βœ… Better planning - Skills for breaking down complex work into manageable tasks
  • βœ… Verification gates - "Evidence before claims" - forces running tests before saying "it works"
  • βœ… Parallel execution - Dispatch multiple agents for independent tasks
  • βœ… Anti-patterns prevention - Stops common mistakes (testing mocks, skipping tests, etc.)

Key Skills Included:

Testing:

  • test-driven-development - Write test first, watch it fail, make it pass
  • condition-based-waiting - Replace flaky timeouts with condition polling
  • testing-anti-patterns - Prevents testing mock behavior and test-only methods

Debugging:

  • systematic-debugging - Root cause first, then fix (no more guess-and-patch)
  • root-cause-tracing - Trace bugs backward through call stack
  • verification-before-completion - Must run verification before claiming "done"
  • defense-in-depth - Validate at every layer to make bugs structurally impossible

Collaboration:

  • brainstorming - Refines rough ideas into solid designs via Socratic method
  • writing-plans - Creates detailed implementation plans for engineers
  • executing-plans - Executes plans in batches with review checkpoints
  • requesting-code-review - Automatic review against requirements
  • dispatching-parallel-agents - Handle multiple independent failures concurrently

Development:

  • using-git-worktrees - Isolated workspaces for parallel feature work
  • finishing-a-development-branch - Structured options for merge/PR/cleanup

Usage: Skills activate automatically when relevant, or you can invoke directly.

Examples:

# Automatic activation
User: "Add user authentication"
β†’ brainstorming skill activates for design refinement
β†’ test-driven-development activates during implementation
β†’ verification-before-completion activates before claiming done

# Manual invocation
User: "/brainstorm how to architect this feature"

Why it matters: Without superpowers, you might get working code. With superpowers, you get tested, verified, systematically-designed code that follows proven patterns.


βš™οΈ GEMINI.md Configuration

Once configured, the Gemini CLI will:

  • Auto-detect your communication language (supports Traditional Chinese, Japanese, etc.)
  • Write all code and documentation in English
  • Follow your project's conventions
  • Apply TDD workflow automatically (when superpowers installed)
  • Use the right tools for your stack
  • Integrate seamlessly with commit and context7 plugins

Available Plugins

Plugin Description Version
commit Conventional commits with emoji and GPG signing 0.0.1
context7 Library documentation via Context7 MCP server 0.0.1

Project Structure

gemini-cli-hubs/
β”œβ”€β”€ .claude-plugin/
β”‚   └── marketplace.json      # Marketplace registry
β”œβ”€β”€ plugins/
β”‚   β”œβ”€β”€ commit/               # Git commit automation plugin
β”‚   └── context7/             # Documentation plugin
β”œβ”€β”€ .GEMINI.md                # Global configuration template
β”œβ”€β”€ .specify/                 # Spec-kit templates and memory
└── README.md                 # This file

Troubleshooting

Click to expand troubleshooting guide

Permission Issues

If the Gemini CLI asks for permissions repeatedly:

# Verify settings were applied
cat ~/.gemini/settings.json | jq '.permissions.allow'

# Re-run the permission configuration script

Plugin Installation Fails

# Inside Claude Code, check marketplace connection
/plugin marketplace list

# Try removing and re-adding marketplace
/plugin marketplace remove pigfoot/claude-code-hubs
/plugin marketplace add pigfoot/claude-code-hubs

Tools Not Found

Ensure tools are in your PATH:

# Check installations
which jq bun uv

# If not found, reinstall following Prerequisites section

Advanced Configuration

Customizing GEMINI.md

The template includes:

  • Language Detection: Auto-detects your primary language
  • Git Workflow: Smart commit patterns with the commit plugin
  • Testing: TDD workflow activation
  • Tool Detection: Auto-discovers your project's stack

Edit ~/.gemini/GEMINI.md or ./GEMINI.md to customize for your needs.

Adding More Plugins

Browse available plugins in plugins/ directory, then:

/plugin install <plugin-name>@pigfoot

Available Plugins

Plugin Origin Description Skills Included
commit pigfoot Conventional commits with emoji and GPG signing commit:commit
context7 pigfoot Library documentation via Context7 MCP context7:skills
superpowers 3rd-party (obra) Proven development workflows (TDD, debugging, review) 17+ skills (brainstorming, TDD, systematic-debugging, etc.)

Installation: All plugins can be installed from this marketplace using /plugin install <name>@pigfoot

Contributing

Contributions are welcome! If you'd like to add a plugin or improve existing ones:

For Plugin Developers

Interested in creating your own plugins? See our Developer Guide for:

  • Plugin structure and standards
  • Skill development best practices
  • Testing and quality requirements
  • Submission process

License

This project is licensed under the MIT License - see individual plugin LICENSE files for specific terms.

Support

  • Issues: Report bugs or request features via GitHub Issues
  • Discussions: Ask questions or share ideas in GitHub Discussions
  • Documentation: See Claude Code docs

Acknowledgments

  • Maintainer: Chih-Chia Chen (pigfoot)
  • Contributors: See individual plugin author information
  • Built for: Claude Code by Anthropic

Related Resources


Version: 0.0.1 | Last Updated: 2025-11-06

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published