📄 Prompt Architect — README

Fuente: README del paquete npm @ckelsoe/prompt-architect
Licencia: MIT
Compatibilidad: Agent Skills (Claude Code, ChatGPT, Gemini CLI, Cursor, Copilot, Windsurf, Codex)

Resumen

Prompt Architect es una skill de ingeniería de prompts que transforma prompts vagos en prompts estructurados de nivel experto usando 31 frameworks organizados en 7 categorías de intención. Evalúa cada prompt en 5 dimensiones de calidad, recomienda el framework adecuado, hace preguntas de clarificación progresivas y refina iterativamente.

Takeaways clave

  1. 31 frameworks en 7 categorías de intención — desde CO-STAR (contenido) hasta ReAct (agente), Chain of Thought (razonamiento) y Pre-Mortem (análisis de riesgo).
  2. Sistema de scoring en 5 dimensiones — Clarity, Specificity, Context, Completeness, Structure (cada una 1-10). Ejemplo: “Write about machine learning” puntúa 1.6/10; transformado con CO-STAR llega a 8.8/10.
  3. Progressive disclosure — hace 3-5 preguntas a la vez, nunca abruma, adapta según el framework elegido.
  4. Iteración continua — muestra antes/después con explicaciones, permite cambiar de framework, refina hasta satisfacer.
  5. Técnica componible: few-shot / in-context examples se puede superponer a cualquier framework (no es uno de los 31).
  6. Árbol de decisión para elegir framework según la tarea (transformar contenido → BAB, tarea agéntica → ReAct, decisión → Tree of Thought, etc.).

Datos relevantes

  • Instalación: npx @ckelsoe/prompt-architect (interactivo, detecta agentes instalados)
  • Estructura: SKILL.md + 30 reference docs (uno por framework) + 30 templates + hybrid_template.txt
  • Los frameworks tienen respaldo académico: CoT, Self-Refine (NeurIPS 2023), Step-Back (Google DeepMind), Least-to-Most (Google Brain), Plan-and-Solve (ACL 2023), RPEF (EMNLP 2025), etc.
  • Optimizado para Claude, pero los frameworks son universales (funcionan con cualquier LLM)

Limitaciones

  • Los frameworks son universales, pero la skill está optimizada para Claude Code
  • Sin Claude Code se puede usar incluyendo SKILL.md en el system prompt de la API
  • Requiere que el skill folder esté en la ubicación correcta (~/.claude/skills/prompt-architect/)