agent-scripts README

The project's README from github.com/steipete/agent-scripts. As one markdown file: README.md.

Agent Scripts

Shared agent instructions, skills, and small portable helpers for Peter's local workspaces.

This repo is the canonical place for:

Skills

Skills are the main routing layer. Each skills/<name>/SKILL.md has YAML front matter:

---
name: skill-name
description: "Short generic trigger phrase."
---

Rules:

Global discovery is built by scripts/sync-skills (idempotent; run on every Mac after cloning or adding skills):

For the specific legacy topology ~/.claude/skills/NAME/NAME -> ~/.codex/skills/NAME -> ~/.claude/skills/NAME, invoke the sync owner directly with an explicit allowlist:

/absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links --dry-run -- boxd-cli boxd-setup-deploy
/absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links -- boxd-cli boxd-setup-deploy

This mode validates every candidate before unlinking only the extra nested leaves. It preserves the real skill directories, assets, and valid Codex backlinks, and exits before creating roots, building mirrors, pruning, or touching instruction pointers. Names must start with an ASCII letter or digit and contain only letters, digits, ., _, or -; duplicates, missing names, and unknown arguments are rejected. A missing nested leaf is a no-op only with the expected surrounding topology. Redirected/inaccessible roots, unexpected objects or literal targets, and changed directory/link identities cause refusal. Rechecks before each unlink are not atomic concurrency protection; a later error stops the batch and reports removals already completed, without rollback.

The read-only skills/fleet-maintenance/scripts/agent-skill-links-audit.sh reports same-name nested ancestor loops as reason=nested-self-link. This is narrow detection, not an exhaustive graph validator. Its --repair remains a broad sync through ~/Projects/agent-scripts/scripts/sync-skills; it is not the scoped repair above. Run scripts/test-sync-skills for isolated fixture coverage; scripts/test-sync-skills --recurrence-only /absolute/path/to/old-sync-skills runs the unchanged recurrence assertion against an original helper.

Shared personal skills live as real folders in skills/. Public OpenClaw shared skills live in ../agent-skills and are exposed here with tracked relative symlinks. Repo-owned skills stay canonical in their repo and are exposed here the same way, for example:

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

Current symlinked repo-owned skills include birdclaw, discrawl, gog, imsg, slacrawl, wacli, and wacrawl.

Agent Instructions

Shared hard rules live in AGENTS.MD.

Global setup (also maintained by scripts/sync-skills; Claude Code reads CLAUDE.md only, so it links to the shared AGENTS.MD):

Downstream repos should use a pointer-style AGENTS.MD:

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

Repo-specific rules go below that pointer. Do not copy the shared blocks into downstream repos.

Helpers

scripts/sync-skills

scripts/validate-skills

scripts/docs-list.ts

scripts/browser-tools.ts

Syncing

Treat this repo as canonical for shared agent rules and portable helper scripts.

When syncing downstream repos:

For submodules, repeat the pointer check inside each subrepo, push those changes, then bump submodule SHAs in the parent repo.

agent-scripts (steipete/agent-scripts)

Searching Database…

Что это такое?Личный набор инструментов для ИИ-агентов, помогающих с кодом: общие инструкции для агентов, переиспользуемые скиллы рабочих процессов и небольшие переносимые скрипты, которые хранятся в одном каноническом репозитории и синхронизируются в настройки автора для Codex и Claude Code.
Так это инструмент, который я устанавливаю, или репозиторий, который я клонирую и подключаю к своим агентам?Это не приложение — это репозиторий, который вы клонируете и подключаете. scripts/sync-skills создаёт симлинки для конкретной машины, чтобы оба агента находили скиллы и общий AGENTS.MD в этой канонической копии.
Как настроить это на своём компьютере?Склонируйте репозиторий и запускайте scripts/sync-skills на каждом Mac после клонирования или добавления скиллов. Скрипт проставляет ссылки на скиллы в каталог skills каждого агента и указывает обоим агентам на общий AGENTS.MD; он идемпотентен и печатает только изменения.
С какими агентами для кодинга это вообще работает?С Codex и Claude Code. Codex сканирует вложенные каталоги, поэтому получает ссылки на весь корень; Claude Code читает только один уровень в ~/.claude/skills, поэтому sync строит для него плоское зеркало — по одной папке на скилл.
А если у меня уже есть свои скиллы или файлы, названия которых совпадают?Sync никогда не затирает настоящие файлы, а сообщает о конфликтах. При совпадении имён приоритет такой: agent-scripts > manager > codex-local, и автор предупреждает, что повторные проверки при unlink — это не атомарная защита от параллельного доступа.
У него тысячи звёзд — это для других людей, или это просто личная настройка автора?Прежде всего это личная настройка Питера для его репозиториев, но отдельные части переносимы: AGENTS.MD в стиле указателей, зеркала скиллов для каждого агента и хуки валидации спроектированы так, чтобы их можно было скопировать в любое рабочее окружение.
Что здесь вообще такое скилл?Это папка с файлом SKILL.md, содержащим YAML front matter с обязательным полем name и кратким описанием для маршрутизации. Скиллы лежат в skills/ (некоторые принадлежащие репозиторию открыты через закоммиченные симлинки), а scripts/validate-skills проверяет каждый из них.
Проверки скиллов могут запускаться автоматически?Да. Включите входящий в комплект git-хук командой git config core.hooksPath hooks, и scripts/validate-skills будет проверять корректный YAML front matter, а также обязательные поля name и description в каждом SKILL.md.
Что делает хелпер browser-tools?scripts/browser-tools.ts — это автономный хелпер для Chrome DevTools: запускает браузер с профилем, переходит по страницам, выполняет JS, делает скриншоты, читает консоль и сеть, инспектирует элементы, убивает запущенные экземпляры. Его также можно собрать в один бинарник с помощью bun build.
Как дочерние репозитории остаются в курсе этих правил?Они держат AGENTS.MD в стиле указателя со ссылкой на этот репозиторий, размещают свои правила ниже указателя и никогда не копируют общие блоки в себя. Изменения в хелперах копируются между репозиториями только когда они должны оставаться побайтово идентичными.
Creator
steipete
Size
2.4 MB
Stars
7.4K
Age
11mo
Commits · 90 Days