Guía

Todo lo que necesitas para instalar y usar Peruvify con tu agente.

¿Qué es Peruvify?

Marketplace de skills para IA en Perú

Peruvify es un marketplace de skills para agentes de IA enfocado en el ecosistema peruano. Permite instalar instrucciones, scripts y herramientas locales para que asistentes como Claude Code, Cursor o Windsurf puedan resolver consultas tributarias, financieras, regulatorias y operativas de Perú con contexto especializado.

Compatibilidad con Claude Code, Cursor y Windsurf

Cada skill se instala como archivos locales compatibles con el estándar SKILL.md, por lo que tu agente puede leerlos desde rutas como .claude/skills/ o .agents/skills/. El CLI de Peruvify gestiona la instalación, autenticación, actualización y organización de esas skills.

Casos de uso con SUNAT, BCRP y UIT

Puedes usar Peruvify para automatizar tareas relacionadas con SUNAT, BCRP, cronogramas tributarios, tipo de cambio, UIT vigente y otras entidades o fuentes peruanas sin tener que escribir prompts largos ni mantener manualmente el contexto técnico de cada integración.

1Quickstart

Instala el gateway gratuito en tu proyecto:

npx @peruvify/cli init

Instala tu primera skill gratuita:

peruvify install bcrp-tipo-cambio

Pregúntale a tu agente:

"¿Cuál es el tipo de cambio de hoy?"

2Autenticación

Para instalar skills premium necesitas una cuenta con suscripción activa.

peruvify login

Se abre tu browser para autenticarte con Google o email/password. El token se guarda en ~/.peruvify/credentials.json con permisos 600.

El refresh token dura ~30 días. El access token se renueva automáticamente.

3Comandos CLI

Comando	Descripción
`npx @peruvify/cli init`	Instala el gateway gratuito (sin auth)
`peruvify login`	Autentica vía browser callback
`peruvify logout`	Borra credenciales locales
`peruvify install <skill>`	Instala una skill (interactivo: ¿dónde?)
`peruvify install <entidad>`	Instala todas las skills de una entidad
`peruvify update`	Actualiza skills instaladas
`peruvify list`	Lista skills instaladas localmente
`peruvify config set defaultPath <path>`	Guarda preferencia de instalación

4Paths de instalación

Al ejecutar peruvify install por primera vez, el CLI te pregunta dónde instalar:

¿Dónde instalar la skill?
  > .claude/skills/        (Claude Code — default)
    .agents/skills/        (Universal)
    skills/                (Claw / OpenClaw)
    ~/.claude/skills/      (global)

Guarda tu preferencia con peruvify config set defaultPath .claude/skills/

5FAQ técnica

¿Dónde se guardan mis credenciales de Peruvify?

En ~/.peruvify/credentials.json con permisos chmod 600. Solo contiene el token de sesión de Peruvify, nunca credenciales de SUNAT u otras entidades.

¿Las skills necesitan conexión a internet?

No para ejecutarse. Las skills son archivos locales (SKILL.md + scripts). Pero tu agente puede necesitar internet para consultar las APIs de SUNAT, BCRP, etc.

¿Puedo usar Peruvify con múltiples agentes?

Sí. Instala las skills en la ruta que use cada agente. Por ejemplo, .claude/skills/ para Claude Code y .agents/skills/ para agentes universales.

¿Qué pasa si una skill queda desactualizada?

Ejecuta peruvify update para verificar y actualizar. El CLI te muestra qué cambió antes de confirmar la actualización.