Общие инструкции, навыки и небольшие переносные помощники для местных рабочих мест Питера.

Это репозитория является каноническим местом для:

• AGENTS.MD: общие жёсткие правила для агентов в стиле Codex/Claude
• skills/: многократно используемые навыки рабочего процесса, включая навыки, принадлежащие репозиториям, раскрываемые через symlink
• scripts/: вспомогательные индикаторы зависимости, используемые в разных проектах
• hooks/: локальные ограничения, такие как валидация навыков

Навыки

Навыки — это основной слой маршрутизации. Каждый skills/ /SKILL.md содержит YAML-фронт:

Правила:

• Делать описания краткими и обобщёнными; оптимизировать для маршрутизации, а не для документации.
• Поддерживайте структуры навыков лаконичными и оперативными.
• Предпочитайте вспомогательные скрипты в skills/ /scripts/, когда в рабочем процессе есть повторяемые команды.
• Валидация после правок: scripts/validate-skills.
• Цитата description в начале материала.

Глобальное обнаружение строится с помощью scripts/sync-skills (идемпотентного; запускается на каждом Mac после клонирования или добавления навыков):

• Codex сканирует вложенные директора, получая целые корневые ссылки: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
• Код Клода загружает только '~/.claude/skills/ /SKILL.

Agent Scripts

Shared agent instructions, skills, and small portable helpers for Peter’s local workspaces.

This repo is the canonical place for:

• AGENTS.MD: shared hard rules for Codex/Claude-style agents
• skills/: reusable workflow skills, including repo-owned skills exposed by symlink
• scripts/: dependency-light helpers used across projects
• hooks/: local guardrails such as skill validation

Skills

Skills are the main routing layer. Each skills//SKILL.md has YAML front matter:

---
name: skill-name
description: "Short generic trigger phrase."
---

Rules:

• Keep descriptions short and generic; optimize for routing, not documentation.
• Keep skill bodies terse and operational.
• Prefer helper scripts under skills//scripts/ when a workflow has repeatable commands.
• Validate after edits: scripts/validate-skills.
• Quote description in front matter.

Global discovery is built by scripts/sync-skills (idempotent; run on every Mac after cloning or adding skills):

• Codex scans nested dirs, so it gets whole-root links: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
• Claude Code loads only ~/.claude/skills//SKILL.md (exactly one level deep; per-entry symlinks are followed, category subfolders are not scanned — verified on 2.1.197). It gets a flat per-skill link mirror covering both repos plus machine-local ~/.codex/skills/ extras.
• Name collisions resolve agent-scripts > manager > codex-local; the script prints skipped duplicates and prunes broken/stale managed links.
• Real destination files and directories are preserved. A real Claude skill directory with a Codex backlink to that same directory satisfies local ownership; other real destination conflicts are reported and make sync fail.

For the specific legacy topology ~/.claude/skills/NAME/NAME -> ~/.codex/skills/NAME -> ~/.claude/skills/NAME, invoke the sync owner directly with an explicit allowlist:

/absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links --dry-run -- boxd-cli boxd-setup-deploy

/absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links -- boxd-cli boxd-setup-deploy