Agent Scripts — скилл

Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации

  • 7 399 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • `sync-skills` меняет ссылки в `~/.codex` и `~/.claude`, а общий `AGENTS.MD` задает правила для всех ваших задач агента
  • В наборе есть скиллы, которые отправляют сообщения, покупают номера и пишут SMS в Twilio, меняют DNS и выкладывают код через Wrangler
  • `browser-use` работает в вашем Chrome с открытыми сессиями, а ряд скиллов читает переписку из мессенджеров
Все причины и проверки

steipete/agent-scripts

Установка

Работает в

Ручная установка

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, диагностика и операции, ставится целиком или набором

ПлагинШирокий доступ288Звезды репозитория

Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету

СкиллРасширенный доступ7,1 тыс.Звезды репозитория

Softaworks Agent Toolkit

Softaworks Agent Skills

Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация

ПлагинРасширенный доступ2,6 тыс.Звезды репозитория

Builder Skills

Skills for agents

Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные

СкиллРасширенный доступ4,6 тыс.Звезды репозитория

Два скилла для кодинг-агентов: wtf проверяет проект перед деплоем, better-codex держит агента в рамках при работе с кодом

СкиллРасширенный доступ1,4 тыс.Звезды репозитория

Набор из 16 инженерных скиллов для агентов: разработка под Apple, упаковка macOS, производительность React, ревью и рефакторинг кода

СкиллРасширенный доступ4 тыс.Звезды репозитория

Коротко о 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

Сообщить о проблеме

Foxx AIAgent Scripts
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.