agent-scripts

What it is

Agent Scripts is a collection of shared agent instructions, skills, and portable helpers intended for Peter's local workspaces. It defines canonical locations for:

• AGENTS.MD: shared hard rules for Codex/Claude-style agents
• skills/: reusable workflow skills and repo-owned skills exposed via symlinks
• scripts/: dependency-light helpers used across projects
• hooks/: local guardrails such as skill validation

How it works

• Skills are defined in skills/<name>/SKILL.md with YAML front matter containing name and description.
• Global discovery is performed by scripts/sync-skills, which creates idempotent links to skills across Codex, Claude, and local mirrors.
• Shared rules reside in AGENTS.MD, referenced via pointers in downstream repos (e.g., ~/.codex/AGENTS.md, ~/.claude/CLAUDE.md).
• Helpers include scripts/committer, scripts/sync-skills, scripts/validate-skills, scripts/docs-list.ts, and scripts/browser-tools.ts, each with described behavior and commands.
• Symlinks expose repo-owned skills (e.g., birdclaw, discrawl, gog, imsg, slacrawl, wacli, wacrawl) to other locations.

Getting started

• Global setup maps AGENTS.md into Codex/Claude environments:
  • ~/.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 repos should start with the pointer-style AGENTS.MD and then apply repo-specific rules below.
• Scripts include commands and behavior, such as:
  • scripts/committer stages exactly the listed files and enforces a non-empty commit message, running skill validation before committing.
  • scripts/sync-skills builds per-machine skill mirror and is idempotent; prints changes only and prunes broken links.
  • scripts/validate-skills checks every skills/*/SKILL.md for YAML front matter and required fields; can be enabled as a local git hook.
  • scripts/browser-tools.ts provides a standalone Chrome DevTools helper with commands like start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<query>", content <url>, inspect, kill --all --force; can be built to a binary with bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.

Recent releases

• Latest release: 0.12.0 Agent Scripts 0.12.0 (2026-07-17)
  • Highlights: Turned maintainer-orchestrator into a long-running control plane for autonomous queue triage, proof-driven changes, dependency maintenance, and release proposals across Peter's rep.

Traction

• Stars: 6503
• Forks: 542
• Open issues: 0

Behind the repo

• The repository is centered on agent scripts and shared rules; symlinkedSkills include repo-owned skills such as birdclaw, discrawl, gog, imsg, slacrawl, wacli, and wacrawl.

Caveats

• Language: Shell
• License: MIT
• Created: 2025-11-08
• Last push: 2026-08-03
• Tags/topics: ai-agents
• Releases indicate maintenance of a central agent rules and skill system; usage depends on downstream integration with Codex/Claude ecosystems and local workspace setup.