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