Files

zero 9b51cc9d3e Restructure into proper Claude Code plugin format

- 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>

2026-04-08 02:33:45 +02:00

2.2 KiB

Raw Permalink Blame History

tea skill for Claude Code

A Claude Code skill that gives Claude full operability with tea — the official CLI for Gitea.

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 installed and accessible in $PATH
At least one login configured (tea logins add)

Installation

From the Claude Code marketplace (once listed)

/plugin install tea@claude-plugins-official

Manual install

Clone and register as a local plugin:

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:

"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)

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

2.2 KiB Raw Permalink Blame History