---
name: gitea
description: 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.
version: 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

```bash
# 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}` |