Skip to content
Back to search

project-context

SkillWorks with Claude CodeGitHub

ES — Memoria de proyecto para Claude Code con registro automático de decisiones, en tres modos. init, para un proyecto nuevo o vacío. migrate, para un proyecto que ya va andando, con chats anteriores, su propio CLAUDE.md u otra estructura. handoff, para pasar un chat normal a un proyecto. Crea .claude-context/ y la regla de registro continuo en CLAUDE.md, de modo que cada decisión, corrección o preferencia se anote sola y cualquier chat nuevo continúe sin empezar de cero. Activar con /project-context, "inicializa el contexto", "deja el proyecto listo para otra sesión", "migra este proyecto", "este proyecto ya tiene varios chats", "rescata las decisiones de los chats anteriores", "pasa este chat a un proyecto", "prepara el handoff". EN — Persistent project memory for Claude Code with automatic decision logging. Three modes: init (new project), migrate (in-flight project with prior sessions or its own structure), handoff (move a regular chat into a project). Trigger on "init context", "set up project memory", "migrate this project", "prepare a handoff".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/byliz-ai--project-context/badge.svg)](/listings/byliz-ai--project-context)

HTML

<a href="/listings/byliz-ai--project-context"><img src="/api/listings/byliz-ai--project-context/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 52 lines
  1. ---
  2. name: project-context
  3. description: ES — Memoria de proyecto para Claude Code con registro automático de decisiones, en tres modos. init, para un proyecto nuevo o vacío. migrate, para un proyecto que ya va andando, con chats anteriores, su propio CLAUDE.md u otra estructura. handoff, para pasar un chat normal a un proyecto. Crea .claude-context/ y la regla de registro continuo en CLAUDE.md, de modo que cada decisión, corrección o preferencia se anote sola y cualquier chat nuevo continúe sin empezar de cero. Activar con /project-context, "inicializa el contexto", "deja el proyecto listo para otra sesión", "migra este proyecto", "este proyecto ya tiene varios chats", "rescata las decisiones de los chats anteriores", "pasa este chat a un proyecto", "prepara el handoff". EN — Persistent project memory for Claude Code with automatic decision logging. Three modes: init (new project), migrate (in-flight project with prior sessions or its own structure), handoff (move a regular chat into a project). Trigger on "init context", "set up project memory", "migrate this project", "prepare a handoff".
  4. ---
  5. # project-context
  6. Deja un proyecto preparado para que cualquier sesión futura de Claude Code continúe sin empezar desde cero, y para que las decisiones y cambios importantes queden anotados en el momento en que ocurren, sin que el usuario lo pida. Lo segundo es lo más importante: el usuario no va a acordarse de pedirlo y las sesiones se cortan sin aviso, así que lo que no se anota en el momento se pierde.
  7. Se corre una sola vez por proyecto. Después, cada chat nuevo se entera solo, por CLAUDE.md y por el hook de inicio de sesión.
  8. Las rutas de este documento son relativas a la carpeta de esta skill.
  9. ## Elegir el modo
  10. Si el usuario pasó un argumento (init, migrate o handoff), usa ese modo. Si no, decide así, en este orden, y dilo en una línea antes de empezar:
  11. 1. handoff: el usuario pide el prompt para sacar el contexto de un chat normal, o habla de un chat que está fuera de Claude Code. Lee references/handoff.md.
  12. 2. Ya inicializado: existe .claude-context/ en el proyecto. No reinicialices. Si hay chats anteriores o archivos HANDOFF sin procesar, sigue references/migrate.md en su forma incremental; si no, solo actualiza lo que haya cambiado.
  13. 3. migrate: el proyecto ya va andando. Señales: CLAUDE.md con contenido propio; archivos de notas, estado o decisiones con otra estructura; o chats anteriores además de este, según `bash scripts/list-sessions.sh "<raíz del proyecto>"`. Lee references/migrate.md.
  14. 4. init: nada de lo anterior. Lee references/init.md.
  15. Los modos init y migrate usan además references/structure.md, que define los seis archivos, el bloque exacto para CLAUDE.md y las reglas de escritura. Léelo antes de escribir.
  16. ## Reglas comunes a todos los modos
  17. - Si esta sesión no está en la carpeta del proyecto, pregunta la ruta antes de escribir nada.
  18. - No resumas de memoria. Revisa el estado real del proyecto y las fuentes. Si no hay información para una sección, escribe "Sin entradas todavía" en vez de inventarla.
  19. - Solo hechos verificables en el proyecto o acordados explícitamente. Las suposiciones van marcadas [to confirm].
  20. - Nunca copies credenciales, tokens ni API keys, aunque aparezcan en las fuentes.
  21. - No hagas commit hasta que el usuario valide el resultado.
  22. ## Hooks
  23. La skill trae dos hooks globales que refuerzan el registro. En proyectos sin .claude-context/ no hacen nada.
  24. - hooks/claude-context-session.sh, evento SessionStart: avisa a cada chat nuevo que el proyecto tiene memoria y dónde está.
  25. - hooks/claude-context-check.sh, evento Stop: si en el turno cambiaron archivos del proyecto y no se actualizó el registro, pide a Claude revisar y anotar lo que falte.
  26. Antes de terminar cualquier modo, comprueba que estén instalados:
  27. ```bash
  28. grep -c "claude-context-" ~/.claude/settings.json
  29. ```
  30. Si el resultado es 0, dile al usuario que los hooks no están instalados y pregúntale si los instalas. Solo con su sí, corre:
  31. ```bash
  32. bash hooks/install.sh
  33. ```
  34. El instalador modifica ~/.claude/settings.json, deja una copia de respaldo al lado y se puede revertir con `bash hooks/install.sh --uninstall`.
