Agentes e Scripts

Scripts compartilhados e instruções para agentes de IA (Codex, Claude Code) em espaços de trabalho locais.

O que é Agentes e Scripts?

Este repositório fornece um conjunto centralizado de instruções, habilidades e scripts auxiliares para agentes de IA como Codex e Claude Code. Ele organiza o roteamento de habilidades através de arquivos `SKILL.md` com front matter YAML, permitindo que agentes descubram e utilizem ferramentas de forma padronizada. O repositório inclui scripts como `sync-skills` para configurar espelhos de habilidades em múltiplos agentes, `validate-skills` para garantir a integridade dos metadados, e `committer` para commits seguros. Também gerencia regras globais (`AGENTS.MD`) que são vinculadas aos diretórios de configuração de cada agente, garantindo que instruções compartilhadas sejam seguidas por todos os projetos downstream. A abordagem é manter as descrições curtas e otimizadas para roteamento, e usar scripts externos para lógica repetitiva, mantendo os corpos das habilidades sucintos e operacionais.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Scripts para Agentes

Instruções compartilhadas para agentes, habilidades e pequenos utilitários portáteis para os espaços de trabalho locais de Peter.

Este repositório é o local canônico para:

  • AGENTS.MD: regras rígidas compartilhadas para agentes estilo Codex/Claude
  • skills/: habilidades de fluxo de trabalho reutilizáveis, incluindo habilidades de propriedade do repositório expostas por symlink
  • scripts/: utilitários leves (sem dependências) usados entre projetos
  • hooks/: barreiras locais, como validação de habilidades

Habilidades

Habilidades são a principal camada de roteamento. Cada skills/<nome>/SKILL.md possui front matter YAML:

---
name: nome-da-habilidade
description: "Frase de gatilho genérica e curta."
---

Regras:

  • Mantenha as descrições curtas e genéricas; otimize para roteamento, não para documentação.
  • Mantenha os corpos das habilidades concisos e operacionais.
  • Prefira scripts auxiliares em skills/<nome>/scripts/ quando um fluxo de trabalho tiver comandos repetitivos.
  • Valide após edições: scripts/validate-skills.
  • Coloque description entre aspas no front matter.

A descoberta global é construída por scripts/sync-skills (idempotente; execute em todo Mac após clonar ou adicionar habilidades):

  • Codex varre diretórios aninhados, então recebe links de raiz inteira: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
  • Claude Code carrega apenas ~/.claude/skills/<nome>/SKILL.md (exatamente um nível de profundidade; symlinks por entrada são seguidos, subpastas de categoria não são varridas — verificado na versão 2.1.197). Ele recebe um espelho de habilidade plana por skill cobrindo ambos os repositórios mais extras ~/.codex/skills/<nome> locais da máquina.
  • Colisões de nome resolvem agent-scripts > manager > codex-local; o script imprime duplicatas ignoradas e remove links gerenciados quebrados/obsoletos.

Habilidades pessoais compartilhadas vivem como pastas reais em skills/. Habilidades compartilhadas públicas do OpenClaw vivem em ../agent-skills e são expostas aqui com symlinks relativos rastreados. Habilidades de propriedade do repositório permanecem canônicas em seu repositório e são expostas aqui da mesma forma, por exemplo:

skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl

Habilidades atuais de propriedade do repositório vinculadas simbolicamente incluem birdclaw, discrawl, gog, imsg, slacrawl, wacli e wacrawl.

Instruções para Agentes

Regras rígidas compartilhadas vivem em AGENTS.MD.

Configuração global (também mantida por scripts/sync-skills; Claude Code lê apenas CLAUDE.md, então ele vincula ao AGENTS.MD compartilhado):

  • ~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD

Repositórios downstream devem usar um AGENTS.MD do tipo ponteiro:

LEIA ~/Projects/agent-scripts/AGENTS.MD ANTES DE QUALQUER COISA (pule se ausente).

Regras específicas do repositório vão abaixo desse ponteiro. Não copie os blocos compartilhados para repositórios downstream.

Auxiliares

scripts/committer

  • Prepara exatamente os arquivos listados. -Exige uma mensagem de commit não vazia.
  • Executa validação de habilidades antes de commitar.

scripts/sync-skills

  • Constrói o espelho de habilidades por máquina: links de raiz inteira para Codex, links planos por habilidade para Claude, ponteiros AGENTS.MD compartilhados.
  • Idempotente; imprime apenas alterações, remove links gerenciados quebrados/obsoletos, nunca sobrescreve arquivos reais.

scripts/validate-skills

  • Verifica cada skills/*/SKILL.md.
  • Verifica front matter YAML mais os campos obrigatórios name e description.
  • Ative como um hook local com git config core.hooksPath hooks.

scripts/docs-list.ts

  • Percorre docs/.
  • Exige front matter com summary e read_when.
  • Imprime resumos de onboarding para repositórios que o integram.

scripts/browser-tools.ts

  • Utilitário independente para Chrome DevTools.
  • Comandos comuns: start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<consulta>", content <url>, inspect, kill --all --force.
  • Compile um binário opcional com bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.

Sincronização

Trate este repositório como canônico para regras compartilhadas de agentes e scripts auxiliares portáteis.

Ao sincronizar repositórios downstream:

  • Atualize este repositório primeiro.
  • Garanta que cada repositório de destino comece com o AGENTS.MD do tipo ponteiro.
  • Preserve as regras locais do repositório abaixo do ponteiro.
  • Copie alterações de auxiliares em ambas as direções apenas quando o auxiliar for destinado a permanecer byte-idêntico.
  • Mantenha os scripts livres de dependências e portáteis; sem imports específicos de repositório ou aliases de caminho.

Para submódulos, repita a verificação do ponteiro dentro de cada sub-repositório, envie essas alterações e então atualize os SHAs dos submódulos no repositório pai.

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.

Habilidades Relacionadas