holocron/plugins/bin/skills/gitea/README.md

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.