# 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

Skills in Claude Code live inside plugin packages under `~/.claude/plugins/`. To install this skill, copy the `tea/` folder into a plugin's `skills/` directory.

### Option A — standalone plugin (recommended)

Create a minimal plugin structure and drop the skill in:

```bash
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea-skill/1.0.0
mkdir -p "$PLUGIN_DIR/skills"
cp -r tea "$PLUGIN_DIR/skills/"
```

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

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

### Option B — clone and symlink

```bash
git clone https://github.com/yourname/tea-skill
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea-skill/1.0.0
mkdir -p "$PLUGIN_DIR/skills"
ln -s "$(pwd)/tea-skill/tea" "$PLUGIN_DIR/skills/tea"
```

Then register as above. With a symlink, pulling the repo updates the skill immediately.

## Structure

```
tea/
├── SKILL.md                  # Main skill instructions
└── references/
    └── commands.md           # Full command & flag reference
```

## License

MIT