---
name: integration
description: Integrate cadrianmae marketplace plugins into CLAUDE.md. Scans installed plugins and generates documentation section listing available skills and commands. User chooses between user-level (global) or project-level (current project only) integration.
allowed-tools: Bash, Read, Write, Edit, AskUserQuestion
---

# Cadrianmae Marketplace Integration

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

## Overview

This skill helps integrate marketplace plugins into your workflow by:
1. Scanning installed plugins from cadrianmae-claude-marketplace
2. Extracting skills and commands from each plugin
3. Generating a structured reference section
4. Adding to user-level or project-level CLAUDE.md

## When to Use

- After installing new marketplace plugins
- Setting up a new project
- Updating documentation of available tools
- Creating project-specific plugin references

## Workflow

### 1. Ask User for Scope

Use AskUserQuestion to determine integration level:

```
Question: "Where should I add the marketplace plugin documentation?"
Options:
  - "User-level (~/.claude/CLAUDE.md)" - Available in all projects
  - "Project-level (./CLAUDE.md)" - Only this project
```

### 2. Scan Installed Plugins

```bash
MARKETPLACE_DIR=~/.claude/marketplaces/cadrianmae-claude-marketplace/plugins

# List all installed plugins
for plugin in "$MARKETPLACE_DIR"/*/; do
    plugin_name=$(basename "$plugin")
    echo "Found: $plugin_name"
done
```

### 3. Extract Plugin Information

For each plugin, read:
- `plugin.json` - Plugin metadata (name, version, description)
- `skills/*/SKILL.md` - Skill information
- `commands/*.md` - Slash command list

### 4. Generate Documentation File

Create separate markdown file with plugin documentation:

**File:** `marketplace-plugins.md`

```markdown
# Cadrianmae Marketplace Plugins

Available plugins from cadrianmae-claude-marketplace.

## Plugin: semantic-search

**Version:** 1.0.0
**Description:** Semantic search across codebases using odino

**Skills:**
- `semantic-search` - Natural language code search with query inference

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

**Usage:** Auto-invokes on "where is..." or "find code that..." queries

---

## Plugin: pandoc

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

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

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

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

---

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

### 5. Add Import to CLAUDE.md

Use import syntax: `@ path/to/file` (no space between @ and path).
Supports up to 5 nesting levels. Imports inside code blocks are ignored.

**User-level:**
```bash
CLAUDE_FILE=~/.claude/CLAUDE.md
PLUGINS_DOC=~/.claude/marketplace-plugins.md

# Write plugin documentation to separate file
cat > "$PLUGINS_DOC" << 'EOF'
# Cadrianmae Marketplace Plugins
...
EOF

# Add import to CLAUDE.md if not already present
IMPORT_LINE="@ ~/.claude/marketplace-plugins.md"
if ! grep -q "@ ~/.claude/marketplace-plugins.md" "$CLAUDE_FILE"; then
    echo "" >> "$CLAUDE_FILE"
    echo "# Marketplace Plugins" >> "$CLAUDE_FILE"
    echo "$IMPORT_LINE" >> "$CLAUDE_FILE"
fi
```

**Project-level:**
```bash
CLAUDE_FILE=./CLAUDE.md
PLUGINS_DOC=./marketplace-plugins.md

# Write plugin documentation
cat > "$PLUGINS_DOC" << 'EOF'
# Project-Specific Plugin Documentation
...
EOF

# Create CLAUDE.md if doesn't exist
if [[ ! -f "$CLAUDE_FILE" ]]; then
    echo "# Project CLAUDE.md" > "$CLAUDE_FILE"
    echo "" >> "$CLAUDE_FILE"
fi

# Add import
IMPORT_LINE="@ ./marketplace-plugins.md"
if ! grep -q "@ ./marketplace-plugins.md" "$CLAUDE_FILE"; then
    echo "" >> "$CLAUDE_FILE"
    echo "# Marketplace Plugins" >> "$CLAUDE_FILE"
    echo "$IMPORT_LINE" >> "$CLAUDE_FILE"
fi
```

**Import syntax rules:**
- Format: `@ path` (@ immediately followed by path, space for display only)
- Relative: `@ ./file.md` or `@ subdir/file.md`
- Absolute: `@ /absolute/path/file.md`
- Home dir: `@ ~/.claude/file.md`
- Code blocks: Imports in backticks/code blocks are ignored
- Nesting: Max 5 levels deep
- Verify: Use `/memory` command to check loaded imports

**Benefits:**
- Clean separation of concerns
- Update plugin docs without touching CLAUDE.md
- Easier to maintain and regenerate
- Can share plugin docs across multiple CLAUDE.md files

## Output Format

After completion, show:
```
✓ Marketplace integration complete

Files created:
  ~/.claude/marketplace-plugins.md (plugin documentation)

Import added to:
  ~/.claude/CLAUDE.md

  Added line:
  @ ~/.claude/marketplace-plugins.md

Plugins documented:
  • semantic-search (1.0.0)
  • pandoc (1.0.0)
  • cadrianmae-integration (1.0.0)

3 plugins, 3 skills, 11 commands

Plugin docs will be loaded in all Claude Code sessions!
Verify with: /memory
```

## Edge Cases

**No plugins installed:**
```
No marketplace plugins found in:
  ~/.claude/marketplaces/cadrianmae-claude-marketplace/plugins/

Install plugins first, then run this skill.
```

**Section already exists:**
Ask user:
- Replace existing section
- Append to existing section
- Cancel

**File locations:**
- User-level: `~/.claude/CLAUDE.md` (affects all projects)
- Project-level: `./CLAUDE.md` (workspace root, affects only this project)

## Best Practices

1. **Run after installing plugins** - Keep documentation current
2. **Choose scope wisely:**
   - User-level: Plugins you use in all projects
   - Project-level: Project-specific plugin workflows
3. **Update regularly** - Re-run when adding/removing plugins
4. **Review generated section** - Verify accuracy before committing

## Example Integration

**User-level CLAUDE.md:**
```markdown
# CLAUDE.md (Global)

## User Context
...

## Coding Preferences
...

## Cadrianmae Marketplace Plugins

Available plugins from cadrianmae-claude-marketplace.

### Plugin: semantic-search
...

### Plugin: pandoc
...
```

**Project-level CLAUDE.md:**
```markdown
# Project: Data Pipeline

## Project Context
This project uses semantic-search for finding algorithm implementations
and pandoc for generating reports.

## Cadrianmae Marketplace Plugins

### Plugin: semantic-search
**Primary use:** Finding ML algorithm implementations in knowledge base
**Commands used:** /semq:search, /semq:here

### Plugin: pandoc
**Primary use:** Converting weekly reports to PDF
**Commands used:** /pandoc:convert, /pandoc:validate
```

## Related

- Global CLAUDE.md: `~/.claude/CLAUDE.md`
- Project CLAUDE.md: `./CLAUDE.md` (workspace root)
- Plugin directory: `~/.claude/marketplaces/cadrianmae-claude-marketplace/plugins/`