Add tea skill for Claude Code

Full operability skill for the tea Gitea CLI — covers issues, PRs,
repos, releases, branches, actions, webhooks, notifications, orgs,
time tracking, and raw API access.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

tea/references/commands.md

@@ -0,0 +1,242 @@
+# tea Command Reference
+
+Quick-lookup table of all `tea` commands and their subcommands.
+
+## Table of Contents
+- [Issues](#issues)
+- [Pull Requests](#pull-requests)
+- [Labels](#labels)
+- [Milestones](#milestones)
+- [Releases](#releases)
+- [Times](#times)
+- [Organizations](#organizations)
+- [Repos](#repos)
+- [Branches](#branches)
+- [Actions](#actions)
+- [Webhooks](#webhooks)
+- [Notifications](#notifications)
+- [Helpers](#helpers)
+- [Setup](#setup)
+- [Misc](#misc)
+
+---
+
+## Issues
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea issues` | `issue`, `i` | List or view issues |
+| `tea issues list` | `ls` | List issues |
+| `tea issues create` | `c` | Create an issue |
+| `tea issues edit` | `e` | Edit one or more issues |
+| `tea issues close` | | Close issues |
+| `tea issues reopen` | `open` | Reopen issues |
+| `tea comment <index>` | `c` | Add comment to issue/PR |
+
+**Filters:** `--state`, `--kind issues|pulls|all`, `--keyword`, `--labels`, `--milestones`, `--author`, `--assignee`, `--mentions`, `--from`, `--until`
+
+---
+
+## Pull Requests
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea pulls` | `pull`, `pr` | List or view PRs |
+| `tea pulls list` | `ls` | List PRs |
+| `tea pulls create` | `c` | Create a PR |
+| `tea pulls checkout` | `co` | Check out PR branch locally |
+| `tea pulls review` | | Interactive review |
+| `tea pulls approve` | `lgtm`, `a` | Approve a PR |
+| `tea pulls reject` | | Request changes |
+| `tea pulls merge` | `m` | Merge a PR |
+| `tea pulls edit` | `e` | Edit PR metadata |
+| `tea pulls close` | | Close a PR |
+| `tea pulls reopen` | `open` | Reopen a PR |
+| `tea pulls clean` | | Delete merged feature branch |
+
+---
+
+## Labels
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea labels` | `label` | List/manage labels |
+| `tea labels list` | `ls` | List labels |
+| `tea labels create` | `c` | Create a label |
+| `tea labels update` | | Update a label |
+| `tea labels delete` | `rm` | Delete a label |
+
+---
+
+## Milestones
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea milestones` | `milestone`, `ms` | List/manage milestones |
+| `tea milestones list` | `ls` | List milestones |
+| `tea milestones create` | `c` | Create a milestone |
+| `tea milestones close` | | Close milestones |
+| `tea milestones reopen` | `open` | Reopen milestones |
+| `tea milestones delete` | `rm` | Delete a milestone |
+| `tea milestones issues` | `i` | List issues in milestone |
+
+---
+
+## Releases
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea releases` | `release`, `r` | List/manage releases |
+| `tea releases list` | `ls` | List releases |
+| `tea releases create` | `c` | Create a release |
+| `tea releases edit` | `e` | Edit a release |
+| `tea releases delete` | `rm` | Delete a release |
+| `tea releases assets` | `asset`, `a` | Manage release assets |
+| `tea releases assets list` | `ls` | List assets |
+| `tea releases assets create` | `c` | Upload asset |
+| `tea releases assets delete` | `rm` | Delete asset |
+
+---
+
+## Times
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea times` | `time`, `t` | List/manage time tracking |
+| `tea times list` | `ls` | List tracked times |
+| `tea times add` | `a` | Add tracked time to issue |
+| `tea times delete` | `rm` | Delete a tracked time entry |
+| `tea times reset` | | Reset all tracked time on issue |
+
+---
+
+## Organizations
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea organizations` | `organization`, `org` | List/manage orgs |
+| `tea orgs list` | `ls` | List organizations |
+| `tea orgs create` | `c` | Create an organization |
+| `tea orgs delete` | `rm` | Delete an organization |
+
+---
+
+## Repos
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea repos` | `repo` | List/manage repos |
+| `tea repos list` | `ls` | List accessible repos |
+| `tea repos search` | `s` | Search repos on instance |
+| `tea repos create` | `c` | Create a repo |
+| `tea repos create-from-template` | `ct` | Create from template |
+| `tea repos fork` | `f` | Fork a repo |
+| `tea repos migrate` | `m` | Migrate repo from external source |
+| `tea repos delete` | `rm` | Delete a repo |
+| `tea repos edit` | `e` | Edit repo properties |
+
+---
+
+## Branches
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea branches` | `branch`, `b` | List/manage branches |
+| `tea branches list` | `ls` | List branches |
+| `tea branches protect` | `P` | Protect a branch |
+| `tea branches unprotect` | `U` | Remove branch protection |
+
+---
+
+## Actions
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea actions` | `action` | Manage CI/CD |
+| `tea actions runs` | `run` | Manage workflow runs |
+| `tea actions runs list` | `ls` | List runs |
+| `tea actions runs view` | `show`, `get` | View run details |
+| `tea actions runs logs` | `log` | View run logs |
+| `tea actions runs cancel` | `delete`, `rm` | Cancel/delete a run |
+| `tea actions secrets` | `secret` | Manage secrets |
+| `tea actions secrets list` | `ls` | List secrets |
+| `tea actions secrets create` | `add`, `set` | Create/update secret |
+| `tea actions secrets delete` | `rm` | Delete secret |
+| `tea actions variables` | `variable`, `vars`, `var` | Manage variables |
+| `tea actions variables list` | `ls` | List variables |
+| `tea actions variables create` | `add`, `set` | Create/update variable |
+| `tea actions variables delete` | `rm` | Delete variable |
+| `tea actions workflows` | `workflow` | List workflows |
+
+---
+
+## Webhooks
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea webhooks` | `webhook`, `hooks`, `hook` | Manage webhooks |
+| `tea webhooks list` | `ls` | List webhooks |
+| `tea webhooks create` | `c` | Create a webhook |
+| `tea webhooks update` | `edit`, `u` | Update a webhook |
+| `tea webhooks delete` | `rm` | Delete a webhook |
+
+Scopes: `--repo`, `--org`, or `--global`
+
+---
+
+## Notifications
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea notifications` | `notification`, `n` | Manage notifications |
+| `tea notifications list` | `ls` | List notifications |
+| `tea notifications read` | `r` | Mark as read |
+| `tea notifications unread` | `u` | Mark as unread |
+| `tea notifications pin` | `p` | Pin notification |
+| `tea notifications unpin` | | Unpin notification |
+
+**Filters:** `--types issue|pull|repository|commit`, `--states pinned|unread|read`, `--mine`
+
+---
+
+## Helpers
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea open` | `o` | Open repo in browser |
+| `tea notifications` | `n` | Show notifications |
+| `tea clone` | `C` | Clone a repo |
+| `tea api` | | Raw authenticated API call |
+
+### tea api flags
+| Flag | Description |
+|------|-------------|
+| `-X method` | HTTP method (GET/POST/PUT/PATCH/DELETE) |
+| `-f key=value` | String field in request body |
+| `-F key=value` | Typed field (number/bool/null/JSON) |
+| `-H key:value` | Custom header |
+| `-d '{"json"...}'` | Raw JSON body |
+| `-i` / `--include` | Include HTTP response headers |
+| `-o file` | Write response to file |
+
+---
+
+## Setup
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `tea logins` | `login` | Manage Gitea logins |
+| `tea logins list` | `ls` | List saved logins |
+| `tea logins add` | | Add a login |
+| `tea logins edit` | `e` | Edit a login |
+| `tea logins delete` | `rm` | Remove a login |
+| `tea logins default` | | Get or set default login |
+| `tea logins oauth-refresh` | | Refresh OAuth token |
+| `tea logout` | | Log out |
+
+---
+
+## Misc
+| Command | Description |
+|---------|-------------|
+| `tea whoami` | Show current logged-in user |
+| `tea admin users` | Manage users (requires admin) |
+
+---
+
+## Global flags (all commands)
+| Flag | Description |
+|------|-------------|
+| `--repo`, `-r` | Override repo (path or owner/name slug) |
+| `--remote`, `-R` | Use specific git remote for login discovery |
+| `--login`, `-l` | Use a specific saved login |
+| `--output`, `-o` | Output format: `table`, `simple`, `csv`, `tsv`, `json`, `yaml` |
+| `--page`, `-p` | Page number for paginated results |
+| `--limit`, `--lm` | Items per page |
+| `--debug`, `--vvv` | Enable debug mode (shows API calls) |