Files
holocron/plugins/gitea/skills/gitea-issues/README.md
Defame1297 bbc73008a3 chore(gitea): regenerate the flat content mirror after the ADR-0020 retrofit
Generated output, not authored content: scripts/sync-plugin-content.sh --all.
Claude Code has no .apm/ awareness, so this compiled mirror must track .apm/ or
the check-plugin-content-sync pre-push hook reports drift.

Deferred to a single commit at the end of the wave on purpose. sync_dir runs
rm -rf before every copy, so running it while seven agents were editing the
same plugin would have raced them; agents were told not to sync for that reason.

Refs #99
2026-08-30 12:42:20 +00:00

2.6 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.

How it composes

This skill composes gitea-labels-milestones for all label inference, label-name-to-ID resolution, and milestone lookup, rather than duplicating that taxonomy or its resolution logic — see references/enrichments.md for the call protocol. Managing the label and milestone definitions themselves (create/edit/delete a label, create/close a milestone) is out of scope here and goes to gitea-labels-milestones directly.

One boundary the description does not spend characters on, because it was never going to win an issue request: local git branch or commit work belongs to gitea-branches (Gitea-side) or git-branches (working copy).

Usage

/gitea-issues

Describe your task: list issues, create one, get/comment/close/label 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