Skip to content

CLAUDE.md

Latest commit

 

History

History
61 lines (38 loc) · 2.34 KB

CLAUDE.md

File metadata and controls

61 lines (38 loc) · 2.34 KB
Raw

CLAUDE.md

Guidance for working in the mrbogomips plugins marketplace repository.

Repository structure

This is a flat-at-root plugin marketplace following the convention used by Anthropic's domain-specific marketplaces. Each top-level directory is a plugin:

  • developer-tools/ — developer environment tooling
  • human-resources/ — HR workflow support
  • project-management/ — project management workflows
  • tech-writing/ — technical writing support

Plugin conventions

Every plugin must contain .claude-plugin/plugin.json. Components are discovered by convention:

  • Skills — skills/*/SKILL.md
  • Agents — agents/*/AGENT.md
  • Hooks — hooks/hooks.json
  • Commands — commands/*.md

Editing marketplace.json

.claude-plugin/marketplace.json is the marketplace manifest. Each plugin entry must be an object with at least name, source, and description. Use category and tags for classification.

String-only entries (bare paths) are not valid — always use the object format.

Validation

After any change to a plugin or to marketplace.json, run:

bash tests/ci/run-structural-tests.sh

This is a strict requirement. No change is complete until validation passes. Requires jq.

For a plugin headed to the community marketplace, also run the check the review pipeline runs before submitting:

claude plugin validate ./<plugin> --strict

CONNECTORS pattern

Plugins with optional MCP server dependencies use CONNECTORS.md to declare ~~placeholder categories. Skills reference these as ~~knowledge base, ~~email, etc. and degrade gracefully when no server is connected. Validation scripts check that every ~~placeholder in SKILL.md files has a matching entry in CONNECTORS.md.

Architecture

This is a static marketplace — no build steps. Plugins are collections of markdown, JSON, and templates. When adding or changing a plugin, update both the plugin's own files and the marketplace manifest.

Shell script conventions

Scripts must be macOS (BSD) compatible — no grep -P, no head -n -1. Use grep -E/grep -oE and awk instead. Avoid ((VAR++)) with set -e (fails when VAR=0); use VAR=$((VAR + 1)).

Git / PR Working Policy

  • Worktree usage: disabled
  • Worktree location: n/a (topic branch in main checkout)
  • Base branch: main
  • Recorded on: 2026-06-01