Prompt library: cómo crear la tuya

Por qué necesitas una prompt library

Una prompt library es tu colección personal de prompts probados, organizados por caso de uso. En vez de reinventar cada prompt desde cero, reutilizas lo que ya funciona. Es como tener una biblioteca de funciones, pero para instrucciones de IA.

Sin library, cada vez que necesitas un prompt para clasificar emails o resumir reuniones, empiezas de cero. Con library, copias, pegas, adaptas y listo. Ahorro: 5-10 minutos por prompt x 20 prompts/semana = 2-3 horas/semana.

Pero el ahorro de tiempo es solo el beneficio más obvio. Una prompt library bien mantenida ofrece tres ventajas adicionales que la mayoría ignora:

• Consistencia de calidad: cuando todo el equipo usa los mismos prompts validados, la calidad del output es predecible. No depende de que cada persona sepa "hablar con la IA".
• Aprendizaje acumulativo: cada mejora en un prompt (v1.0 a v2.1) se documenta. El equipo aprende de los errores anteriores sin repetirlos.
• Onboarding acelerado: un nuevo miembro del equipo puede empezar a ser productivo con IA desde el primer día, usando prompts que ya funcionan.

Tipos de prompt libraries

No todas las prompt libraries son iguales. Dependiendo del contexto, hay tres tipos principales:

1. Library personal. La que cada profesional construye para su trabajo diario. Suele tener entre 10 y 50 prompts organizados por tareas recurrentes. Es informal, iterativa y muy práctica. El formato puede ser tan simple como un documento de Google Docs o una carpeta de archivos de texto.

2. Library de equipo. Compartida entre miembros de un departamento (marketing, desarrollo, soporte). Requiere convenciones de naming, versionado y un proceso de revisión. Funciona mejor en herramientas colaborativas como Notion o un repositorio Git. Suele tener entre 50 y 200 prompts.

3. Library de empresa. Centralizada, con gobernanza, roles de administrador y métricas de uso. Empresas como Deloitte, McKinsey y las Big 4 ya tienen equipos dedicados a mantener estas libraries. Requiere una herramienta dedicada (PromptLayer, Langfuse, o una solución interna) y un proceso formal de aprobación para nuevos prompts.

Estructura de cada prompt

Cada prompt en tu library debe tener estos campos:

# Nombre: Clasificar emails por prioridad
# Versión: v2.1
# Categoría: Email
# Modelo recomendado: Claude Haiku 4.5 (rápido, barato)
# Componentes usados: Rol, Tarea, Formato, Restricciones, Ejemplos
# Autor: Ricardo G.
# Última modificación: 2026-05-10
# Accuracy estimada: 95%

## Prompt
Eres un asistente de email profesional.
Clasifica cada email en: urgente, normal, spam.

Ejemplos:
- "Servidor caído" → urgente
- "Newsletter mayo" → normal
- "iPhone gratis!!!" → spam

Formato: una línea por email (email | clasificación)
No inventes clasificaciones fuera de las 3 definidas.

## Notas
- v1.0: sin few-shot, accuracy 85%
- v2.0: añadido 3 ejemplos, accuracy 95%
- v2.1: añadida restricción "no inventes", eliminó edge cases

## Input de ejemplo
"Factura vencida urgente" | "Nuevo episodio podcast" | "Gana 1000€ ya"

## Output esperado
Factura vencida urgente | urgente
Nuevo episodio podcast | normal
Gana 1000€ ya | spam

Los campos avanzados (autor, accuracy, input/output de ejemplo) no son obligatorios al principio, pero se vuelven necesarios cuando la library crece. Si un prompt no tiene un ejemplo de input/output, es mucho más difícil entender qué hace sin leer todo el prompt.

Categorías recomendadas

Estas 6 categorías cubren el 90% de los casos de uso profesionales. Dentro de cada categoría, puedes crear subcategorías si la library crece. Por ejemplo, dentro de "Comunicación" podrías tener: emails de ventas, emails de soporte, mensajes internos, propuestas comerciales.

Consejos para elegir categorías:

