pigfoot-marketplace

Curated Gemini cli extensions: skills, workflows, and productivity tools
Open source Open in the app JSON README (API)
About

Curated Gemini cli extensions: skills, workflows, and productivity tools
Details

Kind: Plugins
Topic: AI, RAG & memory
Publisher: pigfoot
Origin: gemini
Category: ferramentas
Version: 0.0.1
Last push: 2025-12-08T08:36:58Z
Repository state: ativo
License: MIT
Added: 2026-08-30 14:13:39
Updated: 2026-08-30 14:13:39
Origin id: pigfoot/gemini-cli-hubs
README

# pigfoot's Gemini Cli Hubs

A 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.

## What's Inside

### 🔌 Plugins

**From this marketplace (pigfoot):**
- **[commit](./plugins/commit/)** - Smart commit message generation with conventional commits, emoji prefixes, and GPG signing support
- **[context7](./plugins/context7/)** - Access up-to-date documentation and code examples for any library or framework

**Recommended third-party plugins (available in this marketplace):**
- **[superpowers](https://github.com/obra/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](./.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](https://brew.sh/):

```bash
# 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):**
```bash
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
```

<details>
<summary>Running Gemini Cli on Windows</summary>

For the best experience, we recommend using [Windows Terminal](https://aka.ms/terminal):

- **Windows 11:** Windows Terminal is pre-installed. Just open it and run `gemini`.
- **Windows 10:** Install Windows Terminal first:
  ```powershell
  # Using winget
  winget install Microsoft.WindowsTerminal

  # Or using Scoop
  scoop install windows-terminal
  ```

</details>

<details>
<summary>Windows (Scoop)</summary>

Install tools using [Scoop](https://scoop.sh/):

```powershell
# 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.

</details>

## Install Gemini Cli

Follow the [official installation guide](https://github.com/google-gemini/gemini-cli) or use one of the methods below:

**Homebrew (macOS, Linux):**
```bash
brew install gemini-cli
```

**macOS, Linux, WSL, Git Bash:**
```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

```bash
# 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](https://github.com/pigfoot/gemini-cli-hubs):

```bash
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](https://github.com/pigfoot/gemini-cli-hubs/blob/main/.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:**
```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.

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

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

```bash
/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

```bash
/plugin install superpowers@pigfoot
```

> **Note:** This is a third-party plugin originally from [obra/superpowers](https://github.com/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:**
```bash
# 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](./plugins/commit/) | Conventional commits with emoji and GPG signing | 0.0.1 |
| [context7](./plugins/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

<details>
<summary>Click to expand troubleshooting guide</summary>

### Permission Issues

If the Gemini CLI asks for permissions repeatedly:
```bash
# Verify settings were applied
cat ~/.gemini/settings.json | jq '.permissions.allow'

# Re-run the permission configuration script
```

### Plugin Installation Fails

```bash
# 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:
```bash
# Check installations
which jq bun uv

# If not found, reinstall following Prerequisites section
```

</details>

## 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:
```bash
/plugin install <plugin-name>@pigfoot
```

## Available Plugins

| Plugin | Origin | Description | Skills Included |
|--------|--------|-------------|-----------------|
| [commit](./plugins/commit/) | pigfoot | Conventional commits with emoji and GPG signing | `commit:commit` |
| [context7](./plugins/context7/) | pigfoot | Library documentation via Context7 MCP | `context7:skills` |
| [superpowers](https://github.com/obra/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:
- Read [.specify/memory/constitution.md](./.specify/memory/constitution.md) for project principles
- Include complete documentation and tests
- Use semantic versioning

## For Plugin Developers

Interested in creating your own plugins? See our [Developer Guide](./docs/DEVELOPMENT.md) 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](https://docs.claude.com/en/docs/claude-code)

## Acknowledgments

- **Maintainer**: Chih-Chia Chen (pigfoot)
- **Contributors**: See individual plugin author information
- **Built for**: [Claude Code](https://docs.claude.com/en/docs/claude-code) by Anthropic

## Related Resources

- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)
- [Spec-Kit Templates](./.specify/templates/)
- [Plugin Development Guide](https://docs.claude.com/en/docs/claude-code/plugins)

---

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