Agent Scripts — скилл
Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
- 7 399 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- `sync-skills` меняет ссылки в `~/.codex` и `~/.claude`, а общий `AGENTS.MD` задает правила для всех ваших задач агента
- В наборе есть скиллы, которые отправляют сообщения, покупают номера и пишут SMS в Twilio, меняют DNS и выкладывают код через Wrangler
- `browser-use` работает в вашем Chrome с открытыми сессиями, а ряд скиллов читает переписку из мессенджеров
Установка
- Работает в
Ручная установка
git clone https://github.com/steipete/agent-scripts.git ~/Projects/agent-scriptsСкрипт `~/Projects/agent-scripts/scripts/sync-skills` строит ссылки на скиллы для Codex и Claude Code и связывает файлы правил агентов. Перед запуском посмотрите, что он изменит. Один скилл можно просто скопировать из `skills/`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `sync-skills` меняет ссылки в `~/.codex` и `~/.claude`, а общий `AGENTS.MD` задает правила для всех ваших задач агента
- В наборе есть скиллы, которые отправляют сообщения, покупают номера и пишут SMS в Twilio, меняют DNS и выкладывают код через Wrangler
- `browser-use` работает в вашем Chrome с открытыми сессиями, а ряд скиллов читает переписку из мессенджеров
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Scripts — рабочий репозиторий автора, из которого он раздает одинаковые настройки своим агентам Codex и Claude Code на разных компьютерах. В нем три части: файл `AGENTS.MD` с жесткими правилами, папка `skills/` с готовыми скиллами и несколько вспомогательных скриптов. Скрипт `scripts/sync-skills` собирает на машине зеркало скиллов. Для Codex он создает ссылку на всю папку в `~/.codex/skills`, для Claude Code делает по ссылке на каждый скилл в `~/.claude/skills`, потому что тот читает только один уровень вложенности. Он же связывает `~/.codex/AGENTS.md`, `~/.claude/CLAUDE.md` и `~/.claude/AGENTS.md` с общим `AGENTS.MD`, не затирая настоящие файлы. Скрипт `scripts/validate-skills` проверяет заголовки в каждом `SKILL.md`. Скиллы описаны в `skills.sh.json` по группам: рабочие процессы агентов, GitHub и OpenClaw, Apple и нативные приложения, инструменты и сервисы. Среди них `browser-use` управляет вашим Chrome с открытыми сессиями, `markdown-converter` переводит PDF, Office, HTML и аудио в Markdown, `create-cli` помогает продумать команды и флаги, `oracle` запрашивает второе мнение у другой модели, `wrangler` работает с Cloudflare Workers, `video-transcript-downloader` скачивает видео и субтитры через yt-dlp. Помощник `scripts/browser-tools.ts` запускает Chrome с профилем и дает команды `nav`, `eval`, `screenshot`, `console` и `network`.
Для кого. Для опытных разработчиков на macOS, которые хотят взять за образец чужую организацию работы с Codex и Claude Code и выбрать из нее отдельные скиллы и приемы.
Подходит, если
- Нужно перевести PDF, документ Word или презентацию в Markdown через `markdown-converter`
- Агенту требуется работа в уже открытом и авторизованном Chrome, и вы готовы к этому доступу
- Вы проектируете консольную утилиту и хотите пройти список: аргументы, флаги, справка, вывод ошибок и пробный запуск
- Нужно скачать видео, звук или субтитры по ссылке через yt-dlp и получить расшифровку
- Вы строите собственную папку скиллов и хотите посмотреть, как автор проверяет заголовки, ссылки и дубли
Не подходит, если
- Нужна готовая, универсальная настройка для команды: репозиторий построен под личные машины автора и его папку `~/Projects`
- Вы работаете на Windows без подготовки: часть скиллов привязана к macOS, Xcode и Sparkle, а для Windows есть только отдельная заметка
- Вам нужен один скилл: проще скопировать его папку, чем запускать `sync-skills`, который перестраивает ссылки в каталогах Codex и Claude Code
- Нельзя, чтобы агент читал переписку и менял DNS, отправлял сообщения или выкладывал код: набор включает скиллы для всего этого, и отключать их придется вручную
Пример запроса к агенту
Переведи этот отчет из PDF в Markdown и сохрани рядом с исходным файломОграничения
Автор называет репозиторий общими инструкциями и помощниками для своих локальных рабочих папок. Скрипт `sync-skills` ждет клон в `~/Projects/agent-scripts`, а рядом еще репозиторий `manager`.
Пятнадцать папок в `skills/` — символические ссылки на соседние репозитории: `autoreview`, `discrawl`, `gog`, `imsg`, `peekaboo`, `wacli` и другие. Без этих репозиториев рядом скиллы не откроются.
Файл `AGENTS.MD` написан под автора: подпись «Peter's Claw» в письмах, учетные записи, имена его компьютеров, порядок выпуска версий. Если связать его с глобальным файлом агента, эти правила применятся ко всем вашим задачам.
Проверки и тесты написаны на Bash и Bun, версия набора 0.12.0. Лицензия MIT.
Как отключить. Уберите из `~/.codex/skills` и `~/.claude/skills` ссылки, которые создал `sync-skills`, и ссылки `~/.codex/AGENTS.md`, `~/.claude/CLAUDE.md`, `~/.claude/AGENTS.md`, если они указывают на `AGENTS.MD` из этого репозитория. Затем удалите клон `~/Projects/agent-scripts`. Скиллы, скопированные вручную, удаляются как обычные папки.
Частые вопросы
Как устроены ссылки для Claude Code и Codex?
Codex сканирует вложенные папки, поэтому получает одну ссылку на всю папку скиллов. Claude Code читает только `~/.claude/skills/<имя>/SKILL.md` на один уровень в глубину, поэтому для него `sync-skills` строит плоский набор ссылок по скиллу. При совпадении имен приоритет у agent-scripts, затем у manager.
Что делает `scripts/validate-skills`?
Проверяет каждый `skills/*/SKILL.md`: есть ли заголовок в формате YAML и обязательные поля `name` и `description`. Скрипт можно включить как локальный хук командой `git config core.hooksPath hooks`.
Для чего нужен `scripts/docs-list.ts`?
Он обходит папку `docs/` и требует в каждом файле поля `summary` и `read_when`. Затем печатает краткие сводки, которые удобно показывать агенту при входе в репозиторий.
Какие команды умеет `browser-tools.ts`?
`start --profile` запускает Chrome с профилем, `nav <url>` открывает страницу, `eval '<js>'` выполняет код, а `screenshot`, `console`, `network`, `search --content` и `inspect` собирают данные со страницы. `kill --all --force` закрывает все запущенные экземпляры.
Как работает `markdown-converter`?
Запускает `uvx --from "markitdown[all]" markitdown` без предварительной установки. Он принимает PDF, Word, PowerPoint, Excel, HTML, CSV, изображения с распознаванием текста, аудио, ZIP, EPub и ссылки YouTube.
Какие правила относятся к выпускам?
В `RELEASING.md` описан выпуск по подписанному тегу с пробным прогоном без публикации. Правила в `AGENTS.MD` требуют отдельной просьбы `release` или `publish`: тег и отправка кода сами по себе выпуском не считаются.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллы110 скиллов для Claude Code и Codex и семь агентов Claude Code: разработка, продукт, UI, диагностика и операции, ставится целиком или набором
Agent Skills от Tech Leads Club
Agent Skills
Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету
Softaworks Agent Toolkit
Softaworks Agent Skills
Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация
Builder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
Два скилла для кодинг-агентов: wtf проверяет проект перед деплоем, better-codex держит агента в рамках при работе с кодом
Dimillian Skills
Skills
Набор из 16 инженерных скиллов для агентов: разработка под Apple, упаковка macOS, производительность React, ревью и рефакторинг кода
Коротко о README
В репозитории лежат общие правила `AGENTS.MD`, скиллы, скрипты и хуки. Подробно разобрано, как `sync-skills` строит ссылки для Codex и Claude Code, как решаются конфликты имен и как чинить вложенные ссылки с флагом `--repair-nested-self-links`. Дальше идут описания помощников, правила синхронизации с другими репозиториями и ссылка на порядок выпуска версий. В репозитории лежат заметки о слэш-командах, параллельной работе, публикации в npm, выпуске Mac-приложений, а также тесты скриптов.
Бейдж для README
Исходный SKILL.md
--- name: markdown-converter description: "Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube." --- # Markdown Converter Convert files to Markdown using `uvx --from "markitdown[all]" markitdown` — no installation required. ## Basic Usage ```bash # Convert to stdout uvx --from "markitdown[all]" markitdown input.pdf # Save to file uvx --from "markitdown[all]" markitdown input.pdf -o output.md uvx --from "markitdown[all]" markitdown input.docx > output.md # From stdin cat input.pdf | uvx --from "markitdown[all]" markitdown ``` ## Supported Formats - **Documents**: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls) - **Web/Data**: HTML, CSV, JSON, XML - **Media**: Images (EXIF + OCR), Audio (EXIF + transcription) - **Other**: ZIP (iterates contents), YouTube URLs, EPub ## Options ```bash -o OUTPUT # Output file -x EXTENSION # Hint file extension (for stdin) -m MIME_TYPE # Hint MIME type -c CHARSET # Hint charset (e.g., UTF-8) -d # Use Azure Document Intelligence -e ENDPOINT # Document Intelligence endpoint --use-plugins # Enable 3rd-party plugins --list-plugins # Show installed plugins ``` ## Examples