# Groundwork

A comprehensive skills library for Claude Code, consolidating proven techniques for planning, design, TDD, debugging, collaboration, and problem-solving.

## Installation

### Via Marketplace

First, add the Groundwork marketplace:

```bash claude plugin marketplace add https://github.com/etr/groundwork-marketplace ```

Then install the plugin:

```bash claude plugin install groundwork ```

#### Update via Marketplace

```bash claude plugin marketplace update groundwork-marketplace

claude plugin update groundwork ```

### Manual Installation

```bash cd ~/.claude/plugins git clone https://github.com/etr/groundwork.git ```

Or use the installer provided with the codebase.

### Other Platforms (Experimental)

> **Warning:** Installation on platforms other than Claude Code is experimental. Skills and agents are automatically transformed to work without Claude Code's plugin system, but some features (hooks, slash commands, skill chaining) may not work identically. Use at your own risk.

Groundwork skills and agents can be installed into other AI coding tools using the included installer script. The installer transforms skill content to remove Claude Code-specific constructs and adapts the format for each target.

#### Supported Targets

| Target | Flag | Description | |--------|------|-------------| | [Codex CLI](https://github.com/openai/codex) | `--codex` | Agents are installed as native custom-agent TOML files with Codex model and reasoning settings | | [OpenCode](https://github.com/opencode-ai/opencode) | `--opencode` | Agents are installed as standalone agent files | | [Kiro](https://kiro.dev) | `--kiro` | Agents use JSON config + prompt file pairs | | Pi | `--pi` | Agents install as `review-`prefixed skills, plus a pre-built TypeScript extension (`pi-extension/`) | | Claude Code | `--claude-code` | Recommends the marketplace install (no transformation needed) |

##### Codex Agent Conversion

Codex agents are written to `.codex/agents/*.toml` for pro