Files
holocron/plugins/gitea/.apm/skills/gitea-branches
Defame1297 1a971ee003 fix(gitea): restore routing and sourcing content the retrofit dropped
gitea-issues asserted flatly that a merge never closes an issue, contradicting
gitea-prs' references/merging.md, which documents that closing keywords in
commits landing on the default branch do close one. The qualifier that made the
claim true had been deleted; both sides now agree.

gitea-releases had lost an epistemic hedge and its verification step, leaving
conventions.md asserting unconfirmed tag auto-creation as fact. Nothing in the
research corpus sources it, so the hedge and the verify-afterward instruction are
back rather than upgraded.

Descriptions were cut 50-240 chars under the 400 budget and shed routing with
them: gitea-workflow's boundary named no target, gitea-prs lost the issue/PR
number-space directive the suite is built around at 163/400, gitea-releases lost
its boundary and every trigger. Restored, inside budget. Also restores
delete_branch's hard-refusal strength and gitea-files' Read/Write/Edit pointer.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EJJrm5YmacbwMdzZpXcoti
2026-08-31 19:46:32 +00:00
..

gitea-branches

Manage Gitea repository branches and inspect commit history via the Gitea MCP server.

What it does

This skill handles branch lifecycle operations (list, create, rename, delete) and read-only commit history (list commits, get a single commit's full detail) against a Gitea repository. It resolves owner/repo from the git remote, dispatches to the right MCP tool, and applies safety and pagination conventions specific to Gitea's API (e.g. refusing to delete a protected branch without explicit confirmation, and treating unexpected 404s as possible masked 403s).

Boundaries

This skill operates on the Gitea server via the MCP tools, never on your local checkout. Branch and commit-history work against the working copy belongs to git-branches and git-history. Branch references that only exist relative to a pull request — a PR's head or base branch, and cross-repo fork PR heads in particular — belong to gitea-prs; list_branches cannot see a fork's head at all.

The skill triggers on phrasings like "list branches", "create a branch", "rename a branch", "delete a branch", "what commits are on this branch", "show commit ", and "what changed in that commit", even when the user does not say "Gitea", as long as the repo's remote is a Gitea instance.

Before you start

Requires a Gitea MCP server configured with a token that has write:repository scope. This is confirmed for list_branches, create_branch, and delete_branch (and inferred for rename_branch) (Gitea gates reads behind write scope for repo-scoped operations); list_commits and get_commit are inferred to need the same scope by analogy, not explicitly confirmed — see references/commits.md. Requires a git remote named origin pointing at the Gitea instance.

Usage

/gitea-branches

Describe your task: list/create/rename/delete a branch, or list/inspect commits. See SKILL.md's dispatch table for the full set of recognized invocations.

Files

File Purpose
SKILL.md Skill instructions for agents — dispatch table, gotchas
references/branches.md Verified call signatures and mechanics for list/create/rename/delete branch
references/commits.md Verified call signatures and mechanics for list/get commit
references/sources.md Research sources backing the branch/commit guidance