Claude-skill-registry instruction-manager
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.
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/instruction-manager" ~/.claude/skills/majiayu000-claude-skill-registry-instruction-manager && rm -rf "$T"
skills/data/instruction-manager/SKILL.mdInstruction 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
, oropencode
.all
: Show what would be updated without making changes.--dry-run
- Verify Changes: Check the target files (e.g.,
,gemini/.gemini/GEMINI.md
) to ensure the sync was successful.claude/.claude/CLAUDE.md
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:
— only those systems see this blockcopilot,claude - Exclude prefix:
— all systems EXCEPT copilot see this block!copilot
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
, and.gemini/GEMINI.md
based onAGENTS.md
.templates/PROJECT_INSTRUCTIONS.template.md
- This generates
Workflow: Sub-Agent Management
Use this workflow when modifying specialized sub-agent (Planner, Reviewer, etc.) behaviors.
- Edit Agent Master: Modify files in
(e.g.,templates/subagents/master/
). Use SECTION markers for platform-specific content.planner.md - Sync Agents:
./scripts/update-subagents.sh --agent=all --system=all
:--agent
,planner
,reviewer
,implementer
,coordinator
, orprompt-creator
.all
:--system
,copilot
,opencode
, orclaude
.all
: Show what would be updated without making changes.--dry-run
- Validate Sync:
./scripts/validate-subagents.sh
Reference: Instruction Hierarchy
| Level | Source of Truth | Target Files | Script |
|---|---|---|---|
| Global | | , etc. | |
| Project | | , , etc. | |
| Sub-Agents | | , etc. | |
Resources
scripts/
The skill leverages the following root-level scripts:
: Syncs global master to platform headers.update-global-instructions.sh
: Scaffolds project-specific context.generate-project-instructions.sh
: Populates sub-agent instruction files.update-subagents.sh
: Checks consistency between agent platforms.validate-subagents.sh
references/
: Defines target paths and header requirements for each tool.templates/global-instructions/metadata.json
: Defines agent names, descriptions, and platform-specific overrides.templates/subagents/master/METADATA.json