gitignore-profile-sync-fix
Installation
SKILL.md
Problema
Profile YAML files (*.local.md) in a plugin are silently gitignored by a broad glob pattern, so newly created profiles never sync across machines. Discovered when AUDIT-PRO's nexusos.local.md profile went missing between 2026-03-28 creation and 2026-04-20 — only pitch-deck.local.md was whitelisted in the plugin's .gitignore.
Procedura
- Check plugin's .gitignore for patterns like
profiles/*.local.mdthat exclude profile files from git tracking. - Identify which profiles are canonical (ship with plugin) vs which are machine-specific (user overrides).
- Whitelist canonical profiles explicitly with
!profiles/{name}.local.mdon their own line after the exclusion pattern. - After editing .gitignore, run
git add profiles/{name}.local.mdto force-track previously ignored file. - Commit both .gitignore and the profile together:
git commit -m "Whitelist canonical profile X". - Verify with
git ls-files profiles/— all canonical profiles should appear. - Alternative naming: use
*.user.mdsuffix for machine-specific profiles that should NOT sync, keep*.local.mdfor canonical/shared ones.