dev-agent-skills: Instructions file for Claude Code

CLAUDE.md

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

Project overview

A collection of Claude Code agent skills and hooks for development workflows, distributed as a plugin marketplace. Contains 7 skills and 1 hook organized into 5 plugins:

• github-workflow plugin: git-commit, github-pr-creation, github-pr-merge, github-pr-review
• skill-authoring plugin: creating-skills
• guardrails plugin: guard-destructive PreToolUse hook
• privacy-guard plugin: privacy-guard skill (session rules + pre-commit denylist gate for public repos)
• decision-records plugin: decision-records skill (writes ADRs, and validates a collection against the convention it already follows)

Skills are model-invoked (Claude activates them based on user intent, not slash commands). The hook runs automatically on every Bash tool call.

Architecture

.claude-plugin/
  marketplace.json          # Marketplace registry: lists all plugins
plugins/
  <plugin-name>/
    .claude-plugin/
      plugin.json           # Plugin manifest
    skills/                 # Skills (skill plugins) - auto-discovered
      <skill-name>/
        SKILL.md            # Main skill file (YAML frontmatter + markdown body)
        references/         # Optional deep-dive docs loaded on demand
        scripts/            # Optional executables the skill runs in place
    hooks/                  # Hooks (guardrails plugin) - auto-discovered
      hooks.json            # Hook registration
      guard-destructive.sh  # Hook script, run via ${CLAUDE_PLUGIN_ROOT}
    tests/                  # regression suite - three plugins have one
      run.sh                #   guardrails: cases/*.txt table; the other two: inline
      cases/*.txt           #   (guardrails only)

Key file: marketplace.json

Lists the plugins. Each plugin is a self-contained directory under plugins/, referenced only by source (e.g. ./plugins/github-workflow); its components are auto-discovered from that directory. The marketplace entry carries no skills/hooks arrays - this is the standard Claude Code plugin layout. To add a plugin, create plugins/<name>/ with a .claude-plugin/plugin.json and its components, then add an entry here.