configurar-repo
Skill15 starsChanged 2 months agoMITView on GitHub
Configura el repositorio de GitHub de punta a punta con gh — descripción, topics, labels, rama develop, protección de ramas, merge settings y metadatos — a partir de la definición del producto. Úsalo al crear el repo de un proyecto nuevo o cuando haya que poner en orden uno existente (p. ej. "configura el repo", "prepara el repositorio en GitHub", "pon los labels y la protección de ramas").
- Commits and pushes
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accessibility-auditSkill
- actualizar-plantillaSkill
- changelogSkill
- commitSkill
- copywritingSkill
- design-system-auditSkill
- i18n-paritySkill
- identidadSkill
- instanciarSkill
- migration-guardSkill
- new-adrSkill
- new-specSkill
- open-issueSkill
- open-prSkill
- portar-cambioSkill
- prototipoSkill
- releaseSkill
- seo-auditSkill
The file
Files
Deja el repositorio de GitHub operativo y coherente con la plantilla. Requiere gh
autenticado; verifica con gh auth status antes de empezar.
Paso 1 — Contexto
Lee README.md y docs/product/business-model.md para derivar descripción y
topics. Detecta el repo actual (gh repo view). Si no existe remoto, pregunta si
crearlo (gh repo create — público/privado lo decide la persona).
Paso 2 — Metadatos
- Descripción: una frase desde la visión del producto (
gh repo edit --description). Homepage: la URL del producto si existe. - Topics: 3–6 derivados del stack y el dominio (
gh repo edit --add-topic).
Paso 3 — Labels
Ejecuta .github/scripts/setup-labels.sh (usa .github/LABELS.md como catálogo).
Paso 4 — Ramas y flujo
- Crea
developdesdemainsi no existe, publícala y establécela como rama por defecto del repo (gh api -X PATCH repos/{owner}/{repo} -f default_branch=develop) — no es opcional: la rama por defecto es a donde apuntan los PRs nuevos y los de Dependabot; si quedamain, el Git Flow se rompe (CONTRIBUTING.md). - Verifica que
.github/dependabot.ymltengatarget-branch: "develop"en cada ecosistema. - Protección de
main(ydevelopsi la persona quiere): PR obligatorio, sin force-push, conversaciones resueltas y checks requeridos por su nombre de check run, no por el del workflow:Calidad(dequality.yml) yGitleaks(desecret-scan.yml). Si pones el nombre del workflow, el PR se queda esperando un check que nunca reporta. Verifícalos congh api repos/{owner}/{repo}/commits/{sha}/check-runs --jq '.check_runs[].name'sobre un commit que ya haya corrido CI. Aplica víagh api repos/{owner}/{repo}/branches/{branch}/protectiony muestra el JSON antes de aplicar. - Comprueba que los hooks locales corran:
bash .github/scripts/check-hooks-enabled.sh(con--arreglarlos activa).core.hooksPathno viaja en el repositorio, así que el estado por defecto de cualquier clon nuevo es «sin ninguna verificación local».
Si GitHub responde 403 a la protección
gh: Upgrade to GitHub Pro or make this repository public to enable this feature. (HTTP 403)En un repositorio privado de plan gratuito la protección de ramas no existe. No es
un error suelto que se reporta al final: es un resultado previsto que cambia lo que
el proyecto puede prometer. CONTRIBUTING.md y AGENTS.md declaran PR obligatorio,
nada de push directo a main/develop y checks requeridos para fusionar — y todo eso
lo hace cumplir el servidor. Sin él queda esto:
| Control | Qué cubre | Cómo se salta |
git-guardrails.sh | Push desde una rama protegida | Es un hook del agente: no aplica a la persona |
.githooks/pre-push | Los checks antes de publicar | git push --no-verify |
core.hooksPath | Activa lo anterior | Se olvida: es manual, una vez por clon |
Haz tres cosas, en el momento en que aparece el 403:
- Dilo con todas las letras, sin suavizarlo: «este repositorio no tiene protección
de ramas; los hooks locales son el único control y se saltan con
--no-verify». - Plantea la salida real: hacer público el repositorio activa la protección gratis. Es una decisión de producto, no técnica — pregúntala aquí, no después.
- Déjalo por escrito en el
README.mdo en el ADR de instanciación, para que quien llegue después no dé por buenas unas reglas que nadie aplica.
Paso 5 — Ajustes de merge e higiene
- Squash merge habilitado, borrar ramas al mergear, issues habilitados; template de PR/issues ya vienen del repo.
- Verifica que Actions esté habilitado y que los workflows activos (
quality.yml,secret-scan.yml) corran.
Paso 6 — Cierre
Resume qué quedó configurado (con los comandos ejecutados) y regístralo en el CHANGELOG
bajo Unreleased. Y di qué NO quedó protegido, con su consecuencia — no basta con
listar qué falló por permisos: si no hay protección de ramas, el resumen tiene que decir
que las reglas de CONTRIBUTING.md no las hace cumplir nadie (Paso 4).
Reglas: muestra cada comando destructivo o de configuración antes de ejecutarlo la primera vez; NO borres labels/ramas existentes sin confirmar; NO toques repos que no sean el del proyecto actual.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

