Fizko Skills

Skills para extender Claude con workflows de contabilidad y tributacion chilena. Estas skills trabajan en conjunto con el Fizko MCP connector — conectalo primero, despues instala las skills.

Contenido

6 skills cubriendo los flujos mas comunes:

| Skill | Que hace | |---|---| | fizko-tax | IVA mensual, F29, DTEs, honorarios, DDJJ, busqueda de normativa SII | | fizko-banking | Movimientos bancarios, clasificacion y conciliacion | | fizko-accounting | Asientos, obligaciones, libros contables, reportes financieros | | fizko-balance | Balance de 8 columnas, EERR, balance clasificado, RLI | | fizko-contacts | Asignacion de cuenta COA a clientes y proveedores | | fizko-invoice-approval | Aprobacion de facturas pendientes (invoices que requieren OK manual) |

Cada skill se activa por keywords en el chat: "calcula mi IVA de abril", "conciliame los movimientos pendientes", etc.

Prerequisitos

1. Cuenta Fizko activa en https://app.fizko.ai
2. Fizko MCP connector instalado:
   • Claude.ai → Settings → Connectors → Add custom connector
   • URL: https://mcp.fizko.ai/mcp
   • Client ID / Secret: dejar vacio (DCR auto)

Sin el connector, las skills no pueden invocar los tools de Fizko.

Instalacion

Claude Desktop y Claude Code (CLI) — npx

Una linea:

npx fizko-skills add

Copia las 6 skills de Fizko a ~/.claude/skills/. Reinicia Claude Desktop (o abri una nueva sesion de Claude Code) y estan activas.

Instalar desde cualquier repo GitHub

El CLI tambien sabe levantar skills desde un repo remoto:

npx fizko-skills add fizko-dev/fizko           # de la fuente oficial
npx fizko-skills add owner/repo                # cualquier repo con carpeta skills/
npx fizko-skills add owner/repo#v2.0           # tag o branch especifico
npx fizko-skills add owner/repo/subdir         # subdirectorio arbitrario

Convenciones del auto-detect: el CLI busca en el repo clonado una carpeta skills/ o fizko-skills/skills/. Cada subdirectorio con SKILL.md se copia como una skill individual.

Claude.ai (web)

Claude.ai espera un ZIP subido a mano. Generalo asi:

npx fizko-skills pack     # crea ./fizko-skills.zip

Claude.ai → Settings → Capabilities → Skills → Upload y subilo.

Tambien podes bajar el ZIP prebuildeado desde Releases.

Todos los comandos

npx fizko-skills add [source] [--target <dir>]   # instalar (bundled por default)
npx fizko-skills pack [--out <file>]             # ZIP para Claude.ai web
npx fizko-skills list                            # skills bundled
npx fizko-skills --help

Desarrollo

Las skills viven en skills/. Cada subdirectorio es un skill independiente con su SKILL.md.

Estructura de un skill

skills/fizko-tax/
└── SKILL.md    # YAML frontmatter + cuerpo markdown

Frontmatter minimo:

---
name: fizko-tax
description: "Cuando usar esta skill (triggers)..."
mcp-tools:      # tools del MCP de Fizko que la skill usa
  - fizko_tax
  - fizko_sii_search
---

Probar localmente

# Copia la skill a tu Claude local y reinicia
cp -R skills/fizko-tax ~/.claude/skills/

Empaquetar un release

./scripts/pack.sh         # genera dist/fizko-skills.zip

Licencia

MIT — ver LICENSE.