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.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
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"
manifest: skills/data/instruction-manager/SKILL.md
source content

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.

  1. Edit Master Template: Modify
    templates/global-instructions/master.md
    .
  2. 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.
  3. 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.

  1. Generate Instructions:
    ./scripts/generate-project-instructions.sh [path/to/project]
    
  2. 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.

  1. Edit Agent Master: Modify files in
    templates/subagents/master/
    (e.g.,
    planner.md
    ). Use SECTION markers for platform-specific content.
  2. 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.
  3. Validate Sync:
    ./scripts/validate-subagents.sh
    

Reference: Instruction Hierarchy

LevelSource of TruthTarget FilesScript
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.