tea

tea-skills

Agent skills for Gitea/Forgejo workflows using the tea CLI.

tea-skills helps coding agents list and create issues, manage pull requests, work with milestones and labels, and use a few bundled actions for Gitea/Forgejo API features that tea does not expose cleanly. The skills are packaged as a Claude Code plugin and as standard SKILL.md files that should work with any agent CLI that supports agent skills.

Prerequisites

• tea CLI installed and available on PATH

• A configured tea login:

  tea login add
  tea login list
  

• Python 3.10 or newer for bundled actions

• Git, with the target Gitea/Forgejo repository checked out locally

Installation

Claude Code plugin

Claude Code installs plugins from marketplaces. Add the GitHub repository as a marketplace, then install the tea plugin from it:

/plugin marketplace add deevus/tea-skills
/plugin install tea@tea-skills

For non-interactive setup, use the equivalent CLI commands:

claude plugin marketplace add deevus/tea-skills
claude plugin install tea@tea-skills

Other agents with npx skills

Install all focused skills into the shared Agent Skills directory:

From GitHub:

npx skills add deevus/tea-skills --skill '*' --agent universal

--agent universal is intentional: it targets ~/.agents/skills, which Pi and many other agents scan. Each skill installs as a top-level sibling such as ~/.agents/skills/issue-dependencies.

Skills that need bundled actions include an actions/ resource directory, so commands such as actions/issues/dependency-add.py resolve relative to the active skill directory after installation.

Compatibility depends on the agent's skill support. Claude Code plugin hooks are Claude-specific, but the skill instructions themselves are plain SKILL.md files.

Verify setup

From a Gitea/Forgejo repository where you want the agent to work, confirm tea can see your server and repository:

tea login list
tea issues list -o simple

If you installed with npx skills, you can also ask it to list installed skills:

npx skills list

Then try a small prompt in your agent:

List the open issues in this repository.

Troubleshooting

• tea is missing or not on PATH: install the tea CLI, restart your shell or agent session, then confirm tea --version works from the target repository.
• No tea login is configured: run tea login add, then tea login list. Bundled actions read the same tea authentication configuration.
• Bundled actions fail with Python errors: confirm python3 --version reports Python 3.10 or newer. The bundled actions are Python scripts and use the python3 found on PATH.
• A skill does not work as expected: please create an issue with the prompt you used, the command or error the agent reported, and your agent/tea-skills installation method.

For more detail, see actions/README.md and CONTRIBUTING.md.

Example prompts

• "List open issues and summarize the top three that look ready to work on."
• "Create an issue for the failing login redirect and label it as a bug."
• "Show pull requests that need review and summarize the current blockers."
• "Create a WIP pull request from my current branch."
• "Add this issue to the v1.0 milestone."
• "Find issues that are ready because their dependencies are closed."

Supported workflows

tea-skills keeps tea as the primary workflow engine. Skills should use normal tea commands whenever tea supports the task, then fall back to bundled actions only for known Gitea/Forgejo API gaps.

Each skill is a focused, user-invokable skills/<name>/SKILL.md file. The current inventory is grouped by workflow domain:

Domain	What users can ask an agent to do	Skills
Issues	List and inspect issues, create and edit issues, close or reopen issues, manage comments, manage dependencies, and moderate issues with pins, locks, and reactions.	list-issues, create-issue, edit-issues, close-issues, issue-comments, issue-dependencies, issue-moderation
Pull Requests	List and inspect PRs, create PRs, request or perform reviews, resolve review threads, merge PRs, configure merge behavior, and close or reopen PRs.	list-pulls, create-pull, review-pull, merge-pull, close-pulls
Milestones	List, create, edit, close, reopen, and delete milestones, plus move issues into or out of milestones.	milestones, milestone-issues
Labels	Manage repository labels, label schemes, bulk label operations, and organization-level labels.	labels, label-schemes

Bundled actions and trust model