agent-skills
santim025/agent-skills
Skills de agentes de IA escritos una sola vez y desplegables a Claude Code, OpenCode y pi
Instalação
npx convez-ai santim025/agent-skills1 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
README
A tradução para o português deste README ainda está na fila.
Skills multiplataforma
Skills de agentes de IA escritos una sola vez y desplegables a Claude Code, OpenCode y pi desde una única fuente de verdad.
Las tres plataformas usan el estándar abierto Agent Skills: cada skill es una carpeta con un SKILL.md (frontmatter YAML + cuerpo Markdown), así que el mismo contenido funciona idéntico en las tres.
Quick start
En PowerShell:
git clone https://github.com/santim025/agent-skills.git
cd agent-skills
# Ver qué se copiaría, sin escribir nada
.\deploy.ps1 -WhatIf
# Desplegar a las tres plataformas
.\deploy.ps1
Eso copia cada skill de skills/<nombre>/ a las ubicaciones que cada plataforma escanea. Re-ejecutarlo sobreescribe la versión anterior (idempotente).
Skills incluidos
| Skill | Dominio | Para qué sirve |
|---|---|---|
backend-engineering | Backend | APIs REST/GraphQL, base de datos, auth, rendimiento |
frontend-engineering | Frontend | Componentes, estado, accesibilidad, rendimiento |
devops-automation | DevOps | CI/CD, contenedores, IaC, git/releases |
technical-writing | Docs | READMEs, docs de API, ADRs, changelogs |
data-processing | Datos | Parseo CSV/JSON/PDF, ETL, validación, batch |
Estructura
Skills/
├── skills/
│ ├── backend-engineering/SKILL.md
│ ├── frontend-engineering/
│ │ ├── SKILL.md
│ │ └── references/ # color.md, typography.md, components.md (carga bajo demanda)
│ ├── devops-automation/SKILL.md
│ ├── technical-writing/SKILL.md
│ └── data-processing/SKILL.md
├── deploy.ps1
└── README.md
Desplegar
# Desplegar a las tres plataformas
.\deploy.ps1
# Ver qué se copiaría, sin escribir nada
.\deploy.ps1 -WhatIf
# Desplegar solo a una/varias plataformas
.\deploy.ps1 -Targets claude
.\deploy.ps1 -Targets claude,pi
El script copia cada skill a:
~/.claude/skills/(Claude Code)~/.agents/skills/(pi + OpenCode)~/.pi/agent/skills/(pi, explícito)
Dónde busca cada plataforma los skills
| Plataforma | Ubicaciones que escanea |
|---|---|
| Claude Code | ~/.claude/skills/<nombre>/SKILL.md |
| OpenCode | ~/.config/opencode/skills/, ~/.claude/skills/, ~/.agents/skills/ |
| pi | ~/.pi/agent/skills/, ~/.agents/skills/, .pi/skills/, .agents/skills/ |
~/.agents/skills/es una ubicación compartida que pi y OpenCode leen, así que desplegando ahí cubres ambas.
Añadir o editar un skill
- Crea o edita la carpeta
skills/<nombre>/SKILL.md. - Completa el frontmatter (estándar Agent Skills):
name: 1-64 caracteres, minúsculas, números y guiones simples; debe coincidir con el nombre de la carpeta.description: 1-1024 caracteres; describe qué hace y cuándo usarlo, con palabras clave para que el agente lo active.- Opcionales:
license,compatibility,metadata.
- Ejecuta
.\deploy.ps1para propagar el cambio.
Verificar instalación
Get-ChildItem ~/.claude/skills -Directory
Get-ChildItem ~/.agents/skills -Directory
Get-ChildItem ~/.pi/agent/skills -Directory
En pi también puedes invocarlos manualmente con /skill:<nombre> (p. ej. /skill:backend-engineering).
Licencia
MIT — ver LICENSE.