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>
74 lines
2.2 KiB
Markdown
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
|