sync-skill-allowlist

Synchronize skill entries in project settings against repository SKILL.md files.

1|Updated May 21, 2020
One-click install
npx skills add https://github.com/ahandsel/debugging_log --skill sync-skill-allowlist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skill-allowlist
Source: https://github.com/ahandsel/debugging_log/tree/main/skills/sync-skill-allowlist
Command: npx skills add https://github.com/ahandsel/debugging_log --skill sync-skill-allowlist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill resolves configuration drift between the active skills in your repository and the permissions defined in your project settings, ensuring that your environment remains consistent and secure without manual JSON editing.

Core Features & Use Cases

  • Automated Reconciliation: Automatically detects new skills added to the repository and removes entries for skills that have been deleted.
  • Safety-First Updates: Preserves all non-skill related permissions, such as Bash or Read access, ensuring your existing project configuration remains intact.
  • Use Case: When you add a new skill to your project, run this tool to instantly update your .claude/settings.json file so the AI can immediately recognize and utilize the new capability.

Quick Start

Run the sync-skill-allowlist script with the write flag to automatically update your project settings file with the current list of available skills.

Frequently Asked Questions about sync-skill-allowlist

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

FAQPage Schema
How do I automatically update Claude project settings when skills are added or removed?

This script detects SKILL.md files in your repository and performs non-destructive JSON updates to add new skill entries and remove deleted ones from the .claude/settings.json file.

What causes configuration drift between active skills and project settings?

By parsing YAML frontmatter in SKILL.md files, the synchronization process identifies active skills and ensures the environment configuration matches the repository state.

Does synchronizing skill permissions overwrite existing Bash or Read access in settings.json?

This ensures your existing project configuration and environment access controls remain fully intact during the reconciliation process.

How do I parse YAML frontmatter to manage Claude skill permissions?

This automated environment management process identifies additions and removals based on file presence to keep shared configuration files consistent.

Can I use a script to reconcile project-shared configuration files for Claude?

This satisfies the requirement for automated environment management by detecting changes in the directory structure and applying them safely to the settings file.