por Juanjo LunaEscribir una especificación técnica
Te ayuda a convertir una propuesta aceptada en una especificación de implementación. Sirve para definir alcance, objetivos, plan de migración, pruebas y tareas pendientes.
Descripción original (inglés)
write-a-spec: Scope a feature end to end and write an implementation spec under specs/ from an accepted proposal — current-system mapping, goals/non-goals, a Decision Log for one-way-door choices, a live Open Questions backlog, and a real migration + test plan. Read when asked to write a spec, scope this feature, turn this proposal into a spec, plan the implementation, or break this into tasks. Do NOT fire on frame a proposal or write the PRD (sibling frame-a-proposal — a PRD frames a change before it is accepted; this skill starts once one is), record a decision or write the ADR (record-a-decision), write a postmortem (write-a-postmortem), or review this design (review-a-design) — those are separate skills. Complements the platform open-knowledge skill; does not replace it.
Cómo instalarla
Una skill es una carpeta con un fichero SKILL.md. Para instalarla basta con copiar la carpeta write-a-spec en el sitio donde tu agente busca sus skills.
- Sin terminal: abre la carpeta en GitHub, descárgala y cópiala en la carpeta de tu agente (tabla de abajo).
- Con terminal (macOS, Linux o Git Bash en Windows): elige tu agente y copia los comandos.
git clone --depth 1 https://github.com/inkeep/open-knowledge.git /tmp/skill-src
mkdir -p ~/.claude/skills
cp -r "/tmp/skill-src/packages/server/assets/skills/packs/software-lifecycle/write-a-spec" ~/.claude/skills/write-a-spec
rm -rf /tmp/skill-src| Agente | Para todos tus proyectos | Solo un proyecto |
|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills |
| GitHub Copilot | ~/.copilot/skills | .github/skills |
| Codex | ~/.agents/skills | .agents/skills |
| Gemini CLI | ~/.gemini/skills | .gemini/skills |
Muchos agentes leen también .agents/skills. Reinicia el agente después de instalar. Antes de instalar una skill, revisa su SKILL.md y los scripts que incluya: se ejecutan con tus permisos.
Más skills de inkeep/open-knowledge
- Trabajar con Codebase Wiki codebase-wiki
- Consolidar notas de investigación consolidate-notes
- Redactar una propuesta técnica frame-a-proposal
- Trabajar con base de conocimiento knowledge-base
- Tomar notas y diario diario note-taking
- Guía de Open Knowledge Format okf-knowledge-base
- Usar OpenKnowledge open-knowledge
- Descubrir OpenKnowledge open-knowledge-discovery
Explicación redactada con ayuda de IA a partir de la descripción original.