skill-gitea/README.md

skill-gitea

Skill local de Claude Code para gitea.nucleoriofrio.com (Gitea 1.24, org NucleOS). Cubre PRs, creación de repos, y la killer feature: introspección de Gitea Actions runs con filtros precisos para no saturar la ventana de contexto.

Mirror público del directorio local ~/.claude/skills/gitea/ en la PC del usuario humano. Existe para que el usuario pueda auditar lo que el bot hace contra su instancia de Gitea (creación de repos, PRs, lectura de logs). Clonar y correr en otra máquina no funciona out-of-the-box — requiere PAT del bot en .env (no incluido) y la skill bitwarden configurada para extraerlo.

Doc principal

Ver SKILL.md — diseño, modelo de seguridad (admin guard + anti-AI guard + visibilidad pública del bot), lifecycle, ejemplos.

Cheat sheet de endpoints en endpoints.md.

Estructura

.
├── SKILL.md             ← docs canónicas
├── endpoints.md         ← cheat sheet API Gitea 1.24
├── .env.example         ← plantilla de config (PAT, bot user, etc.)
├── .gitignore
├── README.md            ← este archivo
└── scripts/
    ├── setup.sh                ← extrae PAT desde skill bitwarden + valida
    ├── query.sh                ← helper REST con admin guard
    ├── pr-list.sh              ← lista PRs (state filter)
    ├── pr-view.sh              ← detalle de un PR
    ├── pr-comments.sh          ← lista comments (requiere PAT con read:issue)
    ├── pr-create.sh            ← crear PR (anti-AI guard + UTF-8 safe)
    ├── repo-create.sh          ← crear repo (regla dura: bot user → siempre público)
    ├── actions-list-runs.sh    ← lista runs (filtros client-side)
    ├── actions-view.sh         ← detalle de un run + probe de job_id
    └── actions-logs.sh         ← logs con --tail/--head/--lines/--grep/--errors

Lo que NO está en este repo

• .env (PAT del bot, base URL si fuera distinta a producción)

Vive solo en la PC del usuario humano. Se regenera con bash scripts/setup.sh si el bot tiene la skill bitwarden con un item llamado "Gitea PAT claude-agent-gitops".

Dependencias

• Python 3 (parsear JSON, escapar bodies UTF-8)
• curl (Git Bash en Windows lo trae)
• skill bitwarden sibling (para extraer el PAT en setup.sh)