Communitygithub.com

ASoudy/AGS

Gestoría y contabilidad para autónomos en España. Usar cuando el usuario necesite calcular IVA trimestral (modelo 303), calcular pagos fraccionados de IRPF (modelo 130), gestionar libro de ingresos y gastos, verificar facturas emitidas o recibidas, calcular retenciones, preparar declaraciones trimestrales, estimar impuestos a pagar, procesar ingresos de Stripe o Substack (separando pagos UE con IVA vs pagos internacionales exentos, convirtiendo monedas a euros), o cualquier consulta sobre fiscalidad o contabilidad de autónomos en España.

¿Qué es AGS?

Este skill es una herramienta de gestión contable y fiscal diseñada específicamente para trabajadores autónomos en España. Proporciona cálculos matemáticamente precisos mediante scripts de Python para tareas como liquidación trimestral de IVA (modelo 303), cálculo de pagos fraccionados de IRPF (modelo 130), procesamiento de facturas emitidas y recibidas, generación de libros de ingresos y gastos, y manejo de ingresos de plataformas como Stripe y Substack. El skill aplica la normativa fiscal española vigente, incluyendo la correcta clasificación de pagos UE (con IVA) e internacionales (exentos), y la conversión de monedas a euros. Es compatible con Claude Code, Cursor y Codex, y su valor principal radica en la precisión de los cálculos y la verificación doble de cada resultado, aunque se advierte que no reemplaza el asesoramiento profesional.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/gestor-autonomos

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Gestor de Autónomos España

Skill para gestión contable y fiscal de trabajadores autónomos en España con cálculos matemáticamente precisos.

[!CAUTION] ADVERTENCIA: Esta skill es una herramienta de apoyo y no sustituye el asesoramiento profesional. Los cálculos y sugerencias generados deben ser revisados por un gestor o profesional cualificado. El uso de esta herramienta se realiza bajo la responsabilidad exclusiva del usuario. Mafia Claude Skills y sus contribuidores no se hacen responsables de errores en las declaraciones fiscales o sanciones derivadas de su uso.

Principios fundamentales

  1. Precisión matemática obligatoria: SIEMPRE usar los scripts de Python para cualquier cálculo. NUNCA calcular mentalmente.
  2. Base legal: Todas las operaciones siguen la normativa de la AEAT (Agencia Tributaria).
  3. Verificación doble: Cada cálculo debe ser verificable y trazable.

Workflow principal

Paso 1: Identificar el tipo de operación

¿Qué necesita el usuario?

  • Calcular IVA trimestral → Ejecutar scripts/calcular_iva.py
  • Calcular IRPF trimestral → Ejecutar scripts/calcular_irpf.py
  • Procesar facturas/gastos → Ejecutar scripts/procesar_facturas.py
  • Generar libro contable → Ejecutar scripts/generar_libro.py
  • Procesar ingresos Stripe/Substack → Ejecutar scripts/procesar_stripe.py
  • Consulta normativa → Ver references/normativa_fiscal.md

Paso 2: Recopilar datos

Solicitar al usuario la información necesaria según la operación:

Para IVA trimestral:

  • Facturas emitidas (base imponible + IVA repercutido)
  • Facturas recibidas deducibles (base imponible + IVA soportado)
  • Trimestre (1T, 2T, 3T, 4T) y año

Para IRPF (Modelo 130):

  • Ingresos del trimestre (sin IVA)
  • Gastos deducibles del trimestre (sin IVA)
  • Retenciones practicadas por clientes
  • Pagos fraccionados anteriores del año

Para facturas:

  • Número de factura
  • Fecha
  • NIF/CIF del cliente/proveedor
  • Concepto
  • Base imponible
  • Tipo de IVA aplicable
  • Retención IRPF (si aplica)

Paso 3: Ejecutar cálculos con scripts

OBLIGATORIO usar scripts para todos los cálculos numéricos:

# Calcular IVA trimestral
python3 scripts/calcular_iva.py --iva-repercutido <cantidad> --iva-soportado <cantidad>

# Calcular IRPF modelo 130
python3 scripts/calcular_irpf.py --ingresos <cantidad> --gastos <cantidad> --retenciones <cantidad> --pagos-anteriores <cantidad>

# Procesar lista de facturas desde CSV
python3 scripts/procesar_facturas.py --archivo <ruta.csv> --tipo <emitidas|recibidas>

# Generar libro de ingresos y gastos
python3 scripts/generar_libro.py --trimestre <1-4> --año <YYYY> --facturas-emitidas <ruta> --facturas-recibidas <ruta>

Paso 4: Presentar resultados

Mostrar al usuario:

  1. Desglose completo del cálculo
  2. Resultado final con formato monetario (€)
  3. Fecha límite de presentación si aplica
  4. Advertencias o consideraciones relevantes

Tipos de IVA en España (2024-2025)

TipoPorcentajeAplicación
General21%Mayoría de bienes y servicios
Reducido10%Alimentos, transporte, hostelería
Superreducido4%Pan, leche, frutas, verduras, libros, prensa
Exento0%Sanidad, educación, seguros, servicios financieros

Retenciones IRPF en facturas

