workspace-sync

Sync profile templates, team repositories, and member workspaces with diagnostics.

18|4|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/botminter/botminter --skill workspace-sync-botminter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-sync
Source: https://github.com/botminter/botminter/tree/main/profiles/scrum/roles/chief-of-staff/coding-agent/skills/workspace-sync
Command: npx skills add https://github.com/botminter/botminter --skill workspace-sync-botminter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures profile templates, team repositories, and individual member workspaces remain consistent by automating synchronization, diagnostics, and propagation of profile changes so operators do not have to manually track diffs, submodule states, or rendered prompts.

Core Features & Use Cases

  • Profile → Team Application: Diff profile source to team repo, apply agent-tag filtering, rename context.md to CLAUDE.md, render member placeholders for new files, and commit approved changes.
  • Team → Workspace Propagation: Pull team repo updates, run bm teams sync to copy files, rebuild symlinks, and verify that workspace files match team sources across all hired members.
  • Diagnostics & Fixes: Check submodule branch/merge state, missing required files, symlink validity, and cross-workspace drift; provide actionable fixes such as switching to main, pulling, or resolving conflicts.

Quick Start

Ask the agent to run a full-sync to apply profile changes to the team repository and propagate them to all member workspaces.

Frequently Asked Questions about workspace-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync profile templates with team repositories and member workspaces?

To sync profile templates with team repositories and member workspaces, run a full-sync operation to apply profile changes, execute agent tag filtering, rename context.md to CLAUDE.md, render placeholders, and commit approved updates across all hired members.

What is the best way to diagnose submodule discrepancies and workspace drift?

Diagnosing submodule discrepancies and workspace drift requires checking submodule branch and merge states, validating symlinks, verifying required files, and surfacing cross-workspace differences to provide actionable fixes like switching to main or resolving conflicts.

How does workspace propagation work for team repository updates?

Workspace propagation works by pulling team repository updates, running team sync to copy files, rebuilding symlinks, and verifying that individual workspace files match the team sources across all hired members.

Can I preview diffs before applying profile changes to team repositories?

Yes, you can preview diffs before applying profile changes to team repositories. The process diffs the profile source against the team repository, performs agent tag filtering, and renders member placeholders to surface changes for operator approval before committing.

Why are my workspace files not matching team sources after a sync?

Workspace files not matching team sources after a sync may result from invalid symlinks, detached submodule branches, or unresolved merge conflicts. Diagnose cross-workspace drift and verify submodule states to resolve these discrepancies.

Does workspace sync handle context.md renames and placeholder rendering automatically?

Yes, workspace sync handles context.md renames to CLAUDE.md and renders member placeholders for new files automatically during the profile application process to ensure team repositories remain consistent.