claude-code-plugins CLAUDE.md

CLAUDE.md

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

Repository Overview

This is a Claude Code plugin marketplace for PagerDuty integrations. It contains plugins that bring operational intelligence into development workflows by correlating code changes with PagerDuty incident data.

Current plugins:

• pagerduty: Includes multiple commands:
  • Pre-commit risk scoring using PagerDuty incident history and git diff analysis
  • PagerDuty skill creation and management for AI agents (Early Access)

Repository Structure

.claude-plugin/           # Marketplace and plugin metadata
  marketplace.json        # Marketplace registry definition
  plugin.json            # Plugin metadata (name, version, author)
commands/                # Plugin slash commands
  pre-commit-risk-scoring.md   # Risk assessment command
  create-pagerduty-skill.md    # Skill creation/management command
.mcp.json               # PagerDuty MCP server configuration

Plugin Architecture

Marketplace Registration

The marketplace is defined in .claude-plugin/marketplace.json with owner metadata and a list of plugins. Each plugin entry must specify:

• name: Plugin identifier (e.g., "pagerduty")
• source: Path to plugin definition (typically "./")
• description: What the plugin does
• version: Semantic version string
• author: Attribution metadata

Plugin Metadata

Each plugin has a plugin.json at its source path containing name, description, version, and author. The version in plugin.json must match the version in marketplace.json.

Command Definitions

Commands are markdown files in the commands/ directory with frontmatter:

• description: Human-readable command purpose
• argument-hint: Optional syntax hint for arguments
• allowed-tools: Whitelist of tools the command can invoke

The markdown body contains the full command prompt that gets executed when the slash command is invoked.