Plugin Settings

仓库创建 2026年1月12日最近提交 4 天前SkillHot 收录 21 天前

▸ 精选理由

提供可声明化的本地配置模式，便于项目级定制化。

这个 Skill 做什么

规范插件在项目中用 YAML frontmatter 存储用户配置与本地状态。

用 .claude/plugin-name.local.md 把每个插件的可配置项和本地状态放到项目里，前端用 YAML frontmatter 写结构化配置，正文用 Markdown 存提示或上下文。适合需要每个项目定制插件行为或在团队里共享本地配置的场景，方便把配置纳入代码库并支持覆盖/版本控制。

▸ 展开 SKILL.md 英文原文

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.

开发编程配置本地状态YAMLClaude Code

431

Stars

Forks

仓库内 Skill

+16

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/tzachbon/smart-ralph/main/.agents/skills/Plugin Settings/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/tzachbon/smart-ralph/main/.agents/skills/Plugin Settings/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Plugin Settings Pattern for Claude Code Plugins

## Overview

Plugins can store user-configurable settings and state in `.claude/plugin-name.local.md` files within the project directory. This pattern uses YAML frontmatter for structured configuration and markdown content for prompts or additional context.

**Key characteristics:**
- File location: `.claude/plugin-name.local.md` in project root
- Structure: YAML frontmatter + markdown body
- Purpose: Per-project plugin configuration and state
- Usage: Read from hooks, commands, and agents
- Lifecycle: User-managed (not in git, should be in `.gitignore`)

## File Structure

### Basic Template

```markdown
---
enabled: true
setting1: value1
s

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有