{"id":50614907,"url":"https://github.com/deevus/tea-skills","last_synced_at":"2026-06-06T07:04:10.506Z","repository":{"id":358187375,"uuid":"1240391415","full_name":"deevus/tea-skills","owner":"deevus","description":"Agent skills for Gitea/Forgejo issue, pull request, milestone, and label workflows using the tea CLI","archived":false,"fork":false,"pushed_at":"2026-05-30T01:21:47.000Z","size":370,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-30T03:07:49.879Z","etag":null,"topics":["agent-skills","claude-code","cli","forgejo","gitea","tea"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deevus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-16T04:46:04.000Z","updated_at":"2026-05-30T01:21:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/deevus/tea-skills","commit_stats":null,"previous_names":["deevus/tea-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deevus/tea-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deevus%2Ftea-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deevus%2Ftea-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deevus%2Ftea-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deevus%2Ftea-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deevus","download_url":"https://codeload.github.com/deevus/tea-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deevus%2Ftea-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33972420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","cli","forgejo","gitea","tea"],"created_at":"2026-06-06T07:04:09.937Z","updated_at":"2026-06-06T07:04:10.495Z","avatar_url":"https://github.com/deevus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tea-skills\n\nAgent skills for Gitea/Forgejo workflows using the [tea CLI](https://gitea.com/gitea/tea).\n\n`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.\n\n## Prerequisites\n\n- [tea CLI](https://gitea.com/gitea/tea) installed and available on `PATH`\n- A configured tea login:\n\n  ```bash\n  tea login add\n  tea login list\n  ```\n\n- Python 3.10 or newer for bundled actions\n- Git, with the target Gitea/Forgejo repository checked out locally\n\n## Installation\n\n### Claude Code plugin\n\nClaude Code installs plugins from marketplaces. Add the GitHub repository as a marketplace, then install the `tea` plugin from it:\n\n```text\n/plugin marketplace add deevus/tea-skills\n/plugin install tea@tea-skills\n```\n\nFor non-interactive setup, use the equivalent CLI commands:\n\n```bash\nclaude plugin marketplace add deevus/tea-skills\nclaude plugin install tea@tea-skills\n```\n\n### Other agents with `npx skills`\n\nInstall all focused skills into the shared Agent Skills directory:\n\nFrom GitHub:\n\n```bash\nnpx skills add deevus/tea-skills --skill '*' --agent universal\n```\n\n`--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`.\n\nSkills 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.\n\nCompatibility depends on the agent's skill support. Claude Code plugin hooks are Claude-specific, but the skill instructions themselves are plain `SKILL.md` files.\n\n## Verify setup\n\nFrom a Gitea/Forgejo repository where you want the agent to work, confirm tea can see your server and repository:\n\n```bash\ntea login list\ntea issues list -o simple\n```\n\nIf you installed with `npx skills`, you can also ask it to list installed skills:\n\n```bash\nnpx skills list\n```\n\nThen try a small prompt in your agent:\n\n\u003e List the open issues in this repository.\n\n## Troubleshooting\n\n- **`tea` is missing or not on `PATH`:** install the [tea CLI](https://gitea.com/gitea/tea), restart your shell or agent session, then confirm `tea --version` works from the target repository.\n- **No tea login is configured:** run `tea login add`, then `tea login list`. Bundled actions read the same tea authentication configuration.\n- **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`.\n- **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.\n\nFor more detail, see [`actions/README.md`](actions/README.md) and [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n## Example prompts\n\n- \"List open issues and summarize the top three that look ready to work on.\"\n- \"Create an issue for the failing login redirect and label it as a bug.\"\n- \"Show pull requests that need review and summarize the current blockers.\"\n- \"Create a WIP pull request from my current branch.\"\n- \"Add this issue to the v1.0 milestone.\"\n- \"Find issues that are ready because their dependencies are closed.\"\n\n## Supported workflows\n\n`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.\n\nEach skill is a focused, user-invokable `skills/\u003cname\u003e/SKILL.md` file. The current inventory is grouped by workflow domain:\n\n| Domain | What users can ask an agent to do | Skills |\n|---|---|---|\n| 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` |\n| 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` |\n| Milestones | List, create, edit, close, reopen, and delete milestones, plus move issues into or out of milestones. | `milestones`, `milestone-issues` |\n| Labels | Manage repository labels, label schemes, bulk label operations, and organization-level labels. | `labels`, `label-schemes` |\n\n## Bundled actions and trust model\n\nBundled actions are small Python executables shipped with this plugin. They supplement `tea`; they do not replace it. Use them for API-only operations that Gitea/Forgejo supports but `tea` does not expose cleanly, such as issue dependencies, issue moderation, pull-request auto-merge configuration, milestone edit gaps, and organization labels.\n\nActions run on your machine with your user privileges and read the authentication configured by `tea login`. Repository-scoped bundled actions use active-host-first discovery by default: they target the git remote whose host matches the active `tea` backend, and they fail clearly if that match is ambiguous. Agents should pass explicit `--login`, `--remote`, or `--repo` flags when you name a backend, remote, or repository, resolve the action path from the installed plugin, and keep the working directory in your target repository.\n\nSee [`actions/README.md`](actions/README.md) and the domain references for exact commands and arguments:\n\n| Domain | Reference |\n|---|---|\n| Issues | [`actions/issues/README.md`](actions/issues/README.md) |\n| Pull Requests | [`actions/pull-requests/README.md`](actions/pull-requests/README.md) |\n| Milestones | [`actions/milestones/README.md`](actions/milestones/README.md) |\n| Organization Labels | [`actions/org-labels/README.md`](actions/org-labels/README.md) |\n\n## Contributing\n\nDevelopment and test details live in [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeevus%2Ftea-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeevus%2Ftea-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeevus%2Ftea-skills/lists"}