pigfoot's Claude Code 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
• nano-banana - AI image generation with Gemini models. Direct generation or interactive prompting with brand style support
• secure-container-build - Build secure container images with Wolfi runtime, non-root users, and multi-stage builds. Templates for Python/uv, Bun, Node.js/pnpm, Golang, and Rust
• github-actions-container-build - Build multi-architecture container images in GitHub Actions. Matrix builds (public repos), QEMU (private repos), Podman rootless builds

Recommended third-party plugins:

• context7 - Access up-to-date documentation and code examples for any library or framework (official from @claude-plugins-official)
• 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

• .CLAUDE.md - Comprehensive development guidelines template with language detection, workflow patterns, and best practices

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 Claude Code on Windows

For the best experience, we recommend using Windows Terminal:

• Windows 11: Windows Terminal is pre-installed. Just open it and run claude.
• 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 Claude Code

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

Homebrew (macOS, Linux):

brew install --cask claude-code

macOS, Linux, WSL, Git Bash:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

# Add to PATH (if needed)
[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin",
    "User"
)

Custom Settings for Optimal Workflow (Optional)

This one-time setup grants Claude Code necessary permissions and configures CLAUDE.md for optimal workflow.

Step 1: Configure Allow Permissions

What this does:

• Grants permissions for common commands (git, file operations, package managers)
• Enables skills and MCP tools
• Optimizes Claude Code settings

macOS, Linux, WSL, Git Bash:

# Create settings file if it doesn't exist
[[ ! -r "${HOME}/.claude/settings.json" ]] && mkdir -p "${HOME}/.claude" && echo "{}" > "${HOME}/.claude/settings.json"

# Add permissions
jq "$(cat <<'EOF'
.permissions.allow = (((.permissions // {}).allow // []) + [
  "Bash(ls:*)", "Bash(pwd:*)", "Bash(echo:*)", "Bash(export:*)", "Bash(test:*)",
  "Bash(mkdir:*)", "Bash(mv:*)", "Bash(cat:*)", "Bash(cp:*)", "Bash(chmod:*)", "Bash(touch:*)",
  "Bash(grep:*)", "Bash(find:*)", "Bash(sed:*)", "Bash(head:*)", "Bash(xargs:*)",
  "Bash(git:*)", "Bash(gh:*)", "Bash(jq:*)", "Bash(curl:*)",
  "Bash(node:*)", "Bash(npm:*)", "Bash(pnpm:*)", "Bash(npx:*)", "Bash(bun:*)", "Bash(bunx:*)",
  "Bash(python:*)", "Bash(python3:*)", "Bash(uv:*)", "Bash(uvx:*)",
  "Bash(docker:*)", "Bash(podman:*)", "Bash(buildah:*)",
  "Bash(gh:*)", "Bash(gpg:*)", "Bash(gpgconf:*)",
  "Read", "Edit", "NotebookEdit", "Update", "Write", "WebFetch", "WebSearch",
  "Bash(.specify/scripts/bash/check-prerequisites.sh:*)", "Bash(.specify/scripts/bash/create-new-feature.sh:*)",
  "Bash(.specify/scripts/bash/setup-plan.sh:*)", "Bash(.specify/scripts/bash/update-agent-context.sh:*)",
  "mcp__plugin_context7_context7",
  "Skill(commit:*)", "Skill(nano-banana:*)", "Skill(superpowers:*)", "Skill(secure-container-build:*)", "Skill(github-actions-container-build:*)"
] | unique)
  | .alwaysThinkingEnabled = true
  | .includeCoAuthoredBy = false
  | .model = "opusplan"
  | .spinnerTipsEnabled = false
EOF
)" "${HOME}/.claude/settings.json" > /tmp/temp.json && mv -f /tmp/temp.json "${HOME}/.claude/settings.json"

echo "✅ Permissions configured successfully!"

Windows PowerShell

# Create settings file if it doesn't exist
$settingsPath = "$env:USERPROFILE\.claude\settings.json"
if (-not (Test-Path $settingsPath)) {
    New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude" | Out-Null
    "{}" | Out-File -Encoding utf8 $settingsPath
}

$settings = Get-Content $settingsPath -Raw | ConvertFrom-Json

