# Gemma Agentic Toolkit

A Claude Code plugin marketplace with skills for data engineering, analytics engineering, and infrastructure management.

> **New to Claude Code?** Check out the [Getting Started Guide](docs/getting-started.md) for installation, setup, and tips on how to get the most out of it.

## Plugins

| Plugin | Description | Skills |
|--------|-------------|--------|
| **gemma-1password** | Store and retrieve secrets with 1Password CLI | 1 |
| **gemma-airflow** | Create and manage Airflow DAGs for dlt connectors | 6 |
| **gemma-bedrock-monitor** | Bedrock quota monitoring on Claude Code status line | 1 |
| **gemma-commercial** | Commercial, sales & project management: contracts, document-branding, gantt-chart-generator, product-ticket-writer | 4 |
| **gemma-data-team** | Spawn a full Gemma data team as an agent team (DE, AE, DA, DS, QA, ticket-fetcher, learning-synthesizer) with a hard QA gate | 3 skills + 7 agents |
| **gemma-dbt** | dbt project scaffolding, source/model creation, semantic search, and dbt-docs-hub refresh | 6 |
| **gemma-devx** | Developer experience skills for everyday git workflows and session wrap-up | 1 |
| **gemma-dlt** | Build, test, debug, and distribute dlt data connectors | 7 |
| **gemma-ewah-migration** | Migrate EWAH pipelines to dlt connectors | 3 |
| **gemma-infra** | OpenTofu + Ansible infrastructure scaffolding for AWS | 1 |
| **gemma-kimball** | Kimball dimensional modelling with multi-agent orchestration | 1 + 5 agents |
| **gemma-lightdash** | Lightdash semantic layer configuration and dashboard management | 2 |
| **gemma-metabase** | Metabase dashboard management, screenshots, and visual QA | 1 |
| **gemma-prs** | Pull request review and revision workflows with multi-agent confidence scoring | 3 |
| **gemma-snowflake** | Snowflake key management and tundri/Permifrost access control | 8 |
| **gemma-tech-research** | Multi-agent web research and HTML report generation | 1 + 2 agents |
| **gemma-toolkit-ops** | Maintenance and self-improvement skills for the toolkit | 1 |

## Installation

### Add the marketplace

```
/plugin marketplace add Gemma-Analytics/gemma-agentic-toolkit
```

### Install plugins

```
/plugin install gemma-dlt@gemma-toolkit
/plugin install gemma-snowflake@gemma-toolkit
/plugin install gemma-kimball@gemma-toolkit
```

### Recommended plugin sets

**Data engineering projects:**
- gemma-1password, gemma-snowflake, gemma-dlt, gemma-airflow

**Analytics engineering projects:**
- gemma-1password, gemma-snowflake, gemma-kimball, gemma-lightdash

**Full data team (multi-agent):**
- gemma-data-team, gemma-prs, gemma-dbt (required) — plus gemma-kimball, gemma-dlt, gemma-airflow, gemma-lightdash, gemma-metabase, gemma-1password as needed per discipline. Set `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` before launching.

### Local testing during development

```bash
claude --plugin-dir ./plugins/gemma-dlt
```

## Recommended Third-Party Skills

Beyond Gemma's own plugins, we recommend these skills from other authors. Browse the official directory (`/plugin` → Discover) to find more that fit your workflow.

### superpowers

Structured workflows for planning, brainstorming, TDD, debugging, code review, and parallel agent dispatch. By [Jesse Vincent](https://github.com/obra/superpowers).

```
/plugin install superpowers@claude-plugin-directory
```

### dbt Labs — dbt Agent Skills

A curated collection of skills for analytics engineering with dbt: model development, testing, semantic layer, job troubleshooting, and platform migrations.

```
/plugin marketplace add dbt-labs/dbt-agent-skills
/plugin install dbt@dbt-agent-marketplace
```

GitHub: [dbt-labs/dbt-agent-skills](https://github.com/dbt-labs/dbt-agent-skills)

### Anthropic Official Plugins

These are maintained by Anthropic in [claude-plugins-official](https://github.com/anthropics/claude-plugins-official). Install with `/plugin install <name>@claude-plugin-directory`.

| Plugin | Description |
|--------|-------------|
| **feature-dev** | Guided feature development with codebase exploration, architecture design, and code review agents |
| **skill-creator** | Create, modify, and benchmark custom skills with eval-driven quality checks |
| **explanatory-output-style** | Adds educational insights and context to responses — great for learning unfamiliar codebases |

## Development

### Adding a skill to an existing plugin

1. Create `plugins/<plugin-name>/skills/<skill-name>/SKILL.md` with YAML frontmatter
2. Add supporting files in `scripts/`, `assets/`, or `references/` subdirectories
3. Reference scripts with `${CLAUDE_SKILL_DIR}/scripts/...`
4. Task skills with side effects must have `disable-model-invocation: true`

### Adding a new plugin

1. Create `plugins/<plugin-name>/.claude-plugin/plugin.json`
2. Add skills under `plugins/<plugin-name>/skills/`
3. Add the plugin to `.claude-plugin/marketplace.json`
4. Add the plugin to `release-please-config.json` and `.release-please-manifest.json`

### Commit conventions

Scope commits to the plugin name:

```
feat(gemma-dlt): add incremental loading support
fix(gemma-snowflake): correct keypair rotation for MFA accounts
```

See [`CLAUDE.md`](./CLAUDE.md) for full conventions.