plugin-settings

Store and retrieve plugin configuration in Markdown files with YAML frontmatter.

Updated Nov 3, 2016
One-click install
npx skills add https://github.com/xleliberty/mydotfiles --skill plugin-settings-xleliberty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-settings
Source: https://github.com/xleliberty/mydotfiles/tree/main/.config/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-settings
Command: npx skills add https://github.com/xleliberty/mydotfiles --skill plugin-settings-xleliberty

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the fragmentation of plugin configuration by providing a unified, project-local pattern for storing and reading settings, ensuring consistent behavior across different plugins and environments.

Core Features & Use Cases

  • Structured Configuration: Uses YAML frontmatter for type-safe settings like booleans, numbers, and lists.
  • State Persistence: Enables plugins to maintain project-specific state, such as iteration counts or agent task assignments, without polluting global configuration files.
  • Use Case: A developer can define strict validation rules for a specific project in a local file, which the plugin automatically reads and enforces during hook execution.

Quick Start

Use the plugin-settings skill to initialize a new configuration file for your plugin in the .claude directory.

Frequently Asked Questions about plugin-settings

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

FAQPage Schema
How do I store plugin configuration settings locally per project?

Store plugin configuration settings in local Markdown files with YAML frontmatter to maintain project-specific behavior. This pattern standardizes retrieval and keeps settings isolated without polluting global configuration files.

What is the best way to manage plugin state and iteration counts without global files?

Managing plugin state requires persisting data like iteration counts or task assignments in project-local files. Using YAML frontmatter within Markdown files ensures structured state persistence without modifying global configuration.

Can I use YAML frontmatter to enforce type-safe settings for shell hooks?

YAML frontmatter supports type-safe settings like booleans, numbers, and lists for shell hook execution. The plugin parses the structured frontmatter to enforce strict validation rules during runtime.

How do I standardize configuration storage across multiple plugins in Claude Code?

Standardize configuration storage by applying a unified local file pattern for reading and writing plugin settings. This approach ensures consistent behavior across different plugins and environments within the ecosystem.

Does this configuration approach work in standard shell environments without extra dependencies?

The configuration approach works in standard shell environments without external dependencies. It implements robust parsing logic to extract structured settings from local Markdown files while maintaining shell compatibility.