# Declaración de la Renta España (IRPF 2025) - Skill para Claude

URL canónica: https://plugins.joseconti.com/declaracion-renta-espana/
Repositorio: https://github.com/joseconti/declaracion-renta-espana
Licencia: GPLv3
Autor: José Conti (https://plugins.joseconti.com)

## Resumen

Skill open source para Claude que asiste al contribuyente español en la Declaración de la Renta (IRPF) del ejercicio 2025, que se presenta entre el 8 de abril y el 30 de junio de 2026.

No es un chatbot genérico: es un conjunto de archivos Markdown estructurados con normativa fiscal real, procedente del Manual Práctico de la AEAT (1.903 páginas) y de los manuales oficiales de las 4 haciendas forales (1.311 páginas adicionales). En total, 3.214 páginas de documentación oficial procesadas y estructuradas.

## Modos de trabajo

### Modo A - Revisión

El contribuyente ya tiene un borrador (de la AEAT o de su hacienda foral) y quiere revisarlo para identificar deducciones no aplicadas o errores. El skill lee el PDF, extrae las casillas, formula un cuestionario dirigido por CCAA y perfil, y genera un informe con deducciones adicionales identificadas y ahorro estimado.

### Modo B - Preparación

El contribuyente no tiene borrador y quiere calcular su declaración desde cero a partir de documentos en bruto (nóminas, certificados bancarios, facturas, escrituras). El skill ingiere PDF, Excel, CSV, imágenes y texto, consolida los datos en 9 bloques temáticos, calcula rendimientos netos, base imponible, cuotas y deducciones, y entrega un "paquete Renta WEB" con casillas, importes y checklist de verificación profesional.

### Modo C - Híbrido

El contribuyente tiene borrador pero le faltan datos (autónomo, ventas de inmuebles, criptomonedas no comunicadas). Combina ambos flujos sin duplicar lo que el borrador ya tiene correcto.

## Flujo de trabajo

1. **Selección de modo**: detección automática según el contexto del usuario.
2. **Ingesta**: lectura del borrador o consolidación de documentos en bruto.
3. **Confirmación de datos básicos**: CCAA o territorio foral a 31/12/2025, situación familiar, tipo de declaración (individual o conjunta).
4. **Cuestionario de descubrimiento**: preguntas dirigidas por CCAA, situación personal y perfil. Pregunta siempre por el municipio exacto para detectar deducciones por despoblamiento.
5. **Análisis y recomendaciones**: cruce con deducciones estatales, autonómicas y reducciones de la base. Verifica requisitos uno a uno antes de recomendar.
6. **Resumen y siguientes pasos**: informe final con deducciones aplicadas, adicionales identificadas, comparativa individual vs conjunta, ahorro estimado y checklist profesional.

## Cobertura geográfica

### Comunidades autónomas de régimen común (15)

Andalucía, Aragón, Asturias, Baleares, Canarias, Cantabria, Castilla-La Mancha, Castilla y León, Cataluña, Extremadura, Galicia, Madrid, Murcia, La Rioja, Comunitat Valenciana.

### Ciudades autónomas (régimen especial 60%)

Ceuta, Melilla.

### Territorios forales (IRPF independiente)

- Navarra: 11 tramos del 13% al 52%, escala ahorro 20-28% (6 tramos).
- Álava: 7 tramos del 23% al 49%, escala ahorro 20-25% (5 tramos).
- Bizkaia: 8 tramos del 23% al 49%, escala ahorro 20-25% (5 tramos).
- Gipuzkoa: 8 tramos del 23% al 49%, escala ahorro 20-25% (5 tramos).

Los contribuyentes forales NO presentan declaración ante la AEAT, sino ante sus respectivas haciendas forales. El skill detecta automáticamente la residencia foral y carga el archivo correspondiente.

## Anexos de municipios (deducciones por despoblamiento)

Una de las fuentes de ahorro fiscal más desconocidas en España. El skill incluye listas de municipios elegibles para cada CCAA con deducciones específicas:

- **La Rioja**: Anexo 1 con 184 municipios para deducciones de pequeños municipios. Anexo 2 con 193 municipios para segunda vivienda en medio rural.
- **Aragón**: Asentamientos clasificados como Rango X.
- **Cantabria**: 5 deducciones (alquiler, guardería, traslado, estudios, residencia) según Orden PRE/1/2025.
- **Extremadura**: Municipios con población inferior a 3.000 habitantes (criterio INE).
- **Madrid**: Municipios en riesgo de despoblación.
- **Comunitat Valenciana**: Clasificación AVANT.
- **Castilla-La Mancha, Castilla y León, Galicia, Asturias**: deducciones para zonas rurales.

## Casos especiales cubiertos

- **Ley Beckham (impatriados)**: escala propia 24%/47% para trabajo y 19-30% progresivo para ahorro.
- **Criptomonedas**: trading, staking, lending, airdrops, mining. Método FIFO, casillas 1804/0027, modelos 721/172/173.
- **Modelo 720**: bienes en el extranjero superiores a 50.000 €.
- **Modelo 721**: criptomonedas en el extranjero superiores a 50.000 €.
- **Exit tax**: impuesto de salida para residentes de 10+ años.
- **Artículo 7.p LIRPF**: exención por trabajos en el extranjero hasta 60.100 €.
- **Nómadas digitales**: Ley 28/2022 de Startups. Comparativa detallada con Beckham clásica.
- **Atribución de rentas**: comunidades de bienes, herencias yacentes. Modelo 184.
- **Ganancias patrimoniales complejas**: inmuebles, coeficientes de abatimiento, régimen transitorio pre-1994.
- **Reducción artística**: novedad 2025, hasta 150.000 €.

## Perfiles especiales atendidos

Funcionarios con mutualidad (MUFACE/ISFAS/MUGEJU), jubilados y pensionistas, desempleados con prestación en pago único, viudos, custodia compartida, herederos que venden bienes, consejeros de administración, deportistas, religiosos, agricultores y ganaderos, cooperativistas.

## Novedades del ejercicio 2025

- Reducción por rendimientos del trabajo: incremento de 6.498 € a 7.302 €, con 3 tramos en lugar de 2.
- Tramo máximo del ahorro: sube del 28% al 30% (bases superiores a 300.000 €).
- Reducción especial por rendimientos artísticos: 30% sobre el exceso del 130% de la media de los 3 ejercicios anteriores.
- Deducción especial por DANA en la Comunitat Valenciana (octubre 2024).

## Calendario de la campaña

- Inicio campaña: 8 de abril de 2026.
- Cita previa para teléfono: a partir del 29 de abril.
- Plan "Le Llamamos": 6 de mayo a 30 de junio.
- Atención presencial: 3 de junio a 30 de junio.
- Domiciliación bancaria: hasta 25 de junio.
- Fin de campaña: 30 de junio de 2026.
- Segundo plazo (40%) si fraccionamiento: hasta 5 de noviembre de 2026.

## Instalación

### Como skill de Claude

Tres formas:

1. **Descargar la última release** desde https://github.com/joseconti/declaracion-renta-espana/releases/latest y descomprimir dentro de la carpeta de skills correspondiente.
2. **Clonar con git** dentro de `.claude/skills/`:
   ```
   git clone https://github.com/joseconti/declaracion-renta-espana.git
   ```
3. **Como referencia documental** en cualquier LLM: pegar el contenido de `SKILL.md` y los archivos relevantes como contexto del sistema.

### Ubicaciones recomendadas

- **Cowork mode**: dentro de `.claude/skills/` de la carpeta de trabajo, o como plugin instalado.
- **Claude Code**: dentro de `.claude/skills/` en la raíz del proyecto.
- **Claude Desktop**: como skill personalizado en la configuración.
- **Otros LLMs**: como contexto del sistema.

## Frases que activan el skill (en Claude)

- "Quiero revisar mi declaración de la renta"
- "He subido mi borrador de la AEAT, ¿puedes revisarlo?"
- "¿Qué deducciones puedo aplicar en Madrid?"
- "Mi gestor ha preparado mi declaración, comprueba si falta alguna deducción"
- "Tengo criptomonedas, ¿cómo las declaro?"
- "Me he mudado a España, ¿puedo acogerme a la Ley Beckham?"
- "Vivo en Gipuzkoa, ¿qué deducciones me corresponden?"
- "Soy autónomo y quiero calcular mi declaración"

## Limitaciones conocidas

- En modo preparación, los cálculos son orientativos: deben verificarse contra los datos fiscales de la AEAT y/o con un asesor profesional antes de presentar.
- No accede a los sistemas de la AEAT: trabaja solo con la información que el usuario facilita.
- No cumplimenta Renta WEB automáticamente: calcula importes y presenta casillas, pero el contribuyente o su asesor debe introducir los datos manualmente.
- Solo cubre el ejercicio 2025.
- Canarias requiere revisión manual: muchas deducciones canarias no aparecen en el borrador automático de la AEAT.
- Bizkaia: la nueva escala del ahorro 2026 (NF 2/2025) está documentada pero no aplicable a 2025.
- Las deducciones autonómicas pueden estar restringidas por edad, renta, situación familiar o fechas: el skill verifica los requisitos antes de recomendar.

## Descargo de responsabilidad

Esta herramienta es de orientación fiscal. NO sustituye al asesor fiscal colegiado, gestor administrativo o abogado tributarista profesional. La normativa fiscal española cambia con frecuencia y puede haber matices que solo un profesional cualificado puede valorar correctamente.

El usuario es el único responsable de las decisiones fiscales que tome. Ni el autor ni los colaboradores asumen responsabilidad por errores, omisiones, pérdidas económicas, sanciones administrativas o cualquier perjuicio derivado del uso de esta herramienta.

Caso de uso ideal: verificar que una declaración preparada por un gestor profesional incluye todas las deducciones posibles, como checklist complementaria.

## Fuentes oficiales

- AEAT Manual Práctico Renta 2025: https://sede.agenciatributaria.gob.es/Sede/Ayuda/25Manual/100.html
- AEAT Guía Deducciones Autonómicas 2025: https://sede.agenciatributaria.gob.es/Sede/ayuda/manuales-videos-folletos/manuales-practicos/irpf-2025-deducciones-autonomicas/guia-deducciones-autonomicas.html
- BOE Orden HAC/277/2026: https://www.boe.es/buscar/act.php?id=BOE-A-2026-7041
- Hacienda Foral de Navarra: https://hacienda.navarra.es
- Diputación Foral de Álava: https://web.araba.eus/es/hacienda
- Diputación Foral de Bizkaia: https://www.bizkaia.eus/es/hacienda-y-finanzas
- Diputación Foral de Gipuzkoa: https://www.gipuzkoa.eus/es/hacienda-y-finanzas