Files
holocron/plugins/gitea/skills/gitea-workflow/README.md
Defame1297 0f138f27db feat(gitea): add gitea-workflow skill (human-facing dispatcher)
Adds the human-facing entry point and dispatcher for the Gitea
integration per docs/adr/0011-gitea-skill-deep-modules.md. Preserves
the retired flat skill's default no-args status view (open issues +
open PRs, composed via list_issues/list_pull_requests) and extends
its dispatch table to route ambiguous requests across all 6 domain
skills (issues, labels/milestones, prs, branches, files, releases) —
the old table only covered 4 of these. The skill only calls
gitea-mcp tools directly for the composed status view; every other
operation is a routed handoff to the owning sibling skill, keeping
execution logic (call signatures, gotchas, confirmation gates) owned
in one place.

Bumps plugins/gitea version 1.1.0 -> 1.2.0 in both manifests for the
new skill. Passed structural validation, provenance validation, and
an independent clean-context skill-audit recheck (one finding fixed:
allowed-tools was missing the Skill tool needed for routing).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FNJWdVvdgvZCHi1hZGqgVQ
2026-07-05 11:16:31 +00:00

29 lines
2.0 KiB
Markdown

# gitea-workflow
Human-facing entry point and dispatcher for the Gitea integration — the default status view plus routing to whichever domain skill owns an ambiguous request.
## What it does
This skill is the thin front door for the Gitea integration suite. With no arguments it reproduces the old flat skill's default status view: open issues and open PRs, composed by calling `gitea-issues`' and `gitea-prs`' underlying `list_issues`/`list_pull_requests` tools directly. For any other request, it resolves `owner`/`repo` once from the git remote and routes to whichever of the 6 domain skills owns the request — `gitea-issues`, `gitea-labels-milestones`, `gitea-prs`, `gitea-branches`, `gitea-files`, `gitea-releases` — rather than executing domain operations itself. It does not duplicate any domain skill's call signatures, dispatch verbs, or error recovery; those stay owned by the domain skill.
## Usage
```
/gitea-workflow
```
With no arguments: shows open issues + open PRs. With a request that doesn't already name a domain explicitly, describe what you want — the skill resolves owner/repo and routes to the right domain skill. If you already know which domain applies (issues, labels/milestones, PRs, branches, files, releases), you can invoke that skill directly instead — this one exists for the ambiguous/default case.
## Files
| File | Purpose |
|------|---------|
| `SKILL.md` | Skill instructions for agents — routing table, default status view, Gotchas |
| `references/README.md` | Describes the references directory contents |
| `references/sources.md` | Provenance for the routing table and status-view call signatures |
## Related
- `plugins/bin/skills/gitea/SKILL.md` — the retired flat skill this one replaces (kept as a fallback reference per `docs/adr/0011-gitea-skill-deep-modules.md`, not deleted).
- `plugins/gitea/skills/gitea-issues/`, `gitea-labels-milestones/`, `gitea-prs/`, `gitea-branches/`, `gitea-files/`, `gitea-releases/` — the 6 domain skills this one routes to.