chore: add developer-documentation skill to catalog

- catalog/developer-documentation-skill: submodule → NateBJones-Projects/developer-documentation-skill (v1.0.1, CC BY 4.0 / MIT)
- README: раскладки репозиториев каталога и ручная установка скиллов
This commit is contained in:
eka
2026-09-23 12:17:57 +05:00
parent 13979a05ed
commit 7e2ea5a275
3 changed files with 30 additions and 2 deletions
+3
View File
@@ -1,3 +1,6 @@
[submodule "catalog/jakubkrehel-skills"]
path = catalog/jakubkrehel-skills
url = https://github.com/jakubkrehel/skills.git
[submodule "catalog/developer-documentation-skill"]
path = catalog/developer-documentation-skill
url = https://github.com/NateBJones-Projects/developer-documentation-skill.git
+26 -2
View File
@@ -7,8 +7,9 @@
```
dev/harness/
├── agents/ # Определения агентов OpenCode (leader, fixer, devops, admin, ...)
├── catalog/ # Скиллы: git submodule'ы на внешние репы
│ └── jakubkrehel-skills/ # submodule → github.com/jakubkrehel/skills (11 скиллов UI)
├── catalog/ # Скиллы: git submodule'ы на внешние репы
│ ├── jakubkrehel-skills/ # → github.com/jakubkrehel/skills (11 скиллов UI)
│ └── developer-documentation-skill/ # → NateBJones-Projects/… (доки; ставится вручную)
├── scripts/
│ └── harness # Основной CLI-скрипт
└── README.md
@@ -160,6 +161,29 @@ git commit -m "chore: add user-skills to catalog"
обновит его через `git pull`, но такой каталог не попадёт в коммит репы
(вложенная репа не станет submodule автоматически).
### Раскладка репозитория и ручная установка
CLI `harness` понимает одну раскладку — `<репа>/skills/<name>/SKILL.md`.
Репозитории с другой структурой он показывает как `(no skills/)`, и их скиллы
ставятся вручную. Ограничение только у CLI: сам OpenCode сканирует рекурсивно
(`skills/**/SKILL.md`, а через `skills.paths` — `**/SKILL.md` на любой глубине).
Пример — `developer-documentation-skill` держит `SKILL.md` в корне репы:
```bash
ln -s /mnt/data/Agent/dev/harness/catalog/developer-documentation-skill \
~/.agents/skills/developer-documentation
```
Альтернатива без симлинков — указать в конфиге OpenCode корень каталога:
```json
{ "skills": { "paths": ["/mnt/data/Agent/dev/harness/catalog"] } }
```
Тогда OpenCode найдёт все `SKILL.md` из каталога, в любой раскладке. Минус —
подхватывается всё содержимое разом, включая ненужное.
## Как добавить агента
Положить `.md` файл в `agents/` репозитория — и он сразу виден через `harness list agents`.