| name | verificar-comandos-gh |
| description | Comprueba que los comandos gh, endpoints REST/GraphQL, flags y nombres de features de GitHub citados en el material existan de verdad y hagan lo que el texto dice. Usar SIEMPRE después de escribir teoría o prácticas con comandos, y antes de dar por cerrada cualquier semana. |
| allowed-tools | Bash(gh *) Bash(jq*) Read Grep Glob WebFetch |
Verificar comandos gh y endpoints
El fallo más probable de este repo no es un enlace roto: es un comando
plausible que no existe. Pasa la revisión a ojo y revienta cuando el
estudiante lo ejecuta. Este skill lo caza.
Qué revisar
1. Extraer los comandos del contenido
grep -rhoE '^\s*gh [a-z].*' bootcamp/week-NN-*/ | sort -u
2. Verificar cada subcomando y flag
gh <comando> --help
gh api --help
Si gh no reconoce el subcomando o el flag, el material está mal. No lo
"arregles" adivinando otro flag: busca en gh <comando> --help cuál es el real.
3. Verificar endpoints REST
gh api repos/ergrato-dev/bc-github --jq 'keys'
Errores típicos:
| Escrito | Real | Diferencia |
|---|
repos/{repo}/rules | repos/{repo}/rulesets | rules devuelve las reglas efectivas de una rama, no los rulesets |
repos/{repo}/branches/main/protection | — | Es branch protection clásica, no rulesets |
repos/{repo}/actions/secrets | correcto | pero no lista los valores, solo los nombres |
Si un endpoint devuelve 404 en un repo donde debería existir, el endpoint está
mal escrito. Si devuelve 403, es un problema de scopes, no del material.
4. Verificar queries GraphQL
gh api graphql -f query='query { viewer { login } }'
Los campos de Projects v2, Discussions y sub-issues cambian: verifica cada campo
contra el esquema antes de darlo por bueno.
5. Verificar nombres de features
Contrastar contra docs.github.com. Trampas conocidas:
- Rulesets ≠ branch protection (branch protection es legado)
- Projects v2 ≠ Projects classic (retirado)
- Fine-grained PAT ≠ PAT clásico
- Code scanning es el producto; CodeQL es un motor dentro de él
- Artifact attestations ≠ npm provenance (relacionados, distintos)
- Merge queue requiere que la rama esté protegida por un ruleset con checks
6. Verificar los jq de checks.json
jq -e . bootcamp/week-NN-*/checks.json
Y cada expresión, contra un repo real:
gh api repos/<usuario>/<repo>/rulesets --jq 'map(select(.enforcement == "active")) | length > 0'
Debe imprimir true o false, nunca un objeto ni un error de jq.
Cómo reportar
Una línea por hallazgo: archivo, línea, comando escrito, comando real. Si todo
está correcto, dilo en una línea y ya — no infles el informe.
Lo que NO haces
- No opinas sobre redacción ni pedagogía.
- No ejecutas comandos que escriban (
--method POST/PATCH/DELETE, gh repo delete, gh ruleset...) contra repos reales. Solo lectura.
- No inventas un comando alternativo si no puedes verificarlo: marca el hallazgo
y enlaza la documentación.
