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

  1. Check plugin's .gitignore for patterns like profiles/*.local.md that exclude profile files from git tracking.
  2. Identify which profiles are canonical (ship with plugin) vs which are machine-specific (user overrides).
  3. Whitelist canonical profiles explicitly with !profiles/{name}.local.md on their own line after the exclusion pattern.
  4. After editing .gitignore, run git add profiles/{name}.local.md to force-track previously ignored file.
  5. Commit both .gitignore and the profile together: git commit -m "Whitelist canonical profile X".
  6. Verify with git ls-files profiles/ — all canonical profiles should appear.
  7. Alternative naming: use *.user.md suffix for machine-specific profiles that should NOT sync, keep *.local.md for canonical/shared ones.

Enforcement Loop

Installs
1
First Seen
Jun 23, 2026
gitignore-profile-sync-fix — cryptopafi/nexusos-skills