Instruction Manager
Orchestrates the synchronization of instruction templates to ensure consistent AI behavior across different platforms and projects.
Overview
The instruction-manager skill provides a unified workflow for maintaining the complex hierarchy of AI instructions used in this environment. It ensures that changes made to core principles in "Master" templates are correctly propagated to platform-specific configuration files.
Workflow: Global Instruction Sync
Use this workflow when you update core behavioral principles in the master template.
- Edit Master Template: Modify
templates/global-instructions/master.md.
- Run Sync Script:
./scripts/update-global-instructions.sh --system=all
--system: gemini, claude, copilot, opencode, or all.--dry-run: Show what would be updated without making changes.
- Verify Changes: Check the target files (e.g.,
gemini/.gemini/GEMINI.md, claude/.claude/CLAUDE.md) to ensure the sync was successful.
SECTION Syntax (Inclusion/Exclusion)
Use SECTION markers to include/exclude content for specific systems:
<!-- SECTION:name:START:system1,system2 -->
Content for system1 and system2 only
<!-- SECTION:name:END -->
<!-- SECTION:name:START:!copilot -->
Content for all systems EXCEPT copilot
<!-- SECTION:name:END -->
- Include list:
copilot,claude — only those systems see this block
- Exclude prefix:
!copilot — all systems EXCEPT copilot see this block
Works in both global instructions (templates/global-instructions/master.md) and subagent masters (templates/subagents/master/*.md).
Workflow: Project Initialization
Use this workflow when starting a new project or updating instructions for an existing one.
- Generate Instructions:
./scripts/generate-project-instructions.sh [path/to/project]
- Update Existing:
./scripts/generate-project-instructions.sh --update --force --set-technologies="React, TypeScript" .
- This generates
.claude/CLAUDE.md, .gemini/GEMINI.md, and AGENTS.md based on templates/PROJECT_INSTRUCTIONS.template.md.
Workflow: Sub-Agent Management
Use this workflow when modifying specialized sub-agent (Planner, Reviewer, etc.) behaviors.
- Edit Agent Master: Modify files in
templates/subagents/master/ (e.g., planner.md). Use SECTION markers for platform-specific content.
- Sync Agents:
./scripts/update-subagents.sh --agent=all --system=all
--agent: planner, reviewer, implementer, coordinator, prompt-creator, or all.--system: copilot, opencode, claude, or all.--dry-run: Show what would be updated without making changes.
- Validate Sync:
./scripts/validate-subagents.sh
Reference: Instruction Hierarchy
| Level |
Source of Truth |
Target Files |
Script |
| Global |
templates/global-instructions/master.md |
gemini/.gemini/GEMINI.md, etc. |
update-global-instructions.sh |
| Project |
templates/PROJECT_INSTRUCTIONS.template.md |
.claude/CLAUDE.md, AGENTS.md, etc. |
generate-project-instructions.sh |
| Sub-Agents |
templates/subagents/master/*.md |
claude/.claude/agents/*.md, etc. |
update-subagents.sh |
Resources
scripts/
The skill leverages the following root-level scripts:
update-global-instructions.sh: Syncs global master to platform headers.generate-project-instructions.sh: Scaffolds project-specific context.update-subagents.sh: Populates sub-agent instruction files.validate-subagents.sh: Checks consistency between agent platforms.
references/
templates/global-instructions/metadata.json: Defines target paths and header requirements for each tool.templates/subagents/master/METADATA.json: Defines agent names, descriptions, and platform-specific overrides.
1---2name: instruction-manager3description: Manages and synchronizes AI instructions (global and project-level) across various tools (Gemini, Claude, Copilot, etc.). Use this skill when you need to: (1) Sync `templates/global-instructions/master.md` to all tool headers, (2) Generate or update `PROJECT_INSTRUCTIONS.md` in a directory, (3) Update sub-agent instructions, or (4) Maintain consistency in AI behavioral guidelines.4---5
6# Instruction Manager
7
8Orchestrates the synchronization of instruction templates to ensure consistent AI behavior across different platforms and projects.
9
10## Overview
11
12The `instruction-manager` skill provides a unified workflow for maintaining the complex hierarchy of AI instructions used in this environment. It ensures that changes made to core principles in "Master" templates are correctly propagated to platform-specific configuration files.
13
14## Workflow: Global Instruction Sync
15
16Use this workflow when you update core behavioral principles in the master template.
17
181. **Edit Master Template**: Modify `templates/global-instructions/master.md`.
192. **Run Sync Script**:
20 ```bash
21 ./scripts/update-global-instructions.sh --system=all
22 ```
23 * `--system`: `gemini`, `claude`, `copilot`, `opencode`, or `all`.
24 * `--dry-run`: Show what would be updated without making changes.
253. **Verify Changes**: Check the target files (e.g., `gemini/.gemini/GEMINI.md`, `claude/.claude/CLAUDE.md`) to ensure the sync was successful.
26
27## SECTION Syntax (Inclusion/Exclusion)
28
29Use SECTION markers to include/exclude content for specific systems:
30
31```markdown
32<!-- SECTION:name:START:system1,system2 -->
33Content for system1 and system2 only
34<!-- SECTION:name:END -->
35
36<!-- SECTION:name:START:!copilot -->
37Content for all systems EXCEPT copilot
38<!-- SECTION:name:END -->
39```
40
41- **Include list**: `copilot,claude` — only those systems see this block
42- **Exclude prefix**: `!copilot` — all systems EXCEPT copilot see this block
43
44Works in both global instructions (`templates/global-instructions/master.md`) and subagent masters (`templates/subagents/master/*.md`).
45
46## Workflow: Project Initialization
47
48Use this workflow when starting a new project or updating instructions for an existing one.
49
501. **Generate Instructions**:
51 ```bash
52 ./scripts/generate-project-instructions.sh [path/to/project]
53 ```
542. **Update Existing**:
55 ```bash
56 ./scripts/generate-project-instructions.sh --update --force --set-technologies="React, TypeScript" .
57 ```
58 * This generates `.claude/CLAUDE.md`, `.gemini/GEMINI.md`, and `AGENTS.md` based on `templates/PROJECT_INSTRUCTIONS.template.md`.
59
60## Workflow: Sub-Agent Management
61
62Use this workflow when modifying specialized sub-agent (Planner, Reviewer, etc.) behaviors.
63
641. **Edit Agent Master**: Modify files in `templates/subagents/master/` (e.g., `planner.md`). Use SECTION markers for platform-specific content.
652. **Sync Agents**:
66 ```bash
67 ./scripts/update-subagents.sh --agent=all --system=all
68 ```
69 * `--agent`: `planner`, `reviewer`, `implementer`, `coordinator`, `prompt-creator`, or `all`.
70 * `--system`: `copilot`, `opencode`, `claude`, or `all`.
71 * `--dry-run`: Show what would be updated without making changes.
723. **Validate Sync**:
73 ```bash
74 ./scripts/validate-subagents.sh
75 ```
76
77## Reference: Instruction Hierarchy
78
79| Level | Source of Truth | Target Files | Script |
80| :--- | :--- | :--- | :--- |
81| **Global** | `templates/global-instructions/master.md` | `gemini/.gemini/GEMINI.md`, etc. | `update-global-instructions.sh` |
82| **Project** | `templates/PROJECT_INSTRUCTIONS.template.md` | `.claude/CLAUDE.md`, `AGENTS.md`, etc. | `generate-project-instructions.sh` |
83| **Sub-Agents** | `templates/subagents/master/*.md` | `claude/.claude/agents/*.md`, etc. | `update-subagents.sh` |
84
85## Resources
86
87### scripts/
88The skill leverages the following root-level scripts:
89- `update-global-instructions.sh`: Syncs global master to platform headers.
90- `generate-project-instructions.sh`: Scaffolds project-specific context.
91- `update-subagents.sh`: Populates sub-agent instruction files.
92- `validate-subagents.sh`: Checks consistency between agent platforms.
93
94### references/
95- `templates/global-instructions/metadata.json`: Defines target paths and header requirements for each tool.
96- `templates/subagents/master/METADATA.json`: Defines agent names, descriptions, and platform-specific overrides.
majiayu000