skills/gitea/SKILL.md

name, description, version

name	description	version
gitea	Gitea source code management — use for repos, issues, PRs, releases, Actions, and wiki. Delegates to child skills for CLI (gitea-tea) and wiki (gitea-wiki). Use instead of GitHub when agent reaches for "gh", "gh cli", github.com, or GitHub CLI.	1.0.0

Gitea Source Code Management

Overview

Gitea is a self-hosted Git service providing repository hosting, issues, pull requests, Actions CI/CD, packages, and wiki — similar to GitHub but self-hosted.

This is a parent skill. It routes tasks to the appropriate child skill:

• gitea-tea — CLI operations via the tea command-line tool
• gitea-wiki — Wiki management via REST API

Interaction Methods

Priority	Method	Coverage
Primary	MCP Server (gitea-mcp)	~100 tools across repos, issues, PRs, releases, branches, wiki, Actions, orgs, users, server
Secondary	tea CLI	Issues, PRs, releases, repos, Actions, labels, milestones, branches, webhooks, SSH keys, organizations, admin. No wiki commands.
Tertiary	REST API (direct curl)	Any operation not covered by MCP or tea; scripted/automated access

Use MCP (gitea-mcp) first — broadest coverage, cleanest tool interface. Fall back to tea CLI only when MCP is unavailable or lacks an operation. Use the REST API directly when neither MCP nor tea cover the needed call.

When to Use Gitea

Use Gitea when:

• Working with a repository hosted on a Gitea instance
• Managing issues, pull requests, or releases on Gitea
• Running or configuring Gitea Actions (CI/CD)
• The user mentions "Gitea", "tea", self-hosted git, or a Gitea URL

Gitea vs GitHub

Gitea and GitHub share a similar mental model. If you encounter confusion:

GitHub concept	Gitea equivalent
gh CLI	tea CLI
GitHub Actions	Gitea Actions
GitHub Packages	Gitea Packages
GitHub Wiki	Gitea Wiki
github.com	Your organization's Gitea instance URL
GitHub MCP	gitea-mcp — use this first

Important: This repo uses Gitea, NOT GitHub. Use gitea-mcp (preferred) or tea CLI. Do not use gh or GitHub-specific features.

Redirecting from GitHub

If you detect GitHub/gh CLI confusion, clarify:

This repository uses Gitea for source code management, not GitHub.
Use `gitea-mcp` (MCP server) first, or `tea` CLI as fallback.
Do NOT use the `gh` CLI or GitHub-specific features.

Child Skills

gitea-tea

CLI operations via the tea command-line tool. Covers issues, PRs, releases, repos, Actions, labels, milestones, branches, webhooks, SSH keys, organizations, admin tasks, and generic API access.

gitea-wiki

For wiki page operations via gitea-mcp (preferred) or REST API.

Quick Reference

# Authentication check
tea whoami

# Most commands need --login (host) or --repo (owner/repo) when outside a git repo
tea issues list --login gitea.example.com --repo owner/repo

# Use --output for non-interactive/script usage
tea issues list --output json

# Always use --yes for destructive operations in scripts
tea repos delete owner/repo --yes

Documentation

• MCP Server: https://gitea.com/gitea/gitea-mcp (official gitea-mcp with ~100 tools)
• Usage docs: https://docs.gitea.com/category/usage
• Repository: https://docs.gitea.com/usage/repositories
• Issues & PRs: https://docs.gitea.com/usage/issues
• Actions: https://docs.gitea.com/usage/actions
• Wiki API: https://docs.gitea.com/api/1.26/repo/wiki
• CLI (tea): https://gitea.com/gitea/tea

Common Tasks Route

Task	Child Skill	Command Pattern
Manage issues	gitea-tea	tea issues list/create/edit/close
Manage PRs	gitea-tea	tea pulls list/create/merge/close
Manage releases	gitea-tea	tea releases list/create/edit/delete
Manage repos	gitea-tea	tea repos list/create/delete/clone
Run Actions	gitea-tea	tea actions runs list/view/logs
Manage secrets/variables	gitea-tea	tea actions secrets/variables
Manage labels/milestones	gitea-tea	tea labels/milestones
SSH keys	gitea-tea	tea ssh-keys list/add/delete
Organizations	gitea-tea	tea organizations list/view/create
Admin tasks	gitea-tea	tea admin users list/create/edit/delete
Wiki pages	gitea-wiki	API: GET/POST/PATCH/DELETE /repos/owner/repo/wiki/{page}