gh-cadrianmae-claude-marketplace-plugins-cadrianmae-integration/skills/integration/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
integration	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.	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

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

# 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:

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:

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:

# 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:

# 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/