Idioma: Español
Probar gratis 14 días

Skill oficial · IA en la práctica

Brief de contexto para un asistente de IA

v1.0.0 · Actualizada el

Redacta las instrucciones de un asistente o agente de IA: rol, público, qué puede y qué no, fuentes de verdad, herramientas, formato, ejemplos, casos límite y paso a una persona.

Agregar al pod de mi equipo Descargar SKILL.md

Funciona en Claude, ChatGPT y agentes de programación. En Team y Business, la skill oficial de tu pod se actualiza sola cuando la mejoramos.

Cuándo usarla

Qué le das

Qué obtienes

Un conjunto breve de instrucciones ordenado por importancia, con ejemplos, casos límite y cuándo pasar el caso a una persona.

Cómo funciona

  1. Escribe el rol y el objetivo en 2 frases Para quién trabaja y qué logra una conversación que sale bien: “Ayudas a nuestro equipo de atención al cliente a responder preguntas de facturación de los clientes. Una buena respuesta es correcta, cita el apartado de la política y está lista para pegar.”
  2. Indica el público y el tono Quién lee la respuesta, qué sabe del tema y 2 o 3 reglas de tono con una frase de ejemplo. Omite reglas genéricas que la IA ya cumple (“sé útil”).
  3. Enumera lo que puede y lo que no puede hacer Puede: las tareas dentro del alcance. No puede: lo que queda fuera del alcance, lo que debe rechazar y las promesas que nunca debe hacer (reembolsos, asesoría legal, fechas de entrega). Cada “no puede” dice qué hacer en su lugar.
  4. Nombra las fuentes de verdad Qué documento o herramienta manda en cada tema, y qué hacer cuando las fuentes se contradicen o ninguna responde la pregunta (“Di que no lo sabes y sugiere [contacto]”). Señala las fuentes; no pegues documentos enteros en las instrucciones.
  5. Describe las herramientas, si las hay Una línea por herramienta: qué hace y cuándo usarla. Si dos herramientas se solapan tanto que una persona no sabría cuál usar, fusiona una con la otra o quita una.
  6. Fija el formato de salida Una plantilla o un ejemplo breve de la forma exacta: extensión, encabezados, qué incluir. Añade 2 o 3 ejemplos variados de entrada y salida ideal. Los ejemplos enseñan más que las reglas.
  7. Cubre los casos límite y la escalada Las 3 a 5 situaciones con más probabilidad de salir mal (usuario enojado, petición fuera de alcance, falta de información, petición de datos personales), cada una con el comportamiento esperado. Indica cuándo pasar el caso a una persona y cómo.
  8. Ordena por importancia y recorta Pon arriba las reglas que más importan, con encabezados sencillos. Borra cualquier línea que no puedas vincular a un fallo real o probable. Empieza con lo mínimo y añade una regla solo cuando las pruebas muestren que hace falta.

El SKILL.md

El archivo completo, tal como lo lee tu IA. Descargarlo

---
name: context-engineering-brief
description: Redacta un brief de contexto (system prompt o instrucciones) para un asistente o agente de IA - rol, objetivo, público, qué puede y qué no puede hacer, fuentes de verdad, herramientas, formato de salida, algunos ejemplos, casos límite y cuándo pasar el caso a una persona -, breve y ordenado por importancia. Úsala cuando alguien configura un GPT personalizado, un proyecto de Claude, una gem de Gemini, un agente de Copilot o un bot de soporte, o pide escribir un system prompt, mejorar las instrucciones de una IA o arreglar un asistente que sigue haciendo lo que no debe.
---

# Brief de contexto para un asistente de IA

Un asistente hace lo que su contexto vuelve más probable. La guía de Anthropic sobre ingeniería de contexto (context engineering) recomienda buscar “the smallest set of high-signal tokens that maximize the likelihood of your desired outcome” (el conjunto más pequeño de tokens con mucha señal que maximiza la probabilidad del resultado que buscas): lo bastante concreto para guiar, sin fijar una lógica frágil de “si pasa esto, haz aquello”. También aconseja unos pocos ejemplos variados y canónicos en lugar de una lista interminable de casos límite. Por eso el brief (criterio por defecto de esta skill) pone primero las instrucciones más importantes, usa algunos ejemplos concretos en vez de largas listas de reglas y dice dónde está la verdad en lugar de pegarla entera.

## Cuándo usarla