if (-not $settings.permissions) {
    $settings | Add-Member -Type NoteProperty -Name "permissions" -Value ([PSCustomObject]@{}) -Force
}

if (-not $settings.permissions.allow) {
    $settings.permissions | Add-Member -Type NoteProperty -Name "allow" -Value @() -Force
}

$newPermissions = @(
    "Bash(git:*)", "Bash(gh:*)", "Bash(jq:*)", "Bash(curl:*)",
    "Bash(node:*)", "Bash(npm:*)", "Bash(pnpm:*)", "Bash(npx:*)", "Bash(bun:*)", "Bash(bunx:*)",
    "Bash(python:*)", "Bash(python3:*)", "Bash(uv:*)", "Bash(uvx:*)",
    "Bash(docker:*)", "Bash(podman:*)", "Bash(buildah:*)",
    "Bash(gh:*)", "Bash(gpg:*)", "Bash(gpgconf:*)",
    "Read", "Edit", "NotebookEdit", "Update", "Write", "WebFetch", "WebSearch",
    "Bash(.specify/scripts/bash/check-prerequisites.sh:*)", "Bash(.specify/scripts/bash/create-new-feature.sh:*)",
    "Bash(.specify/scripts/bash/setup-plan.sh:*)", "Bash(.specify/scripts/bash/update-agent-context.sh:*)",
    "mcp__plugin_context7_context7",
    "Skill(commit:*)", "Skill(nano-banana:*)", "Skill(superpowers:*)", "Skill(secure-container-build:*)", "Skill(github-actions-container-build:*)"
)

$merged = @($settings.permissions.allow) + $newPermissions | Select-Object -Unique
$settings.permissions.allow = $merged

$settings | Add-Member -Type NoteProperty -Name "alwaysThinkingEnabled" -Value $true -Force
$settings | Add-Member -Type NoteProperty -Name "includeCoAuthoredBy" -Value $false -Force
$settings | Add-Member -Type NoteProperty -Name "model" -Value "opusplan" -Force
$settings | Add-Member -Type NoteProperty -Name "spinnerTipsEnabled" -Value $false -Force

$settings | ConvertTo-Json -Depth 10 | Out-File -Encoding utf8 $settingsPath

Write-Host "✅ Permissions configured successfully!"

Step 2: Install Plugins

Install plugins from pigfoot/claude-code-hubs using CLI:

# Add marketplace
claude plugin marketplace add pigfoot/claude-code-hubs

# Install plugins from pigfoot marketplace
claude plugin install --scope user commit@pigfoot-marketplace
claude plugin install --scope user nano-banana@pigfoot-marketplace
claude plugin install --scope user secure-container-build@pigfoot-marketplace
claude plugin install --scope user github-actions-container-build@pigfoot-marketplace

# Install recommended third-party plugins
claude plugin install --scope user context7@claude-plugins-official
claude plugin install --scope user superpowers@pigfoot-marketplace

Update marketplace (fetch latest plugin list):

# Update pigfoot marketplace to get latest plugin versions
claude plugin marketplace update pigfoot-marketplace

Upgrade plugins:

# Upgrade specific plugin
claude plugin upgrade commit@pigfoot-marketplace

# Upgrade all plugins from pigfoot marketplace
claude plugin upgrade commit@pigfoot-marketplace nano-banana@pigfoot-marketplace secure-container-build@pigfoot-marketplace github-actions-container-build@pigfoot-marketplace superpowers@pigfoot-marketplace

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

The CLAUDE.md template provides comprehensive development guidelines that work with installed plugins.

For global configuration (applies to all projects):

macOS, Linux, WSL, Git Bash:

claudeDir="${HOME}/.claude"
curl -fsSL https://raw.githubusercontent.com/pigfoot/claude-code-hubs/main/.CLAUDE.md -o "${claudeDir}/CLAUDE.md"

Windows PowerShell

$claudeDir = "$env:USERPROFILE\.claude"
if (-not (Test-Path $claudeDir)) { New-Item -ItemType Directory -Path $claudeDir }
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/pigfoot/claude-code-hubs/main/.CLAUDE.md" -OutFile "$claudeDir\CLAUDE.md"

For project-specific configuration:

Change claudeDir to your project root folder (e.g., claudeDir="." or $claudeDir = ".") in the commands above.

Usage

