Open-source collection of reusable agent skills, shared AGENTS.MD rules, and portable helper scripts for Codex and Claude agents, by steipete.
What it does
Agent Scripts is an open-source repo by Peter Steinberger that centralizes shared agent rules, reusable workflow skills, and portable helper scripts for Codex/Claude-style agents across multiple projects. Skills are SKILL.md files with YAML front matter that agents use as a routing layer to trigger
Every agent-heavy workflow eventually spawns the same problem: rules and skills scatter across repos, drift out of sync, and break silently. Agent Scripts solves this by making one repo the canonical source for shared agent instructions, skills, and helpers, symlinked everywhere rather than copied.
The repo organizes four things: AGENTS.MD (hard rules loaded before any task), skills/ (routing-layer workflow definitions), scripts/ (portable, dependency-light helpers), and hooks/ (local guardrails like pre-commit skill validation). Downstream repos point to this one with a single pointer line and add only their local overrides below it.
Each skill is a directory under skills/ containing a SKILL.md file with YAML front matter. The required fields are name and description. The description is the routing signal: agents match it against the current task and load the full instructions only when they decide to use the skill, a pattern the README calls progressive disclosure. Shared personal skills live as real folders; skills from external repos (such as discrawl, birdclaw, slacrawl) are exposed via tracked relative symlinks so the canonical copy stays in its home repo.
The helper scripts do real work. scripts/committer stages exactly the files you list, rejects empty commit messages, and runs skill validation before writing the commit. scripts/validate-skills checks every skills/*/SKILL.md for valid YAML front matter and required fields, and can run as a git hook via git config core.hooksPath hooks. scripts/browser-tools.ts is a standalone Chrome DevTools helper that covers navigation, evaluation, screenshots, network inspection, and content search; it compiles to a self-contained binary with Bun.
This repo is built around one person's local workspace conventions (symlinking into ~/Projects/agent-scripts). Adopting it as-is means accepting those path conventions or adapting them. The README is explicit: keep scripts dependency-free and portable, and never add repo-specific imports or path aliases.
Agent Scripts is the reference implementation for how a single developer (or a small team) can maintain one authoritative set of agent rules and skills and propagate them cleanly across every project via symlinks and pointer-style AGENTS.MD files. For anyone running multiple Codex or Claude agent setups, it is the most concrete, working example of that pattern available in the open.
Features
Field notes
Reviewed Jun 26, 2026
Best for
Builder outcomes
Watch out
Tested with
Agent Scripts is an open-source GitHub repository by Peter Steinberger that centralizes shared agent instructions, reusable workflow skills, and portable helper scripts for Codex and Claude-style agents. It is designed to be the canonical source for a developer's agent setup, symlinked into every downstream project rather than copied. The repo is MIT licensed and written in Shell, JavaScript, Python, and TypeScript.
Clone the repo to ~/Projects/agent-scripts, then create symlinks from ~/.codex/skills and ~/.claude/skills pointing to the skills/ directory, and symlink ~/.claude/CLAUDE.md and ~/.claude/AGENTS.md to AGENTS.MD in the repo. In each downstream project, add a pointer-style AGENTS.MD that reads 'READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing)' and place any repo-specific rules below that line. You can enable pre-commit skill validation by running 'git config core.hooksPath hooks' in the repo.
Yes, Agent Scripts is released under the MIT license, which allows use, modification, and redistribution with minimal restrictions. There is no hosted service, subscription, or paid tier; everything runs locally on your machine.
Agent Scripts is best for developers who run Codex or Claude agents across several repos and want a single, validated source of agent rules and workflow skills rather than duplicating them in each project. The symlink architecture means a fix or new skill in one place propagates everywhere instantly. The included helpers (committer, validate-skills, browser-tools.ts) make it useful as a lightweight local automation layer alongside any agentic workflow.
Most agent setups either hard-code rules per repo or rely on a hosted platform's skill marketplace. Agent Scripts takes a middle path: a local, file-based, symlink-propagated system that works with both Codex and Claude without requiring any hosted service. The open agent skills standard (also used by Codex and the Microsoft Agent Framework) defines the same SKILL.md format, so skills authored here are portable to any compatible agent runtime. The tradeoff versus a hosted registry is full local control at the cost of manual distribution.
The repo's path conventions assume a ~/Projects/agent-scripts clone location; teams on different layouts must adapt the symlinks manually. Skill distribution is entirely manual, there is no package manager or registry, so sharing skills beyond your own machines means contributors must clone and re-link themselves. The browser-tools.ts script requires Bun to compile to a binary. Very large skill sets may hit context-window limits in agent runtimes that cap the initial skills listing (per the Codex docs, at most 2% of the model context window or 8,000 characters).
Mitchell Hashimoto@mitchellh
“@domenkozar Yes, the agents md says to never create an issue or PR, but if the human forces you to, to put a sentinel file in place. I think its doing what you want. I utilize this agents.md all the time and Codex and Claude both always tel…”
zryph@fcb_cartel
“@steipete agent-scripts is an absolute gold!”
Anthropic's official skill library for Claude: modular SKILL.md bundles that add repeatable, domain-specific workflows across docs, dev, design, and enterprise tasks.
Best for Teams who need Claude to follow repeatable, specialized workflows across many sessions without re-promptingAgent skill collection for engineers who use Claude Code or Codex, small, composable prompts that enforce TDD, domain modeling, and architecture review.
Best for Engineers already using Claude Code or Codex daily who want to stop architectural and quality driftOpen-source agentic skills framework that brings spec-first, TDD-enforced, subagent-driven software development to Claude Code, Cursor, Codex, and 8 other AI coding harnesses.
Best for Teams wanting a full SDLC enforced automatically on coding agents, from spec through code reviewAgent skill that audits your codebase with a capable model and writes executable plans for cheaper models to implement, by shadcn.
Best for Teams running AI-assisted development at scale who want high-quality code review without paying for a capable model on every execution stepA catalog of repeatable AI agent workflows with built-in feedback loops, plus an installable skill for finding, adapting, and designing your own loops.
Best for Teams using Codex, Cursor, or Claude Code who want agents to iterate reliably instead of making one-shot guessesOpen-source collection of 45+ AI agent skills for marketing, CRO, SEO, copywriting, analytics, and growth, built for Claude Code, Cursor, and any Agent Skills-compatible agent.
Best for Technical marketers and founders using Claude Code, Cursor, Windsurf, or OpenAI Codex who want marketing domain knowledge baked in