Agent Scripts
Instrucciones compartidas para agentes, habilidades y pequeños ayudantes portátiles para los espacios de trabajo locales de Peter.
Este repositorio es el lugar canónico para:
AGENTS.MD: reglas fijas compartidas para agentes estilo Codex/Claudeskills/: habilidades reutilizables del flujo de trabajo, incluyendo habilidades propiedad del repositorio expuestas mediante enlace simbólicoscripts/: ayudantes con dependencias ligeras utilizados en todos los proyectoshooks/: barreras de seguridad locales, como validación de habilidades
Habilidades
Las habilidades son la capa principal de enrutamiento. Cada skills/<nombre>/SKILL.md tiene un front matter YAML:
---
name: nombre-de-habilidad
description: "Frase corta de activación genérica."
---
Reglas:
- Mantén las descripciones cortas y genéricas; optimiza para el enrutamiento, no para la documentación.
- Mantén los cuerpos de las habilidades concisos y operativos.
- Prefiere scripts auxiliares en
skills/<nombre>/scripts/cuando un flujo de trabajo tenga comandos repetibles. - Valida después de editar:
scripts/validate-skills. - Pon entre comillas la
descriptionen el front matter.
El descubrimiento global se construye mediante scripts/sync-skills (idempotente; ejecutar en cada Mac después de clonar o agregar habilidades):
- Codex escanea directorios anidados, por lo que obtiene enlaces de raíz completa:
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills,~/.codex/skills/manager -> ~/Projects/manager/skills. - Claude Code carga solo
~/.claude/skills/<nombre>/SKILL.md(exactamente un nivel de profundidad; se siguen enlaces simbólicos por entrada, las subcarpetas de categoría no se escanean — verificado en 2.1.197). Obtiene un espejo plano de enlaces por habilidad que cubre ambos repositorios más extras locales de la máquina~/.codex/skills/<nombre>. - Las colisiones de nombre se resuelven en el orden: agent-scripts > manager > codex-local; el script imprime duplicados omitidos y poda enlaces gestionados rotos/obsoletos.
Las habilidades personales compartidas viven como carpetas reales en skills/. Las habilidades compartidas públicas de OpenClaw viven en ../agent-skills y se exponen aquí con enlaces simbólicos relativos rastreados. Las habilidades propiedad del repositorio se mantienen canónicas en su repositorio y se exponen aquí de la misma manera, por ejemplo:
skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl
Las habilidades actuales propiedad del repositorio con enlace simbólico incluyen birdclaw, discrawl, gog, imsg, slacrawl, wacli y wacrawl.
Instrucciones para el Agente
Las reglas fijas compartidas viven en AGENTS.MD.
Configuración global (también mantenida por scripts/sync-skills; Claude Code solo lee CLAUDE.md, por lo que enlaza al AGENTS.MD compartido):
~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
Los repositorios descendientes deben usar un AGENTS.MD de tipo puntero:
READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).
Las reglas específicas del repositorio van debajo de ese puntero. No copies los bloques compartidos en los repositorios descendientes.
Ayudantes
scripts/committer
- Prepara exactamente los archivos listados.
- Exige un mensaje de commit no vacío.
- Ejecuta validación de habilidades antes de confirmar.
scripts/sync-skills
- Construye el espejo de habilidades por máquina: enlaces de raíz completa de Codex, enlaces planos por habilidad de Claude, punteros compartidos de
AGENTS.MD. - Idempotente; imprime solo cambios, poda enlaces gestionados rotos/obsoletos, nunca sobrescribe archivos reales.
scripts/validate-skills
- Revisa cada
skills/*/SKILL.md. - Verifica que el front matter YAML tenga los campos requeridos
nameydescription. - Actívalo como un hook local con
git config core.hooksPath hooks.
scripts/docs-list.ts
- Recorre
docs/. - Exige front matter con
summaryyread_when. - Imprime resúmenes de onboarding para los repositorios que lo integren.
scripts/browser-tools.ts
- Ayudante independiente de Chrome DevTools.
- Comandos comunes:
start --profile,nav <url>,eval '<js>',screenshot,console,network,search --content "<query>",content <url>,inspect,kill --all --force. - Construye un binario opcional con
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.
Sincronización
Trata este repositorio como canónico para las reglas compartidas del agente y los scripts auxiliares portátiles.
Al sincronizar repositorios descendientes:
- Primero obtén la última versión aquí.
- Asegúrate de que cada repositorio destino comience con el
AGENTS.MDde tipo puntero. - Conserva las reglas locales del repositorio debajo del puntero.
- Copia los cambios de los ayudantes en ambas direcciones solo cuando el ayudante deba mantenerse idéntico byte a byte.
- Mantén los scripts sin dependencias y portátiles; sin importaciones ni alias de ruta específicos del repositorio.
Para submódulos, repite la verificación del puntero dentro de cada subrepositorio, envía esos cambios y luego actualiza los SHAs del submódulo en el repositorio principal.