# skill-sync

> Sincroniza metadata de skills a las tablas "Auto-invoke Skills" en archivos AGENTS.md. Trigger: Después de crear o modificar skills, ejecuta sync para actualizar AGENTS.md.

- Author: Juan Cruz Robledo
- Repository: JuanCruzRobledo/active-ia-correcion-automatica
- Version: 20260129125306
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/JuanCruzRobledo/active-ia-correcion-automatica
- Web: https://mule.run/skillshub/@@JuanCruzRobledo/active-ia-correcion-automatica~skill-sync:20260129125306

---

---
name: skill-sync
description: >
  Sincroniza metadata de skills a las tablas "Auto-invoke Skills" en archivos AGENTS.md.
  Trigger: Después de crear o modificar skills, ejecuta sync para actualizar AGENTS.md.
metadata:
  author: Active-IA Team
  version: "1.0"
  scope: [root]
  auto_invoke:
    - "Syncing AGENTS.md files"
    - "Updating auto-invoke tables"
---

# Skill Sync

## When to Use

- Después de crear un nuevo skill
- Después de modificar el frontmatter de un skill existente
- Para verificar que todos los AGENTS.md están sincronizados
- Para regenerar las tablas de auto-invoke

## How It Works

1. Lee todos los archivos `SKILL.md` en `skills/`
2. Extrae del frontmatter YAML: `name`, `scope[]`, `auto_invoke[]`
3. Agrupa skills por scope (`root`, `frontend`, `backend`)
4. Genera tablas "Auto-invoke Skills" ordenadas alfabéticamente
5. Actualiza o inserta las secciones en cada AGENTS.md

## Scope Mapping

| Scope | Archivo |
|-------|---------|
| `root` | `./AGENTS.md` |
| `frontend` | `./frontend/AGENTS.md` |
| `backend` | `./backend/AGENTS.md` |

## Usage

```bash
# Sincronizar todos los scopes
./skills/skill-sync/assets/sync.sh

# Preview sin escribir cambios
./skills/skill-sync/assets/sync.sh --dry-run

# Solo un scope específico
./skills/skill-sync/assets/sync.sh --scope root

# Salida detallada
./skills/skill-sync/assets/sync.sh --verbose
```

## Generated Output

El script genera tablas como esta:

```markdown
## Auto-invoke Skills

<!-- This section is auto-generated by skill-sync. Do not edit manually. -->

| Action | Skill |
|--------|-------|
| Creating FastAPI endpoints | python-fastapi |
| Creating React components | react-typescript |
| Implementing correction flow | correccion-ia |
| Managing rubrics/criteria | rubricas |
```

## Critical Rules

### ALWAYS
- Ejecutar sync después de modificar skills
- Verificar que el frontmatter YAML es válido
- Usar `--dry-run` primero para verificar cambios
- Mantener el comentario de auto-generación

### NEVER
- Editar manualmente las secciones "Auto-invoke Skills"
- Eliminar el comentario `<!-- This section is auto-generated -->`
- Usar caracteres especiales en `auto_invoke` que rompan markdown

## Frontmatter Requirements

Cada `SKILL.md` debe tener:

```yaml
---
name: skill-name          # REQUERIDO
description: >            # REQUERIDO
  Descripción del skill
metadata:
  scope: [root, backend]  # REQUERIDO - array de scopes
  auto_invoke:            # REQUERIDO - array de acciones
    - "Action 1"
    - "Action 2"
---
```

## Troubleshooting

| Problema | Solución |
|----------|----------|
| Skill no aparece en tabla | Verificar que `scope` incluye el scope deseado |
| YAML parse error | Verificar sintaxis del frontmatter |
| Tabla no se actualiza | Verificar que existe el marcador `## Auto-invoke Skills` |
| Duplicados en tabla | Verificar que no hay `auto_invoke` duplicados |