Files
holocron/plugins/gitea/skills/gitea-issues/README.md
Defame1297 3a1305c438 chore(gitea): remove old flat gitea skill, superseded by plugins/gitea
The deep-module split in plugins/gitea/ (ADR 0011) already covers every
domain the old plugins/bin/skills/gitea/ flat skill handled. Move its
token-access.md into plugins/gitea/references/ first, since it held
empirical scope-test results (Actions/CI, Wiki, Notifications, Packages,
User/Org) not reproduced anywhere in the new plugin, then drop the old
skill and fix a stale cross-reference pointing at it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-23 18:04:37 +00:00

2.1 KiB

gitea-issues

Read and write Gitea issues — list, get, create, comment, close, and search — via the Gitea MCP server.

What it does

This skill handles the issue lifecycle (list_issues, issue_read, issue_write, search_issues): listing repo issues, reading a single issue's details/comments/labels, creating an issue, updating its state, adding/editing comments, applying labels, and searching issues/PRs across repositories. The create flow closes out four enrichments deferred from issue #6 comment #848: label inference and milestone assignment (both by composing gitea-labels-milestones), an assignee workaround for the blocked get_me scope, and the "Depends on #N" dependency-linking convention. It supersedes the issue/issue <N>/issue close <N>/issue comment <N> dispatch in the old flat plugins/bin/skills/gitea/SKILL.md, removed per docs/adr/0011-gitea-skill-deep-modules.md.

Before you start

Requires a Gitea MCP server configured with a token holding write:issue + write:repository. Requires a git remote named origin pointing at the Gitea instance, unless an orchestrating caller (e.g. gitea-workflow) already resolved owner/repo for you. Label and milestone management (creating/editing a label, creating/closing a milestone) is out of scope here — that's gitea-labels-milestones, which this skill composes rather than duplicates.

Usage

/gitea-issues

Describe your task: list issues, create one, get/comment/close a specific issue number, or search across repos. 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/issues.md Verified call signatures and mechanics for list_issues/issue_read/issue_write
references/search.md Verified call signature and mechanics for search_issues
references/enrichments.md Create-flow enrichments — label inference, milestone assignment, assignee workaround, dependency-linking convention
references/sources.md Research sources backing the issue guidance