Amiga IA - Skills e Agentes Declarativos Universais
AnaCataVC/amiga-ia
Skills e agentes declarativos cross-platform para Claude e Gemini
Ver no GitHubRepositório centralizado de skills, agentes e adaptador universal 100% compatível com Gemini (Antigravity) e Claude Code. Fornece uma única fonte de verdade para capacidades IA modulares em formato declarativo Markdown com padrão Agent Skills, incluindo agentes pré-built para commits, PRs, releases e push assistants.
Instalação
npx convez-ai AnaCataVC/amiga-ia1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Orquestração de agentes para fluxos de Git/CI-CD
- Revisão de código com skills reutilizáveis
- Geração de documentação e validação de dados
- Adaptação universal de skills entre plataformas de IA
Veredito

Projeto maduro de arquitetura declarativa que resolve fragmentação entre Claude e Gemini. Abordagem sólida com skills pré-build para DevOps, mas curva de aprendizado moderada em padrões de lazy loading e YAML frontmatter. Recomendado para times que necessitam consistência multi-plataforma em automação.
README
A tradução para o português deste README ainda está na fila.
Amiga IA - Universal Declarative Skills & Agents
🎶 Repo name inspo: Amiga Mia - Los Prisioneros
🤖 Product website: projects.ana-catalina.com/amiga-ia
English
1. Project Description
Amiga IA is a centralized repository for storing declarative skills, declarative agents, and a universal adapter that are 100% cross-compatible with Antigravity (Gemini) and Claude Code. It provides a single source of truth for modern, modular AI capabilities formatted using the Agent Skills (Markdown + Lazy Loading) standard.
2. Repository Structure
amiga-ia/
├── package.json # NPM Package definition
├── agent/ # Boilerplate Agent entrypoint (agent.js)
├── adapters/ # Universal adapter (universal_adapter.js)
├── agents/ # Declarative Markdown agents
│ └── *.md # Individual agent definitions
├── docs/ # Persistent agent memory and architecture docs
├── skills/ # Declarative Markdown skills
│ └── */SKILL.md # Individual skill definitions in directories
└── settings.json # Additional configurations
3. Declarative Format
Skills
All skills are defined as declarative directories containing a SKILL.md file. The adapter scans these directories, extracts the YAML frontmatter, and provides the LLM with an XML index (<available_skills>). When the agent decides to use a skill, it reads the Markdown file natively to understand the instructions.
---
name: ami-quick-reviewer
description: Reviews the code for logic errors.
---
1. Read the files.
2. Run tests.
Agents
Agents are defined in .md files containing the persona and instructions.
# ami-commit-assistant
You are an agent designed to create commits.
Use the `ami-quick-reviewer` skill if necessary.
4. Included Skills & Agents
All built-in tools use the mandatory ami- prefix to ensure safe namespacing and prevent collisions.
| Type | Name | Description |
|---|---|---|
| Agent | ami-commit-assistant | Prepares, reviews, and executes Git commits following Conventional Commits format. |
| Agent | ami-next-step-assistant | Acts as a project guide by analyzing the repository and recommending the most critical next step. |
| Agent | ami-pr-publisher | Master orchestrator agent that performs a comprehensive review of Pull Requests before they are published. |
| Agent | ami-push-assistant | Pre-push orchestrator that performs baseline quality, security, and data consistency checks before a push. |
| Agent | ami-release-manager | The central orchestrator agent that manages the release lifecycle. |
| Skill | ami-data-validator | Validates structural consistency between code changes and data definitions. |
| Skill | ami-doc-architect | Helps generate project documentation from scratch or adapts to existing styles. |
| Skill | ami-docs-updater | Identifies if codebase documentation exists and updates it to reflect code changes. |
| Skill | ami-learnings-extractor | Analyzes recent code changes to extract architectural decisions, lessons, and patterns. |
| Skill | ami-pr-comment-analyzer | Analyzes code review comments left by other developers on an active Pull Request. |
| Skill | ami-pr-conflict-detector | Analyzes other open Pull Requests to alert if there are parallel PRs that might conflict. |
| Skill | ami-pr-peer-reviewer | Assists in reviewing Pull Requests from other people. |
| Skill | ami-project-architect | Interactively sets up the initial architecture and structure of a new project. |
| Skill | ami-quality-auditor | Performs a deep code quality, security, and structure audit on modified files. |
| Skill | ami-quick-reviewer | Performs a static analysis of modified or untracked files before a commit. |
| Skill | ami-release-drafter | Analyzes git commits to automatically draft bilingual release notes. |
| Skill | ami-release-tagger | Analyzes git commits since the last tag and determines the next semantic version. |
| Skill | ami-tech-debt-scanner | Analyzes the repository for technical debt, including outdated dependencies and dead code. |
| Skill | ami-test-creator | Automatically generates tests for modified code if no existing tests cover the changes. |
| Skill | ami-test-runner | Finds and executes the test suite for the current project to ensure no regressions. |
5. Installation & Usage
You can install this repository as a Node.js package or consume it locally.
As an NPM Package:
npm install -g @anacatavc/amiga-ia
Setup Wizard (CLI): Once installed globally, you can run the interactive setup wizard to automatically configure your assistant (Claude or Antigravity) with the package files:
amiga-ia-setup
6. Uninstallation
To completely remove the package and clean up your AI assistant folders:
- Run
amiga-ia-setupand selectu(Uninstall) to safely delete the copied skills and agents. - Run
npm uninstall -g @anacatavc/amiga-iato remove the package.
7. Extending the Package
- Naming Convention (
ami-prefix): All custom skills and agents MUST be prefixed withami-(e.g.,ami-test-runner). This ensures safe namespacing, prevents collisions with other global AI tools, and keeps the ecosystem organized. - To add a new skill: Create a new
skills/ami-<name>/SKILL.mddirectory and file with YAML frontmatter. - To add a new agent: Create a new
agents/ami-<name>.mdfile.
Español
1. Descripción del Proyecto
Amiga IA es un repositorio centralizado diseñado para almacenar skills declarativas, agentes declarativos y un adaptador universal que son 100% compatibles tanto con Antigravity (Gemini) como con Claude Code. Proporciona una única fuente de verdad para un ecosistema de IA estructurado bajo el estándar Agent Skills (Markdown + Lazy Loading).
2. Estructura del Repositorio
amiga-ia/
├── package.json # Definición del paquete NPM
├── agent/ # Entrypoint del agente (agent.js)
├── adapters/ # Adaptador universal (universal_adapter.js)
├── agents/ # Agentes declarativos en Markdown
│ └── *.md # Definiciones individuales de agentes
├── docs/ # Memoria persistente y documentación del proyecto
├── skills/ # Skills declarativas en Markdown
│ └── */SKILL.md # Definiciones individuales de skills
└── settings.json # Configuraciones adicionales
3. Formato Declarativo
Skills
Todas las skills se definen como carpetas con un archivo SKILL.md. El adaptador lee el YAML frontmatter y le presenta a la IA un catálogo XML (<available_skills>). La IA usa Lazy Loading (carga diferida) para leer el archivo solo cuando necesita usar la habilidad.
---
name: ami-quick-reviewer
description: Reviews the code for logic errors.
---
1. Read the files.
2. Run tests.
Agentes
Los agentes se definen en archivos .md. Contienen el prompt principal del asistente.
# ami-commit-assistant
You are an expert git agent.
4. Skills y Agentes Incluidos
Todas las herramientas incluidas utilizan el prefijo obligatorio ami- para garantizar un namespacing seguro y evitar colisiones.
| Tipo | Nombre | Descripción |
|---|---|---|
| Agente | ami-commit-assistant | Prepara, revisa y ejecuta commits de Git siguiendo el formato Conventional Commits. |
| Agente | ami-next-step-assistant | Guía el proyecto analizando el repositorio y recomendando el siguiente paso más crítico. |
| Agente | ami-pr-publisher | Agente orquestador maestro que realiza una revisión exhaustiva de los Pull Requests antes de publicarlos. |
| Agente | ami-push-assistant | Orquestador pre-push que realiza comprobaciones de calidad, seguridad y consistencia de datos. |
| Agente | ami-release-manager | Agente orquestador central que gestiona el ciclo de vida de los lanzamientos (releases). |
| Skill | ami-data-validator | Valida la consistencia estructural entre los cambios de código y las definiciones de datos. |
| Skill | ami-doc-architect | Ayuda a generar documentación del proyecto desde cero o se adapta a estilos existentes. |
| Skill | ami-docs-updater | Identifica si existe documentación del código y la actualiza para reflejar los cambios. |
| Skill | ami-learnings-extractor | Analiza los cambios de código recientes para extraer decisiones arquitectónicas, lecciones y patrones. |
| Skill | ami-pr-comment-analyzer | Analiza los comentarios de revisión de código dejados por otros desarrolladores en un PR activo. |
| Skill | ami-pr-conflict-detector | Analiza otros Pull Requests abiertos para alertar si hay conflictos paralelos. |
| Skill | ami-pr-peer-reviewer | Ayuda a revisar los Pull Requests de otras personas. |
| Skill | ami-project-architect | Configura interactivamente la arquitectura y estructura inicial de un proyecto nuevo. |
| Skill | ami-quality-auditor | Realiza una auditoría profunda de calidad, seguridad y estructura del código en archivos modificados. |
| Skill | ami-quick-reviewer | Realiza un análisis estático de los archivos modificados antes de un commit. |
| Skill | ami-release-drafter | Analiza los commits de git para redactar automáticamente notas de lanzamiento bilingües. |
| Skill | ami-release-tagger | Analiza los commits desde el último tag y determina la siguiente versión semántica. |
| Skill | ami-tech-debt-scanner | Analiza el repositorio en busca de deuda técnica, incluyendo dependencias obsoletas y código muerto. |
| Skill | ami-test-creator | Genera automáticamente pruebas para el código modificado si no existen pruebas previas. |
| Skill | ami-test-runner | Encuentra y ejecuta el conjunto de pruebas del proyecto actual para asegurar que no haya regresiones. |
5. Instalación y Uso
Puedes instalar este repositorio como un paquete de Node.js o usarlo localmente.
Como paquete NPM:
npm install -g @anacatavc/amiga-ia
Asistente de Configuración (CLI): Una vez instalado globalmente, puedes correr el asistente para copiar automáticamente las skills y agentes a tu entorno (Claude o Antigravity):
amiga-ia-setup
6. Desinstalación
Para eliminar completamente el paquete y limpiar las carpetas de tu asistente de IA:
- Ejecuta
amiga-ia-setupy seleccionau(Uninstall) para borrar de forma segura las skills y agentes copiados. - Ejecuta
npm uninstall -g @anacatavc/amiga-iapara eliminar el paquete.
7. Extendiendo el Paquete
- Convención de Nombres (Prefijo
ami-): Todas las skills y agentes personalizados DEBEN llevar el prefijoami-(ej.ami-test-runner). Esto garantiza un namespacing seguro, evita colisiones con otras herramientas de IA globales, y mantiene el ecosistema organizado. - Para añadir una nueva skill: Crea una carpeta y archivo
skills/ami-<nombre>/SKILL.mdcon metadata en YAML. - Para añadir un nuevo agente: Crea un archivo
agents/ami-<nombre>.md.