CO

configured-agent

A pattern for storing plugin configuration in project-specific local markdown files.

Install

mkdir -p .claude/skills/configured-agent && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/430" && unzip -o skill.zip -d .claude/skills/configured-agent && rm skill.zip

Installs to .claude/skills/configured-agent

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

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.
408 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • →Store plugin configuration in .claude/plugin-name.local.md
  • →Read YAML frontmatter for structured settings
  • →Parse markdown body for supplementary instructions
  • →Implement quick-exit patterns in bash hooks
  • →Manage per-project plugin state and flags

How it works

The pattern uses a local markdown file with YAML frontmatter to store settings, which hooks and commands parse using standard shell utilities like sed and awk.

Inputs & outputs

You give it
.claude/plugin-name.local.md file
You get back
Parsed YAML frontmatter fields and markdown content

When to use configured-agent

  • →Setting per-project plugin flags
  • →Configuring plugin-specific behavior
  • →Storing persistent plugin state per repository
  • →Defining plugin-specific instructions

About configured-agent

Allows plugins to read structured settings from .claude/[plugin-name].local.md files. Supports YAML frontmatter for configuration and markdown for supplementary instructions.

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.

When not to use it

  • →Storing sensitive credentials or secrets
  • →Sharing configuration across different users
  • →Storing data that must be committed to version control

Prerequisites

Project directory with .claude/ subdirectoryPlugin name matching the .local.md filename

Limitations

  • →Requires a Claude Code restart to apply configuration changes
  • →Hooks cannot be hot-swapped during a session

How it compares

Unlike hardcoded configurations, this approach allows per-project settings that are user-managed and excluded from version control.

Compared to similar skills

configured-agent side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
configured-agent (this skill)512moReviewBeginner
changelog-automation85moReviewIntermediate
plugin-settings29moReviewBeginner
skill-builder49moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

More by anthropics

View all by anthropics →

frontend-design

anthropics

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

481544

pptx

anthropics

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

393763

webapp-testing

anthropics

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

353585

mcp-builder

anthropics

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

136215

skill-creator

anthropics

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

128200

docx

anthropics

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

93225

You might also like

changelog-automation

wshobson

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

885

plugin-settings

anthropics

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.

217

skill-builder

ruvnet

Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, generate skill templates, or understand the Claude Skills specification.

45

skill-creator-doctor

ananddtyagi

Create, repair, maintain, and consolidate skills. This skill should be used when users want to create new skills, fix broken skills that won't load, diagnose skill system issues, maintain skill health, or consolidate duplicate/obsolete skills. Automatically detects and repairs common skill loading problems including missing registry entries, metadata format issues, and structural problems. Provides comprehensive skill ecosystem management including duplicate detection, merge workflows, and archival processes.

17

slash-command-creator

greatSumini

Guide for creating Claude Code slash commands. Use when the user wants to create a new slash command, update an existing slash command, or asks about slash command syntax, frontmatter options, or best practices.

15

obsidian-core-workflow-a

jeremylongshore

Execute Obsidian primary workflow: note manipulation and vault operations. Use when implementing file operations, frontmatter handling, or programmatic note creation and modification. Trigger with phrases like "obsidian vault operations", "obsidian file manipulation", "obsidian note management".

04

Search skills

Search the agent skills registry