Agents Workflow Template Canonical source for shared agent skills and global instructions used by Claude/Codex style setups. Repo specific operating notes live in AGENTS.md . What this repo manages Skills under skills/ / ( SKILL.md plus optional references/ ) Domain workflows under workflows/ (loaded on trigger, not always in context) Global instruction source at instructions/global.md Sync tooling in bin/ ( sync.sh ) Skills metadata validation in bin/build agents index.py Repository layout [安装/使用命令见下方] Quick start [安装/使用命令见下方] If this repo is not at /.agents , set: [安装/使用命令见下方] Sync behavior bin/sync.sh performs hard sync from this repo to: /.agents/skills/ /.agents/workflows/ /.agents/AGENTS.md (from instructions/global.md ) Sync runs build agents index.py metadata validation before copy. Metadata validation Run when you need to check skill metadata locally: python3 bin/build agents index.py (source validation) Creating or updating a skill 1. Create/update skills/ /SKILL.md . 2. Keep SKILL.md concise; place longer material in skills/ /references/ . 3. Validate: [安装/使用命令见下方] 4. Sync: [安装/使用命令见下方] Useful commands [安装/使用命令见下方] Devcontainer rollout note ./bin/sync.sh only syncs skills, workflows, and global instructions. It does not roll out devcontainer template changes. For devcontainer template rollout: 1. Update files under devcontainer/ in this repo 2. Run ./devcontainer/install.sh self install 3. In target repo: devc install . 4. Rebuild container: devc rebuild .