Skip to content

CLAUDE.md

Latest commit

 

History

History
39 lines (24 loc) · 2.08 KB

CLAUDE.md

File metadata and controls

39 lines (24 loc) · 2.08 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Architecture

This repo is a Claude Code plugin marketplace. The root .claude-plugin/marketplace.json declares the marketplace and points to ./plugins/ as the plugin root.

Each plugin lives under plugins/<plugin-name>/ and contains:

  • .claude-plugin/plugin.json — plugin metadata (including optional hooks for PreToolUse, PostToolUse, SessionStart, etc.)
  • skills/<skill-name>/SKILL.md — one skill per subdirectory; the frontmatter name and description fields control how Claude triggers the skill

Some plugins are hooks-only (no skills directory) — e.g. linters, windows-notify.

Plugin Versions

Follow semver when bumping plugin versions. When a plugin changes, update the version in all of these files (check each — they may already reflect the new version from pending changes):

  • .claude-plugin/marketplace.json — the "version" field for the plugin
  • README.md — the version column in the plugins table
  • plugins/<plugin-name>/README.md — the version in the heading

Adding a Skill

  1. Create plugins/<plugin>/skills/<skill-name>/SKILL.md
  2. Add YAML frontmatter with name and description
  3. Write the skill instructions in the body (markdown)

Skills are auto-discovered from the skills/ directory — no registration in plugin.json needed.

Reference Docs

  • Plugins — overview, plugin structure, skills, hooks, subagents
  • Plugins Reference — full schema for plugin.json, SKILL.md, and other plugin files
  • Plugin Marketplaces — marketplace.json format and how marketplaces work

Creating and Improving Skills

Use the skill-creator skill when creating new skills or iteratively improving existing ones. It guides you through drafting, running test cases, evaluating outputs, and optimizing the skill description for triggering accuracy.