エージェントの指示やスキル、そしてピーターのローカル作業スペースのための小型携帯補助者を共有していた。

このリポジトリは以下の公式な場所です:

• AGENTS.MD:Codex/Claudeスタイルのエージェントに関する共有ハードルール
• skills/:再利用可能なワークフロースキル(シンムリンクで公開されたリポジトリ所有スキルを含む)
• 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 Codeは「~/.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