Skip to content

Скиллы в корневые каталоги: skill.json, корневой SKILL.md, README.en.md#268

Merged
lookinway merged 1 commit into
mainfrom
agent-skill-catalogs
Jul 8, 2026
Merged

Скиллы в корневые каталоги: skill.json, корневой SKILL.md, README.en.md#268
lookinway merged 1 commit into
mainfrom
agent-skill-catalogs

Conversation

@lookinway

Copy link
Copy Markdown
Collaborator

Зачем

Мы уже присутствуем на skills.sh (рекурсивный краулер читает skills/*/SKILL.md, есть установки). Но на каталогах, которые сканируют корень репозитория, а не рекурсивно подпапки, нас нет. Проверка их требований показала: единственный документированный шлюз — skill.json (OpenAgentSkill). Остальное — дешёвые точки входа, которые не мешают.

Что сделано

Генератор скиллов (apps/docs/scripts/skills/generate.ts) дополнительно раскладывает в корень репозитория:

  • skill.json — манифест по схеме OpenAgentSkill: name, version (тянется из @pachca/spec), description (EN), category, platforms, author.
  • корневой SKILL.md — переиспользует роутер-скилл, точка входа для простых краулеров.
  • README.en.md — английская версия README для англоязычных категоризаторов, с перекрёстными ссылками RU ↔ EN. Основной README.md остаётся русским.

Описания per-skill намеренно не меняются — они RU-first для рантайм-матчинга у русскоязычных пользователей, и ни один каталог английского description не требует.

Заметки

  • Оба корневых файла генерируются из источника и добавлены в таблицу «не редактировать вручную» в AGENTS.md.
  • turbo build + turbo check зелёные, check-generated-sync (CI=1) — ✓ all generated files match their sources.
  • Рекурсивные реестры (skills.sh, GuildSkills) продолжают читать skills/*/SKILL.md как раньше.

Генератор скиллов раскладывает корневые точки входа для каталогов,
которые сканируют корень репозитория, а не рекурсивно skills/<name>/:
- skill.json — манифест по схеме OpenAgentSkill (name, version,
  description, category, platforms, author)
- корневой SKILL.md — дублирует роутер-скилл для простых краулеров
- README.en.md — английская версия README для англоязычных категоризаторов,
  плюс перекрёстные ссылки между RU и EN

Рекурсивные реестры (skills.sh, GuildSkills) уже читают skills/*/SKILL.md.
Оба корневых файла генерируются из источника, добавлены в таблицу
'не редактировать вручную' в AGENTS.md.
@cursor

cursor Bot commented Jul 8, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@lookinway
lookinway merged commit f8f19cf into main Jul 8, 2026
7 checks passed
@lookinway
lookinway deleted the agent-skill-catalogs branch July 8, 2026 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant