# gitea

Dispatch skill for managing a Gitea repo — issues, PRs, milestones, labels, and branches — from within Claude Code.

## Files

| File | Purpose |
|---|---|
| `SKILL.md` | Skill definition — dispatch table, gotchas, execution steps |
| `references/token-access.md` | Token scope inventory — what works vs. what needs additional scopes |

## Usage

```
/gitea                          # status: open issues + open PRs
/gitea issue                    # create issue from conversation context
/gitea issue <N>                # get issue details
/gitea issue close <N>          # close issue
/gitea issue comment <N>        # add comment from conversation context
/gitea label <N> Kind/Bug       # apply labels by name (resolves IDs automatically)
/gitea milestone                # list milestones
/gitea milestone create <title> # create milestone
/gitea pr                       # create PR from current branch → main
/gitea pr <N>                   # get PR status and diff summary
/gitea pr merge <N>             # squash-merge PR, delete branch
/gitea branch                   # list branches
/gitea branch create <name>     # create branch from current branch
```

## Requirements

- Gitea MCP server configured in `~/.claude.json` with `write:issue` and `write:repository` token scopes
- `git remote origin` pointing to the Gitea instance (used to derive owner/repo at runtime)

## Scope (v1)

In scope: issues, milestones, labels, PRs, branches, status.
Out of scope: releases, CI/Actions, wiki, file operations, notifications, packages, time tracking.