🛠️ Prompt Architect
Prompt Architect es una skill de ingeniería de prompts (paquete npm @ckelsoe/prompt-architect, MIT) que transforma prompts vagos en prompts estructurados de nivel experto. Compatible con el estándar Agent Skills y con herramientas como Claude Code, ChatGPT, Gemini CLI, Cursor, GitHub Copilot, Windsurf y OpenAI Codex.
Cómo funciona
- Análisis inteligente — evalúa el prompt en 5 dimensiones de calidad (Clarity, Specificity, Context, Completeness, Structure), cada una 1-10.
- Recomendación de framework — sugiere el mejor framework para el caso de uso con razonamiento claro.
- Diálogo guiado — hace 3-5 preguntas de clarificación progresivas (progressive disclosure), nunca abruma.
- Aplicación sistemática — aplica el framework elegido para transformar el prompt.
- Refinamiento iterativo — muestra antes/después con explicaciones, permite cambiar de framework, refina hasta que el usuario está satisfecho.
Sistema de scoring
| Dimensión | Qué mide |
|---|---|
| Clarity | ¿El objetivo es claro e inequívoco? |
| Specificity | ¿Los requisitos son suficientemente detallados? |
| Context | ¿Se aporta información de fondo? |
| Completeness | ¿Están presentes todos los elementos necesarios? |
| Structure | ¿El prompt está bien organizado? |
Ejemplo real: “Write about machine learning” → 1.6/10. Transformado con CO-STAR → 8.8/10.
Instalación
npx @ckelsoe/prompt-architectEl instalador interactivo detecta los agentes instalados y permite elegir dónde instalar. npx da menú interactivo; npm install instala en todos los agentes detectados vía postinstall hook.
Uso
- Básico: “Help me improve this prompt: [tu prompt]”
- Framework específico: “Use the CO-STAR framework to improve: [prompt]”
- Iterar: “Review this prompt and suggest improvements: [prompt estructurado]”
- Cambiar framework: “Try using TIDD-EC instead for more explicit guidance”
Instalada en Hermes (Nura)
Instalada el 2026-10-09 en el VPS de Xabi en ~/.hermes/skills/prompt-architect/ (v3.5.1, 64 archivos: SKILL.md + 30 references de frameworks + 32 templates). Verificada contra la skill real, no solo el README.
Cómo la usaré contigo
Cuando me pidas mejorar, escribir o estructurar un prompt, cargaré su método automáticamente. El flujo es:
- Puntúo tu prompt 1-10 en las 5 dimensiones (Clarity, Specificity, Context, Completeness, Structure) y te muestro el antes/después.
- Detecto la intención — crear, transformar, razonar, criticar, recuperar, aclarar o agéntico — y elijo el framework adecuado con su razonamiento.
- Hago 3-5 preguntas de clarificación progresivas (nunca abrumo).
- Aplico el framework y entrego el prompt final limpio (sin cabeceras de framework, sin markdown sobrante) listo para copiar y pegar tal cual.
Ejemplos de uso conmigo:
- “Mejora este prompt: [tu prompt]”
- “¿Qué framework usaría para [tarea]?”
- “Estructura esta petición para que sea más efectiva”
- “Revisa este prompt y sugiere mejoras”
Los frameworks son universales: funcionan con mi modelo (DeepSeek v4 en este host) igual que con Claude Code, porque es metodología de prompting, no dependiente de un LLM concreto.
Sin Claude Code
Los frameworks son universales (funcionan con cualquier LLM). Sin Claude Code, se incluye el contenido de SKILL.md en el system prompt de la API. En el caso de Hermes, la skill se instala directamente en ~/.hermes/skills/ y se carga automáticamente cuando la petición matchea su descripción.
Relación con el patrón LLM Wiki
Prompt Architect es un complemento de ingeniería de prompts: mientras el LLM Wiki estructura el conocimiento, Prompt Architect estructura los prompts que generan ese conocimiento. Ambos comparten la filosofía de “schema-driven” (ver schema-driven-llm).