From a7979c466df9c81e68f922f45327c699c8fa0797 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sat, 29 Nov 2025 18:03:02 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 12 ++ README.md | 3 + commands/integrate.md | 104 ++++++++++++++ plugin.lock.json | 49 +++++++ skills/integration/SKILL.md | 277 ++++++++++++++++++++++++++++++++++++ 5 files changed, 445 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 commands/integrate.md create mode 100644 plugin.lock.json create mode 100644 skills/integration/SKILL.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..f9fd3ef --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "cadrianmae-integration", + "description": "Integrate marketplace plugins into CLAUDE.md with user/project scope selection", + "version": "1.0.0", + "author": "cadrianmae", + "skills": [ + "./skills" + ], + "commands": [ + "./commands" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..a88145f --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# cadrianmae-integration + +Integrate marketplace plugins into CLAUDE.md with user/project scope selection diff --git a/commands/integrate.md b/commands/integrate.md new file mode 100644 index 0000000..65ee230 --- /dev/null +++ b/commands/integrate.md @@ -0,0 +1,104 @@ +--- +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 ` - Search indexed codebase +- `/semq:here ` - 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 diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..d5ca4e8 --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,49 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:cadrianmae/claude-marketplace:plugins/cadrianmae-integration", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "1dfd36adf7f6e91032f2eeddd0b0bcc711e90031", + "treeHash": "f0a970ea4333457cee6d5abb7272636b7797b2d7eb3a0d65de4a32225f5c3332", + "generatedAt": "2025-11-28T10:14:28.794310Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "cadrianmae-integration", + "description": "Integrate marketplace plugins into CLAUDE.md with user/project scope selection", + "version": "1.0.0" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "cc5567c6464304b49db8011f8bb7dbc416441a2d4abd4916781457fe965a9552" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "964bed8f4c56f3eb5b2a70cfb6c278b8ba9abb5b262cdae18c53d97eebf1bf3a" + }, + { + "path": "commands/integrate.md", + "sha256": "c18babe93920144682880ead68df5e273e13420cd7309941c7574ce097edb932" + }, + { + "path": "skills/integration/SKILL.md", + "sha256": "272c85e8566ebf7dc557098bec2e20dde3272a9e07dd8498b988651b79e26c9f" + } + ], + "dirSha256": "f0a970ea4333457cee6d5abb7272636b7797b2d7eb3a0d65de4a32225f5c3332" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/integration/SKILL.md b/skills/integration/SKILL.md new file mode 100644 index 0000000..fc6971a --- /dev/null +++ b/skills/integration/SKILL.md @@ -0,0 +1,277 @@ +--- +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 ` - Search indexed codebase +- `/semq:here ` - 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/`