instanciar
Skill15 starsChanged 2 months agoMITView on GitHub
Instancia esta plantilla en un proyecto real mediante una entrevista guiada — detecta si el proyecto es nuevo o existente, rellena los placeholders, adapta los docs al tipo de proyecto y decide la política de permisos. Úsalo cuando la persona clone/adopte esta plantilla y quiera configurarla para su proyecto (p. ej. "instancia esta plantilla", "configura este template para mi proyecto", "arranca el proyecto desde esta base").
- Reads credentials
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accessibility-auditSkill
- actualizar-plantillaSkill
- changelogSkill
- commitSkill
- configurar-repoSkill
- copywritingSkill
- design-system-auditSkill
- i18n-paritySkill
- identidadSkill
- migration-guardSkill
- new-adrSkill
- new-specSkill
- open-issueSkill
- open-prSkill
- portar-cambioSkill
- prototipoSkill
- releaseSkill
- seo-auditSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 121
NO hagas commit — deja que la persona revise.
- Distinctive: line 126
NO instancies sobre el repo-fuente del template (Paso 0), NO sobrescribas el código de producción en proyectos existentes, NO hagas commit …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- Skill de ejemplo de la plantilla — adáptalo o elimínalo según tu proyecto. -->Convierte esta plantilla en la documentación real de un proyecto mediante una entrevista.
Lee TEMPLATE-USAGE.md primero: es la fuente de verdad del catálogo de placeholders (§3),
las reglas de borrado por tipo (§7) y el flujo de adopción (§2). Sigue ese documento si
difiere de los pasos de abajo.
Paso 0 — Guardián de seguridad (antes de nada)
Detente y avisa si estás sobre el REPO-FUENTE del template (no una instancia):
- Revisa
git remote -v. Si el origin es el repositorio de la plantilla (project-starter-template-es-ai), NO instancies: estarías destruyendo la plantilla. - En ese caso, pregunta explícitamente si de verdad se quiere modificar la plantilla original antes de continuar.
Paso 1 — Detectar contexto (nuevo vs. existente)
Sin preguntar aún, inspecciona el repo para deducir el contexto:
- ¿Hay código real? (
package.json,Gemfile,pyproject.toml,go.mod,src/, etc.) - ¿El historial de git tiene commits propios del proyecto o es un clon recién iniciado?
- ¿Siguen intactos los
[PLACEHOLDERS]? (grep -rno '\[[A-ZÁÉÍÓÚÑ0-9_/]\+\]' --include='*.md' .)
Deduce NUEVO (repo vacío / placeholders intactos) o EXISTENTE (ya hay código).
Paso 2 — Confirmar y entrevistar (usa AskUserQuestion)
Muestra tu deducción del Paso 1 y deja corregirla. Luego pregunta SOLO lo que no puedas inferir. En proyectos existentes, pre-rellena las respuestas leyendo el código.
- Lote A · Contexto y tipo: nuevo/existente; tipo (Web · Móvil · Escritorio · API/servicio · Librería).
- Lote B · Identidad: nombre, autor, usuario/org de GitHub, empresa (opcional),
email de soporte, email de seguridad, licencia y año. Infiere autor/usuario de
git configy el año de la fecha del sistema. - Lote C · Stack: runtime, gestor de paquetes, base de datos (o "ninguna"), puerto, comandos (instalar / dev / test / lint). En existente: LÉELO del código, no preguntes.
- Lote D · Capacidades: ¿API? ¿autenticación? ¿i18n? ¿SEO/web pública? ¿emails transaccionales? ¿sistema de diseño/UI? (Cada "no" implica borrar su convención.)
Lote E · Permisos: ¿dejar el
ask:[Bash]conservador de.claude/settings.json, o crear.claude/settings.local.jsoncon una allowlist de solo-lectura?Los tres guardrails (git, secretos y specs) vienen activos: solo se tocan si la persona lo pide expresamente, y entonces queda escrito en el ADR del Paso 6.
Activa además los git hooks del clon, que no viajan en el repositorio:
bash .github/scripts/check-hooks-enabled.sh --arreglar. Sin eso,pre-commitno formatea ypre-pushno verifica: los fallos se descubren en el CI.
Paso 3 — Rellenar / fusionar según contexto
Reemplaza los placeholders del catálogo (TEMPLATE-USAGE.md §3) con las respuestas:
[NOMBRE_DEL_PROYECTO], [AUTOR], [USUARIO_GITHUB], [NOMBRE_EMPRESA],
[URL_REPOSITORIO], [AÑO], [EMAIL_SOPORTE], [EMAIL_SEGURIDAD], [RUNTIME],
[GESTOR_DE_PAQUETES], [BASE_DE_DATOS], [PUERTO], [COMANDO_*], [URL_*], [FECHA].
Archivos que se actualizan: README.md, AGENTS.md (resumen + comandos),
docs/architecture/*, docs/product/*, .env.example, LICENSE (año + autor),
SECURITY.md (emails), CHANGELOG.md (primera entrada).
- NUEVO: escribe directo desde las respuestas. Trabaja en el repo tal cual.
- EXISTENTE: lee el código e infiere para no dejar
[…]. NO sobrescribasREADME.md,LICENSEni.gitignore— propón el merge a mano. Trabaja en una ramachore/adopt-doc-template. Sugiere correr/initpara integrar el contexto del código.
Además, escribe .template-origin en la raíz para que /actualizar-plantilla pueda
traer mejoras futuras de la plantilla:
repo=<URL de esta plantilla>
commit=<SHA del HEAD de la plantilla usado como base>
fecha=<YYYY-MM-DD de hoy>Paso 4 — Aplicar la decisión de permisos (Lote E)
Si se eligió "automático", crea .claude/settings.local.json con una allowlist de
comandos de solo-lectura (ls, cat, head, tail, wc, grep, rg, find, tree, sort, uniq,
echo, pwd, which, y git status/log/diff/branch/show/remote). Verifica que
.claude/settings.local.json esté en .gitignore. Si se eligió "conservador", no toques
nada de permisos.
Si se aceptaron los guardrails de git y/o los guardrails de secretos, añade los
bloques hooks.PreToolUse que apuntan a .claude/hooks/git-guardrails.sh (matcher
Bash) y .claude/hooks/secret-guardrails.sh (matcher Write|Edit) — el JSON completo
está en docs/conventions/ai-agents.md. Requieren python3.
Paso 5 — Limpieza por tipo (regla de TEMPLATE-USAGE.md §7)
Borra los docs/convenciones que no apliquen:
- Móvil / Escritorio → borra
docs/conventions/seo.md; reenfocaui,api,deploy. - API / Librería → borra los docs de UI (
conventions/seo.md,conventions/ui.md,architecture/screens.md) y la carpetadesign/conDESIGN.md. - Cada capacidad respondida "no" en el Lote D → borra su convención (p. ej. sin i18n →
docs/conventions/i18n.md) y su skill asociada: sin i18n →i18n-parity; sin base de datos →migration-guard; sin SEO/web pública →seo-audit; sin UI (API o librería) →design-system-audit,accessibility-audit,copywriting,identidad,prototipoy el subagentedesigner. - Siempre borra los archivos exclusivos del repo-plantilla: el workflow
.github/workflows/template-parity.yml, el script.github/scripts/check-parity.shy la skill.claude/skills/portar-cambio/— solo sirven para mantener la familia de variantes, no a un proyecto instanciado.
Pregunta antes de borrar en bloque si hay ambigüedad.
Paso 6 — Cierre
Registra la instanciación como el ADR 0002 (usa docs/decisions/0000-template.md):
contexto del proyecto, stack elegido, tipo, convenciones eliminadas y política de
permisos/guardrails — así el proyecto estrena su propio registro de decisiones.
Muestra un resumen del diff y la lista de placeholders que aún requieren decisión humana.
NO hagas commit — deja que la persona revise. En "existente", recuérdale que todo quedó
en la rama para abrir un PR. Sugiere borrar TEMPLATE-USAGE.md cuando termine.
Ejemplo: /instanciar → entrevista → repo con documentación real y docs/ podados.
NO instancies sobre el repo-fuente del template (Paso 0), NO sobrescribas el código de
producción en proyectos existentes, NO hagas commit ni push por tu cuenta, y NO inventes
datos: si no puedes inferir un valor y la persona no lo da, deja el placeholder y
márcalo como pendiente en su línea —[EMAIL_SEGURIDAD] <!-- pendiente: aún sin
buzón -->, o con # dentro de un bloque de código—. check-placeholders.sh distingue
lo que decidiste dejar de lo que se te olvidó; sin la marca, falla.
Y no dejes el CHANGELOG ni los ADRs de la plantilla: son de otro repositorio. Resetea el
CHANGELOG conservando su ## [Unreleased] (sin una entrada, check-changelog.sh
bloquea el primer PR) y borra todo ADR salvo el 0001. Lo verifica
check-inheritance.sh.
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.

