Will it mess up my JSON formatting?

No, the skill parses your JSON, merges values, sorts them alphabetically, and validates the final structure to ensure it remains a valid configuration file.

Can I see what changes will be made before they happen?

Yes, using the --dry-run flag allows you to preview the additions and skipped variables in a detailed table without modifying any files.

What files does this skill modify?

It modifies either .claude/settings.json or .claude/settings.local.json, depending on the --target argument provided during execution.

Does this skill overwrite my existing API keys?

No, the skill specifically ignores user-specific variables like ANTHROPIC_API_KEY and never overwrites values you have already manually set.

Does it support undocumented environment variables?

Yes, by using the --include-undocumented flag, the skill can scan changelogs and use research agents to find variables not yet in official documentation.

Environment Variable Sync

Name: Environment Variable Sync
Author: melodic-software

bymelodic-software

•

Productivity & Workflow

Automatically synchronizes and adds missing environment variable defaults to your Claude Code settings files while preserving custom configurations.

This skill streamlines the configuration of your Claude Code environment by scanning documentation and changelogs for available environment variables and adding their default values to your local or project settings. It features a safe synchronization process that identifies missing variables, skips user-specific credentials like API keys, and never overwrites your existing custom values. Whether you are setting up a new project or keeping up with new Claude Code releases, this utility ensures your environment is correctly configured with the latest official and undocumented variables without manual editing.

Key Features

01Automatic JSON validation and alphabetical sorting of environment entries for clean file maintenance

0238 GitHub stars

03Automated discovery of official and undocumented environment variables via documentation and changelogs

04Smart merging that preserves existing user-defined values and sensitive credentials like API keys

05Support for both project-level (settings.json) and local-level (settings.local.json) configuration targets

06Interactive dry-run mode to preview all proposed changes and skipped variables before execution

Use Cases

01Managing machine-specific local settings separately from version-controlled project settings

02Updating existing configurations after a Claude Code update to include new feature flags or performance toggles

03Quickly initializing a new project with all standard Claude Code environment defaults

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins sync-environment-variables

For use in Claude.ai and ChatGPT

Download Skill