• Máximo 8 categorías principales. Si tienes más, agrupa. El objetivo es encontrar cualquier prompt en menos de 10 segundos.
• Usa nombres que tu equipo entienda. "Comunicación" es mejor que "NLP-Output-Generation". La library es para humanos, no para máquinas.
• Permite prompts en múltiples categorías si usas una herramienta con tags (Notion, Obsidian). Un prompt de "resumir reunión de ventas" podría estar en Análisis y en Gestión.

Plantillas por caso de uso

Estos son los 5 tipos de prompts que más se repiten en entornos profesionales, con una plantilla base para cada uno.

1. Clasificación. Ordenar items en categorías predefinidas. Emails, tickets de soporte, leads de ventas, documentos legales.

# Plantilla: Clasificación
Clasifica cada [ITEM] en una de estas categorías: [CAT1], [CAT2], [CAT3].

Reglas:
- Si no encaja en ninguna, clasifica como "otros"
- Una sola categoría por item

Ejemplos:
- "[ejemplo1]" → [CAT1]
- "[ejemplo2]" → [CAT2]

Formato de salida: [ITEM] | [CATEGORÍA]

2. Extracción de datos. Sacar información estructurada de texto no estructurado. Contratos, CVs, informes, logs.

# Plantilla: Extracción
Del siguiente [TIPO_DOCUMENTO], extrae:
- Campo 1: [descripción]
- Campo 2: [descripción]
- Campo 3: [descripción]

Si un campo no aparece, indica "No encontrado".
Formato: JSON con los campos anteriores.

3. Generación de contenido. Crear texto para un canal y audiencia específicos. Posts de LinkedIn, emails de seguimiento, descripciones de producto.

# Plantilla: Generación
Escribe un [FORMATO] sobre [TEMA] para [AUDIENCIA].
Tono: [profesional/casual/técnico]
Longitud: [X palabras/párrafos]
Incluye: [CTA / dato / ejemplo]
Evita: [lo que NO debe tener]

4. Análisis y resumen. Condensar documentos largos en información accionable. Reuniones, papers, informes financieros.

# Plantilla: Análisis
Resume el siguiente [DOCUMENTO] en:
1. 3 puntos clave (1 frase cada uno)
2. Decisiones pendientes (si las hay)
3. Siguiente acción recomendada

Contexto: soy [ROL] y necesito [OBJETIVO].

5. Revisión y feedback. Evaluar trabajo existente con criterios definidos. Código, textos, propuestas, diseños.

# Plantilla: Revisión
Revisa el siguiente [ENTREGABLE] según estos criterios:
1. [Criterio 1]: [qué evaluar]
2. [Criterio 2]: [qué evaluar]
3. [Criterio 3]: [qué evaluar]

Para cada criterio: puntuación (1-5) + comentario concreto.
Al final: 1 mejora prioritaria.

Versionado y mejora continua

Cada prompt evoluciona. Usa versionado semántico simple:

• v1.0: primera versión funcional
• v1.1: ajuste menor (tono, longitud)
• v2.0: cambio estructural (añadir few-shot, cambiar formato)

Registra cada cambio en las notas: qué cambiaste, por qué, y qué mejoró. Esto te permite volver atrás si un cambio empeora el resultado.

Un sistema de versionado efectivo necesita tres cosas:

Changelog por prompt. Cada prompt tiene un historial de cambios. No basta con "v2.0": necesitas saber qué cambió y por qué. Ejemplo: "v2.0: añadidos 3 ejemplos few-shot porque accuracy en clasificación de emails de soporte era 78%, ahora 94%".

Métricas de calidad. Define cómo mides si un prompt funciona. Puede ser accuracy (% de respuestas correctas), satisfacción del usuario (1-5), o tiempo de revisión post-output. Sin métricas, el versionado es ciego.

Proceso de promoción. Un prompt nuevo empieza en estado "draft". Cuando funciona bien en 10+ usos, pasa a "validado". Cuando lleva 30 días sin cambios y con buenas métricas, pasa a "estable". Solo los prompts estables se comparten con el equipo.

# Estados de un prompt
draft     → Recién creado, en pruebas
validado  → Funciona bien en 10+ usos reales
estable   → 30 días sin cambios, métricas OK
obsoleto  → Reemplazado por versión mejor o ya no se usa

Herramientas para gestionar tu library

La herramienta importa menos que el proceso, pero hay opciones con ventajas claras según el tamaño del equipo.

