---
description: Integrate marketplace plugins into CLAUDE.md (choose user or project level)
allowed-tools: Bash, Read, Write, Edit, AskUserQuestion
---

# integrate - Add marketplace plugins to CLAUDE.md

Generate documentation for installed cadrianmae marketplace plugins and add to CLAUDE.md.

## Usage

```
/integrate
```

No arguments needed - Claude will ask you where to add the documentation.

## What It Does

1. **Asks for scope** - User-level (~/.claude/CLAUDE.md) or Project-level (./CLAUDE.md)
2. **Scans plugins** - Finds all installed marketplace plugins
3. **Extracts information** - Reads plugin.json, skills, and commands
4. **Generates section** - Creates formatted markdown documentation
5. **Adds to CLAUDE.md** - Appends or updates the plugins section

## What Gets Created

**marketplace-plugins.md:**
```markdown
# Cadrianmae Marketplace Plugins

Available plugins from cadrianmae-claude-marketplace.

## Plugin: semantic-search

**Version:** 1.0.0
**Description:** Semantic search with query inference

**Skills:**
- `semantic-search` - Natural language code search

**Commands:**
- `/semq:search <query>` - Search indexed codebase
- `/semq:here <query>` - Search with traversal
- `/semq:index` - Create index
- `/semq:status` - Show stats

**Usage:** Auto-invokes on "where is..." queries

---

## Plugin: pandoc

**Version:** 1.0.0
**Description:** Document conversion toolkit

**Skills:**
- `pandoc` - Document conversion with templates

**Commands:**
- `/pandoc:help` - Plugin overview
- `/pandoc:convert` - Convert documents
- `/pandoc:validate` - Validate frontmatter
- `/pandoc:restyle` - Transform styles

**Usage:** Auto-invokes for document conversion

---

*Last updated: 2025-11-19*
*Generated by cadrianmae-integration*
```

**Added to CLAUDE.md:**
```markdown
# Marketplace Plugins
@ ~/.claude/marketplace-plugins.md
```

## Scope Selection

**User-level** (`~/.claude/CLAUDE.md`):
- Available in ALL projects
- Use for plugins you use everywhere
- Example: semantic-search, datetime

**Project-level** (`./CLAUDE.md`):
- Only available in THIS project
- Use for project-specific workflows
- Example: Project uses pandoc for reports

## When to Use

Run `/integrate` when you:
- Install new marketplace plugins
- Set up a new project
- Want to document available tools
- Update plugin documentation

## Related Commands

- `/plugin list` - List all installed plugins
- `/skill` - Invoke specific skills
- `/help` - General Claude Code help