Assisted-by: Claude Opus 4.6 via pi

diff --git a/ai/claude/skills/gitea/SKILL.md b/ai/claude/skills/gitea/SKILL.md
new file mode 100644
index 00000000..12105c27
--- /dev/null
+++ b/ai/claude/skills/gitea/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: gitea
+description: Use when needing tea CLI command reference, syntax, or behavior - directs to tea --help for authoritative documentation and flags
+---
+
+# Gitea CLI (tea)
+
+Use `tea --help` for authoritative command reference and current flags.
+
+## Quick Start
+
+Run `tea <command> --help` for detailed command documentation:
+
+```bash
+tea --help              # Full command list
+tea issues --help       # Specific command details
+tea pulls create --help # Syntax and options
+```
+
+tea auto-discovers the Gitea instance and repo from the current directory's git remote.
+
+## Core Workflows
+
+**Issues:**
+```bash
+tea issues                      # List open issues
+tea issues <index>              # Show issue details
+tea issues create               # Create an issue
+tea issues edit <index>         # Edit an issue
+tea issues close <index>        # Close an issue
+tea comment <index> "<body>"    # Comment on an issue or PR
+```
+
+**Pull requests:**
+```bash
+tea pulls                       # List open PRs
+tea pulls <index>               # Show PR details
+tea pulls create                # Create a PR
+tea pulls checkout <index>      # Check out a PR locally
+tea pulls merge <index>         # Merge a PR
+tea pulls approve <index>       # Approve a PR
+tea pulls reject <index>        # Request changes
+tea pulls review <index>        # Interactive review
+```
+
+**Repositories:**
+```bash
+tea repos                       # Show current repo details
+tea repos list                  # List your repos
+tea repos search <query>        # Search repos on the instance
+tea repos create                # Create a repo
+tea repos fork                  # Fork a repo
+```
+
+**Releases:**
+```bash
+tea releases list               # List releases
+tea releases create             # Create a release
+```
+
+**Labels & milestones:**
+```bash
+tea labels list                 # List labels
+tea labels create               # Create a label
+tea milestones list             # List milestones
+tea milestones create           # Create a milestone
+```
+
+## Command Categories
+
+Run `tea --help` to see all commands. Main categories:
+
+Issues: issues list/create/edit/close/reopen
+Pull Requests: pulls list/create/checkout/close/merge/approve/reject/review/clean
+Comments: comment (on issues or PRs)
+Repos: repos list/search/create/fork/migrate/delete
+Labels: labels list/create/update/delete
+Milestones: milestones list/create
+Releases: releases list/create/edit/delete, releases assets
+Times: times (tracked time on issues/PRs)
+Organizations: organizations list/create/delete
+Helpers: open (open in browser), notifications, clone
+Setup: logins, logout, whoami
+
+## Output Formats
+
+All listing commands support `--output` / `-o`:
+
+```bash
+tea issues --output json        # JSON output (useful for scripting)
+tea issues --output yaml        # YAML output
+tea issues --output csv         # CSV output
+tea issues --output table       # Table output
+```
+
+## Filtering
+
+Issues and PRs support filtering:
+
+```bash
+tea issues --state closed           # By state (open/closed/all)
+tea issues --labels "bug,urgent"    # By labels
+tea issues --milestones "v1.0"      # By milestone
+tea issues --assignee "username"    # By assignee
+tea issues --keyword "search term"  # By keyword search
+```
+
+## When to Use tea --help
+
+Direct command help is always more current than documentation. Use it for:
+
+- Exact flag names and syntax
+- Current command options
+- Command behavior details
+- Examples and edge cases
+
+Never rely on this skill's command list as authoritative. Always run `tea <command> --help` to verify behavior, flags, and current options.