update-base-config

update-base-config is a small npx CLI that copies shared project-local AI agent skills from this repository into another repository.

What it syncs

The CLI copies each skill from templates/skills/ into .agents/skills/, .claude/skills/, .opencode/skills/, and .codex/skills/.

Behavior

• Shows a summary before changing files
• Asks for confirmation by default
• Creates a backup before replacing an existing skill file
• Use --verbose to show planned file changes; --dry-run always shows the full plan. Detailed plans group changes under each agent directory and show paths relative to that agent's skills/ directory.
• Uses ANSI color only for interactive terminals. Piped output stays plain; use --no-color to disable color explicitly.

Backups are stored inside the target project under .update-base-config-backups/<timestamp>/.

Usage

npx update-base-config
npx update-base-config --dry-run
npx update-base-config --verbose
npx update-base-config --yes

Options

• --yes, -y: Apply without asking for confirmation.
• --dry-run: Show the detailed plan without writing files.
• --verbose: Show the detailed plan before confirmation.
• --no-color: Disable ANSI color output.
• --target <path>: Override the target project directory.
• --skills-root <path>: Override the master skills directory.

Develop the template

Edit every shared skill once inside templates/skills/. The CLI distributes that master source into each supported local agent directory.