Claude Code Tools

A multi-plugin marketplace for Claude Code with Git workflow skills and comprehensive documentation for skill development.

What's Included

Plugins

This marketplace includes two plugins:

Core Plugin

Purpose: Shared base plugin with Git fundamentals and common utilities

Location: core/

Includes:

• git-fundamentals skill: Essential Git knowledge (repositories, commits, branches, workflows)
• Best practices for commits and collaboration
• Foundation for advanced Git tools

When Claude uses this:

• User asks about basic Git operations
• Need to explain Git fundamentals
• Teaching version control concepts

GitButler CLI Plugin

Purpose: Advanced Git workflows with virtual branches and operation history

Location: gitbutler-cli/

Includes:

• gitbutler-cli skill: Complete GitButler CLI command reference
• Common workflow patterns
• Progressive documentation (core concepts → detailed reference)
• Safe operation guidance with undo support

Features:

• Virtual branch management - multiple branches active simultaneously
• Operation history - complete undo/redo capability
• Stack operations - commit management, squashing, moving
• Safe operations - every action is reversible

When Claude uses this:

• User mentions "GitButler", "but command", or "virtual branches"
• Working with multiple features simultaneously
• Managing stacked commits
• Need safe Git operations with undo capability

Dependencies: Requires core plugin (automatically installed)

Documentation

AI Documentation (ai_docs/)

Extracted documentation optimized for AI context:

• Claude Code Skill Specifications (ai_docs/claude-code/)

  • Complete guide to writing Claude Code skills
  • YAML frontmatter requirements
  • Best practices for skill development

• GitButler Documentation (ai_docs/gitbutler/)

  • GitButler concepts and workflows
  • Complete CLI command reference
  • Use cases and comparisons with traditional Git

Quick Start

# 1. Add the marketplace
/plugin marketplace add amitkot/claude-code-tools

# 2. Install plugins (gitbutler-cli automatically installs core)
/plugin install gitbutler-cli@claude-code-tools

# 3. Start using them!
# Ask Claude: "Can you help me with GitButler?"
# Ask Claude: "Explain Git branches to me"

Installation

Prerequisites

1. Claude Code - Anthropic's official CLI for Claude (Get Claude Code)

2. GitButler CLI (for GitButler skill) - Install from gitbutlerapp/gitbutler

Public Readiness

Before changing repository visibility or publishing a release, run the local audit:

pre-commit run --all-files
just audit-public
gitleaks detect --source . --redact --no-banner
git status --short --ignored

The public-readiness gate targets the current tree and future commits. Repository history is not rewritten.

Installing Plugins

Option 1: Via Plugin Marketplace (Recommended)

The easiest way to install and keep plugins updated:

# Add this marketplace
/plugin marketplace add amitkot/claude-code-tools

# Install GitButler CLI plugin (automatically installs core)
/plugin install gitbutler-cli@claude-code-tools

# Or install individual plugins
/plugin install core@claude-code-tools
/plugin install gitbutler-cli@claude-code-tools

# Later, update to the latest versions
/plugin update gitbutler-cli
/plugin update core

# List installed plugins
/plugin list

Plugins will be automatically available in all your Claude Code sessions.

Benefits:

• One-command installation
• Automatic dependency management (core installed with gitbutler-cli)
• Easy updates with /plugin update
• Easy removal with /plugin remove
• Version management built-in

Option 2: Manual Installation

If you prefer manual installation, you can copy the skill directly:

Expand for manual installation instructions

User-Level Installation (available in all projects):

# Create skills directory
mkdir -p ~/.claude/skills

