serge-the-hedge/agent-skills

¿Qué hace agent-skills?

~/Dev/agent-skills contiene todos los skills que uso en mis proyectos: los míos propios y los de terceros sobre los que construyo. agent-skills link llena ~/.claude/skills (Claude Code) y ~/.agents/skills (Codex) con enlaces simbólicos hacia ese repositorio, de modo que un skill editado desde cualquiera de esas carpetas se edita en el repositorio.

Dónde pertenece un skill

• Skill de proyecto (el .agents/skills/ propio de un repositorio, como verify-*): permanece en ese proyecto. El resto de este archivo trata sobre los skills de este repositorio.
• Míos: skills/<nombre>/.
• De terceros: vendor/<origen>/, extraídos de pstack, los skills de Matt Pocock y good-css mediante agent-skills update. upstreams.ts selecciona cuáles de sus skills se enlazan.
• Todo lo que esté en las carpetas de agente que no sea un enlace simbólico al repositorio (blabla-*, synced/ de Claude, .system/ de Codex) pertenece a la herramienta que lo instaló, que también lo actualiza.

realpath ~/.agents/skills/<nombre> te indica a cuál pertenece un skill.

Crear

Crea el skill en ~/Dev/agent-skills/skills/<nombre>/SKILL.md; esa ruta tiene prioridad sobre los valores predeterminados de skill-creator y /automate-me. Luego ejecuta agent-skills link. Si informa de un conflicto, elige otro nombre.

Editar

Decide según el tipo de cambio:

• Una preferencia mía (estilo, valores predeterminados, cómo me gusta trabajar) va en mis propios skills: extiende uno en skills/, o crea uno. Mis archivos nunca entran en conflicto con actualizaciones de terceros.
• Una corrección para algo que un skill de terceros hace mal para mí va directamente en vendor/. Las ediciones locales en upstream sobreviven a agent-skills update, pero cada una puede entrar en conflicto cuando el upstream cambia las mismas líneas, así que mantenlas pequeñas. Después de editar pstack, ejecuta node ~/Dev/agent-skills/vendor/pstack/scripts/check-t3-native.mjs <nombre> hasta que termine con código 0.

Eliminar

Borra skills/<nombre>/ para un skill mío. Para un skill de terceros, pregúntame primero: implica cambiar upstreams.ts.

Finalizar

Terminado cuando agent-skills link tiene éxito y cada cambio es su propio commit en ~/Dev/agent-skills, subido:

• Prepara solo los archivos que cambiaste (git add <rutas>); otros agentes pueden tener trabajo en curso allí.
• Escribe el mensaje indicando por qué cambió el skill.
• Sube justo después de hacer commit.

Escribir

• El repositorio es público, así que escribe cada skill como texto público: ejemplos genéricos, sin nombres, rutas ni secretos de mis proyectos.
• Refiérete a otro skill por su ruta completa, ~/.agents/skills/<nombre>/SKILL.md. Un ../<nombre> relativo aquí no funciona, porque mis skills y cada tercero están en carpetas diferentes.
• Para la escritura en sí, sigue ~/.agents/skills/writing-for-agents/SKILL.md.

Ejecuta agent-skills sin argumentos para ver sus comandos.