Analiza ejercicios matemáticos tipo ICFES según 6 dimensiones oficiales (dificultad, competencia, componente, pensamiento, contenido, eje). Usa cuando tengas imagen de problema ICFES, pregunta matemática para clasificar, o necesites decidir si requiere gráficos complejos. Detecta automáticamente si el ejercicio necesita Graficador Experto para replicación visual.
apm install @mattnigh/analizar-icfes
[](https://apm-p1ls2dz87-atlamors-projects.vercel.app/packages/@mattnigh/analizar-icfes)---
name: analizar-icfes
description: >
Analiza ejercicios matemáticos tipo ICFES según 6 dimensiones oficiales
(dificultad, competencia, componente, pensamiento, contenido, eje).
Usa cuando tengas imagen de problema ICFES, pregunta matemática para clasificar,
o necesites decidir si requiere gráficos complejos. Detecta automáticamente
si el ejercicio necesita Graficador Experto para replicación visual.
allowed-tools:
- Read
- Grep
- Glob
- Bash(find:*)
- Bash(cat:*)
- Bash(ls:*)
---
# Análisis ICFES de Ejercicios Matemáticos
## 🎯 Propósito de este Skill
Este skill es el **punto de entrada principal** del workflow de generación de ejercicios .Rmd. Analiza imágenes o descripciones de problemas matemáticos tipo ICFES según **6 dimensiones oficiales** y determina la ruta óptima de procesamiento.
### Cuándo usar este skill
**Triggers automáticos** (Claude lo usa cuando detecta):
- "Analiza este ejercicio ICFES"
- "Clasifica este problema matemático"
- "¿Qué nivel tiene este ejercicio?"
- Imagen de problema matemático adjunta
- Mención de competencias/componentes ICFES
**Invocación manual:**
```
/analizar-icfes imagen_ejercicio.png
```
## 📋 Las 6 Dimensiones ICFES
### Dimensión 1: Nivel de Dificultad (1-4)
**Escala oficial ICFES:**
| Nivel | Puntos | Descripción | Características |
|-------|--------|-------------|-----------------|
| **1** | 0-35 pts | Básico | Aplicación directa de fórmulas, un solo paso |
| **2** | 36-50 pts | Intermedio | Requiere 2-3 pasos, interpretación |
| **3** | 51-70 pts | Avanzado | Múltiples pasos, razonamiento complejo |
| **4** | 71-100 pts | Superior | Síntesis, análisis profundo, creatividad |
**Criterios de clasificación:**
- **Número de pasos**: ¿Cuántas operaciones requiere?
- **Abstracción**: ¿Requiere modelado matemático?
- **Interpretación**: ¿El enunciado es directo o requiere inferencias?
**Ejemplo:**
```
Nivel 1: "Calcula el área de un cuadrado de lado 5 cm"
Nivel 3: "Una piscina rectangular de 8m×6m se llena con manguera
que vierte 2L/min. ¿Cuánto tarda en llenarse a 1.5m altura?"
```
Ver detalles en: @DIMENSIONES.md (sección Nivel de Dificultad)
### Dimensión 2: Competencia (3 categorías)
**Distribución oficial ICFES 2025:**
1. **Interpretación y Representación** (34%)
- Leer gráficos, tablas, diagramas
- Traducir entre representaciones
- Identificar información relevante
2. **Formulación y Ejecución** (43%)
- Plantear ecuaciones/modelos
- Ejecutar procedimientos
- Aplicar algoritmos
3. **Argumentación** (23%)
- Justificar procedimientos
- Validar argumentos
- Demostrar proposiciones
**Ejemplo de clasificación:**
```
"Observa la gráfica y determina el valor máximo"
→ Interpretación y Representación
"Plantea la ecuación que modela la situación y resuélvela"
→ Formulación y Ejecución
"Explica por qué el método usado es correcto"
→ Argumentación
```
Ver ejemplos completos en: @DIMENSIONES.md (sección Competencias)
### Dimensión 3: Componente (3 categorías)
**Según estructura curricular ICFES:**
1. **Numérico-Variacional**
- Números y operaciones
- Patrones y regularidades
- Álgebra y funciones
2. **Geométrico-Métrico**
- Formas y figuras
- Medidas y magnitudes
- Transformaciones
3. **Aleatorio**
- Datos y estadística
- Probabilidad
- Análisis de información
**Criterios de decisión:**
- ¿Trabaja con números/ecuaciones? → Numérico-Variacional
- ¿Involucra figuras/medidas? → Geométrico-Métrico
- ¿Analiza datos/probabilidades? → Aleatorio
Ver tabla de decisión en: @DIMENSIONES.md (sección Componentes)
### Dimensión 4: Tipo de Pensamiento (5 categorías)
Clasifica según el tipo de razonamiento predominante:
1. **Pensamiento Numérico**: Operaciones, propiedades numéricas
2. **Pensamiento Espacial**: Visualización, geometría
3. **Pensamiento Métrico**: Medidas, estimaciones
4. **Pensamiento Variacional**: Cambios, relaciones, funciones
5. **Pensamiento Aleatorio**: Incertidumbre, datos, probabilidad
**Puede haber combinaciones**:
- Problema de geometría analítica → Espacial + Variacional
- Estadística descriptiva → Aleatorio + Numérico
Ver matriz de combinaciones en: @DIMENSIONES.md (sección Pensamiento)
### Dimensión 5: Contenido Curricular
**Clasificación jerárquica:**
```
Álgebra y Cálculo
├── Genéricos (ecuaciones, funciones básicas)
└── No Genéricos (derivadas, límites, series)
Geometría
├── Genéricos (áreas, perímetros, teoremas básicos)
└── No Genéricos (geometría analítica, transformaciones)
Estadística
├── Descriptiva (medidas de tendencia, gráficos)
└── Inferencial (probabilidad, distribuciones)
```
**Regla de oro:**
- Contenido de grados 6-9 → Genérico
- Contenido de grados 10-11 → No Genérico
Ver taxonomía completa en: @DIMENSIONES.md (sección Contenido)
### Dimensión 6: Eje Axial Disciplinar
**Dos categorías:**
1. **Puramente Matemático**
- Problema abstracto
- Sin contexto real
- Ejemplo: "Resuelve x² - 5x + 6 = 0"
2. **Aplicado/Contextualizado**
- Situación del mundo real
- Requiere modelado
- Ejemplo: "Una empresa vende x productos a precio p(x) = 100 - 2x..."
**Criterio simple:**
- ¿Hay contexto narrativo? → Aplicado
- ¿Solo matemática pura? → Puramente Matemático
## 🔍 Proceso de Análisis Paso a Paso
### PASO 1: Lectura y Comprensión Inicial
**Si es imagen:**
1. Leer el enunciado completo
2. Identificar datos numéricos
3. Detectar gráficos, tablas, diagramas
4. Extraer la pregunta principal
**Si es texto:**
1. Identificar el problema matemático
2. Extraer variables y relaciones
3. Determinar qué se pregunta
**Output esperado:**
```markdown
## Comprensión Inicial
- **Enunciado**: [resumen breve]
- **Datos**: [lista de datos numéricos]
- **Pregunta**: [qué se pide calcular/demostrar]
- **Gráficos**: [SÍ/NO - descripción si aplica]
```
### PASO 2: Clasificación por las 6 Dimensiones
**Usar la plantilla:**
```markdown
## Análisis ICFES Completo
### 1. Nivel de Dificultad
- **Nivel**: [1|2|3|4]
- **Justificación**: [por qué este nivel]
- **Puntos estimados**: [0-100]
### 2. Competencia
- **Competencia**: [Interpretación|Formulación|Argumentación]
- **Justificación**: [qué hace principalmente]
### 3. Componente
- **Componente**: [Numérico-Variacional|Geométrico-Métrico|Aleatorio]
- **Justificación**: [área matemática principal]
### 4. Tipo de Pensamiento
- **Pensamiento(s)**: [lista de tipos aplicables]
- **Predominante**: [el principal]
### 5. Contenido Curricular
- **Área**: [Álgebra|Geometría|Estadística]
- **Tipo**: [Genérico|No Genérico]
- **Tema específico**: [ej: "Ecuaciones cuadráticas"]
### 6. Eje Axial
- **Eje**: [Puramente Matemático|Aplicado/Contextualizado]
- **Contexto**: [descripción si es aplicado]
```
Ver plantilla completa en: @PLANTILLA_ANALISIS.md
### PASO 3: Decision de Flujo de Trabajo (OBLIGATORIO Y BLOQUEANTE)
**REGLA CRITICA**: Ver @.claude/rules/flujo-b-obligatorio.md
Este paso es **OBLIGATORIO** y **BLOQUEANTE**. NO se puede continuar sin declarar explicitamente la decision de flujo.
**Criterio critico: ¿Requiere Graficador Experto?**
**ACTIVAR Graficador Experto (Flujo B) SI cualquiera aplica:**
- ✓ Hay graficos matematicos en la imagen (barras, lineas, dispersion, etc.)
- ✓ Hay diagramas geometricos (triangulos, circulos, figuras)
- ✓ Hay plano cartesiano con funciones o puntos
- ✓ Hay tablas con datos que requieren visualizacion
- ✓ Las opciones de respuesta incluyen graficos
- ✓ El enunciado menciona "segun la grafica", "observa el diagrama", etc.
**NO activar (Flujo A estandar) SOLO SI:**
- ✗ Solo texto puro sin NINGUN elemento visual
- ✗ Imagenes puramente decorativas (no matematicas)
**⚠️ SI HAY DUDA: USAR FLUJO B**
**Output de decision OBLIGATORIO:**
```markdown
## Decision de Flujo (OBLIGATORIO)
### Deteccion de Graficos
- **Graficos en enunciado**: [SI/NO - descripcion]
- **Graficos en opciones**: [SI/NO - descripcion]
- **Elementos visuales matematicos**: [lista]
### Decision Final
**Flujo seleccionado**: [A: Estandar | B: Con Graficador]
**Justificacion**: [razon detallada]
**Registro**:
```json
{
"requiere_flujo_b": true/false,
"graficos_detectados": ["lista de graficos"],
"decision_justificada": "razon"
}
```
### Siguiente Paso OBLIGATORIO
- **Flujo A** → Ir a /generar-schoice o /generar-cloze
- **Flujo B** → Ejecutar Graficador Experto SECUENCIALMENTE:
1. TikZ → iterar hasta >=95% + coherencias + aprobacion usuario
2. Python → iterar hasta >=95% + coherencias + aprobacion usuario
3. R → iterar hasta >=95% + coherencias + aprobacion usuario
4. Usuario selecciona version final
5. SOLO ENTONCES → /generar-schoice o /generar-cloze
```
**⛔ BLOQUEO**: Si se detectan graficos y se intenta generar .Rmd sin completar Flujo B, el sistema BLOQUEARA la generacion. Ver @.claude/rules/flujo-b-obligatorio.md
### PASO 4: Generar Metadatos R/exams
**Traducir el análisis a metadatos obligatorios:**
```yaml
exname: [Nombre descriptivo del ejercicio]
extype: [schoice|cloze]
exsolution: [Respuesta correcta]
exshuffle: TRUE
extol: 0.01
# Metadatos ICFES (derivados del análisis)
exextra[Type]: [SCHOICE|CLOZE]
exextra[Competencia]: [resultado Dimensión 2]
exextra[Componente]: [resultado Dimensión 3]
exextra[Afirmacion]: [descripción específica basada en Dimensión 5]
exextra[Evidencia]: [descripción específica basada en Dimensión 2]
exextra[Nivel]: [resultado Dimensión 1]
```
**Ejemplo completo:**
```yaml
exname: Ecuación Cuadrática Aplicada Tiempo Llenado
extype: schoice
exsolution: 01000
exshuffle: TRUE
extol: 0.01
exextra[Type]: SCHOICE
exextra[Competencia]: Formulación y Ejecución
exextra[Componente]: Numérico-Variacional
exextra[Afirmacion]: Plantea y resuelve ecuaciones cuadráticas en contextos reales
exextra[Evidencia]: Formula modelos matemáticos a partir de situaciones problema
exextra[Nivel]: 3
```
Ver especificaciones completas en: @.claude/rules/codigo-rmd.md
## 🎓 Ejemplos Completos de Análisis
### Ejemplo 1: Problema Nivel 2 - Geometría
**Enunciado:**
> "Un triángulo rectángulo tiene catetos de 3 cm y 4 cm. ¿Cuál es la longitud de la hipotenusa?"
**Análisis:**
```markdown
### Dimensión 1: Nivel de Dificultad
- Nivel: 2 (Intermedio)
- Justificación: Aplicación directa del teorema de Pitágoras (2 pasos)
- Puntos: 40
### Dimensión 2: Competencia
- Competencia: Formulación y Ejecución
- Justificación: Debe aplicar fórmula y calcular
### Dimensión 3: Componente
- Componente: Geométrico-Métrico
- Justificación: Figuras geométricas y medidas
### Dimensión 4: Pensamiento
- Pensamiento: Espacial + Métrico
- Predominante: Espacial
### Dimensión 5: Contenido
- Área: Geometría
- Tipo: Genérico
- Tema: Teorema de Pitágoras
### Dimensión 6: Eje
- Eje: Puramente Matemático
- Sin contexto aplicado
### Decisión de Flujo
- Flujo: A (Estándar - no requiere gráficos complejos)
- Siguiente: /generar-schoice
```
Ver más ejemplos en: @EJEMPLOS.md
### Ejemplo 2: Problema Nivel 3 - Estadística con Gráfico
**Enunciado:**
> [Imagen con gráfico de barras de ventas mensuales]
> "Según el gráfico, ¿en qué mes hubo el mayor incremento porcentual respecto al mes anterior?"
**Análisis:**
```markdown
### Dimensión 1: Nivel 3 (requiere cálculo de variaciones porcentuales)
### Dimensión 2: Interpretación y Representación
### Dimensión 3: Aleatorio
### Dimensión 4: Aleatorio + Variacional
### Dimensión 5: Estadística Descriptiva (Genérico)
### Dimensión 6: Aplicado (contexto de ventas)
### Decisión de Flujo
- Flujo: B (Graficador Experto)
- Razón: Gráfico de barras necesita replicación exacta
- Siguiente: Activar Graficador → Generar código R/ggplot2
```
## ⚠️ Errores Comunes a Evitar
### Error 1: Confundir Competencia con Componente
**❌ Incorrecto:**
- Competencia: "Geométrico" (esto es un Componente)
**✓ Correcto:**
- Competencia: "Interpretación y Representación"
- Componente: "Geométrico-Métrico"
### Error 2: Nivel muy bajo/alto
**Criterio objetivo:**
- Cuenta los pasos matemáticos necesarios
- Si son 1-2 pasos directos → Nivel 1-2
- Si son 3+ pasos con razonamiento → Nivel 3-4
### Error 3: No detectar necesidad de Graficador
**Regla simple:**
- ¿El gráfico tiene valores numéricos específicos? → SÍ usar Graficador
- ¿Es solo ilustrativo/decorativo? → NO usar Graficador
## 🔗 Referencias y Documentación
### Archivos de Referencia
- @DIMENSIONES.md - Especificación detallada de las 6 dimensiones
- @EJEMPLOS.md - Colección de ejercicios analizados
- @PLANTILLA_ANALISIS.md - Plantilla para análisis consistente
### Reglas del Proyecto
- @.claude/rules/codigo-rmd.md - Metadatos requeridos
- @.claude/rules/ciclo-validacion.md - Qué hacer después del análisis
### Documentación Oficial ICFES
- @.claude/docs/WORKFLOW_PASO_A_PASO.md - Flujo completo
- @.claude/Mermaid_Chart.txt - Diagrama visual del workflow
## 📊 Output Final Esperado
Después de usar este skill, debes tener:
```markdown
# Análisis ICFES Completo: [Nombre del Ejercicio]
## 1. Clasificación por Dimensiones
[Tabla con las 6 dimensiones clasificadas]
## 2. Metadatos R/exams Generados
[Bloque YAML con metadatos]
## 3. Decisión de Flujo
[Flujo A o B, con justificación]
## 4. Siguiente Acción Recomendada
[Comando específico a ejecutar]
```
## 🚀 Integracion con Otros Skills
Este skill es el **entry point** que activa otros skills:
```
analizar-icfes
↓
├─→ [Flujo A: SIN graficos]
│ ↓
│ generar-schoice / generar-cloze
│ ↓
│ validar-renderizado → validar-coherencia
│ ↓
│ promover-ejercicio
│
└─→ [Flujo B: CON graficos] ⚠️ OBLIGATORIO si hay graficos
↓
1. TikZ (dinamico desde R)
↓ iterar >=95% + coherencias + aprobacion
2. Python (reticulate)
↓ iterar >=95% + coherencias + aprobacion
3. R (ggplot2 nativo)
↓ iterar >=95% + coherencias + aprobacion
4. Usuario selecciona version
↓
generar-schoice / generar-cloze
↓
validar-renderizado → validar-coherencia
↓
promover-ejercicio
```
## ⛔ Reglas Obligatorias Relacionadas
- @.claude/rules/flujo-b-obligatorio.md - Flujo B es OBLIGATORIO si hay graficos
- @.claude/rules/graficador-secuencial.md - Proceso TikZ→Python→R SECUENCIAL
---
**Ultima actualizacion**: 2025-12-30
**Version**: 2.1 (Flujo B obligatorio + Secuencial)
**Basado en**: Documentacion oficial ICFES 2025 + Claude Code best practices