---
name: gitea-workflow
description: >-
  Canonical alias for the Gitea/LLM project workflow router. Same skill as
  llm-project-workflow. Use at the start of any Gitea-Tools author, review,
  merge, reconcile, or issue-filing task. Trigger terms: gitea-workflow,
  llm-project-workflow, git-pr-workflows, gitea, PR review, work-issue.
---

# gitea-workflow (canonical alias)

This directory is the **stable name** for controller prompts and Codex mounts
(`gitea-workflow`). The portable implementation lives at:

**[`../llm-project-workflow/SKILL.md`](../llm-project-workflow/SKILL.md)**

## Required action

1. Open and follow `skills/llm-project-workflow/SKILL.md` (router).
2. Load the matching workflow under `skills/llm-project-workflow/workflows/`.
3. Do not mutate git/Gitea until the workflow is loaded.

## Multi-runtime names (must resolve identically)

| Name | Role |
|------|------|
| `gitea-workflow` | Canonical controller / Codex skill name |
| `llm-project-workflow` | Portable in-repo skill package |
| `git-pr-workflows` | Legacy alias |

Install for Codex:

```bash
./scripts/install-codex-workflow-skill.sh
```

Preflight via MCP: `mcp_check_workflow_skill_preflight`.

## Tool inventory

Which tools actually exist is documented in
[`docs/mcp-tool-inventory.md`](../../docs/mcp-tool-inventory.md), which a test
holds equal to the registered set. Never plan a mutation against a tool that is
not listed there — that is the #781 failure mode, where a documented
`gitea_edit_issue` did not exist until execution time.
