Why use .local.md files for plugin settings?

The .local.md format allows you to combine structured YAML data for scripts with human-readable Markdown for AI prompts, while the .local suffix ensures they are easily ignored by Git.

Is this pattern secure for storing API keys?

While the files are local and gitignored, they are stored in plaintext. It is recommended to use environment variables for sensitive secrets and this pattern for non-sensitive configuration.

Do I need to restart Claude Code after changing settings?

Yes, if the settings are used by hooks. Claude Code registers hooks at startup, so a restart is required for the scripts to recognize the updated configuration values.

How do I extract settings in a Bash hook?

You can use common CLI tools like sed to extract the frontmatter between the triple-dash markers and grep/awk to parse individual key-value pairs.

Plugin Settings Manager

Name: Plugin Settings Manager
Author: syahiidkamil

bysyahiidkamil

•

275

•

開発者ツール

Implements a standardized pattern for per-project configuration and state management using YAML frontmatter and Markdown files.

The Plugin Settings skill provides a robust architecture for creating configurable Claude Code plugins. By utilizing the .claude/plugin-name.local.md pattern, it allows developers to store structured configuration data (YAML) alongside rich context or prompts (Markdown) within the project directory. This approach enables highly flexible workflows where plugin behavior, hook activation, and agent state can be adjusted on a per-project basis without modifying the core plugin code or committing sensitive configurations to version control. It is specifically designed to be easily parsed by Bash hooks, custom commands, and AI agents.

主な機能

01Standardized .local.md file pattern to ensure settings stay out of version control

02Markdown body integration for storing complex instructions, task state, or prompts

03Seamless integration with Claude Code agents and commands for dynamic behavior adjustment

04YAML frontmatter support for structured configuration like booleans, lists, and numeric values

05275 GitHub stars

06Pre-defined Bash patterns for extracting and validating settings within automation hooks

ユースケース

01Toggling specific automation hooks on or off per project without editing hooks.json

02Maintaining persistent state for multi-agent workflows including task IDs and session roles

03Storing project-specific validation rules and 'completion promises' for iterative coding loops

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add syahiidkamil/software-engineer-ai-agent-atlas plugin-settings

For use in Claude.ai and ChatGPT

Download Skill