CommunityCodierung & Entwicklunggithub.com

steipete/agent-scripts

Skripte für Agenten, geteilt zwischen meinen Repositories.

Was ist agent-scripts?

Dieses Repository stellt zentrale Agenten-Anweisungen, wiederverwendbare Skills und portable Helfer-Skripte bereit, die in verschiedenen lokalen Arbeitsbereichen und Projekten genutzt werden. Es dient als kanonischer Ort für geteilte hartkodierte Regeln (AGENTS.MD), wiederverwendbare Workflow-Skills und abhängigkeitsarme Helfer. Die Skill-Verwaltung optimiert die Routing-Erkennung für Agenten wie Claude Code und Codex, indem sie YAML-Frontmatter und ein globales Verknüpfungssystem (über sync-skills) nutzt, um Duplikate zu vermeiden und veraltete Symlinks zu bereinigen. Zusätzlich bietet es Skripte für das automatische Validieren von Skills, das Bühnen von Änderungen und ein eigenständiges Browser-Tool zur Chrome-Entwicklung. Das Repository ist so konzipiert, dass es über mehrere Repositories hinweg synchronisiert werden kann, wobei kanonische Regeln und portierbare Skripte im Vordergrund stehen und gleichzeitig projektspezifische Anpassungen unterhalb von Zeiger-AGENTS.MD-Dateien erhalten bleiben.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Agent-Skripte

Geteilte Agenten-Anweisungen, Skills und kleine portable Helfer für Peters lokale Arbeitsbereiche.

Dieses Repository ist der kanonische Ort für:

  • AGENTS.MD: Geteilte feste Regeln für Codex/Claude-ähnliche Agenten
  • skills/: Wiederverwendbare Workflow-Skills, einschließlich repositoriumseigener Skills, die per Symlink bereitgestellt werden
  • scripts/: Abhängigkeitsarme Helfer, die projektübergreifend verwendet werden
  • hooks/: Lokale Schutzmechanismen wie Skill-Validierung

Skills

Skills sind die primäre Routing-Ebene. Jede skills/<name>/SKILL.md hat YAML-Frontmatter:

---
name: skill-name
description: "Kurze generische Trigger-Phrase."
---

Regeln:

  • Beschreibungen kurz und generisch halten; für Routing optimieren, nicht für Dokumentation.
  • Skill-Körper prägnant und operativ halten.
  • Bei wiederholbaren Befehlen in Workflows bevorzugt Helfer-Skripte unter skills/<name>/scripts/ verwenden.
  • Nach Bearbeitungen validieren: scripts/validate-skills.
  • description im Frontmatter in Anführungszeichen setzen.

Die globale Erkennung wird von scripts/sync-skills aufgebaut (idempotent; wird auf jedem Mac nach dem Klonen oder Hinzufügen von Skills ausgeführt):

  • Codex scannt verschachtelte Verzeichnisse, daher erhält es Wurzelverknüpfungen: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
  • Claude Code lädt nur ~/.claude/skills/<name>/SKILL.md (genau eine Ebene tief; pro Eintrag werden Symlinks gefolgt, Kategorie-Unterordner werden nicht gescannt – bestätigt auf 2.1.197). Es erhält ein flaches, pro Skill verknüpftes Spiegelbild, das beide Repositories sowie maschinenlokale ~/.codex/skills/<name>-Extras abdeckt.
  • Namenskonflikte lösen sich auf in der Reihenfolge agent-scripts > manager > codex-local; das Skript gibt übersprungene Duplikate aus und entfernt defekte/veraltete verwaltete Verknüpfungen.

Geteilte persönliche Skills leben als echte Ordner in skills/. Öffentliche OpenClaw-Community-Skills leben in ../agent-skills und werden hier mit getrackten relativen Symlinks bereitgestellt. Repositoriumseigene Skills bleiben kanonisch in ihrem Repository und werden hier auf die gleiche Weise bereitgestellt, zum Beispiel:

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

Aktuelle per Symlink verknüpfte repositoriumseigene Skills sind birdclaw, discrawl, gog, imsg, slacrawl, wacli und wacrawl.

Agenten-Anweisungen

Geteilte feste Regeln leben in AGENTS.MD.

Globale Einrichtung (ebenfalls von scripts/sync-skills gewartet; Claude Code liest nur CLAUDE.md, daher wird auf die gemeinsame AGENTS.MD verlinkt):

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

Downstream-Repositories sollten eine Zeiger-AGENTS.MD verwenden:

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

Repositoriumsspezifische Regeln stehen unterhalb dieses Zeigers. Kopieren Sie die gemeinsamen Blöcke nicht in Downstream-Repositories.

Helfer

scripts/committer

  • Staged genau die aufgelisteten Dateien.
  • Erzwingt eine nicht leere Commit-Nachricht.
  • Führt vor dem Commit die Skill-Validierung aus.

scripts/sync-skills

  • Erstellt das maschinenspezifische Skill-Spiegelbild: Codex-Wurzelverknüpfungen, Claude-flache-Pro-Skill-Verknüpfungen, gemeinsame AGENTS.MD-Zeiger.
  • Idempotent; gibt nur Änderungen aus, entfernt defekte/veraltete verwaltete Verknüpfungen, überschreibt niemals echte Dateien.

scripts/validate-skills

  • Überprüft jede skills/*/SKILL.md.
  • Validiert YAML-Frontmatter sowie die erforderlichen Felder name und description.
  • Als lokaler Hook aktivieren mit git config core.hooksPath hooks.

scripts/docs-list.ts

  • Durchläuft docs/.
  • Erzwingt summary- und read_when-Frontmatter.
  • Gibt Onboarding-Zusammenfassungen für Repositories aus, die es eingebunden haben.

scripts/browser-tools.ts

  • Eigenständiger Chrome DevTools-Helfer.
  • Häufige Befehle: start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<query>", content <url>, inspect, kill --all --force.
  • Optionale Binärdatei erstellen mit bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.

Synchronisierung

Behandeln Sie dieses Repository als kanonisch für gemeinsame Agentenregeln und portable Helfer-Skripte.

Beim Synchronisieren von Downstream-Repositories:

  • Zuerst hier die neueste Version ziehen.
  • Sicherstellen, dass jedes Ziel-Repository mit der Zeiger-AGENTS.MD beginnt.
  • Repositoriumslokale Regeln unterhalb des Zeigers erhalten.
  • Helfer-Änderungen nur dann in beide Richtungen kopieren, wenn der Helfer byte-identisch bleiben soll.
  • Skripte abhängigkeitsfrei und portabel halten; keine repositoriumsspezifischen Importe oder Pfad-Alias.

Für Submodule den Zeiger-Check innerhalb jedes Subrepos wiederholen, diese Änderungen pushen und dann die Submodule-SHA im Eltern-Repository aktualisieren.

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.

Verwandte Skills