# agent-skill-groups

No cargues todas las skills de un agente en cada sesión. Cambia los grupos de skills por runtime y escenario.

`agent-skill-groups` es un gestor de GitHub skill-group / GitHub agent-skill-group para organizar directorios `SKILL.md` al estilo Agent Skills. Está pensado para:

- OpenAI Codex
- Claude Code
- OpenCode
- layouts genéricos `.agents/skills`

## Problema

Cuando una biblioteca local de skills crece, el problema real no es la instalación sino la operación diaria:

- demasiadas skills se cargan en cada sesión
- el contexto inicial se vuelve más ruidoso
- skills de CTF, Figma, papers o video quedan activas aunque no se usen
- mover carpetas manualmente no es una solución mantenible
- los repositorios grandes necesitan escaneo, agrupación, diagnóstico, backup y restore

Este proyecto mantiene un `core` pequeño siempre activo y activa perfiles por escenario solo cuando hacen falta.

## Flujo básico

```bash
python -m agent_skill_groups runtimes
python -m agent_skill_groups analyze --runtime codex --json
python -m agent_skill_groups suggest --runtime codex
python -m agent_skill_groups init --runtime codex --output groups.json
python -m agent_skill_groups doctor --config groups.json --runtime codex
python -m agent_skill_groups plan --config groups.json --runtime codex ctf-web
python -m agent_skill_groups backup --config groups.json --runtime codex
python -m agent_skill_groups profile --config groups.json --runtime codex ctf-web
```

## Uso recomendado

Usa `core` como perfil predeterminado. Cambia a un perfil de escenario solo cuando la tarea lo necesite y vuelve a `core` al terminar.

## Términos de búsqueda

Este proyecto cubre búsquedas como:

- GitHub skill-group
- GitHub agent-skill-group
- GitHub agent skill group
- Agent Skills manager
- Codex skills manager
- Claude Code skills manager
- OpenCode skills manager
- skill manager
- skills manager
- SKILL.md organizer

## Enlaces

- Repositorio de GitHub: https://github.com/go165/agent-skill-groups
- Documentación: https://go165.github.io/agent-skill-groups/
- Demo rápida: https://go165.github.io/agent-skill-groups/quickstart.html
- Estado de visibilidad: https://go165.github.io/agent-skill-groups/visibility-status.html