---
name: cie11-formulacion-clinica
description: >-
  Apoya a clínicos (psiquiatría, psicología clínica) a estructurar la formulación de casos ya entrevistados, con CIE-11 como referencia diagnóstica primaria. Trigger obligatorio: "/cie11-formulacion-clinica"; actívalo cuando se escriba ese comando o ante peticiones como "formula este caso" o "audita esta formulación". Modos: completo (default), diferenciales, lagunas, riesgo, auditoria, auditoria-lagunas. NO para autodiagnóstico ni con datos identificables de pacientes reales.
license: CC BY 4.0
metadata:
  author: "Pablo"
  homepage: "https://mindandhealth.org"
  repository: "https://github.com/novanoticia"
---

# Formulación Clínica (CIE-11)

**Autor:** Pablo
**Web:** [mindandhealth.org](https://mindandhealth.org) · [github.com/novanoticia](https://github.com/novanoticia)
**Licencia:** Creative Commons Atribución 4.0 Internacional (CC BY 4.0)
**Diseño asistido por IA (Claude, Anthropic). El diseño, las decisiones arquitectónicas y la dirección son responsabilidad del autor.**

---

Skill de apoyo a la formulación de casos clínicos basado en **CIE-11** como referencia diagnóstica primaria. **No diagnostica.** Genera un andamio de hipótesis a contrastar por el clínico responsable.

## Por qué CIE-11

- Marco oficial en España y la mayoría de sistemas sanitarios públicos.
- Publicado por la OMS bajo licencia CC BY-ND, con un régimen de uso mucho más amigable que el DSM-5-TR (propiedad APA).
- Permite distribución y referencia de categorías y códigos sin los riesgos legales asociados al manual estadounidense.
- Incluye dimensión transcultural y un capítulo de salud mental (06) más actualizado que el equivalente del DSM en varias áreas.

El skill no transcribe criterios de ninguno de los dos manuales. La razón ya no es solo legal: convertir el razonamiento clínico en checklist desactiva la utilidad del juicio profesional.

## Para qué sirve

Recibe un caso ya entrevistado por un profesional habilitado y devuelve, en este orden (modo completo):

1. Caso estructurado en formato consistente.
2. Hipótesis diagnósticas a considerar (códigos CIE-11; DSM-5-TR solo si aporta matiz), separando hipótesis principales de hipótesis a vigilar, con especificadores cuando proceda.
3. Diagnóstico diferencial obligatorio (orgánico, sustancias, otros primarios, reactivo).
4. Lagunas de información con plan de exploración priorizado.
5. Señales de riesgo a vigilar.
6. Cuestionamiento epistémico (2-3 ángulos seleccionados).

## Modos de invocación

El skill admite seis modos. La sintaxis es `/cie11-formulacion-clinica [modo]` seguido del caso.

- **`completo`** (default). Ejecuta los seis pasos.
- **`diferenciales`**. Solo pasos 1, 2 y 3.
- **`lagunas`**. Solo pasos 1 y 4.
- **`riesgo`**. Solo pasos 1 y 5.
- **`auditoria`**. Pasos 1, 6, y bloque A (detección de errores específicos en la formulación auditada). Para someter una formulación a crítica desde fuera.
- **`auditoria-lagunas`**. Paso 1 y bloque B (lagunas críticas para sostener la formulación auditada). Más operativo, más rápido. Para evaluar qué falta sin desplegar cuestionamiento epistémico.

El paso 1 (caso estructurado) se ejecuta siempre. La nota final es obligatoria en todos los modos. Si el caso muestra señales de riesgo agudo, el flujo activa el paso 5 fuera de modo aunque no se haya pedido. La seguridad clínica está por encima del modo elegido.

Los dos modos de auditoría se diseñan para invocarse por separado, no juntos. Si el clínico necesita ambos análisis, se ejecutan en dos pasadas. Cada modo sugiere el otro al final cuando detecta que aporta valor complementario.

## Capacidades (acumuladas hasta v1.5)

- **Detección de identificadores indirectos** con regla estructural (localidad concreta + cargo único + dato familiar específico = identificación automática). Cuando se detecta, el flujo ofrece una versión generalizada del caso para confirmación, en lugar de limitarse a listar cambios.
- **Variantes de entrada.** Procesa tres formatos: caso ya estructurado (no reescribe innecesariamente), prosa narrativa (reorganiza al esquema de 11 apartados), notas en bruto o transcripción (extrae lo posible y marca lagunas con generosidad).
- **Capa transversal de comorbilidad sistémica** con cabecera explícita en la salida cuando se activa. Aplica consideraciones específicas en pasos 2-6: descarte activo de cuadro secundario, ampliación del diferencial iatrogénico con peso clínico, lectura "respuesta adaptativa a enfermedad médica" como ángulo obligatorio en paso 6 (estructura "1 obligatorio + 1-2 a elección"). Aplica regla de parsimonia clínica.
- **Regla anti-redundancia entre pasos 2 y 3.** Cuando una hipótesis principal coincide con una sospecha del paso 3, no se duplica desarrollo: se trata en el paso donde aporta más y se referencia en el otro.
- **Modos de auditoría diferenciados.** `auditoria` se centra en errores específicos de la formulación (descartes prematuros, diferenciales no considerados, descartes orgánicos insuficientes, supuestos no fundamentados, saltos lógicos). `auditoria-lagunas` se centra en qué falta para sostener la formulación. Cada modo hace una cosa y la hace bien; sugieren el otro cuando es complementario.
- **Versiones alternativas opcionales.** Tras la salida principal, ofrece (no genera automáticamente) versión condensada para historia clínica y versión sintética para supervisión.

## Para qué NO sirve

- Autodiagnóstico o autodescripción no mediada por clínico.
- Reproducción literal de criterios diagnósticos de la CIE-11 ni del DSM-5-TR.
- Diagnóstico definitivo, prescripción farmacológica, decisiones de tratamiento.
- Sustitución del juicio clínico, de la entrevista directa o de los protocolos del centro.
- Procesamiento de datos identificables de pacientes (RGPD, datos de salud categoría especial). Trabajar siempre con casos pseudonimizados.

## Cómo usarlo

1. Lee `flujo.md` antes de procesar cualquier caso.
2. En la primera respuesta de la sesión, abre con el aviso de asistencia de IA en el idioma elegido (véase «Aviso de asistencia de IA» y §0.0 en `flujo.md`), antes de cualquier otra cosa, incluso si solo vas a detenerte en una puerta.
3. Detecta si el usuario ha indicado un modo; si no, asume `completo`.
4. Verifica las dos puertas de entrada: pseudonimización (con detección de identificadores indirectos) y mediación clínica.
5. Detecta tipo de entrada (estructurada / prosa / notas) y ajusta paso 1.
6. Detecta si la capa de comorbilidad sistémica debe activarse.
7. Sigue los pasos correspondientes al modo, en orden, sin saltar ninguno.
8. Devuelve la salida con el formato y los encabezados especificados, incluida la nota final obligatoria y el bloque de versiones alternativas opcionales.

<!-- i18n:inicio -->
## Idioma de la salida

El skill responde en español, inglés o francés. Elige el idioma por este orden: petición explícita del clínico (un código de dos o tres letras justo después del modo y como última palabra de la primera línea, p. ej. `/cie11-formulacion-clinica completo en`, o «responde en francés»), idioma en que está escrito el caso, español. Si el idioma pedido o el del caso no existe, responde en el idioma del caso (o en español), muestra el aviso de IA en los tres idiomas y lo avisa. Los nombres de modo, el trigger y los códigos CIE-11 no se traducen. Las reglas están en `flujo.md` (§0.0) y las frases fijas de cada idioma en `idioma-<código>.md`. Para añadir un idioma basta con soltar un `idioma-<código>.md` con las mismas claves y validarlo con `python3 scripts/validar_idiomas.py`.

<!-- i18n:fin -->
## Archivos del skill

- `SKILL.md` — este descriptor.
- `flujo.md` — flujo de razonamiento de seis pasos con reglas duras transversales y un caso resuelto canónico como apéndice de referencia.
- `plantilla-caso.md` — formato esperado de entrada como referencia para el clínico.
<!-- i18n:inicio -->
- `idioma-es.md`, `idioma-en.md`, `idioma-fr.md` — catálogos de frases fijas, encabezados y glosario por idioma. Léelos según `flujo.md` §0.0.
<!-- i18n:fin -->
- `LICENSE` — texto íntegro de la licencia CC BY 4.0 y atribución sugerida.

## Limitaciones conocidas

- Calibrado para población adulta. **Desaconsejado en infanto-juvenil sin revisión específica**: ante un caso de menor, el flujo emite un aviso y continúa bajo responsabilidad del clínico (ver `flujo.md`, "Aviso de población").
- No calibrado para urgencias ni para evaluación de riesgo agudo.
- No reemplaza pruebas estandarizadas, escalas validadas ni exploración complementaria.
- Pendiente de validación con casos reales por clínicos habilitados antes de uso en consulta.
<!-- i18n:inicio -->
- Las traducciones al inglés y al francés las ha redactado una IA y no las ha revisado una persona nativa ni un clínico: deben revisarse antes de cualquier uso en consulta.
<!-- i18n:fin -->

## Instalación

Si recibes el skill empaquetado como `cie11-formulacion-clinica.skill`:

```bash
mkdir -p ~/.claude/skills/cie11-formulacion-clinica/
unzip cie11-formulacion-clinica.skill -d ~/.claude/skills/cie11-formulacion-clinica/
```

Después, invocar con `/cie11-formulacion-clinica [modo]` en una conversación con un entorno compatible con skills.

## Versión

v1.7.0 — versión vigente (cambios en el historial de versiones y en `CHANGELOG.md`). Mantiene la compatibilidad con Mistral AI (`description` < 500 caracteres) y con parsers YAML estrictos (Perplexity: `description` como bloque escalar `>-`). Base funcional en v1.5 (división de `auditoria` en `auditoria` y `auditoria-lagunas`). Sigue pendiente de validación con casos reales por clínicos habilitados.

## Historial de versiones

- **v1.0** — primer borrador funcional con seis pasos.
- **v1.1** — referencia primaria CIE-11, especificadores en hipótesis, plan de exploración priorizado.
- **v1.2** — modos de invocación con salvaguarda de seguridad clínica, ejemplo canónico como apéndice del flujo.
- **v1.3** — identificadores indirectos, variantes de entrada, capa de comorbilidad sistémica, versiones exportables.
- **v1.4** — refinamientos tras testeo: cabecera de comorbilidad, regla anti-redundancia, estructura "1+1-2" en paso 6, salida pre-pseudonimización, regla estructural en Puerta 1, bloque de auditoría ampliado.
- **v1.5** — `auditoria` partido en `auditoria` (errores) y `auditoria-lagunas` (qué falta). Sugerencia cruzada entre ambos.
- **v1.5.1** — fix del frontmatter YAML (`description` como bloque escalar `>-`) para parsers estrictos (Perplexity); paquete `dist/` regenerado.
- **v1.5.2** — compatibilidad con Mistral AI (`description` < 500 caracteres); Mistral documentado en el README; paquete `dist/` regenerado.
- **v1.6.2** — aviso de asistencia de IA (en español, inglés y francés) al inicio de la primera respuesta de cada sesión (requisito de uso de alto riesgo sanitario), sin cambiar el resto del flujo.
<!-- i18n:inicio -->
- **v1.7.0** — salida en español, inglés y francés (`flujo.md` §0.0 y catálogos `idioma-*.md`); el aviso de IA pasa a mostrarse en el idioma elegido, con el bloque trilingüe como respaldo. El razonamiento clínico no cambia.
<!-- i18n:fin -->
