# Plugin Settings

> This skill should be used when the user asks about "plugin settings", "store plugin configuration", "user-configurable plugin", ".local.md files", "plugin state files", "read YAML frontmatter", "per-project plugin settings", or wants to make plugin behavior configurable. Documents the .claude/plugin-name.local.md pattern for storing plugin-specific configuration with YAML frontmatter and markdown content.

Source: https://skillsagentes.com/skills/anthropics/claude-code/plugin-settings
Repository: https://github.com/anthropics/claude-code
Author: anthropics
License: not specified
Updated: hace 9 meses
Context cost: 102 tok installed, 3k tok once triggered, 11.1k tok with every bundled file
Bundle: 8 files, 43 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add anthropics/claude-code --skill plugin-settings --agent claude-code
```

## What it does

- Documenta el patrón `.claude/plugin-name.local.md` para configuración de plugins con frontmatter YAML y cuerpo markdown
- Explica cómo leer y parsear settings desde hooks bash, comandos y agentes
- Define buenas prácticas: gitignore, permisos chmod 600, sanitización de entrada, validación de rutas
- Muestra patrones comunes: activación temporal de hooks, gestión de estado de agentes, comportamiento dirigido por configuración

## Use it when

- El usuario pregunta sobre 'plugin settings' o 'store plugin configuration'
- Se necesita hacer configurable el comportamiento de un plugin por proyecto
- Se trabaja con archivos `.local.md` o se necesita leer YAML frontmatter
- Se quiere almacenar configuración o estado por proyecto para hooks, comandos o agentes

## What triggers it

- "¿Cómo hago que mi plugin sea configurable por proyecto?"
- "Necesito leer YAML frontmatter desde un hook bash"
- "Explícame el patrón .claude/plugin-name.local.md"
- "Quiero activar y desactivar un hook sin editar hooks.json"

## Before you install

- Needs on PATH: awk, sed
- Environment: AGENT_NAME, BODY, BODY_LINES, COORDINATOR, ENABLED, FIELD, FILE, FILE_PATH, FRONTMATTER, LEVEL, MARKER_COUNT, SAFE_VALUE, SETTINGS_FILE, STATE_FILE, STRICT_MODE, USER_INPUT, VALUE

## Files

- SKILL.md — 12 KB
- examples/create-settings-command.md — 2 KB
- examples/example-settings.md — 3 KB
- examples/read-settings-hook.sh — 2 KB
- references/parsing-techniques.md — 11 KB
- references/real-world-examples.md — 9 KB
- scripts/parse-frontmatter.sh — 1 KB
- scripts/validate-settings.sh — 3 KB

## SKILL.md

Not reproduced here. Read it at https://github.com/anthropics/claude-code/blob/main/plugins/plugin-dev/skills/plugin-settings/SKILL.md

---

Skills Agentes — https://skillsagentes.com/skills/anthropics/claude-code/plugin-settings