claude-mpm-skills: Instructions file for Claude Code

Claude Code Instructions for claude-mpm-skills Project

⚠️ CRITICAL: This is a SKILLS REPOSITORY

This project develops skills for the Claude MPM Skills Repository, NOT for local use.

Skills are:

1. Developed in toolchains/ or universal/ directories
2. Built using scripts/generate_manifest.py
3. Deployed via scripts/flatten_skills.sh to .claude/skills/ (gitignored)

DO NOT create skills directly in .claude/skills/ - that's the deployment target, not the source!

---

Skill Creation Workflow

Step 1: Initialize New Skill

Use the init script (recommended):

# Interactive mode
python scripts/init_skill.py

# Toolchain skill (e.g., PHP framework)
python scripts/init_skill.py --path toolchains/php/frameworks/espocrm

# Universal skill
python scripts/init_skill.py --path universal/testing/integration-patterns

# With description
python scripts/init_skill.py --path toolchains/python/async/celery --description "Celery task queue patterns"

# Dry run to preview
python scripts/init_skill.py --dry-run --path toolchains/go/testing/integration

Step 2: Skill Directory Structure

Skills are organized hierarchically in the repository:

claude-mpm-skills/
├── toolchains/           # Language/framework-specific skills
│   ├── python/
│   │   ├── frameworks/
│   │   │   └── django/
│   │   │       ├── SKILL.md
│   │   │       ├── metadata.json
│   │   │       └── references/     # Optional deep-dive docs
│   │   └── testing/
│   │       └── pytest/
│   └── php/
│       └── frameworks/
│           └── espocrm/            # ← Example: EspoCRM skill location
│               ├── SKILL.md
│               ├── metadata.json
│               └── references/
├── universal/            # Cross-language skills
│   ├── testing/
│   │   └── tdd-patterns/
│   └── architecture/
│       └── api-design/
└── manifest.json         # Auto-generated - DO NOT edit manually

Step 3: Required Files

Each skill directory must contain:

SKILL.md (Required)

---
name: skill-name
description: Brief description with use cases
version: 1.0.0
category: development
author: Claude MPM Team
license: MIT
progressive_disclosure:
  entry_point:
    summary: "One-line summary"
    when_to_use: "When to activate this skill"
    quick_start: "Steps to get started"
  references:
    - architecture.md
    - patterns.md
context_limit: 800
tags:
  - tag1
  - tag2
requires_tools: []
---

# Skill Title

## Overview

## When to Use This Skill

## Core Concepts

## Implementation Patterns

## Best Practices

## Anti-Patterns

## Navigation (if references exist)
- **[Architecture](references/architecture.md)**: ...
- **[Patterns](references/patterns.md)**: ...