Notion. Ideal para equipos de 2-20 personas. Puedes crear una base de datos con campos (nombre, versión, categoría, modelo, accuracy) y filtros por vista. Ventaja: visual, colaborativo, gratis para equipos pequeños. Desventaja: sin control de versiones nativo (hay que hacerlo manualmente).

Obsidian. Ideal para libraries personales o técnicas. Archivos markdown planos, versionables con Git, con backlinks entre prompts. Ventaja: rápido, offline, totalmente tuyo. Desventaja: curva de aprendizaje para equipos no técnicos.

GitHub / GitLab. Ideal para equipos de desarrollo. Cada prompt es un archivo .md en un directorio organizado. Pull requests para cambios, code review para calidad, CI/CD para validación automática. Ventaja: versionado real (Git), revisión formal, trazabilidad. Desventaja: no visual, requiere conocimiento de Git.

Herramientas dedicadas. PromptLayer, Langfuse, Helicone, PromptHub. Ofrecen versionado, métricas, A/B testing y gestión de equipos. Ventaja: todo en uno, métricas automáticas. Desventaja: coste mensual (20-100 USD), posible lock-in.

Google Docs / Sheets. El mínimo viable. Un documento compartido con prompts organizados por secciones. Funciona para empezar. Pierde utilidad por encima de 30 prompts porque la búsqueda y organización se degradan.

Compartir la library en equipo

Una prompt library de equipo no es simplemente "poner los prompts en un Drive compartido". Requiere proceso, roles y mantenimiento.

Define un owner por categoría. La persona de marketing es owner de "Contenido". El lead de desarrollo es owner de "Código". El owner revisa nuevos prompts, válida cambios y retira prompts obsoletos. Sin owner, la library se llena de prompts duplicados y desactualizados en semanas.

Establece convenciones de naming. Todos los prompts deben seguir el mismo formato de nombre. Por ejemplo: [categoría]-[acción]-[objeto]-v[X.Y]. Así, email-clasificar-prioridad-v2.1 es inmediatamente comprensible. Sin convenciones, cada persona nombra diferente y encontrar algo es imposible.

Haz revisiones mensuales. Una vez al mes, el equipo dedica 30 minutos a revisar los prompts más usados. Se identifican prompts que han dejado de funcionar bien (porque el modelo cambió, o porque el caso de uso evolucionó), se retiran los obsoletos y se promueven los draft a validado.

Mide el uso. Si tu herramienta lo permite, trackea qué prompts se usan más. Los prompts más usados son los que más impacto tienen si se mejoran. Los que nadie usa probablemente deberían retirarse.

Ejemplo completo

Así es como se ve una prompt library real con 5 prompts:

prompt-library/
├── comunicación/
│ ├── email-followup-v2.1.md
│ └── email-cold-outreach-v1.3.md
├── análisis/
│ ├── resumir-reunion-v3.0.md
│ └── clasificar-tickets-v2.0.md
└── contenido/
  └── post-linkedin-v1.2.md

Empieza con 5 prompts que uses cada semana. En un mes tendrás 15-20. En 3 meses, una biblioteca completa que te ahorra horas.

Un ejemplo más completo para un equipo de marketing de 5 personas:

prompt-library/
├── README.md                          # Convenciones, cómo contribuir
├── comunicación/
│ ├── email-followup-cliente-v2.1.md
│ ├── email-cold-outreach-b2b-v1.3.md
│ ├── email-onboarding-usuario-v1.0.md
│ └── mensaje-slack-reporte-v1.1.md
├── contenido/
│ ├── post-linkedin-empresa-v2.0.md
│ ├── post-linkedin-personal-v1.4.md
│ ├── articulo-blog-seo-v3.1.md
│ ├── script-video-corto-v1.2.md
│ └── newsletter-semanal-v2.0.md
├── análisis/
│ ├── resumir-reunion-ventas-v3.0.md
│ ├── analizar-competencia-v1.1.md
│ └── extraer-datos-informe-v2.0.md
├── código/
│ ├── review-pr-seguridad-v2.1.md
│ └── generar-tests-unitarios-v1.0.md
└── gestion/
  ├── okr-trimestral-v1.2.md
  └── informe-semanal-v1.0.md

En el Módulo 02 de IAcademy construimos tu primera prompt library con el framework de 7 componentes.

Preguntas frecuentes