How does this differ from standard documentation like a README?

While READMEs are written for humans, .local.md files are optimized for AI consumption (agent context), similar to how CLAUDE.md works for general project rules.

What kind of information should I exclude from plugin extensions?

Avoid including personal preferences or secrets. Personal settings should stay in gitignored files like settings.local.json, while extensions focus on shared project logic.

What is the purpose of a .local.md file in Claude Code?

A .local.md file serves as agent context, providing Claude with project-specific instructions that bridge general plugin skills to the actual file paths and conventions of your codebase.

Should I commit .local.md files to my repository?

Yes. These files contain project-level context that should be shared with all contributors and the AI to ensure consistent implementation of patterns across the team.

Plugin Context Extension

Name: Plugin Context Extension
Author: ImproperSubset

byImproperSubset

0•

Productivity & Workflow

Bridges marketplace plugins with project-specific logic using structured documentation patterns for AI assistants.

The Plugin Context Extension skill enables developers to customize general Claude Code marketplace plugins for specific codebases using the .local.md pattern. It provides a standardized framework for documenting project-specific file paths, naming conventions, and custom workflows that bridge the gap between generic plugin capabilities and a repository's unique requirements. By creating structured agent context, it ensures that Claude understands exactly how to implement patterns within the specific architecture of your project.

Key Features

01Documents project-specific build commands and Git workflows for the AI assistant

02Standardizes the creation of .local.md extension files for AI context

03Supports team-wide AI alignment through version-controlled project conventions

04Maps general plugin skills to specific project file paths and directories

05Uses YAML frontmatter to explicitly link extensions to specific marketplace plugins

060 GitHub stars

Use Cases

01Providing the AI with local build and linting commands unique to a repository

02Documenting specific Git branch workflows for AI-assisted pull requests

03Configuring a generic library plugin to recognize your project's unique folder structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add impropersubset/hh-agentics cc-plugin-extensions

For use in Claude.ai and ChatGPT

Download Skill