{
  "markdown": "# pigfoot's Gemini Cli Hubs\n\nA curated collection of plugins, skills, and configuration templates for [Claude Code](https://docs.claude.com/en/docs/claude-code), plus integration with recommended third-party marketplaces.\n\n## What's Inside\n\n### 🔌 Plugins\n\n**From this marketplace (pigfoot):**\n- **[commit](./plugins/commit/)** - Smart commit message generation with conventional commits, emoji prefixes, and GPG signing support\n- **[context7](./plugins/context7/)** - Access up-to-date documentation and code examples for any library or framework\n\n**Recommended third-party plugins (available in this marketplace):**\n- **[superpowers](https://github.com/obra/superpowers)** - Comprehensive skills library with proven development workflows (TDD, debugging, code review)\n\n### 🎯 Skills\n\nReusable workflow patterns included in plugins - automatically available after plugin installation.\n\n### ⚙️ Configuration Templates\n\n- **[.GEMINI.md](./.GEMINI.md)** - Comprehensive development guidelines template (save as `GEMINI.md` in your project)\n\n\n## Prerequisites\n\n### Required Tools\n\nBefore using this marketplace, ensure you have these tools installed:\n\n#### macOS (using Homebrew)\n\nRecommended to use [Homebrew](https://brew.sh/):\n\n```bash\n# Install Homebrew if you don't have it\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n\n# Install required tools\nbrew install jq\nbrew install oven-sh/bun/bun\nbrew install uv\n```\n\n#### Linux\n\nUse `apt`, `apt-get`, `yum`, `pacman`, `apk` or any native package manager tool.\n\n**Example (Debian/Ubuntu):**\n```bash\nsudo apt-get update && sudo apt-get install -y jq\n\n# bun for javascript/typescript\ncurl -fsSL https://bun.sh/install | bash\n# uv for python\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n<details>\n<summary>Running Gemini Cli on Windows</summary>\n\nFor the best experience, we recommend using [Windows Terminal](https://aka.ms/terminal):\n\n- **Windows 11:** Windows Terminal is pre-installed. Just open it and run `gemini`.\n- **Windows 10:** Install Windows Terminal first:\n  ```powershell\n  # Using winget\n  winget install Microsoft.WindowsTerminal\n\n  # Or using Scoop\n  scoop install windows-terminal\n  ```\n\n</details>\n\n<details>\n<summary>Windows (Scoop)</summary>\n\nInstall tools using [Scoop](https://scoop.sh/):\n\n```powershell\n# Install Scoop if you don't have it\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\nInvoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression\n\n# Install required tools\nscoop install jq\nscoop install bun\nscoop install uv\n```\n\n> **Note:** Windows built-in `winget` is also possible, however Scoop is recommended for better compatibility with command line tools.\n\n</details>\n\n## Install Gemini Cli\n\nFollow the [official installation guide](https://github.com/google-gemini/gemini-cli) or use one of the methods below:\n\n**Homebrew (macOS, Linux):**\n```bash\nbrew install gemini-cli\n```\n\n**macOS, Linux, WSL, Git Bash:**\n```bash\nbun install -g @google/gemini-cli\n```\n\n## Custom Settings for Optimal Workflow (Optional)\n\nThis one-time setup gemini cli configures `GEMINI.md` for optimal workflow.\n\n### Step 1: Custom Configure\n\nRun these commands to optimize gemini cli settings\n\n```bash\n# Create settings file if it does not exist\n[[ ! -r \"${HOME}/.gemini/settings.json\" ]] && mkdir -p \"${HOME}/.gemini\" && echo \"{}\" > \"${HOME}/.gemini/settings.json\"\njq \"$(cat <<'EOF'\n  .contextFileName = (((.contextFileName // []) + [\"GEMINI.md\", \"AGENTS.md\"])\n  | unique)\n  | .general.previewFeatures = true\n  | .security.auth.selectedType = \"gemini-api-key\"\n  | .ui.hideTips = true\n  | .usageStatisticsEnabled = false\nEOF\n)\" ${HOME}/.gemini/settings.json > /tmp/temp.json && mv -f /tmp/temp.json ${HOME}/.gemini/settings.json\n```\n\n### Step 2: Install Extensions\n\nRun these commands to install extensions from [pigfoot/gemini-cli-hubs](https://github.com/pigfoot/gemini-cli-hubs):\n\n```bash\nmkdir -p \"${HOME}/.skillz\"\ngemini extensions install https://github.com/pigfoot/gemini-cli-hubs\n```\n\n### Step 3: Setup GEMINI.md Template (Optional but Recommended)\n\nThe [.GEMINI.md](https://github.com/pigfoot/gemini-cli-hubs/blob/main/.GEMINI.md) template provides comprehensive development guidelines that work with installed extensions.\n\n**Option 1: Apply to current project (Recommended)**\nThis ensures Gemini follows these rules for this specific project.\n\n**macOS, Linux, WSL, Git Bash:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/pigfoot/gemini-cli-hubs/main/.GEMINI.md -o \"./GEMINI.md\"\n```\n\n**Option 2: Save as global template**\nUseful for copying to new projects later.\n\n```bash\nmkdir -p \"${HOME}/.gemini\"\ncurl -fsSL https://raw.githubusercontent.com/pigfoot/gemini-cli-hubs/main/.GEMINI.md -o \"${HOME}/.gemini/GEMINI.md\"\n```\n\n## Usage\n\n### 🎯 commit Plugin - Smart Git Commits\n\n```bash\nmkdir -p \"${HOME}/.skillz/commit\"\ncurl -fsSL https://raw.githubusercontent.com/pigfoot/claude-code-hubs/refs/heads/main/plugins/commit/skills/commit/SKILL.md -o \"${HOME}/.skillz/commit/SKILL.md\"\n\n```\n\n**What it does:**\nAutomates the tedious parts of creating well-formatted commits.\n\n**Benefits:**\n- ✅ **No more commit message writer's block** - Analyzes your changes and suggests appropriate messages\n- ✅ **Consistent format** - Automatic conventional commits with emoji (`✨ feat:`, `🐛 fix:`, etc.)\n- ✅ **Multi-concern detection** - Suggests splitting commits when you've mixed different types of changes\n- ✅ **GPG signing made easy** - Handles passphrase caching automatically\n- ✅ **DCO compliance** - Always includes --signoff for projects requiring it\n\n**Usage:**\nJust say \"commit changes\" and Claude will handle the rest.\n\n**Example:**\n```bash\nUser: \"commit changes\"\n→ Claude analyzes: auth changes + UI updates + docs\n→ Suggests: Split into 3 commits?\n→ Creates: ✨ feat: add JWT authentication\n         💄 style: update login UI\n         📝 docs: update auth documentation\n```\n\n---\n\n### 📚 context7 Plugin - Up-to-Date Library Docs\n\n```bash\n/plugin install context7@pigfoot\n```\n\n**What it does:**\nFetches current documentation and code examples from any library or framework.\n\n**Benefits:**\n- ✅ **Always current** - Gets latest docs, not outdated LLM training data\n- ✅ **Better suggestions** - Claude works with actual API docs and best practices\n- ✅ **Faster learning** - No need to manually browse documentation sites\n- ✅ **Accurate examples** - Real code snippets from official sources\n- ✅ **Version-specific** - Can target specific library versions\n\n**Usage:**\nAsk Claude about any library naturally.\n\n**Examples:**\n- \"Show me the latest Next.js routing docs\"\n- \"How do I use MongoDB aggregation pipeline?\"\n- \"What are the best practices for React hooks?\"\n- \"How to configure Vite for a library?\"\n\n**Behind the scenes:**\nClaude automatically fetches documentation from Context7's curated database.\n\n---\n\n### 🦸 superpowers Plugin - Proven Development Workflows\n\n```bash\n/plugin install superpowers@pigfoot\n```\n\n> **Note:** This is a third-party plugin originally from [obra/superpowers](https://github.com/obra/superpowers), available in this marketplace for convenient installation\n\n**What it does:**\nProvides a comprehensive library of battle-tested skills that enforce systematic development practices.\n\n**Benefits:**\n- ✅ **TDD enforcement** - Test-Driven Development skill ensures you write tests first\n- ✅ **Systematic debugging** - Four-phase framework (investigate → analyze → test → implement) instead of guess-and-fix\n- ✅ **Code review automation** - Built-in review checkpoints before completing major tasks\n- ✅ **Better planning** - Skills for breaking down complex work into manageable tasks\n- ✅ **Verification gates** - \"Evidence before claims\" - forces running tests before saying \"it works\"\n- ✅ **Parallel execution** - Dispatch multiple agents for independent tasks\n- ✅ **Anti-patterns prevention** - Stops common mistakes (testing mocks, skipping tests, etc.)\n\n**Key Skills Included:**\n\n**Testing:**\n- `test-driven-development` - Write test first, watch it fail, make it pass\n- `condition-based-waiting` - Replace flaky timeouts with condition polling\n- `testing-anti-patterns` - Prevents testing mock behavior and test-only methods\n\n**Debugging:**\n- `systematic-debugging` - Root cause first, then fix (no more guess-and-patch)\n- `root-cause-tracing` - Trace bugs backward through call stack\n- `verification-before-completion` - Must run verification before claiming \"done\"\n- `defense-in-depth` - Validate at every layer to make bugs structurally impossible\n\n**Collaboration:**\n- `brainstorming` - Refines rough ideas into solid designs via Socratic method\n- `writing-plans` - Creates detailed implementation plans for engineers\n- `executing-plans` - Executes plans in batches with review checkpoints\n- `requesting-code-review` - Automatic review against requirements\n- `dispatching-parallel-agents` - Handle multiple independent failures concurrently\n\n**Development:**\n- `using-git-worktrees` - Isolated workspaces for parallel feature work\n- `finishing-a-development-branch` - Structured options for merge/PR/cleanup\n\n**Usage:**\nSkills activate automatically when relevant, or you can invoke directly.\n\n**Examples:**\n```bash\n# Automatic activation\nUser: \"Add user authentication\"\n→ brainstorming skill activates for design refinement\n→ test-driven-development activates during implementation\n→ verification-before-completion activates before claiming done\n\n# Manual invocation\nUser: \"/brainstorm how to architect this feature\"\n```\n\n**Why it matters:**\nWithout superpowers, you might get working code. With superpowers, you get **tested, verified, systematically-designed code** that follows proven patterns.\n\n---\n\n### ⚙️ GEMINI.md Configuration\n\nOnce configured, the Gemini CLI will:\n- Auto-detect your communication language (supports Traditional Chinese, Japanese, etc.)\n- Write all code and documentation in English\n- Follow your project's conventions\n- Apply TDD workflow automatically (when superpowers installed)\n- Use the right tools for your stack\n- Integrate seamlessly with commit and context7 plugins\n\n## Available Plugins\n\n| Plugin | Description | Version |\n|--------|-------------|---------|\n| [commit](./plugins/commit/) | Conventional commits with emoji and GPG signing | 0.0.1 |\n| [context7](./plugins/context7/) | Library documentation via Context7 MCP server | 0.0.1 |\n\n## Project Structure\n\n```\ngemini-cli-hubs/\n├── .claude-plugin/\n│   └── marketplace.json      # Marketplace registry\n├── plugins/\n│   ├── commit/               # Git commit automation plugin\n│   └── context7/             # Documentation plugin\n├── .GEMINI.md                # Global configuration template\n├── .specify/                 # Spec-kit templates and memory\n└── README.md                 # This file\n```\n\n## Troubleshooting\n\n<details>\n<summary>Click to expand troubleshooting guide</summary>\n\n### Permission Issues\n\nIf the Gemini CLI asks for permissions repeatedly:\n```bash\n# Verify settings were applied\ncat ~/.gemini/settings.json | jq '.permissions.allow'\n\n# Re-run the permission configuration script\n```\n\n### Plugin Installation Fails\n\n```bash\n# Inside Claude Code, check marketplace connection\n/plugin marketplace list\n\n# Try removing and re-adding marketplace\n/plugin marketplace remove pigfoot/claude-code-hubs\n/plugin marketplace add pigfoot/claude-code-hubs\n```\n\n### Tools Not Found\n\nEnsure tools are in your PATH:\n```bash\n# Check installations\nwhich jq bun uv\n\n# If not found, reinstall following Prerequisites section\n```\n\n</details>\n\n## Advanced Configuration\n\n### Customizing GEMINI.md\n\nThe template includes:\n- **Language Detection**: Auto-detects your primary language\n- **Git Workflow**: Smart commit patterns with the commit plugin\n- **Testing**: TDD workflow activation\n- **Tool Detection**: Auto-discovers your project's stack\n\nEdit `~/.gemini/GEMINI.md` or `./GEMINI.md` to customize for your needs.\n\n### Adding More Plugins\n\nBrowse available plugins in `plugins/` directory, then:\n```bash\n/plugin install <plugin-name>@pigfoot\n```\n\n## Available Plugins\n\n| Plugin | Origin | Description | Skills Included |\n|--------|--------|-------------|-----------------|\n| [commit](./plugins/commit/) | pigfoot | Conventional commits with emoji and GPG signing | `commit:commit` |\n| [context7](./plugins/context7/) | pigfoot | Library documentation via Context7 MCP | `context7:skills` |\n| [superpowers](https://github.com/obra/superpowers) | 3rd-party (obra) | Proven development workflows (TDD, debugging, review) | 17+ skills (brainstorming, TDD, systematic-debugging, etc.) |\n\n**Installation:** All plugins can be installed from this marketplace using `/plugin install <name>@pigfoot`\n\n## Contributing\n\nContributions are welcome! If you'd like to add a plugin or improve existing ones:\n- Read [.specify/memory/constitution.md](./.specify/memory/constitution.md) for project principles\n- Include complete documentation and tests\n- Use semantic versioning\n\n## For Plugin Developers\n\nInterested in creating your own plugins? See our [Developer Guide](./docs/DEVELOPMENT.md) for:\n- Plugin structure and standards\n- Skill development best practices\n- Testing and quality requirements\n- Submission process\n\n## License\n\nThis project is licensed under the MIT License - see individual plugin LICENSE files for specific terms.\n\n## Support\n\n- **Issues**: Report bugs or request features via GitHub Issues\n- **Discussions**: Ask questions or share ideas in GitHub Discussions\n- **Documentation**: See [Claude Code docs](https://docs.claude.com/en/docs/claude-code)\n\n## Acknowledgments\n\n- **Maintainer**: Chih-Chia Chen (pigfoot)\n- **Contributors**: See individual plugin author information\n- **Built for**: [Claude Code](https://docs.claude.com/en/docs/claude-code) by Anthropic\n\n## Related Resources\n\n- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)\n- [Spec-Kit Templates](./.specify/templates/)\n- [Plugin Development Guide](https://docs.claude.com/en/docs/claude-code/plugins)\n\n---\n\n**Version**: 0.0.1 | **Last Updated**: 2025-11-06\n",
  "bytes": 14027,
  "sha": "a2040c7757808310954a7b3d7094da8ef0b55941956dcc3f95682b140609219a",
  "repo_slug": "pigfoot/gemini-cli-hubs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pigfoot_gemini_cli_hubs_7959b834/readme"
}