skill: Add skill to use tea-cli.

.claude/skills/gitea/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: gitea
+description: Use when interacting with Gitea — issues, pull requests, reviews, comments, releases, labels, milestones, notifications — via the `tea` CLI, e.g. on repos hosted at git.alexion.dev. Covers listing, creating, editing, reviewing, and merging non-interactively.
+---
+
+Drive Gitea from the terminal with `tea`.
+The recipes below are the fast path for common tasks; run `tea <command> --help` for the full flag list of any command, which is authoritative and always current.
+
+## Core rules
+
+These apply to every recipe.
+
+**Run `tea` from inside the target repo.**
+It infers the repo and login from the checkout's remote, so you normally pass neither.
+The default login is `alexion` on `git.alexion.dev`.
+Only when acting on a repo other than `$PWD`'s do you add `--repo <owner>/<name>` (and `--login alexion` if the remote doesn't resolve a login).
+
+**Pick output by purpose.**
+Add `--output json` when you need to extract a value to act on — a PR index, a state, a comment id.
+Use the default table output when the result is only being shown to the user.
+
+**Never invoke an interactive `tea` command** — it opens a TUI or prompt and hangs a non-interactive agent.
+The traps and their non-interactive replacements:
+
+- `tea pulls review` → use `approve` / `reject` / a comment (see Pull requests below).
+- Bare `tea pulls create` or `tea issues create` → always pass `--title` (and `--base` for PRs), which skips the prompt.
+- `--comments` on a view command → pass it explicitly to include comments; never leave it to prompt.
+
+**Confirm hard-to-reverse writes first.**
+Read commands (list, view, search, notifications) run freely.
+Reversible writes — create issue/PR, comment, label, assign, open/close, edit — run without asking; report what you did after.
+Get explicit confirmation before **merging a PR, deleting anything (`rm`), or publishing a release**.
+
+## Issues
+
+- List open issues assigned to you: `tea issues ls --assignee alexion`
+- Search across all states: `tea issues ls --state all --keyword "flaky test"`
+- Filter: `tea issues ls --labels bug --milestones v1 --author someone`
+- View one in detail (with its comments): `tea issues 42 --comments`
+- Create: `tea issues create --title "..." --description "..." --labels bug --assignees alexion --milestone v1`
+- Assign / (un)label / retitle / set milestone: `tea issues edit 42 --add-assignees alexion --add-labels bug --remove-labels wip --milestone v1`
+- Close / reopen: `tea issues close 42` · `tea issues reopen 42`
+
+## Pull requests
+
+`pr` is the alias for `pulls`.
+
+- List / view: `tea pulls ls --state all` · `tea pulls 17`
+- Open a PR from the current branch against `main`: `tea pulls create --base main --title "..." --description "..."`
+  (head defaults to the current branch; add `--draft` for a WIP draft, `--head user:branch` for a cross-repo source.)
+- Check out a PR locally: `tea pulls checkout 17`
+- Merge (confirm first): `tea pulls merge 17 --style squash` — styles: `merge`, `rebase`, `squash`, `rebase-merge`.
+- Delete the merged feature branch afterward: `tea pulls clean 17`
+
+**Review a PR non-interactively** — do not use `tea pulls review`:
+
+- Approve: `tea pulls approve 17 "looks good"`
+- Request changes: `tea pulls reject 17 "needs tests"`
+- Plain comment: `tea comments add 17 "..."`
+- Read existing review threads: `tea pulls review-comments 17`
+- Resolve / unresolve a thread: `tea pulls resolve <comment-id>` · `tea pulls unresolve <comment-id>`
+
+## Comments
+
+Comments work on an issue or PR by its index.
+
+- Add: `tea comments add 42 "..."`
+- List: `tea comments ls 42`
+- Edit: `tea comments edit <comment-id> "..."`
+- Delete (confirm first): `tea comments rm <comment-id>`
+
+## Labels & milestones
+
+- Labels: `tea labels ls` · `tea labels create --name bug --color "#ee0701" --description "..."` · `tea labels update ...` · `tea labels rm <id>` (confirm first)
+- Milestones: `tea milestones ls` · `tea milestones create --title v1 --description "..." --deadline 2026-08-01` · `tea milestones close v1` · `tea milestones reopen v1`
+
+## Notifications
+
+Use these to find work waiting on you.
+
+- Across all your repos: `tea notifications ls --mine`
+- Current repo only: `tea notifications ls`
+- Mark read: `tea notifications read` (all filtered) or `tea notifications read <id>`
+
+## Releases
+
+- List: `tea releases ls`
+- Create for a tag: `tea releases create --tag v1.0.0 --title "..." --note "..."` — or `--note-file NOTES.md`; add `--draft` / `--prerelease`.
+- Delete (confirm first): `tea releases rm v1.0.0`
+
+## Repos & branches
+
+- List repos you can access: `tea repos ls` — search the whole instance: `tea repos search <query>`
+- Create: `tea repos create --name foo --private --init`
+- Clone: `tea clone <owner>/<repo>`
+- List branches: `tea branches ls`