# Copy plugins
cp -r core/skills/* ~/.claude/skills/
cp -r gitbutler-cli/skills/* ~/.claude/skills/

# Verify installation
ls ~/.claude/skills/git-fundamentals
ls ~/.claude/skills/gitbutler-cli

Project-Level Installation (specific to one project):

# Navigate to your project
cd /path/to/your/project

# Create skills directory
mkdir -p .claude/skills

# Copy plugins
cp -r /path/to/claude-code-tools/core/skills/* .claude/skills/
cp -r /path/to/claude-code-tools/gitbutler-cli/skills/* .claude/skills/

# Verify installation
ls .claude/skills/

Verification

Test that Claude Code recognizes the skills:

1. Start Claude Code in a terminal
2. Ask: "Can you help me with GitButler?" → Should use gitbutler-cli skill
3. Ask: "Explain Git branches to me" → Should use git-fundamentals skill

Using the Skills

Once installed, Claude Code will automatically use skills based on your questions:

Git Fundamentals Skill (from core plugin)

Activates when you:

• Ask about basic Git concepts
• Need help with standard Git workflows
• Want to learn version control fundamentals

Example: "How do I create and merge a Git branch?"

GitButler CLI Skill

Activates when you:

• Ask about GitButler operations
• Mention virtual branches or the but command
• Request help with managing multiple features
• Need to undo Git operations

Example: "Create a new virtual branch for authentication"

Example Interactions

Using Git Fundamentals:

You: "Explain how Git commits work"
Claude: *Uses git-fundamentals skill*
        Commits are snapshots of your project at specific points in time...

You: "What's the difference between git pull and git fetch?"
Claude: *Uses git-fundamentals skill*
        git fetch downloads changes but doesn't merge them...

Using GitButler CLI:

You: "Initialize GitButler in this repository"
Claude: *Uses gitbutler-cli skill*
        but init

You: "Check my GitButler status"
Claude: *Uses gitbutler-cli skill*
        but status -fv

You: "I committed to the wrong branch"
Claude: *Uses gitbutler-cli skill*
        but rub <commit-sha> <correct-branch>

Plugin Structure

Core Plugin Structure

core/
├── .claude-plugin/
│   └── plugin.json               # Plugin metadata
├── skills/
│   └── git-fundamentals/
│       └── SKILL.md              # Git basics skill
└── README.md                     # Plugin documentation

GitButler CLI Plugin Structure

gitbutler-cli/
├── .claude-plugin/
│   └── plugin.json               # Plugin metadata (with core dependency)
└── skills/
    └── gitbutler-cli/
        ├── SKILL.md              # Main skill with YAML frontmatter
        ├── REFERENCE.md          # Detailed command reference
        └── examples/
            └── common-workflows.md  # Real-world usage patterns

How Progressive Disclosure Works

1. At Startup: Claude only loads the skill's name and description from YAML frontmatter
2. When Invoked: Claude loads the full SKILL.md content (core workflows and concepts)
3. When Needed: Claude can reference REFERENCE.md and examples/ for detailed information

This keeps Claude's context efficient while providing complete documentation when needed.

Repository Structure

claude-code-tools/
├── .claude-plugin/              # Marketplace configuration
│   └── marketplace.json         # Marketplace metadata (lists all plugins)
│
├── core/                        # Shared base plugin
│   ├── .claude-plugin/
│   │   └── plugin.json          # Core plugin metadata
│   ├── skills/
│   │   └── git-fundamentals/
│   │       └── SKILL.md         # Git basics skill
│   └── README.md                # Core plugin documentation
│
├── gitbutler-cli/               # GitButler CLI plugin
│   ├── .claude-plugin/
│   │   └── plugin.json          # GitButler plugin metadata
│   └── skills/
│       └── gitbutler-cli/
│           ├── SKILL.md         # Main skill with YAML frontmatter
│           ├── REFERENCE.md     # Detailed command reference
│           └── examples/
│               └── common-workflows.md
│
├── ai_docs/                     # Documentation for AI tools
│   ├── claude-code/
│   │   ├── skill-specifications.md
│   │   ├── marketplace-publishing.md
│   │   └── plugins-documentation.md
│   └── gitbutler/
│       ├── overview.md
│       └── command-reference.md
│
├── CLAUDE.md                    # Repository guide for Claude
├── LICENSE                      # Apache-2.0
├── CHANGELOG.md                 # Version history
└── README.md                    # This file

Development

Creating Your Own Skills

Use the documentation in ai_docs/claude-code/skill-specifications.md as your guide.

Key Requirements:

1. Create a directory with a SKILL.md file
2. Add YAML frontmatter with name and description
3. Write clear, concise instructions for Claude
4. Test with different Claude models (Haiku, Sonnet, Opus)

Best Practices:

• Use gerund form for skill names (e.g., processing-pdfs, analyzing-data)
• Optimize description for discovery (include trigger keywords)
• Keep SKILL.md under 500 lines (use separate files for details)
• Test that Claude invokes the skill at the right times

Testing Skills

1. Install the skill (user or project level)
2. Start Claude Code
3. Try natural language requests that should trigger the skill
4. Verify Claude uses the skill appropriately
5. Iterate on the description if Claude doesn't recognize when to use it

Contributing

This repository contains:

• Reference implementations of Claude Code skills
• Extracted documentation for AI development
• Best practices and examples

Feel free to:

• Use these skills in your own projects
• Create derivative works
• Submit improvements via pull requests

Resources

Claude Code

• Claude Code Documentation
• Claude Code Skills Guide
• Claude Code GitHub

GitButler

• GitButler Homepage
• GitButler GitHub
• GitButler CLI Documentation

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

The skill implementations and documentation in this repository are provided as examples and references for creating Claude Code skills.

Support

For Claude Code Issues

• Claude Code Issues
• Claude Code Discussions

For GitButler Issues

• GitButler Issues
• GitButler Discord

For This Repository

If you find issues with the skill implementation or documentation, please open an issue in this repository.

Changelog

See CHANGELOG.md for a complete version history.

Latest Release: v1.0.0

• GitButler CLI skill with complete command coverage
• Marketplace plugin structure for easy installation
• Progressive documentation structure (SKILL.md → REFERENCE.md → examples/)
• Comprehensive AI documentation for Claude Code and GitButler
• Apache-2.0 license

Acknowledgments

• Anthropic for Claude Code and the skills system
• GitButler team for the innovative Git workflow tool
• Claude Code community for skills best practices