steipete/agent-scripts

Scripts pour agents, partagés entre mes dépôts.

Qu'est-ce que agent-scripts ?

Ce dépôt centralise les instructions, compétences et scripts portables pour les agents IA, spécialement conçus pour les environnements Claude Code et Codex. Il fournit une structure organisée avec un fichier `AGENTS.MD` contenant les règles dures partagées, un dossier `skills/` pour des compétences réutilisables (avec front matter YAML), et des scripts utilitaires sans dépendances externes dans `scripts/`. Le mécanisme de synchronisation `scripts/sync-skills` crée des liens symboliques pour que les agents puissent accéder aux compétences de manière cohérente sur plusieurs dépôts et machines, tout en gérant les collisions de noms et en nettoyant les liens obsolètes. Ce système est utile pour maintenir un ensemble de règles et d'outils partagés entre projets personnels et publics, garantissant ainsi une expérience homogène pour les agents IA.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Agent Scripts

Instructions d'agent partagées, compétences et petits utilitaires portables pour les espaces de travail locaux de Peter.

Ce dépôt est l'endroit canonique pour :

  • AGENTS.MD : règles dures partagées pour les agents de type Codex/Claude
  • skills/ : compétences de workflow réutilisables, y compris les compétences appartenant au dépôt exposées par lien symbolique
  • scripts/ : utilitaires légers en dépendances utilisés dans tous les projets
  • hooks/ : garde-fous locaux tels que la validation des compétences

Compétences

Les compétences constituent la couche de routage principale. Chaque skills/<nom>/SKILL.md possède un front matter YAML :

---
name: nom-de-la-competence
description: "Courte phrase de déclenchement générique."
---

Règles :

  • Gardez les descriptions courtes et génériques ; optimisez pour le routage, pas la documentation.
  • Gardez les corps de compétences concis et opérationnels.
  • Préférez les scripts d'aide sous skills/<nom>/scripts/ lorsqu'un workflow a des commandes répétables.
  • Validez après modifications : scripts/validate-skills.
  • Mettez description entre guillemets dans le front matter.

La découverte globale est construite par scripts/sync-skills (idempotent ; exécuté sur chaque Mac après clonage ou ajout de compétences) :

  • Codex scanne les répertoires imbriqués, il reçoit donc des liens racine entière : ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
  • Claude Code charge seulement ~/.claude/skills/<nom>/SKILL.md (exactement un niveau de profondeur ; les liens symboliques par entrée sont suivis, les sous-dossiers de catégorie ne sont pas scannés — vérifié sur la version 2.1.197). Il reçoit un miroir plat de liens par compétence couvrant les deux dépôts plus les extras locaux à la machine ~/.codex/skills/<nom>.
  • Les collisions de noms se résolvent dans l'ordre agent-scripts > manager > codex-local ; le script affiche les doublons ignorés et supprime les liens gérés cassés/obsolètes.

Les compétences personnelles partagées vivent comme de vrais dossiers dans skills/. Les compétences partagées publiques d'OpenClaw vivent dans ../agent-skills et sont exposées ici avec des liens symboliques relatifs suivis. Les compétences appartenant au dépôt restent canoniques dans leur dépôt et sont exposées ici de la même manière, par exemple :

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

Les compétences actuelles appartenant au dépôt liées par symbole incluent birdclaw, discrawl, gog, imsg, slacrawl, wacli, et wacrawl.

Instructions pour l'Agent

Les règles dures partagées vivent dans AGENTS.MD.

Configuration globale (également maintenue par scripts/sync-skills ; Claude Code lit uniquement CLAUDE.md, donc il crée un lien vers le fichier partagé AGENTS.MD) :

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

Les dépôts en aval doivent utiliser un AGENTS.MD de style pointeur :

READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).

Les règles spécifiques au dépôt vont en dessous de ce pointeur. Ne copiez pas les blocs partagés dans les dépôts en aval.

Utilitaires

scripts/committer

  • Place exactement les fichiers listés.
  • Exige un message de commit non vide.
  • Exécute la validation des compétences avant de commit.

scripts/sync-skills

  • Construit le miroir de compétences par machine : liens racine entière pour Codex, liens plats par compétence pour Claude, pointeurs partagés AGENTS.MD.
  • Idempotent ; affiche uniquement les changements, supprime les liens gérés cassés/obsolètes, n'écrase jamais les vrais fichiers.

scripts/validate-skills

  • Vérifie chaque skills/*/SKILL.md.
  • Valide le front matter YAML ainsi que les champs obligatoires name et description.
  • Activez comme hook local avec git config core.hooksPath hooks.

scripts/docs-list.ts

  • Parcourt docs/.
  • Exige les champs summary et read_when dans le front matter.
  • Affiche des résumés d'intégration pour les dépôts qui l'intègrent.

scripts/browser-tools.ts

  • Utilitaire Chrome DevTools autonome.
  • Commandes courantes : start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<query>", content <url>, inspect, kill --all --force.
  • Construisez un binaire optionnel avec bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.

Synchronisation

Considérez ce dépôt comme canonique pour les règles d'agent partagées et les scripts portables.

Lors de la synchronisation de dépôts en aval :

  • Récupérez d'abord la dernière version ici.
  • Assurez-vous que chaque dépôt cible commence par le AGENTS.MD de style pointeur.
  • Conservez les règles locales au dépôt en dessous du pointeur.
  • Copiez les modifications des utilitaires dans les deux directions uniquement lorsque l'utilitaire est destiné à rester identique octet par octet.
  • Gardez les scripts sans dépendances et portables ; pas d'imports ou d'alias de chemins spécifiques au dépôt.

Pour les sous-modules, répétez la vérification du pointeur à l'intérieur de chaque sous-dépôt, poussez ces modifications, puis mettez à jour les SHA des sous-modules dans le dépôt parent.

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 associés