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
In this repository21 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- claudia-blueprintSkill
- claudia-calendarSkill
- claudia-corpus-syncSkill
- claudia-critiqueSkill
- claudia-finanzasSkill
- claudia-gmailSkill
- claudia-imageSkill
- claudia-intakeSkill
- claudia-onboardingSkill
- claudia-researchSkill
- claudia-scrapeSkill
- claudia-thinkingSkill
- claudia-wisdomSkill
- claudia-yt-analyticsSkill
- claudia-yt-transcriptSkill
- memory-searchSkill
- notesSkill
- telegram-botSkill
- vault-searchSkill
- weekly-reviewSkill
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
- Distinctive: line 151
No elimines ni modifiques blueprints locales que no aparezcan en esa lista.
- Very specific: line 173
Si
upstream/mainno existe, parar con mensaje claro: No mostrar errores git crudos.
≈ “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
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.mdscripts/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: mainFlujo
Paso 1 — Preparar remote upstream
- Comprueba si existe el remote
upstream:git remote get-url upstream - Si no existe, añádelo:
git remote add upstream https://github.com/sergi-rz/claudia-os.git - 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.mdSi 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.md6b. 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 --porcelainMuestra al usuario:
- Ficheros actualizados
- Skills nuevas (si las hay)
- Rollback disponible:
git checkout HEAD -- . - "Revisa los cambios con
git diff HEADantes de commitear."
Reglas invariantes
- Nunca commitear. El usuario decide cuándo.
user/es sagrado. Ningún fichero bajouser/puede ser tocado, creado ni eliminado.*/user/en skills es sagrado. Sigit checkoutlo sobreescribe, restáuralo de inmediato.- Sin OK explícito en Paso 5, no hay Paso 6.
- Si
upstream/mainno existe, parar con mensaje claro. No mostrar errores git crudos. - Blueprints locales no en upstream: no tocar. Son del usuario.
- No eliminar skills locales. Una skill que esté en local pero no en upstream podría ser del usuario.
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.

