convez.ai
SkillAutomaçãoIntermediário
AnaCataVC

Amiga IA - Skills e Agentes Declarativos Universais

AnaCataVC/amiga-ia

Skills e agentes declarativos cross-platform para Claude e Gemini

Ver no GitHub
InicialPluginScore · de 0 a 100

Repositó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-ia

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 semana
Versão
v5.15.2
Issues abertas
0
Contribuidores
2

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

Antigravity Claude Code NPM

English | Español


🎶 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.

TypeNameDescription
Agentami-commit-assistantPrepares, reviews, and executes Git commits following Conventional Commits format.
Agentami-next-step-assistantActs as a project guide by analyzing the repository and recommending the most critical next step.
Agentami-pr-publisherMaster orchestrator agent that performs a comprehensive review of Pull Requests before they are published.
Agentami-push-assistantPre-push orchestrator that performs baseline quality, security, and data consistency checks before a push.
Agentami-release-managerThe central orchestrator agent that manages the release lifecycle.
Skillami-data-validatorValidates structural consistency between code changes and data definitions.
Skillami-doc-architectHelps generate project documentation from scratch or adapts to existing styles.
Skillami-docs-updaterIdentifies if codebase documentation exists and updates it to reflect code changes.
Skillami-learnings-extractorAnalyzes recent code changes to extract architectural decisions, lessons, and patterns.
Skillami-pr-comment-analyzerAnalyzes code review comments left by other developers on an active Pull Request.
Skillami-pr-conflict-detectorAnalyzes other open Pull Requests to alert if there are parallel PRs that might conflict.
Skillami-pr-peer-reviewerAssists in reviewing Pull Requests from other people.
Skillami-project-architectInteractively sets up the initial architecture and structure of a new project.
Skillami-quality-auditorPerforms a deep code quality, security, and structure audit on modified files.
Skillami-quick-reviewerPerforms a static analysis of modified or untracked files before a commit.
Skillami-release-drafterAnalyzes git commits to automatically draft bilingual release notes.
Skillami-release-taggerAnalyzes git commits since the last tag and determines the next semantic version.
Skillami-tech-debt-scannerAnalyzes the repository for technical debt, including outdated dependencies and dead code.
Skillami-test-creatorAutomatically generates tests for modified code if no existing tests cover the changes.
Skillami-test-runnerFinds 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:

  1. Run amiga-ia-setup and select u (Uninstall) to safely delete the copied skills and agents.
  2. Run npm uninstall -g @anacatavc/amiga-ia to remove the package.

7. Extending the Package

  • Naming Convention (ami- prefix): All custom skills and agents MUST be prefixed with ami- (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.md directory and file with YAML frontmatter.
  • To add a new agent: Create a new agents/ami-<name>.md file.

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.

TipoNombreDescripción
Agenteami-commit-assistantPrepara, revisa y ejecuta commits de Git siguiendo el formato Conventional Commits.
Agenteami-next-step-assistantGuía el proyecto analizando el repositorio y recomendando el siguiente paso más crítico.
Agenteami-pr-publisherAgente orquestador maestro que realiza una revisión exhaustiva de los Pull Requests antes de publicarlos.
Agenteami-push-assistantOrquestador pre-push que realiza comprobaciones de calidad, seguridad y consistencia de datos.
Agenteami-release-managerAgente orquestador central que gestiona el ciclo de vida de los lanzamientos (releases).
Skillami-data-validatorValida la consistencia estructural entre los cambios de código y las definiciones de datos.
Skillami-doc-architectAyuda a generar documentación del proyecto desde cero o se adapta a estilos existentes.
Skillami-docs-updaterIdentifica si existe documentación del código y la actualiza para reflejar los cambios.
Skillami-learnings-extractorAnaliza los cambios de código recientes para extraer decisiones arquitectónicas, lecciones y patrones.
Skillami-pr-comment-analyzerAnaliza los comentarios de revisión de código dejados por otros desarrolladores en un PR activo.
Skillami-pr-conflict-detectorAnaliza otros Pull Requests abiertos para alertar si hay conflictos paralelos.
Skillami-pr-peer-reviewerAyuda a revisar los Pull Requests de otras personas.
Skillami-project-architectConfigura interactivamente la arquitectura y estructura inicial de un proyecto nuevo.
Skillami-quality-auditorRealiza una auditoría profunda de calidad, seguridad y estructura del código en archivos modificados.
Skillami-quick-reviewerRealiza un análisis estático de los archivos modificados antes de un commit.
Skillami-release-drafterAnaliza los commits de git para redactar automáticamente notas de lanzamiento bilingües.
Skillami-release-taggerAnaliza los commits desde el último tag y determina la siguiente versión semántica.
Skillami-tech-debt-scannerAnaliza el repositorio en busca de deuda técnica, incluyendo dependencias obsoletas y código muerto.
Skillami-test-creatorGenera automáticamente pruebas para el código modificado si no existen pruebas previas.
Skillami-test-runnerEncuentra 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:

  1. Ejecuta amiga-ia-setup y selecciona u (Uninstall) para borrar de forma segura las skills y agentes copiados.
  2. Ejecuta npm uninstall -g @anacatavc/amiga-ia para eliminar el paquete.

7. Extendiendo el Paquete

  • Convención de Nombres (Prefijo ami-): Todas las skills y agentes personalizados DEBEN llevar el prefijo ami- (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.md con metadata en YAML.
  • Para añadir un nuevo agente: Crea un archivo agents/ami-<nombre>.md.
Ver o original no GitHub

Bom para

Relacionados