README.md · README · 301 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-reduced-motion: reduce)" srcset="assets/banner.png">
  4. <img src="assets/banner.gif" alt="project-context, skill para Claude Code. La configuras 1 vez y Claude recuerda tu proyecto. by liz" width="100%">
  5. </picture>
  6. </p>
  7. <p align="center">
  8. Una skill gratuita <b>by liz●●</b> · Encuéntrame en Instagram: <a href="https://www.instagram.com/bylizllanos/">@bylizllanos</a>
  9. </p>
  10. ---
  11. # project-context
  12. Una skill para Claude Code que hace que Claude no se olvide de tu proyecto.
  13. ## El problema
  14. Cada vez que abres un chat nuevo, Claude empieza en blanco. No sabe qué decidiste ayer, qué le corregiste ni dónde quedaron. Te toca explicarle todo otra vez, y a veces repite errores que ya habías arreglado.
  15. ## La solución
  16. Esta skill le pone al proyecto una libreta de notas. Mientras trabajas, Claude anota solo:
  17. - lo que decidieron y por qué,
  18. - lo que le corregiste,
  19. - cómo te gusta que haga las cosas,
  20. - lo que quedó pendiente y dónde quedaron.
  21. Cuando abres un chat nuevo, Claude lee esa libreta antes de empezar. Tú no tienes que pedirle que anote ni que lea nada.
  22. Se configura una sola vez por proyecto.
  23. ## Antes y después
  24. Sin la skill, en un chat nuevo:
  25. > Tú: Sigamos con el reporte.
  26. > Claude: ¡Claro! ¿De qué reporte hablamos? ¿Qué datos usamos?
  27. Con la skill, en un chat nuevo:
  28. > Tú: Sigamos con el reporte.
  29. > Claude: Quedamos en la sección de resultados. Faltan las gráficas por región. Recuerdo que decidiste usar los datos de 2024 y no los de 2023, porque los de 2023 estaban incompletos.
  30. ---
  31. ## Instalación (una sola vez)
  32. Necesitas la app de Claude (pestaña Code) o Claude Code en la terminal, en un Mac.
  33. La forma más fácil: abre un chat en Claude Code y escribe esto.
  34. ```text
  35. Instala la skill https://github.com/byliz-ai/project-context en ~/.claude/skills/project-context y corre su instalador de hooks.
  36. ```
  37. Si prefieres hacerlo tú, pega estos dos comandos en la terminal:
  38. ```bash
  39. git clone https://github.com/byliz-ai/project-context.git ~/.claude/skills/project-context
  40. ```
  41. ```bash
  42. bash ~/.claude/skills/project-context/hooks/install.sh
  43. ```
  44. Después cierra y vuelve a abrir los chats que tenías abiertos.
  45. ---
  46. ## ¿Qué escribo en el chat?
  47. | Tu situación | Escribe esto |
  48. | --- | --- |
  49. | Voy a empezar un proyecto nuevo | `/project-context` |
  50. | Ya tengo un proyecto con varios chats | `/project-context` |
  51. | Tengo un chat normal en claude.ai y quiero seguirlo en un proyecto | `/project-context handoff` |
  52. | Ya lo configuré antes | Nada. Solo trabaja. |
  53. No te preocupes por elegir mal: si escribes solo `/project-context`, Claude revisa la carpeta y decide cuál de los casos aplica. Antes de empezar te dice cuál eligió.
  54. Abajo hay un ejemplo de cada caso.
  55. ---
  56. ### Caso 1. Proyecto nuevo
  57. Tienes una carpeta nueva o casi vacía y quieres que Claude lleve la memoria desde el primer día.
  58. 1. Abre la carpeta del proyecto en Claude Code.
  59. 2. Escribe:
  60. ```text
  61. /project-context
  62. ```
  63. También funciona en tus palabras:
  64. ```text
  65. Deja este proyecto listo para que otros chats sigan sin empezar de cero.
  66. ```
  67. Qué pasa:
  68. - Claude crea una carpeta `.claude-context/` con la libreta del proyecto.
  69. - Agrega unas instrucciones a tu archivo `CLAUDE.md` (si no existe, lo crea).
  70. - Te muestra dónde quedaron y te pide revisar cualquier cosa que no pudo confirmar.
  71. Desde ese momento ya anota solo.
  72. ---
  73. ### Caso 2. Proyecto que ya va andando
  74. Llevas días o semanas trabajando en el proyecto, con varios chats. Quizás ya tienes tus propias notas, un `CLAUDE.md` o archivos tipo "pendientes" o "decisiones".
  75. 1. Abre la carpeta del proyecto en Claude Code.
  76. 2. Escribe:
  77. ```text
  78. /project-context
  79. ```
  80. O en tus palabras:
  81. ```text
  82. Este proyecto ya tiene varios chats. Rescata las decisiones de los chats anteriores sin romper mi estructura.
  83. ```
  84. Qué pasa:
  85. 1. Claude revisa tus archivos y lee todos los chats anteriores del proyecto.
  86. 2. Saca de ellos lo importante: decisiones, correcciones, preferencias y pendientes, con fecha.
  87. 3. Te muestra un plan con ejemplos de lo que encontró. **Hasta aquí no ha cambiado nada.**
  88. 4. Te pregunta algo así:
  89. > ¿Cómo quieres organizar la memoria del proyecto?
  90. > 1. Juntar todo en una carpeta nueva (recomendado si tus notas viejas ya no las usas)
  91. > 2. Mantener tus archivos como están y agregar solo lo que falte
  92. 5. Cuando le dices que sí, escribe la libreta.
  93. Lo que siempre respeta:
  94. - No borra, no mueve y no renombra ninguno de tus archivos.
  95. - No reescribe lo que ya tenía tu `CLAUDE.md`. Solo le agrega.
  96. - Si lo vuelves a correr más adelante, solo revisa los chats nuevos.
  97. > Consejo: al terminar, abre un chat nuevo para seguir trabajando. Los chats que ya estaban abiertos no se enteran del cambio.
  98. ---
  99. ### Caso 3. Pasar un chat normal a un proyecto
  100. Tienes una conversación larga en claude.ai (el chat normal, fuera de Claude Code) y quieres continuarla en un proyecto con memoria.
  101. Paso 1. En Claude Code, escribe:
  102. ```text
  103. /project-context handoff
  104. ```
  105. Claude te da un texto para copiar.
  106. Paso 2. Pega ese texto en tu chat viejo de claude.ai. Claude te va a escribir un resumen completo de la conversación. Guárdalo como `HANDOFF.md` dentro de la carpeta del proyecto.
  107. > Si son varios chats, repite el paso con cada uno y guárdalos con nombres distintos: `HANDOFF_presupuesto.md`, `HANDOFF_diseño.md`.
  108. Paso 3. Abre esa carpeta en Claude Code y escribe:
  109. ```text
  110. /project-context
  111. ```
  112. Claude lee los `HANDOFF` y arma la libreta con ellos.
  113. **Variante:** si estás en un chat de Claude Code que empezaste sin carpeta y quieres convertirlo en proyecto, escribe:
  114. ```text
  115. Convierte este chat en un proyecto en la carpeta Documentos/Mi proyecto.
  116. ```
  117. ---
  118. ## Y después, ¿qué hago?
  119. Nada especial. Trabaja como siempre. Cuando Claude anote algo, te avisa con una línea, por ejemplo:
  120. > Anoté en decisions_log.md: usamos los datos de 2024 porque los de 2023 estaban incompletos.
  121. Si algo quedó mal, corrígelo en el momento.
  122. Cosas útiles que puedes escribir cuando quieras:
  123. | Para | Escribe |
  124. | --- | --- |
  125. | Retomar | `¿Dónde quedamos?` |
  126. | Recordar una decisión | `¿Por qué decidimos usar los datos de 2024?` |
  127. | Guardar algo a propósito | `Anota que los reportes siempre van en PDF.` |
  128. | Corregir una nota | `Lo que anotaste no es así: el cliente pidió Excel, no PDF.` |
  129. | Revisar antes de cerrar | `Voy a parar por hoy, deja todo al día.` |
  130. ---
  131. ## Qué queda en tu carpeta
  132. ```
  133. mi-proyecto/
  134. ├── CLAUDE.md ← instrucciones que Claude lee al abrir cada chat
  135. └── .claude-context/
  136. ├── 00_README_FIRST.md ← de qué se trata el proyecto
  137. ├── project_status.md ← qué está listo, qué falta y dónde quedamos
  138. ├── decisions_log.md ← cada decisión, con fecha y motivo
  139. ├── preferences.md ← cómo te gusta que se hagan las cosas
  140. ├── lessons_learned.md ← lo que no funcionó y lo que sí
  141. └── open_issues.md ← pendientes y dudas abiertas
  142. ```
  143. Son archivos de texto normales. Puedes abrirlos y editarlos tú.
  144. > En Mac, las carpetas que empiezan con punto están ocultas. Para verlas en el Finder, presiona Cmd + Shift + punto.
  145. ---
  146. ## Preguntas frecuentes
  147. **¿Tengo que correrlo en cada chat?**
  148. No. Una vez por proyecto. Los chats nuevos lo encuentran solos.
  149. **¿Me va a borrar o cambiar mis archivos?**
  150. No borra, no mueve y no renombra nada. En proyectos que ya van andando, te muestra el plan y espera tu aprobación antes de escribir.
  151. **¿Funciona en el chat normal de claude.ai?**
  152. No directamente, porque ese chat no tiene carpeta. Usa el Caso 3 para pasarlo a Claude Code.
  153. **¿Mis notas se suben a internet?**
  154. Se quedan en la carpeta del proyecto. Si esa carpeta está en Google Drive u OneDrive, se sincronizan como cualquier otro archivo. Si es un repositorio de git, tú decides si las subes. Claude nunca anota contraseñas ni claves.
  155. **¿Qué pasa en carpetas que no tienen la libreta?**
  156. Nada. La skill solo actúa donde la configuraste.
  157. **¿Cómo la quito?**
  158. Para quitar el aviso automático:
  159. ```bash
  160. bash ~/.claude/skills/project-context/hooks/install.sh --uninstall
  161. ```
  162. Para quitarla del todo, borra también la carpeta `~/.claude/skills/project-context`. Las libretas de tus proyectos se quedan donde están, por si las quieres conservar.
  163. ---
  164. ## Lo que conviene saber
  165. - Claude anota casi todo solo, pero no es perfecto. Si algo importante se le escapa, dile "anota que...".
  166. - Si tú o Google Drive cambian archivos mientras Claude trabaja, a veces revisa las notas sin que haga falta. No pasa nada: Claude dice "Registro al día" y sigue.
  167. - En carpetas muy grandes puede saltarse alguna revisión.
  168. - Para rescatar chats viejos, esos chats tienen que seguir guardados en tu computador. Claude Code borra los muy antiguos después de un tiempo.
  169. - Está probada en Mac.
  170. ---
  171. <details>
  172. <summary>Para curiosos: cómo funciona por dentro</summary>
  173. La skill tiene tres piezas:
  174. 1. **Las instrucciones en `CLAUDE.md`.** Claude Code lee ese archivo al abrir cada chat. Ahí dice cuándo anotar y en qué archivo.
  175. 2. **Dos hooks**, que son pequeños programas que Claude Code corre solo:
  176. - Al abrir un chat, le recuerda a Claude que el proyecto tiene libreta.
  177. - Al terminar cada respuesta, revisa si cambiaron archivos sin que se anotara nada, y si es así le pide a Claude revisar.
  178. 3. **Dos scripts** que leen los chats anteriores y los resumen, para el Caso 2.
  179. Requisitos técnicos: `git` y `jq`. Los Mac con macOS 15 o más nuevo ya traen `jq`; en versiones anteriores, instálalo con `brew install jq`.
  180. ```
  181. SKILL.md ← elige el caso y coordina
  182. references/
  183. structure.md ← los seis archivos y las instrucciones para CLAUDE.md
  184. init.md ← Caso 1
  185. migrate.md ← Caso 2
  186. handoff.md ← Caso 3, con el texto para copiar
  187. scripts/
  188. list-sessions.sh ← lista los chats anteriores de un proyecto
  189. dump-session.sh ← resume un chat en texto
  190. hooks/
  191. claude-context-session.sh
  192. claude-context-check.sh
  193. install.sh ← instala o quita los hooks
  194. ```
  195. </details>
  196. ---
  197. <p align="center">
  198. <b>by liz●●</b><br>
  199. Si te sirvió, cuéntame en Instagram: <a href="https://www.instagram.com/bylizllanos/">@bylizllanos</a>
  200. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.