agentleFS
sergi-rzsergi-rz/claudia-os/.claude/skills/claudia-update/SKILL.md

claudia-update

Skill39 starsChanged 7 months agoMITView on GitHub

Actualiza el framework de Claudia OS desde el repo canónico sergi-rz/claudia-os, protegiendo todo el territorio del usuario (user/, .claude/skills/*/user/). Uso: /claudia-update

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
  1. Distinctive:

    No elimines ni modifiques blueprints locales que no aparezcan en esa lista.

    line 151
  2. Very specific:

    Si upstream/main no existe, parar con mensaje claro: No mostrar errores git crudos.

    line 173

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

claudia-update

Qué hace

Sincroniza la instalación local con la última versión del framework publicada en sergi-rz/claudia-os. Nunca toca el territorio del usuario.

Territorio del usuario — intocable:

  • user/ — todo, sin excepciones
  • .claude/skills/*/user/ — personalizaciones de skills
  • .claude/settings.json, .claude/settings.local.json
  • Blueprints en blueprints/ que no existan en el repo canónico (son del usuario)

Territorio del framework — actualizable:

  • core/
  • .claude/skills/<skill>/ (excepto */user/)
  • CLAUDE.md
  • scripts/
  • blueprints/_template/ + blueprints que vengan del canónico
  • Documentos raíz: README.md, ROADMAP.md, PHILOSOPHY.md, CONTRIBUTING.md, ATTRIBUTION.md, SECURITY.md, CLAUDIA_OS_OVERVIEW.md, VPS.md, PORTABILIDAD.md

Invocación

  • /claudia-update — comprueba y aplica actualizaciones
  • /claudia-update --check — muestra qué cambiaría sin aplicar nada

Repositorio canónico

Remote:  upstream
URL:     https://github.com/sergi-rz/claudia-os.git
Branch:  main

Flujo

Paso 1 — Preparar remote upstream

  1. Comprueba si existe el remote upstream:
    git remote get-url upstream
  2. Si no existe, añádelo:
    git remote add upstream https://github.com/sergi-rz/claudia-os.git
  3. Fetch:
    git fetch upstream

Paso 2 — Detectar cambios en el framework

Ejecuta:

git diff --stat HEAD upstream/main -- core/ .claude/skills/ CLAUDE.md scripts/ blueprints/ README.md ROADMAP.md PHILOSOPHY.md CONTRIBUTING.md ATTRIBUTION.md SECURITY.md CLAUDIA_OS_OVERVIEW.md VPS.md PORTABILIDAD.md

Si no hay cambios: "Tu instalación ya está al día con el framework." Para.

Paso 3 — Detectar cambios locales no commiteados en el framework

Ejecuta:

git status --porcelain -- core/ CLAUDE.md scripts/

Si hay ficheros del framework con cambios locales sin commitear, avisa antes de continuar:

⚠ Tienes cambios locales en ficheros del framework que serían sobreescritos:
  <lista de ficheros>

Estos cambios no están en el repo canónico. Se perderán con el update.
¿Deseas continuar de todos modos, o prefieres commitear o stashear primero?

Espera OK explícito. Sin OK, para.

Paso 4 — Mostrar resumen de cambios

Muestra un resumen legible organizado por categoría. Para skills, distingue entre actualizada y NUEVA. Ejemplo de formato:

Actualizaciones disponibles desde sergi-rz/claudia-os:

Framework:
  core/memory.md          modificado
  core/behavior.md        modificado

Skills:
  .claude/skills/claudia-wisdom/SKILL.md    actualizada
  .claude/skills/claudia-nueva/             NUEVA

Documentos raíz:
  README.md               modificado
  ROADMAP.md              modificado

Tu carpeta user/ no se toca. Tus personalizaciones en */user/ tampoco.

Si el usuario invocó con --check: para aquí. No apliques nada.

Paso 5 — Confirmar

Pregunta:

"¿Aplico estas actualizaciones? Los cambios quedarán sin commitear para que puedas revisarlos antes."

Espera OK explícito. Sin OK, para.

Paso 6 — Aplicar actualizaciones

Aplica en este orden:

6a. Core, CLAUDE.md, scripts y documentos raíz:

git checkout upstream/main -- core/ CLAUDE.md scripts/ README.md ROADMAP.md PHILOSOPHY.md CONTRIBUTING.md ATTRIBUTION.md SECURITY.md CLAUDIA_OS_OVERVIEW.md VPS.md PORTABILIDAD.md

6b. Skills — con exclusión explícita de */user/:

git checkout upstream/main -- .claude/skills/ ":(exclude).claude/skills/*/user/"

Si el shell reporta que la sintaxis :(exclude) no es soportada, haz el checkout skill a skill:

git checkout upstream/main -- .claude/skills/<skill>/

Y para cada skill que tuviera un subdirectorio user/ local: restáuralo inmediatamente con:

git checkout HEAD -- .claude/skills/<skill>/user/

6c. Blueprints — solo los del canónico, sin eliminar los del usuario:

Obtén la lista de blueprints en upstream:

git ls-tree --name-only upstream/main blueprints/

Para cada blueprint de upstream (excepto README.md como fichero suelto):

git checkout upstream/main -- blueprints/<nombre>/

No elimines ni modifiques blueprints locales que no aparezcan en esa lista.

Paso 7 — Confirmar resultado

Ejecuta:

git diff --stat HEAD
git status --porcelain

Muestra al usuario:

  • Ficheros actualizados
  • Skills nuevas (si las hay)
  • Rollback disponible: git checkout HEAD -- .
  • "Revisa los cambios con git diff HEAD antes de commitear."

Reglas invariantes

  1. Nunca commitear. El usuario decide cuándo.
  2. user/ es sagrado. Ningún fichero bajo user/ puede ser tocado, creado ni eliminado.
  3. */user/ en skills es sagrado. Si git checkout lo sobreescribe, restáuralo de inmediato.
  4. Sin OK explícito en Paso 5, no hay Paso 6.
  5. Si upstream/main no existe, parar con mensaje claro. No mostrar errores git crudos.
  6. Blueprints locales no en upstream: no tocar. Son del usuario.
  7. No eliminar skills locales. Una skill que esté en local pero no en upstream podría ser del usuario.

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.