A curated collection of plugins, skills, and configuration templates for Claude Code, plus integration with recommended third-party marketplaces.
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)
Reusable workflow patterns included in plugins - automatically available after plugin installation.
- .GEMINI.md - Comprehensive development guidelines template (save as
GEMINI.mdin your project)
Before using this marketplace, ensure you have these tools installed:
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 uvUse 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 | shRunning 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 uvNote: Windows built-in
wingetis also possible, however Scoop is recommended for better compatibility with command line tools.
Follow the official installation guide or use one of the methods below:
Homebrew (macOS, Linux):
brew install gemini-climacOS, Linux, WSL, Git Bash:
bun install -g @google/gemini-cliThis one-time setup gemini cli configures GEMINI.md for optimal workflow.
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.jsonRun these commands to install extensions from pigfoot/gemini-cli-hubs:
mkdir -p "${HOME}/.skillz"
gemini extensions install https://github.com/pigfoot/gemini-cli-hubsThe .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"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/plugin install context7@pigfootWhat 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.
/plugin install superpowers@pigfootNote: 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 passcondition-based-waiting- Replace flaky timeouts with condition pollingtesting-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 stackverification-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 methodwriting-plans- Creates detailed implementation plans for engineersexecuting-plans- Executes plans in batches with review checkpointsrequesting-code-review- Automatic review against requirementsdispatching-parallel-agents- Handle multiple independent failures concurrently
Development:
using-git-worktrees- Isolated workspaces for parallel feature workfinishing-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.
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
| Plugin | Description | Version |
|---|---|---|
| commit | Conventional commits with emoji and GPG signing | 0.0.1 |
| context7 | Library documentation via Context7 MCP server | 0.0.1 |
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
Click to expand troubleshooting guide
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# 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-hubsEnsure tools are in your PATH:
# Check installations
which jq bun uv
# If not found, reinstall following Prerequisites sectionThe 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.
Browse available plugins in plugins/ directory, then:
/plugin install <plugin-name>@pigfoot| 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
Contributions are welcome! If you'd like to add a plugin or improve existing ones:
- Read .specify/memory/constitution.md for project principles
- Include complete documentation and tests
- Use semantic versioning
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
This project is licensed under the MIT License - see individual plugin LICENSE files for specific terms.
- Issues: Report bugs or request features via GitHub Issues
- Discussions: Ask questions or share ideas in GitHub Discussions
- Documentation: See Claude Code docs
- Maintainer: Chih-Chia Chen (pigfoot)
- Contributors: See individual plugin author information
- Built for: Claude Code by Anthropic
Version: 0.0.1 | Last Updated: 2025-11-06