Files
tea-skill/README.md
zero f865302cb4 Fix install instructions with correct plugin path
Skills live inside plugin packages under ~/.claude/plugins/,
not a standalone ~/.claude/skills/ directory. Updated README
with working install steps for both copy and symlink approaches.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-07 22:04:13 +02:00

74 lines
2.2 KiB
Markdown

# 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