# tea skill for Claude Code

A [Claude Code](https://claude.ai/code) skill that gives Claude full operability with [`tea`](https://gitea.com/gitea/tea) — the official CLI for [Gitea](https://gitea.com).

## What it does

When installed, Claude will know how to use `tea` to:

- Manage **issues** and **pull requests** (create, edit, review, merge, close)
- Work with **repositories** (create, fork, migrate, search)
- Handle **releases** and **release assets**
- Manage **branches**, **labels**, and **milestones**
- Monitor **CI/CD actions** (runs, logs, secrets, variables)
- Configure **webhooks**
- Track **time** on issues
- Manage **organizations**
- Read and act on **notifications**
- Make raw **authenticated API calls** for anything else

## Requirements

- [`tea`](https://gitea.com/gitea/tea) installed and accessible in `$PATH`
- At least one login configured (`tea logins add`)

## Installation

### From the Claude Code marketplace (once listed)

```bash
/plugin install tea@claude-plugins-official
```

### Manual install

Clone and register as a local plugin:

```bash
git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0
mkdir -p "$PLUGIN_DIR"
cp -r tea-skill/* "$PLUGIN_DIR/"
```

Then register it in `~/.claude/plugins/installed_plugins.json` under the `"plugins"` key:

```json
"tea@local-plugins": [{
  "scope": "user",
  "installPath": "/home/YOUR_USER/.claude/plugins/cache/local-plugins/tea/1.0.0",
  "version": "1.0.0",
  "installedAt": "2025-01-01T00:00:00.000Z",
  "lastUpdated": "2025-01-01T00:00:00.000Z"
}]
```

### Clone and symlink (for development)

```bash
git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0
mkdir -p "$PLUGIN_DIR"
ln -s "$(pwd)/tea-skill/.claude-plugin" "$PLUGIN_DIR/.claude-plugin"
ln -s "$(pwd)/tea-skill/skills" "$PLUGIN_DIR/skills"
```

With symlinks, pulling the repo updates the skill immediately.

## Structure

```
.claude-plugin/
└── plugin.json               # Plugin metadata
skills/
└── tea/
    ├── SKILL.md              # Main skill instructions
    └── references/
        └── commands.md       # Full command & flag reference
```

## License

MIT