claudia-blueprint
Skill39 starsChanged 7 months agoMITView on GitHub
Aplica un blueprint de Claudia OS a la instancia del usuario, siguiendo los 7 pasos del formato. Busca el blueprint primero en la carpeta local blueprints/, y si no existe lo descarga del repo canónico sergi-rz/claudia-os. Uso: /claudia-blueprint <nombre>.
In this repository21 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- claudia-calendarSkill
- claudia-corpus-syncSkill
- claudia-critiqueSkill
- claudia-finanzasSkill
- claudia-gmailSkill
- claudia-imageSkill
- claudia-intakeSkill
- claudia-onboardingSkill
- claudia-researchSkill
- claudia-scrapeSkill
- claudia-thinkingSkill
- claudia-updateSkill
- 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
- Very specific: line 114
No hay merge/rebase en curso (.git/MERGE_HEAD, .git/REBASE_HEAD no existen).
- Distinctive: line 161
Fallo en cualquier paso = parar: No intentes auto-reparar.
≈ “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-blueprint
Qué hace
Orquesta la aplicación de un blueprint (recipe declarativo de 7 pasos) contra la instancia local del usuario. La lógica de qué instalar vive en cada blueprint.md; esta skill sólo encadena los pasos, gestiona la descarga del repo canónico cuando el blueprint no está en local, y refuerza las reglas del formato (OK gates, nunca commitear, revertir si quedan marcadores vivos).
Pensado para que el usuario pueda leer un tuit tipo "he publicado una nueva funcionalidad, instálala con /claudia-blueprint <nombre>" y aplicarla en un solo comando.
Invocación
/claudia-blueprint <nombre>— aplica el blueprint llamado<nombre>./claudia-blueprint(sin argumento) — lista los blueprints disponibles en local y para.
Repositorio canónico
URL: https://github.com/sergi-rz/claudia-os
Branch: main
Base raw: https://raw.githubusercontent.com/sergi-rz/claudia-os/main/blueprints/Nota: hasta que se publique la v1 del template, el repo está vacío. Si un blueprint no está en local y la descarga devuelve 404, la skill avisa: "El blueprint <nombre> no existe todavía en el repo canónico (la v1 aún no está publicada). Tráelo manualmente a blueprints/<nombre>/ antes de aplicarlo." y para.
Flujo
0. Resolver blueprint
- Si no hay argumento:
- Lista
blueprints/*/blueprint.mden el repo local (excluye_template/). - Muestra nombres +
descriptionde cada frontmatter. - Para. No sigas al Paso 1.
- Lista
- Si hay argumento
<nombre>:- Comprueba si existe
blueprints/<nombre>/blueprint.mden local. - Si sí existe: úsalo. Salta al Paso 1.
- Si no existe: intenta descargarlo del repo canónico (ver subsección siguiente).
- Comprueba si existe
0b. Descarga desde el repo canónico
Cuando el blueprint no está en local:
- Avisa: "El blueprint
<nombre>no está en local. Voy a descargarlo desergi-rz/claudia-os. ¿OK?" Espera confirmación. - Con OK, usa la herramienta de lectura de URLs disponible para descargar
https://raw.githubusercontent.com/sergi-rz/claudia-os/main/blueprints/<nombre>/blueprint.md.- Si 404: para y avisa: "No existe
<nombre>en el repo canónico (puede que aún no esté publicado — la v1 del template está pendiente). Blueprints disponibles en local: <lista del Paso 0.1>." - Si no es markdown válido: para y avisa.
- Si 404: para y avisa: "No existe
- Parsea el frontmatter para leer el manifest
assets:. - Por cada entrada
source:, descargahttps://raw.githubusercontent.com/sergi-rz/claudia-os/main/blueprints/<nombre>/<source>. Si alguna falla, para — no apliques un blueprint incompleto. - Escribe todo el árbol en local (
blueprints/<nombre>/blueprint.md+ assets). - Avisa: "Blueprint descargado a
blueprints/<nombre>/. Queda rastro en git para auditoría y re-aplicación."
A partir de aquí el blueprint vive en local como si el usuario lo hubiera escrito él mismo. El flujo continúa igual que si ya estuviera.
1. Paso 1 — Metadatos
Lee el frontmatter de blueprints/<nombre>/blueprint.md. Valida:
- Campos obligatorios presentes:
name,version,scope,toca,reversibilidad,riesgo. - Si
assets:existe, cada entrada tienesourceytarget. - Cada
sourcereferenciado existe como fichero enblueprints/<nombre>/.
Si falta algo, para y avisa con el campo concreto.
Muestra al usuario un resumen corto: nombre, versión, qué toca, riesgo declarado. Pregunta: "¿Procedemos con Discovery?" Espera OK.
2. Paso 2 — Discovery
Lee la sección ## Paso 2 — Discovery del blueprint.md. Ejecuta cada punto como lectura pasiva (Read, Glob, Grep — nada de escrituras). Para cada fuente descrita:
- Intenta localizar en la instancia del usuario la ruta/formato real.
- Registra: existe / no existe / formato detectado.
Construye un mapa {fuente: estado_real} que usarás en el Paso 3.
3. Paso 3 — Propuesta adaptada + confirmación
Genera un mensaje con las fuentes reales detectadas, no las genéricas del blueprint:
He revisado tu instancia. Propongo aplicar <nombre> v<version>:
Fuentes reales detectadas que la skill usará:
- <solo las que existen, con su formato real>
Fuentes del blueprint genérico que NO aplican aquí:
- <lista, o "ninguna">
Voy a crear:
- <target> de cada asset
- <directorios adicionales que el blueprint declare>
No voy a tocar nada existente.
¿OK, o ajustamos?Espera OK explícito. Si el usuario redirige, ajusta y vuelve a pedir OK. No pases al Paso 4 sin confirmación.
4. Paso 4 — Pre-flight
Lee la sección ## Paso 4 — Pre-flight del blueprint y ejecuta los checks declarados. Como mínimo:
git status --porcelain -- <rutas-del-blueprint>vacío. Si no: para y pide al usuario commitear o stashear esas rutas.- No hay merge/rebase en curso (
.git/MERGE_HEAD,.git/REBASE_HEADno existen). - Los
targetde los assets no existen todavía (si existieran, el blueprint los sobreescribiría — requiere confirmación extra del usuario).
Cambios sin commit en otras rutas del repo: avisar pero no bloquear.
5. Paso 5 — Cambios
Por cada entrada del manifest assets::
- Lee
blueprints/<nombre>/<source>. - Busca marcadores
<!-- ADAPTAR: ... -->(y variantes# ADAPTAR:,// ADAPTAR:). - Por cada marcador:
- Muestra al usuario contexto (5-10 líneas alrededor) y el valor propuesto basado en Discovery.
- Pide OK o valor alternativo.
- Sustituye todos los marcadores por los valores confirmados.
- Crea el directorio padre de
targetsi no existe. - Escribe el resultado en
target. Aplicamodeconchmodsi está declarado. - Verificación post-escritura: grep
ADAPTARsobretarget. Si devuelve alguna línea, revierte (borra el fichero escrito) y para con error — el blueprint tiene un bug.
Ejecuta también los pasos adicionales declarados en el blueprint.md (crear directorios vacíos con .gitkeep, mover ficheros, etc.).
6. Paso 6 — Post
Nunca commitees.
Ejecuta:
git statusgit diff --stat HEAD -- <rutas-del-blueprint>
Muestra al usuario:
- Qué ficheros se añadieron.
- Comando de rollback: el declarado en el frontmatter
reversibilidad. - Mensaje de commit sugerido:
feat: add <nombre> skill via blueprint v<version>(o lo que el blueprint declare explícitamente en Paso 6).
7. Paso 7 — Verificación
Lee la sección ## Paso 7 — Verificación del blueprint y ejecuta los checks declarados. Si el blueprint pide invocar una skill recién creada, hazlo. Reporta cada check como pasado o fallado.
Si algún check falla: para. No declares el blueprint aplicado. Sugiere al usuario revisar la salida y decidir si rollback o fix manual.
Si todos pasan: "Blueprint <nombre> v<version> aplicado y verificado. Recuerda commitear cuando revises el diff."
Reglas invariantes
- Nunca commitear. El usuario commitea cuando él quiere.
- OK gate en Paso 3 es obligatorio. Sin OK explícito, no hay Paso 4.
- Marcadores
ADAPTARvivos tras escritura = bug. Siempre revertir. - Fallo en cualquier paso = parar. No intentes auto-reparar.
- Blueprints sin frontmatter válido no se aplican. Valida antes de empezar.
- Descargas de GitHub se guardan siempre en local (
blueprints/<nombre>/), para que el usuario tenga rastro auditable y pueda re-aplicar offline.
Notas
- Esta skill es el único cliente oficial para aplicar blueprints. Ver
blueprints/README.mdpara la guía de autoría. - Si el usuario quiere aplicar un blueprint desde un fork o rama distinta, tendrá que clonarlo manualmente a
blueprints/<nombre>/antes de invocar/claudia-blueprint <nombre>. No se soporta override de URL por comando (principio de mínima superficie).
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.