- Al configurar un GPT personalizado, un proyecto de Claude, una gem de Gemini, un agente de Copilot o un bot de soporte.
- Un asistente comete una y otra vez el mismo error y sus instrucciones ya son largas.
- Al entregar un asistente a un equipo, para que todos sepan para qué sirve y qué no hará.
- No sirve para preparar los documentos en los que busca (usa rag-source-prep) ni para probarlo (usa eval-set-builder).

## Qué necesitas

- Para qué es el asistente y quién lo va a usar.
- Lo que nunca debe hacer (políticas, datos, tono, promesas).
- Dónde están los datos: documentos, una base de conocimiento, una herramienta.
- De 2 a 3 ejemplos de buenas respuestas, si los hay. Si no, escríbelos en el paso 6 y márcalos “[borrador]”.
- Fallos conocidos, si es un asistente que ya existe. Son la información más valiosa.

## Pasos

1. **Escribe el rol y el objetivo en 2 frases.** Para quién trabaja y qué logra una conversación que sale bien: “Ayudas a nuestro equipo de atención al cliente a responder preguntas de facturación de los clientes. Una buena respuesta es correcta, cita el apartado de la política y está lista para pegar.”
2. **Indica el público y el tono.** Quién lee la respuesta, qué sabe del tema y 2 o 3 reglas de tono con una frase de ejemplo. Omite reglas genéricas que la IA ya cumple (“sé útil”).
3. **Enumera lo que puede y lo que no puede hacer.** Puede: las tareas dentro del alcance. No puede: lo que queda fuera del alcance, lo que debe rechazar y las promesas que nunca debe hacer (reembolsos, asesoría legal, fechas de entrega). Cada “no puede” dice qué hacer en su lugar.
4. **Nombra las fuentes de verdad.** Qué documento o herramienta manda en cada tema, y qué hacer cuando las fuentes se contradicen o ninguna responde la pregunta (“Di que no lo sabes y sugiere [contacto]”). Señala las fuentes; no pegues documentos enteros en las instrucciones.
5. **Describe las herramientas, si las hay.** Una línea por herramienta: qué hace y cuándo usarla. Si dos herramientas se solapan tanto que una persona no sabría cuál usar, fusiona una con la otra o quita una.
6. **Fija el formato de salida.** Una plantilla o un ejemplo breve de la forma exacta: extensión, encabezados, qué incluir. Añade 2 o 3 ejemplos variados de entrada y salida ideal. Los ejemplos enseñan más que las reglas.
7. **Cubre los casos límite y la escalada.** Las 3 a 5 situaciones con más probabilidad de salir mal (usuario enojado, petición fuera de alcance, falta de información, petición de datos personales), cada una con el comportamiento esperado. Indica cuándo pasar el caso a una persona y cómo.
8. **Ordena por importancia y recorta.** Pon arriba las reglas que más importan, con encabezados sencillos. Borra cualquier línea que no puedas vincular a un fallo real o probable. Empieza con lo mínimo y añade una regla solo cuando las pruebas muestren que hace falta.

## Formato de salida

```markdown
# [Nombre del asistente] — instrucciones

## Rol y objetivo
[2 frases]

## Público y tono
- Público: [quién, nivel de conocimiento]
- Tono: [regla] — p. ej., “[frase de ejemplo]”

## Puedes
- [Tarea dentro del alcance]

## No puedes (y qué hacer en su lugar)
- [Nunca hagas X] → [haz Y]

## Fuentes de verdad
| Tema | Fuente | Si falta o hay contradicción |
|---|---|---|

## Herramientas
- [herramienta]: [qué hace] — úsala cuando [condición]

## Formato de salida
[Plantilla o descripción]

## Ejemplos
**Usuario:** [entrada]
**Tú:** [salida ideal]

## Casos límite
- [Situación] → [comportamiento]

## Pasa el caso a una persona cuando
- [Condición] → [cómo: quién, canal]
```

## Ejemplo

**Entrada:** “GPT personalizado para el equipo comercial de Rutaplan (SaaS de planificación de servicios técnicos de campo). Debe redactar respuestas a preguntas de clientes potenciales sobre funciones y precios. Los precios están en el documento «Precios 2025» y las funciones en «FAQ de producto». No para de prometer integraciones a medida y de ofrecer descuentos. Los descuentos necesitan la aprobación de la jefa de ventas (Inés).”

**Salida:**

