agentleFS
MazalucasMazalucas/El-DT-Lightweight-Army/.agents/skills/dt-setup/SKILL.md

dt-setup

Skill4 starsChanged 4 days agoMITView on GitHub

[Rutina/Framework] Primera vez o repair multi-IDE. /bienvenida = charla guiada de a un paso (checklist en silencio, pregunta de camino, /yo); /setup = repair drift. Use when the user invokes /bienvenida, /setup, or first conversation post-clone without session.

  • Reads credentials

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 2 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No commitear durante /bienvenida salvo que el usuario pida /guardar.

    line 58
  2. Distinctive:

    No volcar todo el guion en un mensaje: un paso por vez.

    line 75
  3. Very specific:

    No borrar carpetas de IDE ni usar --solo (eliminado).

    line 76
  4. Very specific:

    No tocar vitals/ops/session.yaml, .env, credenciales.

    line 77
  5. Very specific:

    No instalar Git/Ruby/npm sin confirmación explícita del usuario.

    line 78
  6. Distinctive:

    No commitear durante setup.

    line 79
  7. Very specific:

    No pushear al remoto oficial del DT ni ofrecer pedir acceso.

    line 80

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

dt-setup

Setup multi-IDE, no destructivo. Dos modos; el agente elige según el command invocado y el contexto.

CommandModo default
/bienvenidafirst-run — charla guiada de a un paso, sin Ruby obligatorio
/setuprepair — regenerar desde fuentes canónicas + dt-doctor

Referencias: references/first-run-checklist.md · references/welcome-message.md · references/post-sync-pipeline.md

Fuente de verdad

Registro de IDEs: vitals/config/ide-targets.yaml. No hardcodear IDEs en este skill.

Modo A — first-run (default en /bienvenida)

La bienvenida es una charla: un paso por mensaje, y esperás la respuesta antes de seguir. El primer mensaje es la Presentación del guion (quién soy, para qué existo, objetivo, /yo y /ayuda). El camino de un clone se pregunta después, si todavía no está elegido. Guion obligatorio: references/welcome-message.md.

El clone ya trae .cursor/, .agents/, .claude/, commands y skills en Git. El usuario no necesita Ruby para empezar.

  1. Resolver git_root (multi-proyecto: vitals/workspace.yaml si existe).
  2. Correr en silencio references/first-run-checklist.md: paths, Git, desajuste. No lo muestres salvo que falle.
  3. Si el checklist falla, mandá M0-B. Si no, mandá solo la Presentación. Esperá la respuesta.
  4. Con /yo empieza dt-session. Si todavía no hay camino (clone del DT, sin dt-upstream, sin /oficial), la pregunta de camino va después de la identidad, con el texto M1 del guion. Según la opción, registrá dt-upstream (abajo) e instalá el pre-push con ./scripts/dt-oficial.sh install-hook.
  5. dt-session cierra con el paso siguiente del camino. No repitas la presentación.
  6. No correr sync-ide ni dt-doctor salvo desajuste evidente y que el usuario pida reparar → modo B.

Escrituras permitidas en first-run

Solo estas, locales y sin commit:

  • git remote add dt-upstream …
  • vitals/config/dt-upstream.md (desde vitals/config/dt-upstream.example.md)
  • ./scripts/dt-oficial.sh install-hook

Nada más hasta /yo.

Registro dt-upstream (first-run)

Si el repo parece El DT (AGENTS.md + vitals/config/commands-meta.yaml) y existe origin y no existe remote dt-upstream, la pregunta de camino (M1) lo resuelve. No hagas una pregunta aparte.

  1. Opción 1 o 2 → consumidor (default en clone antes de /bootstrap):

    git remote add dt-upstream "$(git remote get-url origin)"

    Copiar vitals/config/dt-upstream.example.md → vitals/config/dt-upstream.md con mode: consumer y framework_version = contenido de VERSION en ese momento (el clone todavía trae el semver del DT). Eso no autoriza a escribir ese número en la app. Después de /bootstrap, VERSION es del producto y no se vuelve a copiar a framework_version desde /guardar.

  2. Opción 3 → canónico: mode: canonical en el frontmatter (Fase B de /actualizar se omite). Eso no habilita el push. Publicar al remoto oficial exige /oficial en este checkout, con la sesión de GitHub del dueño.

No commitear durante /bienvenida salvo que el usuario pida /guardar. Si ese /guardar apunta al remoto oficial y la carpeta no está activada, el gate corta: no pidas acceso.

Modo B — repair (default en /setup, drift, post-pull grande)

  1. Mismos checks del modo A.
  2. Si Ruby disponible → pipeline completo en references/post-sync-pipeline.md.
  3. Si Ruby no disponible → explicar que la estructura del clone suele bastar; sugerir Ruby solo a maintainers.
  4. Informar: targets enabled garantizados, resultado de dt-doctor, versión VERSION.

Inferencia de modo

  • /bienvenida → siempre first-run primero; repair solo si el checklist falla (M0-B) o el usuario pide explícitamente reparar.
  • /setup → repair; si todo OK en checklist, reportar "estructura OK" y opcionalmente correr pipeline si Ruby hay.
  • Drift tras /actualizar → repair (compartir pipeline con git-actualizar vía post-sync-pipeline.md).

No hacer

  • No volcar todo el guion en un mensaje: un paso por vez.
  • No borrar carpetas de IDE ni usar --solo (eliminado).
  • No tocar vitals/ops/session.yaml, .env, credenciales.
  • No instalar Git/Ruby/npm sin confirmación explícita del usuario.
  • No commitear durante setup.
  • No pushear al remoto oficial del DT ni ofrecer pedir acceso. Publicar es /oficial, solo en el checkout que el dueño activó.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.