skill-allowlist-syncer

To sync Claude project settings, you can use a reconciliation script that scans your skills directory for SKILL.md files and updates the permissions.allow section of .claude/settings.json. This preserves existing non-skill permission entries and requires Node.js 24+.

Configuration drift occurs when your .claude/settings.json allowlist becomes outdated relative to your actual skills folder. Stale entries for removed skills persist while newly added skills lack necessary permissions, causing manual overhead and potential permission errors.

Yes, you need Node.js 24 or higher to execute the reconciliation logic that synchronizes the permissions.allow section of .claude/settings.json against the active set of skills found in your directory structure.

Yes, synchronizing your Claude skill allowlist preserves existing non-skill permission entries. The script scans for SKILL.md files to identify active skills and reconciles the JSON configuration file accordingly without overwriting unrelated permissions.

The best way to detect stale entries is to run an automated reconciliation script that compares the permissions.allow section against the actual directory structure. It identifies removed skills and cleans up the JSON configuration to prevent drift.

To fix Claude skill permission errors, run a check-skill-allowlist script with the write flag. This instantly updates your project permissions in .claude/settings.json by detecting the new SKILL.md file and adding it to the allowlist.