🎯 commit Plugin - Smart Git Commits

claude plugin install --scope user commit@pigfoot-marketplace

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 (Official)

claude plugin install --scope user context7@claude-plugins-official

What it does: Fetches current documentation and code examples from any library or framework via official Context7 MCP server.

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.

Note: This is the official plugin from @claude-plugins-official, maintained by Upstash.

Optional: Auto-configure package runner (bunx/npx)

By default, context7 uses npx (Node.js package runner). This script auto-detects and configures the best available option:

macOS, Linux, WSL, Git Bash:

# Auto-detect and configure context7 package runner
config_file="$HOME/.claude/plugins/marketplaces/claude-plugins-official/external_plugins/context7/.mcp.json"

if [ ! -f "$config_file" ]; then
  echo "⚠️ context7 config not found. Install context7 first:"
  echo "   claude plugin install --scope user context7@claude-plugins-official"
  exit 1
fi

if command -v bunx &> /dev/null; then
  # Use bunx (fastest: ~50-100ms faster than npx)
  jq '.context7.command = "bunx" | .context7.args = ["@upstash/context7-mcp"]' "$config_file" > /tmp/mcp.json && mv /tmp/mcp.json "$config_file"
  echo "✅ Configured context7 to use bunx (fastest)"
elif command -v npx &> /dev/null; then
  # Use npx (default Node.js runner)
  jq '.context7.command = "npx" | .context7.args = ["-y", "@upstash/context7-mcp"]' "$config_file" > /tmp/mcp.json && mv /tmp/mcp.json "$config_file"
  echo "✅ Configured context7 to use npx (default)"
else
  echo "❌ Neither bunx nor npx found. Install one of:"
  echo "   - Bun: curl -fsSL https://bun.sh/install | bash"
  echo "   - Node.js: see https://nodejs.org/"
  exit 1
fi

Windows PowerShell

# Auto-detect and configure context7 package runner
$configFile = "$env:USERPROFILE\.claude\plugins\marketplaces\claude-plugins-official\external_plugins\context7\.mcp.json"

if (-not (Test-Path $configFile)) {
    Write-Host "⚠️ context7 config not found. Install context7 first:" -ForegroundColor Yellow
    Write-Host "   claude plugin install --scope user context7@claude-plugins-official"
    exit 1
}

$config = Get-Content $configFile -Raw | ConvertFrom-Json

if (Get-Command bunx -ErrorAction SilentlyContinue) {
    # Use bunx (fastest: ~50-100ms faster than npx)
    $config.context7.command = "bunx"
    $config.context7.args = @("@upstash/context7-mcp")
    $config | ConvertTo-Json -Depth 10 | Out-File -Encoding utf8 $configFile
    Write-Host "✅ Configured context7 to use bunx (fastest)" -ForegroundColor Green
} elseif (Get-Command npx -ErrorAction SilentlyContinue) {
    # Use npx (default Node.js runner)
    $config.context7.command = "npx"
    $config.context7.args = @("-y", "@upstash/context7-mcp")
    $config | ConvertTo-Json -Depth 10 | Out-File -Encoding utf8 $configFile
    Write-Host "✅ Configured context7 to use npx (default)" -ForegroundColor Green
} else {
    Write-Host "❌ Neither bunx nor npx found. Install one of:" -ForegroundColor Red
    Write-Host "   - Bun: https://bun.sh/install"
    Write-Host "   - Node.js: https://nodejs.org/"
    exit 1
}

---

🍌 nano-banana Plugin - AI Image Generation

claude plugin install --scope user nano-banana@pigfoot-marketplace

What it does: Generates and edits images using Google's Gemini models with Python scripting powered by uv.

Benefits:

• ✅ AI image generation - Create images from text descriptions using Gemini 3 Pro (Nano Banana Pro)
• ✅ Image editing - Edit existing images with AI-powered transformations
• ✅ Interactive prompting - Get help crafting effective prompts for better results
• ✅ Inline dependencies - Self-contained Python scripts with uv run and inline script metadata
• ✅ Multiple models - Choose between fast generation and professional quality
• ✅ Format flexibility - Output WebP (default), JPEG, or PNG with quality control

Prerequisites:

• uv installed
• GEMINI_API_KEY (or GOOGLE_API_KEY) environment variable set with a valid Gemini API key

