ship-checklist
Acerca de
Esta habilidad proporciona una lista de verificación de definición de terminado para desarrolladores que implementan nuevas escrituras o consultas de datos en el grafo ax, asegurando que cada escritura tenga tanto una lectura bajo demanda como una ruta de lectura proactiva orientada a agentes. Se activa con palabras clave como "implementar", "nueva señal" o "conectar esto", y se utiliza antes de abrir un PR para nuevas tablas de SurrealDB, etapas de ingesta o consultas analíticas. El principio fundamental es que una característica no está completa hasta que un agente pueda descubrir y actuar sobre los nuevos datos de forma autónoma.
Instalación rápida
Claude Code
Recomendadonpx skills add Necmttn/ax -a claude-code/plugin add https://github.com/Necmttn/axgit clone https://github.com/Necmttn/ax.git ~/.claude/skills/ship-checklistCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
ship-checklist - every write needs a read path an agent can find
The recurring miss in ax: we ship the write + an on-demand CLI read, and skip the proactive / agent-facing read. A signal only visible on a manual CLI run is invisible to the self-improvement loop. ax's whole thesis is that agents discover and act on signals - so a new write is not done until an agent can find it without being told.
Organizing rule: every write needs (B) an on-demand read AND (C) a proactive read AND an agent-facing surface (MCP/skill). Most features do A+B and stop.
Run this before opening the PR. Skipping a row is fine - but say so in the PR and why, don't skip silently.
A. Write
- Schema in
schema.surql+ registered inSCHEMA_TABLES(CI mirror guard) - Ingest idempotent + incremental (since-aware) + deref-free denormalization for reads (no record derefs inside aggregates - they hang prod)
- Backfill: does history get the signal, or only new data? Note "dark until re-ingest" if so
- Stage
deps= every producer of the input table
B. Read - on-demand
- CLI: a command or a facet on an existing one (consistent family)
-
--jsonenvelope for scripting - Dashboard/studio surface (if visual)
C. Read - proactive (the usually-missed half)
- MCP tool so an agent can query it in-context (
apps/axctl/src/mcp/tools.ts) -
ax improve recommendgenerator - mint a proposal when the signal crosses a threshold (agent gets the suggestion unprompted) -
ax insights/ dashboard next-actions wiring (if it implies an action) - dojo agenda item (if the overnight loop should act on it)
- Skill: a cognitive pattern teaching an agent to act on the signal (e.g. the
lnskill routes visual judgment to subagents offax cost images)
D. Documentation
-
CLAUDE.mdcommand/section docs (there is a docs gate for new subcommands) - llms.txt / site docs / README, if user-facing
- CHANGELOG + release notes (release-please)
- Spec in
docs/superpowers/specs/for non-trivial features
E. Onboarding / distribution
- Onboarding prompt (
@ax/onboarding-prompt) - should a day-1 user/agent know it exists? - Marketing coverage (site page / blog / X), if a user-facing capability
-
/api/versioncapability flag, if relevant
F. Verify (evidence, not assertion)
- Tests: unit on pure helpers + schema-mirror guard + CLI command-list test
- Live-verified against the real DB - paste the actual output in the PR
- "Dark until data" honesty: state if it needs backfill/telemetry to light up
How to use
Create a TodoWrite item per relevant row, or paste the A-F headers into the PR body as a checked list. The point is the C section - if a new signal has no MCP tool, no improve generator, and no skill, an agent will never surface it on its own, and the feature is half-built no matter how clean the write is.
Repositorio GitHub
Preguntas frecuentes
¿Qué es el Skill ship-checklist?
ship-checklist es un Skill de Claude creado por Necmttn. Los Skills agrupan instrucciones y recursos que Claude carga cuando los necesita para realizar tareas relacionadas con ship-checklist sin indicaciones adicionales.
¿Cómo instalo ship-checklist?
Usa los comandos de instalación de esta página: añade ship-checklist a Claude Code como plugin o clona su repositorio en tu directorio de skills y reinicia Claude para cargarlo.
¿A qué categoría pertenece ship-checklist?
ship-checklist pertenece a la categoría Documentación.
¿Se puede usar ship-checklist gratis?
Sí. ship-checklist aparece en AIMCP y se puede instalar gratis.
Habilidades relacionadas
Esta habilidad obtiene la documentación actual de Railway para responder preguntas sobre características, funcionalidad o URLs específicas de documentación. Garantiza que los desarrolladores reciban información precisa y actualizada directamente de las fuentes oficiales de Railway. Úsala cuando los usuarios pregunten cómo funciona Railway o hagan referencia a la documentación de Railway.
Esta Skill de Claude proporciona orientación experta para escribir código Python en los nodos Code de n8n, específicamente para usar la biblioteca estándar de Python y trabajar con la sintaxis especial de n8n como `_input`, `_json` y `_node`. Ayuda a los desarrolladores a comprender las limitaciones de Python dentro de n8n y recomienda usar JavaScript para la mayoría de los flujos de trabajo, mientras ofrece soluciones en Python para necesidades específicas de transformación de datos.
La habilidad Archon proporciona búsqueda semántica con tecnología RAG y gestión de proyectos a través de una API REST. Úsala para consultar documentación, gestionar proyectos/tareas jerárquicos y realizar recuperación de conocimiento con capacidades de carga de documentos. Prioriza siempre a Archon en primer lugar al buscar en documentación externa antes de utilizar otras fuentes.
Esta habilidad de Claude proporciona orientación experta para escribir código JavaScript en los nodos de Código de n8n. Cubre sintaxis esencial específica de n8n como las variables `$input`/`$json`, ayudantes HTTP y manejo de DateTime, mientras soluciona errores comunes. Úsela al desarrollar flujos de trabajo en n8n que requieran procesamiento personalizado de JavaScript en los nodos de Código.