steipete/agent-scripts

Scripts for agents, shared between my repositories.

What it solves

This project provides a centralized system for managing shared instructions, reusable skills, and portable helper scripts for AI agents (specifically tailored for Codex and Claude Code). It eliminates the need to manually copy rules and skills across multiple local workspaces and repositories, ensuring that agent behavior remains consistent across different projects.

How it works

The system uses a combination of shared files and symlinks to distribute instructions and skills:

  • Shared Instructions: A central AGENTS.MD file contains global hard rules. Other repositories point to this file via a pointer-style AGENTS.MD to avoid duplication.
  • Skills Routing: Skills are defined in SKILL.md files with YAML front matter for routing. A synchronization script (scripts/sync-skills) creates the necessary mirrors for different agents: whole-root links for Codex and flat per-skill links for Claude Code.
  • Portable Helpers: Dependency-light scripts are stored in scripts/ and hooks/ to provide common functionality and agent guardrails, such as skill validation.

Who it’s for

Developers who use AI agents like Claude Code or Codex across multiple local projects and want a centralized way to manage their agent's "knowledge base" of skills and instructions.

Highlights

  • Multi-Agent Support: Specifically handles the different directory structures required by Codex and Claude Code.
  • Idempotent Syncing: The sync-skills script prunes stale links and avoids clobbering real files.
  • Skill Validation: Includes a validate-skills script to be used as a git hook to ensure skill definitions are correct.
  • Browser Tooling: Includes a standalone Chrome DevTools helper for agent-driven browser automation.

Related

  • Project
    openclaw/agent-skills

    A centralized library of shared workflows and helper scripts for AI coding agents to ensure consistent behavior across multiple repositories.

  • Project
    amd/skills

    A catalog of standardized skills for AI coding agents that provide the specialized knowledge and scripts needed to deploy and optimize AI workloads on AMD hardware.

  • Project
    xingkongliang/skills-manager

    A centralized manager for AI agent skills that allows users to install, organize, and sync capabilities across multiple AI coding tools and devices.

  • Project
    runkids/skillshare

    A centralized management tool that synchronizes AI CLI skills, agents, and rules across multiple AI tools from a single source of truth.

  • Project
    KKKKhazix/khazix-skills

    A collection of standardized AI agent skills (instruction sets) for goal definition, disk cleanup, deep research, and project documentation maintenance.