SituaciónRetención
Profesionales (general)15%
Nuevos autónomos (primeros 3 años)7%
Cursos, conferencias15%
Arrendamientos19%

Plazos de presentación trimestral

TrimestrePeríodoPlazo presentación
1TEnero-Marzo1-20 Abril
2TAbril-Junio1-20 Julio
3TJulio-Septiembre1-20 Octubre
4TOctubre-Diciembre1-30 Enero (año siguiente)

Gastos deducibles principales

Ver detalle completo en references/normativa_fiscal.md

Deducibles al 100%:

  • Cuota de autónomos
  • Gestoría y asesoría
  • Seguros de responsabilidad civil
  • Material de oficina
  • Hosting, dominios, software
  • Formación relacionada con actividad
  • Publicidad y marketing

Deducibles con límites:

  • Suministros (30% si trabajas desde casa)
  • Vehículo (50% máximo, según uso profesional)
  • Dietas y desplazamientos (con límites diarios)

Advertencias importantes

  1. Nunca aproximar: Los cálculos fiscales deben ser exactos al céntimo.
  2. Conservar justificantes: Obligatorio guardar facturas 4 años mínimo.
  3. Verificar NIFs: Siempre validar que los NIFs/CIFs sean correctos.
  4. Coherencia IVA: El IVA soportado solo es deducible si está vinculado a la actividad.

Integración con Stripe/Substack

⚠️ IMPORTANTE - Diferencia entre Modelo 303 y Modelo 130

Modelo 303 (IVA trimestral):

  • NO lleva base imponible en la presentación
  • Solo reporta:
    • Casilla 03: Cuota IVA devengada (21% de clientes UE)
    • Casilla 60: Exportaciones exentas (base imponible de no-UE)

Modelo 130 (IRPF trimestral):

  • SÍ lleva base imponible (suma de UE + no-UE)
  • Luego resta gastos deducibles (fees)
  • Resultado: rendimiento neto del trimestre

IMPORTANTE - Reglas fiscales aplicadas

1. El precio cobrado INCLUYE el IVA (Tax Inclusive)

  • El importe que cobras al cliente ya tiene el IVA dentro
  • Para extraer la base imponible: Base = Total / 1.21
  • NO multiplicar por 0.21 (eso sería añadir IVA encima)
  • Ejemplo: Si cobras 60€ → Base = 49,59€, IVA = 10,41€

2. La territorialidad se determina por PAÍS, no por moneda

  • Un cliente de Chile que paga en EUR → Exportación (sin IVA)
  • Un cliente de España que paga en USD → Lleva IVA
  • Prioridad: country (billing) > country (ip)

3. Pagos sin país identificado → Criterio conservador (UE)

  • Si no hay país, se trata como cliente UE (paga IVA)
  • Es más seguro fiscalmente aunque pagues algo más

4. Los fees (Substack + Stripe) son gastos deducibles

  • Se restan en el IRPF (Modelo 130)
  • NO afectan al IVA

Formatos soportados

CSV de Substack (formato nativo):

email,date,currency,amount,Substack fee,Stripe fee,...,country (ip),country (billing)
[email protected],02-Oct-25,eur,€60.00,€6.00,€1.15,...,ES,ES

CSV de Stripe Dashboard:

id,Amount,Currency,Created (UTC),country (billing),Status,...
pi_xxx,60.00,eur,2025-10-02,ES,succeeded,...

Uso del script

# Procesar CSV de Substack o Stripe:
python3 scripts/procesar_stripe.py --archivo pagos.csv --trimestre 4 --año 2025

# El script automáticamente:
# - Detecta formato (Substack o Stripe)
# - Parsea importes con símbolo (€60.00, CA$140.00)
# - Extrae base imponible dividiendo por 1.21 (no multiplicando)
# - Clasifica por PAÍS del cliente (no por moneda)
# - Calcula fees como gastos deducibles

Resultados generados

Para Modelo 303 (IVA):

  • Casilla 03: Cuota IVA a repercutir (21% de la base UE)
  • Casilla 60: Exportaciones exentas (clientes no-UE) - IMPORTANTE: se reporta como base, no como cuota

Para Modelo 130 (IRPF):

  • Base imponible: Suma de bases de clientes UE + no-UE
  • Gastos: Fees de Substack + Stripe (deducibles)
  • Rendimiento neto: Base imponible - Gastos

Países UE-27 (referencia)

AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK

⚠️ Reino Unido (GB/UK) NO está en la UE desde 2021 → Exento

Ejemplo práctico

Pago de 60€ desde España (ES):
  Base imponible: 60 / 1.21 = 49,59€
  IVA incluido:   60 - 49,59 = 10,41€

Pago de 60€ desde Chile (CL):
  Base imponible: 60€ (total, sin división)
  IVA: 0€ (exportación exenta)

Pago de 85€ sin país identificado:
  → Tratado como UE (conservador)
  Base imponible: 85 / 1.21 = 70,25€
  IVA incluido:   85 - 70,25 = 14,75€

Consultas normativas

Para preguntas sobre legislación, consultar references/normativa_fiscal.md que contiene:

  • Ley del IVA (Ley 37/1992)
  • Ley del IRPF (Ley 35/2006)
  • Reglamento de facturación
  • Criterios de la AEAT

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados