Skills Storage Policy

Единая политика хранения и синхронизации skills в DesignCorp.

Каноническое хранилище

• Source of truth: /home/admin/workspace/skills

Runtime путь

• Runtime путь: ~/.codex/skills
• ~/.codex/skills/skill-* должны быть symlink на /home/admin/workspace/skills/skill-*
• Внешние upstream skills могут сохранять upstream name без skill- префикса, если этого требует их SKILL.md и command namespace.
• ~/.codex/skills не является каноническим местом хранения

Публичная документация

• Публичные страницы skills: docs-designcorp/docs/agents/skills
• Индекс skills: docs-designcorp/docs/agents/skills/index.md

Обязательные шаги при обновлении skill

1. Обновить файлы в /home/admin/workspace/skills/skill-<name>/ или upstream-named директории для внешнего skill
2. Проверить symlink в ~/.codex/skills
3. Обновить docs-страницу docs/agents/skills/skill-<name>.md
4. Обновить docs/agents/skills/index.md

Запрещено

• Хранить skill только в ~/.codex/skills
• Держать разные версии skill между workspace и docs

Быстрая валидация

1. Канон существует и содержит последнюю версию
2. Runtime путь указывает на канон
3. В docs есть страница skill и запись в индексе