Configuration:

Customize behavior using environment variables:

Variable	Default	Description
NANO_BANANA_MODEL	(Claude chooses: Pro or Flash)	Force specific model (overrides Claude's choice)
NANO_BANANA_FORMAT	webp	Output format: webp, jpg, or png
NANO_BANANA_QUALITY	90	Image quality (1-100) for webp/jpg
GOOGLE_GEMINI_BASE_URL	(official API)	Custom API endpoint (for non-official deployments)
GEMINI_API_KEY	(falls back to GOOGLE_API_KEY)	API key (official or custom endpoint)

Official Google API:

export GEMINI_API_KEY="your-api-key"  # Or GOOGLE_API_KEY (backward compatible)
# Model: Claude chooses Pro (default) or Flash (budget/fast) automatically
# Optional: force specific model or format
# export NANO_BANANA_MODEL="gemini-2.5-flash-image"
# export NANO_BANANA_FORMAT="jpg"

Custom Endpoint (self-hosted or proxy):

export GOOGLE_GEMINI_BASE_URL="https://your-api.example.com/v1"
export GEMINI_API_KEY="your-custom-api-key"
export NANO_BANANA_MODEL="gemini-3-pro-image"
export NANO_BANANA_FORMAT="webp"

Note: When using a custom model, set GOOGLE_GEMINI_BASE_URL and GEMINI_API_KEY to match your deployment.

Usage: The plugin operates in two modes automatically based on your request:

Direct Generation Mode (detailed prompts or with style):

# Example 1: Detailed prompt
"Generate a photorealistic cat wearing sunglasses on a beach chair, sunset golden hour lighting, 16:9"
→ Output: 001-beach-cat/generated.webp

# Example 2: With brand style (structured)
"Generate a cybersecurity dashboard infographic, style: trend"
→ Applies Trend Micro colors (Trend Red #d71920, Guardian Red, grays)
→ Output: 002-security-dashboard/generated.webp

# Example 3: With brand style (natural language)
"Use style trend to generate LLM introduction infographic"
→ Detects "style trend", applies brand colors
→ Output: 003-llm-intro/generated.webp

# Example 4: Image editing
"Edit 001-beach-cat/generated.webp and add a party hat"
→ Output: 004-party-hat/edited.webp

# Example 5: Slide deck / Presentation (NotebookLM style)
"Create a slide explaining how transformers work, use notebooklm style"
→ Detects notebooklm style, uses professional infographic aesthetic
→ Output: 005-transformer-architecture/generated.webp

Interactive Prompting Mode (vague requests or explicit help):

# Example 6: Explicit prompting request
"Help me write a good prompt for a professional poster"
→ Claude asks questions (type, subject, style)
→ Crafts optimized prompt
→ Generates with crafted prompt

# Example 7: Vague prompt (triggers prompting)
"Make a logo"
→ Claude: "Let me help you design a better prompt"
→ Asks about logo type, colors, style
→ Generates with refined prompt

Skills Included:

• nano-banana - Unified skill with dual-mode operation (direct generation + interactive prompting)

Style Support:

• style: "trend" or style: trend - Trend Micro brand colors + NotebookLM slide aesthetic (professional presentations, polished infographics, 16:9 format with Trend Red #d71920, Guardian Red, grays, Dark Blue/Teal) - Uses lossless WebP (saves 20-30% vs PNG)
• style: "notebooklm" or notebooklm style - NotebookLM presentation aesthetic (professional infographics, slide decks) - Uses lossless WebP (saves 20-30% vs PNG)
• use style trend or with trend colors - Natural language syntax
• style: "custom" - Claude asks for your color preferences

Behind the scenes: Claude uses Python with Google's Gemini API to generate images. Scripts run via uv with automatic dependency management, making it easy to create high-quality AI art. Images use WebP format: lossless VP8L for slide decks (saves 20-30% vs PNG, zero quality loss), lossy VP8 for photos (~30% smaller than JPEG).

---

🐳 secure-container-build Plugin - Secure Container Images

claude plugin install --scope user secure-container-build@pigfoot-marketplace

What it does: Provides Containerfile templates and best practices for building secure container images.

Benefits:

• ✅ Security-first runtime - Wolfi distroless images with minimal attack surface and no CVEs
• ✅ Non-root containers - Run as UID 65532 by default
• ✅ Multi-stage builds - Minimal runtime images with only necessary artifacts
• ✅ Production & debug variants - Switch between secure production and debug-friendly images
• ✅ Allocator optimization - mimalloc support for Rust builds

Supported Stacks:

• Python + uv - Fast, reproducible Python builds
• Bun - All-in-one JavaScript runtime
• Node.js + pnpm - Efficient workspace-friendly builds
• Golang - Static and CGO builds
• Rust - glibc and musl builds with allocator options

Usage: Ask Claude to create secure Containerfiles for your project.

Examples:

• "Create a secure Containerfile for my Python app"
• "Set up a multi-stage build for my Rust project"
• "Help me optimize my container image size"

---

🚀 github-actions-container-build Plugin - CI/CD Workflows

claude plugin install --scope user github-actions-container-build@pigfoot-marketplace

What it does: Provides GitHub Actions workflows for building multi-architecture container images.

Benefits:

• ✅ Matrix builds - Native ARM64 runners for public repos (10-50x faster)
• ✅ QEMU fallback - Free emulation for private repos
• ✅ Podman rootless - Secure, daemonless container builds
• ✅ Multi-arch manifests - Single tag for amd64 and arm64
• ✅ Retry logic - Automatic retries for transient failures

Usage: Ask Claude to set up CI/CD for your container builds.

Examples:

• "Set up GitHub Actions for multi-arch container builds"
• "I need a workflow to build ARM64 images for my public repo"
• "Create a container build pipeline for my private repository"

Demo

---

🦸 superpowers Plugin - Proven Development Workflows

claude plugin install --scope user superpowers@pigfoot-marketplace

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.

---

⚙️ .CLAUDE.md Configuration

Once configured, Claude 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
nano-banana	Python scripting and Gemini image generation	0.0.2
secure-container-build	Secure container images with Wolfi runtime	0.0.1
github-actions-container-build	Multi-arch container builds in GitHub Actions	0.0.1

Project Structure

claude-code-hubs/
├── .claude-plugin/
│   └── marketplace.json                        # Marketplace registry
├── plugins/
│   ├── commit/                          # Git commit automation plugin
│   ├── nano-banana/                     # AI image generation plugin
│   ├── secure-container-build/          # Containerfile templates plugin
│   └── github-actions-container-build/  # GitHub Actions CI/CD plugin
├── .CLAUDE.md                                  # Global configuration template
├── .specify/                                   # Spec-kit templates and memory
└── README.md                                   # This file

Troubleshooting

Click to expand troubleshooting guide

Permission Issues

If Claude asks for permissions repeatedly:

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

# Re-run the permission configuration script

Plugin Installation Fails

# Check marketplace connection
claude plugin marketplace list

# Try removing and re-adding marketplace
claude plugin marketplace remove pigfoot-marketplace
claude 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 .CLAUDE.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 ~/.claude/CLAUDE.md or ./CLAUDE.md to customize for your needs.

Adding More Plugins

Browse available plugins in plugins/ directory, then:

claude plugin install --scope user <plugin-name>@pigfoot-marketplace

Available Plugins

Plugin	Origin	Description	Skills Included
commit	pigfoot	Conventional commits with emoji and GPG signing	commit:commit
nano-banana	pigfoot	Python scripting and Gemini image generation with dual-mode operation	nano-banana:nano-banana
secure-container-build	pigfoot	Secure container images with Wolfi runtime	secure-container-build:secure-container-build
github-actions-container-build	pigfoot	Multi-arch container builds in GitHub Actions	github-actions-container-build:github-actions-container-build
context7	official (@claude-plugins-official)	Library documentation via Context7 MCP	MCP server
superpowers	3rd-party (obra)	Proven development workflows (TDD, debugging, review)	17+ skills (brainstorming, TDD, systematic-debugging, etc.)

Installation:

• pigfoot plugins: claude plugin install --scope user <name>@pigfoot-marketplace
• Official/3rd-party: claude plugin install --scope user context7@claude-plugins-official or claude plugin install --scope user superpowers@pigfoot-marketplace

Contributing

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

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

• Claude Code Documentation
• Spec-Kit Templates
• Plugin Development Guide

---

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