```markdown
# Asistente de respuestas comerciales de Rutaplan — instrucciones

## Rol y objetivo
Redactas respuestas para los vendedores de Rutaplan a las preguntas de clientes potenciales sobre funciones y precios. Un buen borrador se ajusta a los documentos Precios 2025 y FAQ de producto, está listo para que el comercial lo pegue y nunca compromete a la empresa a nada que esos documentos no digan.

## Público y tono
- Público: responsables de operaciones de empresas de servicios técnicos; no son técnicos.
- Tono: claro y directo, menos de 150 palabras — p. ej., “Sí, los equipos ven su agenda sin conexión.”

## Puedes
- Responder preguntas de funciones y precios con los dos documentos.
- Sugerir un siguiente paso (demo, prueba).

## No puedes (y qué hacer en su lugar)
- Ofrecer o insinuar descuentos → escribe “[Comercial: los descuentos necesitan la aprobación de Inés]” en el borrador.
- Prometer integraciones a medida o funciones de la hoja de ruta → di lo que existe hoy y ofrece trasladar la petición.
- Responder preguntas de seguridad o legales → escribe “[Comercial: derivar al proceso del cuestionario de seguridad]”.

## Fuentes de verdad
| Tema | Fuente | Si falta o hay contradicción |
|---|---|---|
| Precios, planes | Precios 2025 | Di “déjame confirmarlo” y avisa al comercial |
| Funciones | FAQ de producto | No adivines; avisa al comercial |

## Formato de salida
Una respuesta de 150 palabras o menos y, después, una línea “Notas para el comercial:” con lo que haya que revisar.

## Ejemplos
**Usuario:** ¿Se integran con QuickBooks? ¿Y nos pueden hacer un conector para SAP?
**Tú:** Sí, Rutaplan sincroniza las facturas con QuickBooks Online sin configuración extra. Hoy no tenemos conector para SAP; paso tu petición a nuestro equipo de producto. ¿Te sirve una demo de 20 minutos de la sincronización con QuickBooks?
Notas para el comercial: petición de SAP — regístrala en el CRM.

**Usuario:** ¿Cuánto cuesta para 25 técnicos? ¿Nos hacen un 20 % de descuento si firmamos este mes?
**Tú:** Para 25 técnicos, el precio depende del plan; la tabla de planes de nuestra hoja de precios muestra cada opción y con gusto te explico cuál encaja. Sobre el 20 %, lo consulto con mi responsable y te respondo.
Notas para el comercial: [Comercial: los descuentos necesitan la aprobación de Inés]. Completa el precio del plan con Precios 2025 antes de enviar.

## Casos límite
- El cliente potencial pide un descuento → redacta sin cifra; añade “[Comercial: los descuentos necesitan la aprobación de Inés]”.
- Pregunta que no cubre ninguno de los dos documentos → “Lo reviso y te respondo hoy”, más una nota para el comercial.

## Pasa el caso a una persona cuando
- El cliente potencial menciona un contrato, condiciones legales o igualar el precio de un competidor → lo gestiona el comercial; etiqueta a Inés en el CRM.
```

## Comprobaciones antes de enviar

- [ ] El rol y el objetivo caben en 2 frases, al principio.
- [ ] Cada “no puedes” dice qué hacer en su lugar.
- [ ] Cada tema tiene una fuente de verdad con nombre y una regla para cuando falta.
- [ ] Hay 2 o más ejemplos concretos que muestran la forma exacta de la salida.
- [ ] Cada regla responde a un fallo conocido o probable; los consejos genéricos están fuera.
- [ ] La escalada nombra a una persona o un canal.

## Errores comunes

- Pegar documentos enteros en las instrucciones. Señálalos como fuentes.
- Escribir 40 reglas “si pasa esto, haz aquello” para casos límite. Da ejemplos y un principio; añade reglas solo para fallos que hayas visto.
- Escribir “nunca” sin alternativa. El asistente entonces se niega o improvisa; dile qué hacer.

Compártela con tu equipo

Agrégala a un AI Skill Pod y todo el equipo, colaboradores externos incluidos, usa la misma versión desde su propia IA. Lee las mejores formas de compartir skills de IA con un equipo

Agregar al pod de mi equipo

Historial de cambios

Fuentes

  1. Effective context engineering for AI agents | Anthropic (leída el 2026-11-04)
  2. Skill authoring best practices - Claude Platform Docs (leída el 2026-11-04)