9b51cc9d3e
- Move tea/ → skills/tea/ so the plugin loader can find the skill - Add .claude-plugin/plugin.json with name, version, description, author, keywords - Add MIT LICENSE file - Update README with marketplace install command and corrected manual install paths Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
83 lines
2.2 KiB
Markdown
83 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
|
|
|
|
### From the Claude Code marketplace (once listed)
|
|
|
|
```bash
|
|
/plugin install tea@claude-plugins-official
|
|
```
|
|
|
|
### Manual install
|
|
|
|
Clone and register as a local plugin:
|
|
|
|
```bash
|
|
git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill
|
|
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0
|
|
mkdir -p "$PLUGIN_DIR"
|
|
cp -r tea-skill/* "$PLUGIN_DIR/"
|
|
```
|
|
|
|
Then register it in `~/.claude/plugins/installed_plugins.json` under the `"plugins"` key:
|
|
|
|
```json
|
|
"tea@local-plugins": [{
|
|
"scope": "user",
|
|
"installPath": "/home/YOUR_USER/.claude/plugins/cache/local-plugins/tea/1.0.0",
|
|
"version": "1.0.0",
|
|
"installedAt": "2025-01-01T00:00:00.000Z",
|
|
"lastUpdated": "2025-01-01T00:00:00.000Z"
|
|
}]
|
|
```
|
|
|
|
### Clone and symlink (for development)
|
|
|
|
```bash
|
|
git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill
|
|
PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0
|
|
mkdir -p "$PLUGIN_DIR"
|
|
ln -s "$(pwd)/tea-skill/.claude-plugin" "$PLUGIN_DIR/.claude-plugin"
|
|
ln -s "$(pwd)/tea-skill/skills" "$PLUGIN_DIR/skills"
|
|
```
|
|
|
|
With symlinks, pulling the repo updates the skill immediately.
|
|
|
|
## Structure
|
|
|
|
```
|
|
.claude-plugin/
|
|
└── plugin.json # Plugin metadata
|
|
skills/
|
|
└── tea/
|
|
├── SKILL.md # Main skill instructions
|
|
└── references/
|
|
└── commands.md # Full command & flag reference
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|