Habilidades plugin-settings

⚙️

plugin-settings

Name: plugin-settings
Author: anthropics

Seguro ⚡ Contém scripts📁 Acesso ao sistema de arquivos⚙️ Comandos externos

Configurar ajustes de plugins con el patrón YAML frontmatter

Também disponível em: anthropics,davila7

Los ajustes de plugins se pueden almacenar en archivos .claude/plugin-name.local.md usando YAML frontmatter y markdown. Este patrón permite la configuración por proyecto del plugin, la persistencia de estado y el comportamiento personalizable por el usuario sin bases de datos complejas ni archivos de configuración.

Suporta: Claude Codex Code(CC)

🥉 76 Bronze

Baixar o ZIP da skill

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

Ative e comece a usar

Testar

A utilizar "plugin-settings". Crear un archivo de ajustes para habilitar mi plugin con modo de validación estricto

Resultado esperado:

Archivo de ajustes creado en .claude/my-plugin.local.md
Configuración: enabled=true, mode=strict, max_file_size=1000000
Para modificar: editar archivo y reiniciar Claude Code
El archivo está automáticamente en gitignore

A utilizar "plugin-settings". Configurar mi plugin para permitir archivos JavaScript y TypeScript con límite de 2MB

Resultado esperado:

Actualizado .claude/my-plugin.local.md con nuevos ajustes
Extensiones permitidas: .js, .ts
Tamaño máximo de archivo: 2097152 bytes
Reiniciar Claude Code para que los cambios surtan efecto

Auditoria de Segurança

Seguro

v5 • 1/17/2026

Official Anthropic skill providing documentation on plugin settings pattern. Contains only educational content and utility scripts with safe bash practices including set -euo pipefail, file existence checks, and proper input validation. No network access, no dangerous operations, no external dependencies beyond standard POSIX tools.

Arquivos analisados

2,264

Linhas analisadas

achados

Total de auditorias

Fatores de risco

⚡ Contém scripts (3)

scripts/parse-frontmatter.sh:1-60 scripts/validate-settings.sh:1-102 examples/read-settings-hook.sh:1-66

📁 Acesso ao sistema de arquivos (2)

scripts/parse-frontmatter.sh:30-35 scripts/validate-settings.sh:26-38

⚙️ Comandos externos (2)

scripts/parse-frontmatter.sh:37-51 SKILL.md:139-171

Auditado por: claude Ver Histórico de Auditoria →

Pontuação de qualidade

Arquitetura

100

Manutenibilidade

Conteúdo

Comunidade

100

Segurança

Conformidade com especificações

O Que Você Pode Construir

Añadir comportamiento configurable

Permitir a los usuarios personalizar el comportamiento del plugin a través de archivos de ajustes en lugar de valores predeterminados codificados

Rastrear estado del agente

Almacenar asignaciones de tareas del agente, conteos de iteraciones e información de sesiones del coordinador entre sesiones

Crear banderas de características

Habilitar o deshabilitar características del plugin sin modificar el código del plugin

Tente Estes Prompts

Habilitar mi plugin

Crear un archivo .claude/my-plugin.local.md para habilitar mi plugin con modo estándar y registro habilitado

Leer ajustes del plugin

Verificar si existe .claude/my-plugin.local.md y leer los campos enabled y mode del frontmatter

Actualizar contador de iteraciones

Actualizar el campo iteration en .claude/ralph-loop.local.md para incrementar desde el valor actual

Validar archivo de ajustes

Validar que .claude/my-plugin.local.md tiene frontmatter válido con el campo enabled establecido en true

Melhores Práticas

Siempre proporcionar valores predeterminados sensatos cuando el archivo de ajustes no existe
Usar patrón de salida rápida para omitir el procesamiento del hook cuando el plugin no está configurado
Añadir .claude/*.local.md al .gitignore del proyecto para evitar confirmar ajustes de usuario

Evitar

No codificar rutas absolutas a archivos de ajustes (usar rutas relativas como .claude/plugin-name.local.md)
No omitir verificaciones de existencia de archivo antes de leer los ajustes
No usar actualizaciones de archivo no atómicas que podrían corromper los ajustes si hay interrupción

Perguntas Frequentes

¿Qué herramientas soportan este patrón?

Plugin Settings funciona con Claude, Codex y Claude Code. El patrón de directorio .claude es nativo de los plugins de Claude Code.

¿Cuáles son los límites de tamaño para los archivos de ajustes?

Los archivos de ajustes usan markdown estándar. No hay límites estrictos pero mantener archivos bajo 1MB para un rendimiento óptimo del hook.

¿Cómo integro con plugins existentes?

Añadir creación del archivo de ajustes a tus comandos del plugin y lectura de ajustes a tus hooks. Usar el patrón de salida rápida para mantener compatibilidad hacia atrás.

¿Son seguros los archivos de ajustes?

Los archivos de ajustes se almacenan en el directorio .claude que es local del usuario. Siempre validar y sanear la entrada antes de escribir ajustes. Añadir a .gitignore para confirmar accidentalmente.

¿Por qué mis cambios no están surtiendo efecto?

Los cambios de ajustes requieren reinicio de Claude Code. Los hooks no pueden intercambiarse en caliente dentro de una sesión. Salir y reiniciar con el comando 'claude'.

¿Cómo se compara con CLAUDE.md?

CLAUDE.md es para contexto del proyecto completo. .claude/*.local.md es para ajustes específicos del plugin. Usar local.md para configuración del plugin, CLAUDE.md para documentación general del proyecto.