ck

Visión general de ck skill

Qué hace ck

ck es una skill de memoria de proyecto para Claude Code que guarda contexto reutilizable fuera del chat actual. Está pensada para personas que trabajan en varios repositorios y quieren continuidad entre sesiones sin reescribir siempre el mismo trasfondo. El trabajo principal que resuelve es sencillo: registrar un proyecto una sola vez y luego guardar, reanudar, inspeccionar, listar y olvidar contexto mediante comandos deterministas de Node.js.

Quién debería instalar ck skill

La mejor opción para ck skill son los desarrolladores que usan Claude Code para trabajo continuo en repositorios, especialmente cuando los objetivos, las restricciones y las decisiones del proyecto deben sobrevivir entre sesiones. También encaja muy bien con ck for Context Engineering porque separa la memoria durable del proyecto del historial ad hoc de prompts. Si haces sobre todo prompts puntuales o no usas el sistema local de skills de Claude Code, ck es menos útil.

Por qué ck es diferente de un prompt normal

Un prompt normal puede resumir un repositorio una vez. ck añade estructura persistente: un registro de proyectos en ~/.claude/ck/projects.json, una fuente de verdad context.json por proyecto, un CONTEXT.md generado y un hook de inicio de sesión que puede cargar automáticamente el contexto del proyecto. La diferencia práctica es la consistencia: los comandos llaman a scripts locales, así que el flujo depende menos del modelo que pedirle al asistente que “recuerde esto” de forma informal.

Cómo usar ck skill

Contexto de instalación y archivos que conviene leer primero

Para ck install, usa el mecanismo de skills de Claude Code y después revisa primero skills/ck/SKILL.md. Luego lee:

• commands/init.mjs
• commands/save.mjs
• commands/resume.mjs
• commands/info.mjs
• hooks/session-start.mjs

Ese orden importa. init.mjs muestra qué metadatos intenta inferir ck desde el repositorio actual, save.mjs define los esquemas JSON exactos y resume.mjs / info.mjs muestran lo que realmente recibirás en el uso diario.

Cómo se invoca ck en la práctica

El modelo de ck usage se basa en comandos. Los comandos principales son:

• /ck:init para registrar el proyecto actual
• /ck:save para guardar el estado de la sesión
• /ck:resume para cargar un briefing completo
• /ck:info para una vista rápida
• /ck:list para ver todos los proyectos registrados
• /ck:forget para eliminar un proyecto
• /ck:migrate para convertir datos antiguos de v1

Un detalle clave de implementación: ck espera que el asistente ejecute scripts de Node en ~/.claude/skills/ck/commands/ y presente el stdout de forma limpia. En el caso de init, no debe guardar de inmediato; primero redacta los detalles detectados del proyecto y espera la confirmación del usuario antes de enviar el JSON confirmado a save.mjs --init.

Qué entradas dan mejores resultados

ck funciona mejor cuando aportas los datos del proyecto que la detección automática no puede inferir bien. Buenas entradas para /ck:init incluyen:

• nombre claro del proyecto
• descripción en una sola frase
• stack principal
• objetivo actual
• restricciones explícitas o “no hacer”
• URL del repositorio, si está disponible

Para /ck:save, una mejor entrada de sesión se parece a esto:

• summary: qué cambió en esta sesión
• leftOff: el punto exacto donde se quedó
• nextSteps: de 2 a 5 seguimientos concretos
• decisions: qué se decidió y por qué
• blockers: asuntos sin resolver

Entrada débil: “trabajé en auth.”
Entrada fuerte: “Implementé la rotación de refresh tokens, me quedé en tests de integración fallando en apps/api/tests/auth.spec.ts, el siguiente paso es corregir el manejo del dominio de cookies, la decisión fue mantener por ahora la revocación del lado del servidor porque los clientes móviles aún no están listos.”

Flujo de trabajo recomendado para proyectos reales

Un ck guide práctico es:

1. En la raíz del repo, ejecuta /ck:init.
2. Revisa y corrige el borrador detectado antes de confirmar.
3. Al terminar trabajo relevante, ejecuta /ck:save.
4. En la siguiente sesión, usa /ck:resume para tener contexto completo o /ck:info para una comprobación rápida.
5. Usa /ck:list cuando alternes entre proyectos.

Si adoptas ck for Context Engineering, trátalo como tu capa durable de briefing del proyecto. Mantén la lluvia de ideas de corta vida en el chat, pero mueve los datos estables, las decisiones y los siguientes pasos a ck para que las futuras sesiones partan de un estado más limpio.

Preguntas frecuentes sobre ck skill

¿ck es apto para principiantes?

En general sí, si ya te sientes cómodo con Claude Code y la ejecución de comandos locales. El concepto es sencillo, pero la skill es más operativa que conversacional. A quienes empiezan puede costarles un poco entender bien el paso de confirmación, el traspaso en JSON y dónde se almacenan los datos; conviene leer SKILL.md con atención.

¿Cuándo es mejor ck que un prompt normal?

ck es mejor cuando el mismo proyecto reaparece durante días o semanas. No es solo una plantilla de prompt más inteligente; mantiene memoria estructurada del proyecto en disco y puede recargarla de forma consistente. Si tu trabajo es temporal o se resuelve en una sola sesión, un prompt normal suele ser suficiente y más rápido.

¿Cuáles son las principales limitaciones o riesgos?

La mayor limitación es que ck solo es tan bueno como lo que se guarda. Si los usuarios omiten /ck:save, la capa de memoria se queda desactualizada. Otra restricción es el encaje: está diseñado alrededor de las skills locales y las convenciones de sistema de archivos de Claude Code, como ~/.claude/ck/. No es un servicio de memoria en la nube de propósito general. Además, CONTEXT.md se genera automáticamente, así que editarlo a mano es el lugar incorrecto para mantener la verdad.

Cómo mejorar ck skill

Dale a ck mejores datos de registro del proyecto

La mejora con más impacto para ck es elevar la calidad de la inicialización. La detección automática desde package.json, el contenido del README o los metadatos de git ayuda, pero a menudo se queda corta. Corrige el borrador con firmeza en el momento de /ck:init. Un objetivo preciso y restricciones explícitas hacen que las salidas posteriores de /ck:resume sean mucho más útiles que las etiquetas genéricas del stack por sí solas.

Evita los fallos más comunes

Los problemas típicos de ck son bastante predecibles:

• registrar desde el directorio equivocado
• guardar resúmenes vagos
• olvidar actualizar los siguientes pasos
• asumir que el markdown generado es la fuente de verdad
• borrar contexto sin confirmar antes la identidad del proyecto

Si las salidas se sienten flojas, revisa si el context.json subyacente contiene realmente suficiente detalle. La mayoría de los problemas de calidad vienen de un estado guardado demasiado escaso, no de los scripts de comandos en sí.

Itera después de la primera salida

Para mejorar ck usage, no trates el primer contexto guardado como definitivo. Después de /ck:resume, pregúntate: ¿qué me faltaría mañana si no tuviera nada más del historial del chat? Luego vuelve a guardar con decisiones más nítidas, bloqueos más claros y puntos de parada más precisos. Las mejores configuraciones de ck skill evolucionan hacia briefings compactos y de alto valor, no hacia entradas largas de diario.