# 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

### Option A — install the skill folder directly

Copy or symlink the `tea/` directory into your Claude Code skills path:

```bash
cp -r tea ~/.claude/skills/
```

Or via a plugin that points at this repo.

### Option B — clone and reference

```bash
git clone https://github.com/yourname/tea-skill
```

Then point your Claude Code config at the `tea/` subdirectory.

## Structure

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

## License

MIT