CommunityProgramación y desarrollogithub.com

steipete/agent-scripts

Scripts para agentes, compartidos entre mis repositorios.

¿Qué es agent-scripts?

Este repositorio centraliza las instrucciones, habilidades y scripts auxiliares compartidos para agentes de IA como Claude Code y Codex. Proporciona un mecanismo de enrutamiento basado en habilidades (skills) con SKILL.md, validación automática y enlaces simbólicos para integrar estas habilidades en múltiples entornos de trabajo. El sistema gestiona de forma idempotente la sincronización entre repositorios, evitando colisiones de nombres y manteniendo un espejo plano de habilidades tanto para Codex como para Claude Code. Además, incluye scripts portátiles para validación de habilidades, confirmación de cambios y herramientas de navegación de Chrome, todo diseñado para ser ligero y sin dependencias externas.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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/Claude
  • skills/: habilidades reutilizables del flujo de trabajo, incluyendo habilidades propiedad del repositorio expuestas mediante enlace simbólico
  • scripts/: ayudantes con dependencias ligeras utilizados en todos los proyectos
  • hooks/: 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 description en 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 name y description.
  • Actívalo como un hook local con git config core.hooksPath hooks.

scripts/docs-list.ts

  • Recorre docs/.
  • Exige front matter con summary y read_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.MD de 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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills relacionados