39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# 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.
|