claude-setup 1.1.8 → 1.1.9

package/dist/builder.js

@@ -21,10 +21,16 @@ function replaceVars(template, vars) {
 }
 function processConditionals(template, flags) {
     let result = template;
-    // {{#if VAR}}...{{else}}...{{/if}}
-    result = result.replace(/\{\{#if\s+(\w+)\}\}\n?([\s\S]*?)\{\{else\}\}\n?([\s\S]*?)\{\{\/if\}\}/g, (_m, key, ifBlock, elseBlock) => flags[key] ? ifBlock : elseBlock);
-    // {{#if VAR}}...{{/if}}
-    result = result.replace(/\{\{#if\s+(\w+)\}\}\n?([\s\S]*?)\{\{\/if\}\}/g, (_m, key, block) => flags[key] ? block : "");
+    // Process innermost conditionals first, repeat until stable.
+    // This prevents outer {{#if}} from greedily matching inner {{else}}/{{/if}}.
+    let prev = "";
+    while (prev !== result) {
+        prev = result;
+        // {{#if VAR}}...{{else}}...{{/if}} first (innermost — no nested {{#if}} in either branch)
+        result = result.replace(/\{\{#if\s+(\w+)\}\}\n?((?:(?!\{\{#if\b)[\s\S])*?)\{\{else\}\}\n?((?:(?!\{\{#if\b)[\s\S])*?)\{\{\/if\}\}/g, (_m, key, ifBlock, elseBlock) => flags[key] ? ifBlock : elseBlock);
+        // Simple {{#if VAR}}...{{/if}} (no else, no nested if inside)
+        result = result.replace(/\{\{#if\s+(\w+)\}\}\n?((?:(?!\{\{#if\b|\{\{else\}\})[\s\S])*?)\{\{\/if\}\}/g, (_m, key, block) => flags[key] ? block : "");
+    }
     return result;
 }
 function formatList(items) {

package/dist/marketplace.d.ts

@@ -1,34 +1,39 @@
 /**
  * Marketplace intelligence — provides catalog info and decision logic
- * for the add command to suggest plugins, skills, and MCP servers.
+ * for the add command to suggest plugins, skills, MCP servers, and agents.
+ *
+ * Implements the 4-catalog exhaustion pipeline (Rule 6) with 3-stage
+ * fetch resolution (Rule 7): find entry → navigate directory → download content.
  *
  * Zero API calls at import time. Catalog is fetched only when needed.
  */
+export declare const VOLTAGENT_SUBAGENTS_REPO = "VoltAgent/awesome-claude-code-subagents";
+export declare const VOLTAGENT_SUBAGENTS_API = "https://api.github.com/repos/VoltAgent/awesome-claude-code-subagents/contents/categories";
+export declare const VOLTAGENT_SUBAGENTS_RAW = "https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories";
+export declare const VOLTAGENT_CATEGORIES: readonly ["01-core-development", "02-language-specialists", "03-infrastructure", "04-quality-security", "05-data-ai", "06-developer-experience", "07-specialized-domains", "08-business-product", "09-meta-orchestration", "10-research-analysis"];
 export declare const MARKETPLACE_REPO = "jeremylongshore/claude-code-plugins-plus-skills";
 export declare const MARKETPLACE_CATALOG_URL = "https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/main/.claude-plugin/marketplace.extended.json";
-/** Additional marketplace sources for broader coverage */
-export declare const ADDITIONAL_MARKETPLACE_SOURCES: readonly [{
-    readonly name: "claude-plugins-official";
-    readonly description: "Official Anthropic plugins (GitHub, Slack, Linear, Notion, etc.)";
-    readonly installPrefix: "claude-plugins-official";
-    readonly note: "No marketplace add needed — available by default";
-}, {
-    readonly name: "awesome-claude-code";
-    readonly description: "Community collection of Claude Code skills and workflows";
-    readonly catalogUrl: "https://raw.githubusercontent.com/hesreallyhim/awesome-claude-code/main/catalog.json";
-    readonly installPrefix: null;
-    readonly note: "Browse and manually install skills";
-}];
+export declare const VOLTAGENT_SKILLS_REPO = "VoltAgent/awesome-agent-skills";
+export declare const VOLTAGENT_SKILLS_API = "https://api.github.com/repos/VoltAgent/awesome-agent-skills/contents";
+export declare const COMPOSIO_REPO = "ComposioHQ/awesome-claude-skills";
+export declare const COMPOSIO_API = "https://api.github.com/repos/ComposioHQ/awesome-claude-skills/contents";
+export declare const COMPOSIO_RAW = "https://raw.githubusercontent.com/ComposioHQ/awesome-claude-skills/master";
 /** The 20 skill categories in the marketplace */
 export declare const SKILL_CATEGORIES: readonly ["01-code-quality", "02-testing", "03-security", "04-devops", "05-api-development", "06-database", "07-frontend", "08-backend", "09-mobile", "10-data-science", "11-documentation", "12-project-management", "13-communication", "14-research", "15-content-creation", "16-business", "17-finance", "18-visual-content", "19-legal", "20-productivity"];
 /** SaaS packs available in the marketplace */
 export declare const SAAS_PACKS: readonly ["Supabase", "Vercel", "OpenRouter", "GitHub", "Azure", "MongoDB", "Playwright", "Tavily", "Stripe", "Slack", "Linear", "Notion"];
-/** Keyword-to-category mapping for classifying user requests */
+/** Keyword-to-category mapping for classifying skill requests */
 export declare const KEYWORD_CATEGORY_MAP: Record<string, string>;
-/** Classify a user request into marketplace categories */
-export declare function classifyRequest(input: string): {
+export interface ClassificationResult {
     categories: string[];
     saasMatches: string[];
-};
-/** Generate fully-automated marketplace search and install instructions */
+    isAgent: boolean;
+    agentCategories: string[];
+}
+/** Detect whether the request is about agents/subagents/orchestration */
+export declare function isAgentRequest(input: string): boolean;
+/** Map input to VoltAgent agent category directories */
+export declare function matchAgentCategories(input: string): string[];
+/** Classify a user request into marketplace categories and detect agent requests */
+export declare function classifyRequest(input: string): ClassificationResult;
 export declare function buildMarketplaceInstructions(input: string): string;

package/dist/marketplace.js

@@ -1,27 +1,38 @@
 /**
  * Marketplace intelligence — provides catalog info and decision logic
- * for the add command to suggest plugins, skills, and MCP servers.
+ * for the add command to suggest plugins, skills, MCP servers, and agents.
+ *
+ * Implements the 4-catalog exhaustion pipeline (Rule 6) with 3-stage
+ * fetch resolution (Rule 7): find entry → navigate directory → download content.
  *
  * Zero API calls at import time. Catalog is fetched only when needed.
  */
+// ── Source 1: VoltAgent subagents (agents/sub-agents) ────────────────
+export const VOLTAGENT_SUBAGENTS_REPO = "VoltAgent/awesome-claude-code-subagents";
+export const VOLTAGENT_SUBAGENTS_API = `https://api.github.com/repos/${VOLTAGENT_SUBAGENTS_REPO}/contents/categories`;
+export const VOLTAGENT_SUBAGENTS_RAW = `https://raw.githubusercontent.com/${VOLTAGENT_SUBAGENTS_REPO}/main/categories`;
+export const VOLTAGENT_CATEGORIES = [
+    "01-core-development",
+    "02-language-specialists",
+    "03-infrastructure",
+    "04-quality-security",
+    "05-data-ai",
+    "06-developer-experience",
+    "07-specialized-domains",
+    "08-business-product",
+    "09-meta-orchestration",
+    "10-research-analysis",
+];
+// ── Source 2: Community skills catalog (416+ plugins) ───────────────────
 export const MARKETPLACE_REPO = "jeremylongshore/claude-code-plugins-plus-skills";
 export const MARKETPLACE_CATALOG_URL = `https://raw.githubusercontent.com/${MARKETPLACE_REPO}/main/.claude-plugin/marketplace.extended.json`;
-/** Additional marketplace sources for broader coverage */
-export const ADDITIONAL_MARKETPLACE_SOURCES = [
-    {
-        name: "claude-plugins-official",
-        description: "Official Anthropic plugins (GitHub, Slack, Linear, Notion, etc.)",
-        installPrefix: "claude-plugins-official",
-        note: "No marketplace add needed — available by default"
-    },
-    {
-        name: "awesome-claude-code",
-        description: "Community collection of Claude Code skills and workflows",
-        catalogUrl: "https://raw.githubusercontent.com/hesreallyhim/awesome-claude-code/main/catalog.json",
-        installPrefix: null,
-        note: "Browse and manually install skills"
-    }
-];
+// ── Source 3: VoltAgent curated agent skills ────────────────────────────
+export const VOLTAGENT_SKILLS_REPO = "VoltAgent/awesome-agent-skills";
+export const VOLTAGENT_SKILLS_API = `https://api.github.com/repos/${VOLTAGENT_SKILLS_REPO}/contents`;
+// ── Source 4: ComposioHQ service integrations (1000+) ───────────────────
+export const COMPOSIO_REPO = "ComposioHQ/awesome-claude-skills";
+export const COMPOSIO_API = `https://api.github.com/repos/${COMPOSIO_REPO}/contents`;
+export const COMPOSIO_RAW = `https://raw.githubusercontent.com/${COMPOSIO_REPO}/master`;
 /** The 20 skill categories in the marketplace */
 export const SKILL_CATEGORIES = [
     "01-code-quality", "02-testing", "03-security",
@@ -37,7 +48,71 @@ export const SAAS_PACKS = [
     "Supabase", "Vercel", "OpenRouter", "GitHub", "Azure", "MongoDB",
     "Playwright", "Tavily", "Stripe", "Slack", "Linear", "Notion",
 ];
-/** Keyword-to-category mapping for classifying user requests */
+// ── Agent detection keywords ────────────────────────────────────────────
+const AGENT_KEYWORDS = [
+    "agent", "subagent", "sub-agent", "orchestrat", "multi-agent",
+    "coordinator", "dispatcher", "workflow agent", "task routing",
+    "agent system", "agent framework", "meta-agent",
+];
+/** Map agent keywords to VoltAgent category directories */
+const AGENT_CATEGORY_MAP = {
+    // Meta / orchestration
+    "orchestrat": "09-meta-orchestration",
+    "coordinator": "09-meta-orchestration",
+    "dispatcher": "09-meta-orchestration",
+    "multi-agent": "09-meta-orchestration",
+    "meta-agent": "09-meta-orchestration",
+    "task routing": "09-meta-orchestration",
+    "workflow agent": "09-meta-orchestration",
+    "workflow orchestrat": "09-meta-orchestration",
+    // Core development
+    "code review agent": "01-core-development",
+    "api design": "01-core-development",
+    "refactor": "01-core-development",
+    // Language specialists
+    "typescript agent": "02-language-specialists",
+    "python agent": "02-language-specialists",
+    "rust agent": "02-language-specialists",
+    "go agent": "02-language-specialists",
+    "java agent": "02-language-specialists",
+    "powershell": "02-language-specialists",
+    // Infrastructure
+    "infra": "03-infrastructure",
+    "devops agent": "03-infrastructure",
+    "docker agent": "03-infrastructure",
+    "kubernetes agent": "03-infrastructure",
+    "cloud agent": "03-infrastructure",
+    "azure agent": "03-infrastructure",
+    "aws agent": "03-infrastructure",
+    // Quality & security
+    "security agent": "04-quality-security",
+    "test agent": "04-quality-security",
+    "qa agent": "04-quality-security",
+    "audit agent": "04-quality-security",
+    // Data & AI
+    "data agent": "05-data-ai",
+    "data pipeline": "05-data-ai",
+    "data engineer": "05-data-ai",
+    "ml agent": "05-data-ai",
+    "ml pipeline": "05-data-ai",
+    "ai agent": "05-data-ai",
+    // Developer experience
+    "dx agent": "06-developer-experience",
+    "productivity agent": "06-developer-experience",
+    "documentation agent": "06-developer-experience",
+    // Specialized
+    "domain agent": "07-specialized-domains",
+    "iot agent": "07-specialized-domains",
+    "embedded agent": "07-specialized-domains",
+    // Business
+    "business agent": "08-business-product",
+    "product agent": "08-business-product",
+    "pm agent": "08-business-product",
+    // Research
+    "research agent": "10-research-analysis",
+    "analysis agent": "10-research-analysis",
+};
+/** Keyword-to-category mapping for classifying skill requests */
 export const KEYWORD_CATEGORY_MAP = {
     // Code quality
     "lint": "01-code-quality", "format": "01-code-quality", "prettier": "01-code-quality",
@@ -79,13 +154,42 @@ export const KEYWORD_CATEGORY_MAP = {
     // Project management
     "project management": "12-project-management", "agile": "12-project-management",
     "sprint": "12-project-management", "kanban": "12-project-management",
+    // Communication
+    "slack": "13-communication", "email": "13-communication", "notification": "13-communication",
+    "discord": "13-communication", "telegram": "13-communication",
+    // Content
+    "content": "15-content-creation", "blog": "15-content-creation",
+    "seo": "15-content-creation", "copywriting": "15-content-creation",
+    // Productivity
+    "productivity": "20-productivity", "automation": "20-productivity",
+    "workflow": "20-productivity",
 };
-/** Classify a user request into marketplace categories */
+/** Detect whether the request is about agents/subagents/orchestration */
+export function isAgentRequest(input) {
+    const lower = input.toLowerCase();
+    return AGENT_KEYWORDS.some(kw => lower.includes(kw));
+}
+/** Map input to VoltAgent agent category directories */
+export function matchAgentCategories(input) {
+    const lower = input.toLowerCase();
+    const matched = new Set();
+    for (const [keyword, category] of Object.entries(AGENT_CATEGORY_MAP)) {
+        if (lower.includes(keyword)) {
+            matched.add(category);
+        }
+    }
+    // Default to meta-orchestration for generic agent requests
+    if (matched.size === 0 && isAgentRequest(input)) {
+        matched.add("09-meta-orchestration");
+    }
+    return [...matched];
+}
+/** Classify a user request into marketplace categories and detect agent requests */
 export function classifyRequest(input) {
     const lower = input.toLowerCase();
     const categories = new Set();
     const saasMatches = [];
-    // Check keyword matches
+    // Check keyword matches for skills
     for (const [keyword, category] of Object.entries(KEYWORD_CATEGORY_MAP)) {
         if (lower.includes(keyword)) {
             categories.add(category);
@@ -97,121 +201,359 @@ export function classifyRequest(input) {
             saasMatches.push(saas);
         }
     }
-    return { categories: [...categories], saasMatches };
+    return {
+        categories: [...categories],
+        saasMatches,
+        isAgent: isAgentRequest(input),
+        agentCategories: matchAgentCategories(input),
+    };
 }
-/** Generate fully-automated marketplace search and install instructions */
+// ── Marketplace instruction builder ─────────────────────────────────────
+// Implements Rule 6 (4-catalog exhaustion) and Rule 7 (3-stage fetch).
+// Agent requests route to VoltAgent subagents first.
+// Skill requests route to jeremylongshore → VoltAgent skills → ComposioHQ.
 export function buildMarketplaceInstructions(input) {
-    const { categories, saasMatches } = classifyRequest(input);
+    const classification = classifyRequest(input);
+    const { categories, saasMatches, isAgent: isAgentReq, agentCategories } = classification;
     const categoryFilter = categories[0] ?? "";
     const lines = [];
     lines.push(`## Marketplace — fully automated install (DO NOT ASK — JUST DO IT)`);
     lines.push(``);
-    lines.push(`A plugin marketplace has 416 community skills + 13 official Anthropic plugins.`);
-    lines.push(`Follow the steps below IN ORDER. Execute every command yourself. Do not stop until a skill is installed.`);
-    lines.push(`**DO NOT ask the user clarifying questions. DO NOT suggest commands for the user to run. Execute them yourself.**`);
+    lines.push(`4 catalogs available. You MUST search them ALL in order before giving up.`);
+    lines.push(`A fetch failure is NOT a stop condition — it is a routing signal to the next source.`);
+    lines.push(`**DO NOT ask the user clarifying questions. Execute every command yourself.**`);
+    lines.push(`**Rate-limit safe:** all api.github.com calls include GITHUB_TOKEN when set (5000/hr vs 60/hr).`);
+    lines.push(`Downloads use raw.githubusercontent.com (no limit). For heavy usage (10+ installs/hr), set GITHUB_TOKEN.`);
     lines.push(``);
-    if (categories.length > 0 || saasMatches.length > 0) {
-        lines.push(`### Matched for "${input}":`);
+    if (isAgentReq || categories.length > 0 || saasMatches.length > 0) {
+        lines.push(`### Classification for "${input}":`);
+        if (isAgentReq)
+            lines.push(`- **Type: AGENT** — routing to agent catalogs first`);
+        for (const cat of agentCategories)
+            lines.push(`- agent-category: ${cat}`);
         for (const cat of categories)
-            lines.push(`- category: ${cat}`);
+            lines.push(`- skill-category: ${cat}`);
         for (const saas of saasMatches)
             lines.push(`- SaaS: ${saas}`);
         lines.push(``);
     }
+    // ── Universal resolution rules (applies to every catalog) ──────
+    buildUniversalRulesBlock(lines);
+    // ── Route based on request type ───────────────────────────────────
+    if (isAgentReq) {
+        buildAgentPipeline(lines, input, agentCategories, categoryFilter);
+    }
+    else {
+        buildSkillPipeline(lines, input, categoryFilter, saasMatches);
+    }
+    // ── Install result format ─────────────────────────────────────────
     lines.push(`---`);
     lines.push(``);
-    lines.push(`### STEP 1 — Try official Anthropic plugins first (no schema errors, always works)`);
+    lines.push(`### Install result format`);
+    lines.push(`After installing, confirm with one of:`);
+    if (isAgentReq) {
+        lines.push(`✅ Agent installed: .claude/agents/<name>.md — [one line: what it orchestrates]`);
+        lines.push(`✅ Then add to CLAUDE.md agents section (separate from skills)`);
+    }
+    else {
+        lines.push(`✅ Installed: .claude/skills/<name>/SKILL.md — [one line: what it does]`);
+    }
+    lines.push(`⏭ No match in [source] — moving to next catalog`);
+    lines.push(`🔧 All 4 catalogs exhausted — created production-quality custom ${isAgentReq ? "agent" : "skill"}`);
+    lines.push(``);
+    return lines.join("\n");
+}
+// ── Agent pipeline (VoltAgent subagents → skills fallback) ──────────
+function buildAgentPipeline(lines, input, agentCategories, categoryFilter) {
+    const safeName = input.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    const targetCategories = agentCategories.length > 0
+        ? agentCategories
+        : ["09-meta-orchestration"];
+    // ── STEP 1: VoltAgent/awesome-claude-code-subagents ──────────────
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 1 — VoltAgent subagents (PRIMARY source for agents — 127+ specialized agents)`);
+    lines.push(``);
+    lines.push(`This is the preferred source for anything agent-shaped. 10 categories, 127+ agents.`);
+    lines.push(`If a match is found here, install to \`.claude/agents/\` (NOT .claude/skills/).`);
+    lines.push(``);
+    lines.push(`**1a. List agent files in the matched categories:**`);
+    lines.push(`If any curl below fails, skip to the next category or STEP 2 immediately.`);
+    lines.push(``);
+    for (const cat of targetCategories) {
+        lines.push(`\`\`\`bash`);
+        lines.push(`# Category: ${cat}`);
+        lines.push(`curl -sf \${GITHUB_TOKEN:+-H "Authorization: token \$GITHUB_TOKEN"} "${VOLTAGENT_SUBAGENTS_API}/${cat}" \\`);
+        lines.push(`  | node -e "const d=JSON.parse(require('fs').readFileSync(0,'utf8'));` +
+            `if(!Array.isArray(d)){console.log('SKIP');process.exit(0)}` +
+            `d.filter(x=>x.name.endsWith('.md')&&x.name!=='README.md').forEach(x=>console.log(x.name))"`);
+        lines.push(`\`\`\``);
+        lines.push(``);
+    }
+    lines.push(`**1b. From the file list above, pick the BEST match for "${input}".**`);
+    lines.push(`Match by name and relevance. If multiple candidates exist, pick the closest one.`);
     lines.push(``);
+    lines.push(`**1c. Download the matched agent file (3-stage resolution — this is stage 3):**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Replace CATEGORY and AGENT_FILE with actual values from 1a/1b`);
+    lines.push(`CATEGORY="${targetCategories[0]}"`);
+    lines.push(`AGENT_FILE="matched-agent.md"`);
+    lines.push(`mkdir -p ".claude/agents"`);
+    lines.push(`curl -sf "${VOLTAGENT_SUBAGENTS_RAW}/\${CATEGORY}/\${AGENT_FILE}" \\`);
+    lines.push(`  -o ".claude/agents/\${AGENT_FILE}"`);
     lines.push(`\`\`\``);
-    lines.push(`/plugin marketplace add anthropics/claude-code`);
+    lines.push(``);
+    lines.push(`**1d. Verify the file has real content (Rule 7 — must not be empty):**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# File must have frontmatter (---) and body content`);
+    lines.push(`head -3 ".claude/agents/\${AGENT_FILE}"`);
+    lines.push(`wc -l ".claude/agents/\${AGENT_FILE}"`);
     lines.push(`\`\`\``);
-    lines.push(`Then search installed plugins for a match. If found, install:`);
+    lines.push(`If the file is empty or just frontmatter with no body: delete it, log the failure, continue to STEP 2.`);
+    lines.push(`If the file has real content: agent is installed. Skip to "Install result format" below.`);
+    lines.push(``);
+    lines.push(`**README-driven fallback:** If a category listing returns a README.md instead of agent files,`);
+    lines.push(`parse the README for entries with links. Entries may point to external repos — follow them`);
+    lines.push(`using the universal URL resolution rules (extract {owner}/{repo} dynamically from the link).`);
+    lines.push(`Navigate the foreign repo to locate the agent .md file and download it.`);
+    lines.push(``);
+    // ── STEP 2: jeremylongshore community skills (fallback for agents) ─
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 2 — Community skills catalog (fallback — 416 plugins)`);
+    lines.push(``);
+    lines.push(`Only reach here if STEP 1 found no match.`);
+    lines.push(`Search for agent-like skills in the community catalog.`);
+    lines.push(`If curl fails, skip to STEP 3.`);
+    lines.push(``);
+    buildCommunitySkillsFetchBlock(lines, categoryFilter);
+    // ── STEP 3: ComposioHQ (fallback for SaaS/integration agents) ─────
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 3 — ComposioHQ service integrations (1000+ skills — fallback)`);
+    lines.push(``);
+    lines.push(`Only reach here if STEP 1 and 2 found no match.`);
+    lines.push(`Strong for API and SaaS automation. Skills live in per-directory SKILL.md files.`);
+    lines.push(`If curl fails, skip to STEP 4.`);
+    lines.push(``);
+    buildComposioFetchBlock(lines, input);
+    // ── STEP 4: Create custom agent ───────────────────────────────────
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 4 — All 3 catalogs exhausted. Create a production-quality custom agent.`);
+    lines.push(``);
+    lines.push(`You MUST have attempted all 3 sources above with real fetch calls before reaching here.`);
+    lines.push(`The custom agent must be production-valid on first write (Rule 4). No placeholders.`);
+    lines.push(``);
+    lines.push(`\`\`\`bash`);
+    lines.push(`mkdir -p ".claude/agents"`);
     lines.push(`\`\`\``);
-    lines.push(`/plugin install <name>@claude-code-plugins`);
+    lines.push(`Then create \`.claude/agents/${safeName}.md\` with:`);
+    lines.push(`\`\`\`yaml`);
+    lines.push(`---`);
+    lines.push(`name: ${safeName}`);
+    lines.push(`description: "${input}"`);
+    lines.push(`tools: Read, Write, Edit, Bash, Glob, Grep`);
+    lines.push(`model: sonnet`);
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`[Complete agent instructions — task routing, responsibilities, integration points]`);
     lines.push(`\`\`\``);
-    lines.push(`Official plugins: agent-sdk-dev, claude-opus-4-5-migration, code-review, commit-commands,`);
+    lines.push(`The body must contain real, actionable agent instructions — not a template stub.`);
+    lines.push(``);
+}
+// ── Skill pipeline (community → VoltAgent skills → ComposioHQ) ──────
+function buildSkillPipeline(lines, input, categoryFilter, saasMatches) {
+    const safeName = input.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    // ── STEP 1: Official Anthropic plugins ────────────────────────────
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 1 — Official Anthropic plugins (always work, no schema errors)`);
+    lines.push(``);
+    lines.push(`Check if any of these 13 official plugins match the request:`);
+    lines.push(`agent-sdk-dev, claude-opus-4-5-migration, code-review, commit-commands,`);
     lines.push(`explanatory-output-style, feature-dev, frontend-design, hookify, learning-output-style,`);
     lines.push(`plugin-dev, pr-review-toolkit, ralph-wiggum, security-guidance`);
     lines.push(``);
+    lines.push(`If a name above matches "${input}": install with \`/plugin install <name>@claude-code-plugins\``);
+    lines.push(`If no match, continue to STEP 2.`);
+    lines.push(``);
+    // ── STEP 2: jeremylongshore community skills ──────────────────────
     lines.push(`---`);
     lines.push(``);
-    lines.push(`### STEP 2 — Search community catalog (jeremylongshore — 416 plugins)`);
+    lines.push(`### STEP 2 — Community skills catalog (jeremylongshore — 416 plugins)`);
     lines.push(``);
     lines.push(`NOTE: /plugin marketplace add FAILS for this repo (one entry has broken schema).`);
-    lines.push(`Use the DIRECT FETCH approach below instead — no marketplace add needed.`);
-    lines.push(`If the curl command fails or returns an error, skip to STEP 3 immediately — do NOT stop.`);
+    lines.push(`Use the DIRECT FETCH approach below. If curl fails, skip to STEP 3.`);
     lines.push(``);
-    lines.push(`**2a. Fetch catalog and find matching plugin:**`);
-    lines.push(`\`\`\`bash`);
-    lines.push(`curl -s "${MARKETPLACE_CATALOG_URL}" \\`);
-    lines.push(`  | node -e "const d=JSON.parse(require('fs').readFileSync(0,'utf8'));const q='${categoryFilter}';const r=d.plugins.filter(p=>(q===''||p.category.includes(q))&&p.name&&p.source).slice(0,10).map(p=>({name:p.name,source:p.source,desc:p.description}));console.log(JSON.stringify(r,null,2));"`);
-    lines.push(`\`\`\``);
+    buildCommunitySkillsFetchBlock(lines, categoryFilter);
+    // ── STEP 3: VoltAgent curated skills ──────────────────────────────
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`### STEP 3 — VoltAgent curated agent skills (production-proven)`);
     lines.push(``);
-    lines.push(`**2b. Pick the best match — get its source path (e.g. \`./plugins/productivity/my-skill\`)**`);
+    lines.push(`Only reach here if STEP 2 found no match.`);
+    lines.push(`Curated real-world skills from engineering teams. If curl fails, skip to STEP 4.`);
     lines.push(``);
-    lines.push(`**2c. List the skills inside that plugin:**`);
     lines.push(`\`\`\`bash`);
-    lines.push(`# Replace PLUGIN_SOURCE_PATH with value from step 2b (e.g. plugins/productivity/my-skill)`);
-    lines.push(`PLUGIN_SOURCE_PATH="plugins/productivity/my-skill"`);
-    lines.push(`curl -s "https://api.github.com/repos/${MARKETPLACE_REPO}/contents/\${PLUGIN_SOURCE_PATH}/skills" \\`);
-    lines.push(`  | node -e "const a=JSON.parse(require('fs').readFileSync(0,'utf8'));console.log(a.map(x=>x.name).join('\\n'));"`);
+    lines.push(`curl -sf \${GITHUB_TOKEN:+-H "Authorization: token \$GITHUB_TOKEN"} "${VOLTAGENT_SKILLS_API}" \\`);
+    lines.push(`  | node -e "const d=JSON.parse(require('fs').readFileSync(0,'utf8'));` +
+        `if(!Array.isArray(d)){console.log('SKIP');process.exit(0)}` +
+        `d.filter(x=>x.type==='dir'&&!x.name.startsWith('.')).forEach(x=>console.log(x.name))"`);
     lines.push(`\`\`\``);
-    lines.push(``);
-    lines.push(`**2d. For each skill listed, download and install it:**`);
+    lines.push(`If any directory name matches "${input}", fetch its SKILL.md:`);
     lines.push(`\`\`\`bash`);
-    lines.push(`# Replace PLUGIN_SOURCE_PATH and SKILL_NAME with actual values`);
-    lines.push(`PLUGIN_SOURCE_PATH="plugins/productivity/my-skill"`);
-    lines.push(`SKILL_NAME="skill-directory-name"`);
-    lines.push(`mkdir -p ".claude/skills/\${SKILL_NAME}"`);
-    lines.push(`curl -s "https://raw.githubusercontent.com/${MARKETPLACE_REPO}/main/\${PLUGIN_SOURCE_PATH}/skills/\${SKILL_NAME}/SKILL.md" \\`);
-    lines.push(`  -o ".claude/skills/\${SKILL_NAME}/SKILL.md"`);
-    lines.push(`echo "Installed: .claude/skills/\${SKILL_NAME}/SKILL.md"`);
+    lines.push(`SKILL_DIR="matched-skill"`);
+    lines.push(`mkdir -p ".claude/skills/\${SKILL_DIR}"`);
+    lines.push(`curl -sf "https://raw.githubusercontent.com/${VOLTAGENT_SKILLS_REPO}/main/\${SKILL_DIR}/SKILL.md" \\`);
+    lines.push(`  -o ".claude/skills/\${SKILL_DIR}/SKILL.md"`);
     lines.push(`\`\`\``);
+    lines.push(`Verify content is real (not empty). If empty, delete and continue.`);
     lines.push(``);
-    lines.push(`**On Windows, replace curl with:**`);
-    lines.push(`\`\`\`powershell`);
-    lines.push(`$url = "https://raw.githubusercontent.com/${MARKETPLACE_REPO}/main/$PLUGIN_SOURCE_PATH/skills/$SKILL_NAME/SKILL.md"`);
-    lines.push(`New-Item -ItemType Directory -Force ".claude/skills/$SKILL_NAME" | Out-Null`);
-    lines.push(`Invoke-WebRequest $url -OutFile ".claude/skills/$SKILL_NAME/SKILL.md"`);
-    lines.push(`\`\`\``);
+    lines.push(`**README-driven fallback:** If the API returns a single file (README.md) instead of a directory listing,`);
+    lines.push(`parse its markdown sections for entries matching "${input}". Entries may link to external repos owned by`);
+    lines.push(`different authors — follow those links using the universal URL resolution rules above (extract {owner}/{repo}`);
+    lines.push(`dynamically, never hardcode). Navigate the foreign repo to find the installable .md file and download it.`);
     lines.push(``);
+    // ── STEP 4: ComposioHQ service integrations ───────────────────────
     lines.push(`---`);
     lines.push(``);
-    lines.push(`### STEP 3 — Search additional sources`);
+    lines.push(`### STEP 4 — ComposioHQ service integrations (1000+ skills)`);
     lines.push(``);
-    for (const source of ADDITIONAL_MARKETPLACE_SOURCES) {
-        lines.push(`**${source.name}** — ${source.description}`);
-        if ("catalogUrl" in source && source.catalogUrl) {
-            lines.push(`Catalog: ${source.catalogUrl}`);
-        }
-        if (source.note) {
-            lines.push(`Note: ${source.note}`);
-        }
-        lines.push(``);
-    }
+    lines.push(`Only reach here if STEPs 2+3 found no match.`);
+    lines.push(`Strong for API/SaaS automation: Gmail, Slack, GitHub, Notion, Stripe, Shopify, etc.`);
+    lines.push(`If curl fails, skip to STEP 5.`);
+    lines.push(``);
+    buildComposioFetchBlock(lines, input);
+    // ── STEP 5: Create custom skill ───────────────────────────────────
     lines.push(`---`);
     lines.push(``);
-    lines.push(`### STEP 4 — If no match found in any source, create a custom skill`);
+    lines.push(`### STEP 5 — All 4 catalogs exhausted. Create a production-quality custom skill.`);
+    lines.push(``);
+    lines.push(`You MUST have attempted all 4 sources above with real fetch calls before reaching here.`);
+    lines.push(`The custom skill must be production-valid on first write (Rule 4). No placeholders.`);
     lines.push(``);
     lines.push(`\`\`\`bash`);
-    lines.push(`mkdir -p ".claude/skills/${input.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '')}"`);
+    lines.push(`mkdir -p ".claude/skills/${safeName}"`);
     lines.push(`\`\`\``);
-    lines.push(`Then create SKILL.md with:`);
+    lines.push(`Then create \`.claude/skills/${safeName}/SKILL.md\` with:`);
     lines.push(`\`\`\`yaml`);
     lines.push(`---`);
-    lines.push(`name: ${input.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '')}`);
-    lines.push(`description: ${input}`);
+    lines.push(`name: ${safeName}`);
+    lines.push(`description: "${input}"`);
     lines.push(`---`);
     lines.push(``);
-    lines.push(`[Skill instructions here]`);
+    lines.push(`[Complete skill instructions — not a stub. Must work on first use.]`);
     lines.push(`\`\`\``);
     lines.push(``);
-    lines.push(`---`);
+}
+// ── Universal catalog resolution rules (applies to all sources) ─────────
+function buildUniversalRulesBlock(lines) {
+    lines.push(`### Universal catalog resolution rules`);
     lines.push(``);
-    lines.push(`### Install result format`);
-    lines.push(`After installing, confirm:`);
-    lines.push(`✅ Installed: .claude/skills/<name>/SKILL.md — [one line: what it does]`);
-    lines.push(`⏭ No match: searched [categories], created custom skill instead`);
+    lines.push(`These rules apply to EVERY source below. Read them first.`);
+    lines.push(``);
+    lines.push(`**1. Catalog shape detection — detect before processing:**`);
+    lines.push(`When you fetch a catalog endpoint, the response determines your strategy:`);
+    lines.push(`- **JSON catalog**: valid JSON with a structured list (array of objects with name/source/description). Filter by relevance, navigate source paths, download.`);
+    lines.push(`- **README-driven catalog**: markdown organized into sections with headings. Each entry has a name, description, and a link — but that link may point to a **completely different external repository**. Parse sections, collect entries, follow external links.`);
+    lines.push(`- **Directory listing**: GitHub API array with "type"/"name"/"download_url" fields. List entries, match by name, download via raw URL.`);
+    lines.push(`Detect the shape first. Never assume one format.`);
+    lines.push(``);
+    lines.push(`**2. Universal GitHub URL resolution — works for ANY repo, ANY author:**`);
+    lines.push(`Convert any GitHub URL to a downloadable form by extracting {owner}, {repo}, {branch}, {path} dynamically:`);
+    lines.push(`- \`github.com/{owner}/{repo}/tree/{branch}/{path}\` → \`https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}\``);
+    lines.push(`- \`github.com/{owner}/{repo}/blob/{branch}/{path}\` → \`https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}\``);
+    lines.push(`- Directory URL → list via \`https://api.github.com/repos/{owner}/{repo}/contents/{path}\`, then download individual files`);
+    lines.push(`**Never hardcode a specific owner or repo in the resolution logic.** Always derive them dynamically from whatever link the catalog provides.`);
+    lines.push(``);
+    lines.push(`**3. README-driven external link navigation:**`);
+    lines.push(`When a catalog entry links to an external repository (different {owner}/{repo}):`);
+    lines.push(`1. Extract {owner}/{repo} from the link URL`);
+    lines.push(`2. Resolve to the raw file or directory listing in that foreign repo`);
+    lines.push(`3. If it points to a directory, list contents via API to find the installable .md file`);
+    lines.push(`4. Download from the foreign repo using universal resolution above`);
+    lines.push(`The catalog is just a curated map — the real content lives in the external repo.`);
+    lines.push(``);
+    lines.push(`**4. Candidate scoring — compare before choosing:**`);
+    lines.push(`When multiple candidates match, score each on three axes:`);
+    lines.push(`- **Relevance** (highest weight): does the description directly address the request?`);
+    lines.push(`- **Scope**: is it surgical and focused, or a kitchen-sink tool? Prefer focused — lower cost, easier to reason about.`);
+    lines.push(`- **Uniqueness**: does it duplicate something already installed in .claude/skills/ or .claude/agents/? Deprioritize duplicates.`);
+    lines.push(`Install only the highest-scoring candidate. One high-quality tool per task.`);
+    lines.push(``);
+    lines.push(`**5. Content verification — never keep stubs:**`);
+    lines.push(`After downloading any file, verify ALL of these before accepting:`);
+    lines.push(`- Not empty (0 bytes)`);
+    lines.push(`- Not only YAML frontmatter with no body (just \`---\\nname: x\\n---\` and nothing after)`);
+    lines.push(`- Contains at least 50 characters of instruction content after frontmatter`);
+    lines.push(`If verification fails: delete the file, log which source/candidate failed, continue to next candidate or next STEP.`);
+    lines.push(``);
+}
+// ── Shared fetch blocks ─────────────────────────────────────────────────
+function buildCommunitySkillsFetchBlock(lines, categoryFilter) {
+    lines.push(`**Stage 1 — Fetch catalog and find matching plugin:**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`curl -sf "${MARKETPLACE_CATALOG_URL}" \\`);
+    lines.push(`  | node -e "const d=JSON.parse(require('fs').readFileSync(0,'utf8'));` +
+        `const q='${categoryFilter}';` +
+        `const r=d.plugins.filter(p=>(q===''||p.category.includes(q))&&p.name&&p.source).slice(0,10)` +
+        `.map(p=>({name:p.name,source:p.source,desc:p.description}));` +
+        `console.log(JSON.stringify(r,null,2));"`);
+    lines.push(`\`\`\``);
+    lines.push(`If this returns an error or empty array, skip to the next STEP.`);
+    lines.push(``);
+    lines.push(`**Stage 2 — Score candidates and pick the best match (see rule 4: Relevance > Scope > Uniqueness):**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Replace PLUGIN_SOURCE_PATH with the "source" value from Stage 1`);
+    lines.push(`PLUGIN_SOURCE_PATH="plugins/category/plugin-name"`);
+    lines.push(`curl -sf \${GITHUB_TOKEN:+-H "Authorization: token \$GITHUB_TOKEN"} "https://api.github.com/repos/${MARKETPLACE_REPO}/contents/\${PLUGIN_SOURCE_PATH}/skills" \\`);
+    lines.push(`  | node -e "const a=JSON.parse(require('fs').readFileSync(0,'utf8'));` +
+        `if(!Array.isArray(a)){console.log('NO_SKILLS_DIR');process.exit(0)}` +
+        `a.forEach(x=>console.log(x.name))"`);
+    lines.push(`\`\`\``);
+    lines.push(`If this fails or shows NO_SKILLS_DIR, the plugin has no installable skills — skip.`);
+    lines.push(``);
+    lines.push(`**Stage 3 — Download each skill file and install:**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Replace PLUGIN_SOURCE_PATH and SKILL_NAME with actual values`);
+    lines.push(`PLUGIN_SOURCE_PATH="plugins/category/plugin-name"`);
+    lines.push(`SKILL_NAME="skill-directory-name"`);
+    lines.push(`mkdir -p ".claude/skills/\${SKILL_NAME}"`);
+    lines.push(`curl -sf "https://raw.githubusercontent.com/${MARKETPLACE_REPO}/main/\${PLUGIN_SOURCE_PATH}/skills/\${SKILL_NAME}/SKILL.md" \\`);
+    lines.push(`  -o ".claude/skills/\${SKILL_NAME}/SKILL.md"`);
+    lines.push(`\`\`\``);
+    lines.push(`Verify the file has real content (not empty, not just frontmatter). If empty: delete and move on.`);
+    lines.push(``);
+}
+function buildComposioFetchBlock(lines, input) {
+    lines.push(`**Stage 1 — List available skill directories:**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`curl -sf \${GITHUB_TOKEN:+-H "Authorization: token \$GITHUB_TOKEN"} "${COMPOSIO_API}" \\`);
+    lines.push(`  | node -e "const d=JSON.parse(require('fs').readFileSync(0,'utf8'));` +
+        `if(!Array.isArray(d)){console.log('SKIP');process.exit(0)}` +
+        `d.filter(x=>x.type==='dir'&&!x.name.startsWith('.')).forEach(x=>console.log(x.name))"`);
+    lines.push(`\`\`\``);
+    lines.push(``);
+    lines.push(`**Stage 2 — Pick the directory that best matches "${input}":**`);
+    lines.push(`Match by name similarity. If no directory name is relevant, skip.`);
+    lines.push(``);
+    lines.push(`**Stage 3 — Download the SKILL.md from the matched directory:**`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`SKILL_DIR="matched-directory"`);
+    lines.push(`mkdir -p ".claude/skills/\${SKILL_DIR}"`);
+    lines.push(`curl -sf "${COMPOSIO_RAW}/\${SKILL_DIR}/SKILL.md" \\`);
+    lines.push(`  -o ".claude/skills/\${SKILL_DIR}/SKILL.md"`);
+    lines.push(`\`\`\``);
+    lines.push(`Verify the file has real content (rule 5 above). If empty: delete and move on.`);
+    lines.push(``);
+    lines.push(`**README-driven fallback:** If the directory listing above fails or returns unexpected content,`);
+    lines.push(`fetch the repo's README.md and parse it for sections matching "${input}":`);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Derive owner/repo dynamically from the catalog source — never hardcode`);
+    lines.push(`curl -sf "https://raw.githubusercontent.com/${COMPOSIO_REPO}/master/README.md" | head -300`);
+    lines.push(`\`\`\``);
+    lines.push(`Scan sections for entries with external links. Follow those links using universal URL resolution`);
+    lines.push(`(rule 2+3 above) to download from the linked repo, regardless of its owner.`);
     lines.push(``);
-    return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-setup",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "Setup layer for Claude Code — reads your project, writes command files, Claude Code does the rest",
   "type": "module",
   "bin": {

package/templates/add.md

@@ -4,6 +4,7 @@ Add to Claude Code setup: "{{USER_INPUT}}"
 
 **CRITICAL: Marketplace-first. Do NOT ask clarifying questions. Search and install automatically.**
 **Execute every curl/install command yourself. The user expects zero-friction automation.**
+**A fetch failure is NOT a stop — it is a routing signal to the next catalog.**
 
 ## Project context
 {{PROJECT_CONTEXT}}
@@ -37,7 +38,20 @@ Skills: {{SKILLS_LIST}} | Commands: {{COMMANDS_LIST}}
 
 Parse the user's request and take ALL applicable actions:
 
-### 1. MCP servers
+### 1. Agents (if request is about agents/orchestration/subagents)
+If the marketplace pipeline installed an agent file to `.claude/agents/`:
+- Verify the file has YAML frontmatter (name, description, tools, model) and a body
+- Document it in CLAUDE.md under a **separate agents section** (not mixed with skills)
+- Agent entry format in CLAUDE.md:
+  ```
+  ## Agents
+  - **agent-name** — what it orchestrates, when to invoke it
+  ```
+
+Agent files live in `.claude/agents/<name>.md` — NOT in `.claude/skills/`.
+Agents and skills are architecturally different and must never be mixed.
+
+### 2. MCP servers
 If the request mentions an external service (database, API, browser, etc.):
 - Check the verified MCP package list below
 - If found: add to `.mcp.json` with OS-correct format (detected: {{DETECTED_OS}})
@@ -125,8 +139,8 @@ MCP format — create new .mcp.json:
 ```
 {{/if}}
 
-### 2. Skills
-If the request mentions skills or capabilities:
+### 3. Skills
+If the request mentions skills or capabilities (NOT agents):
 - Create `.claude/skills/<name>/SKILL.md` with proper frontmatter
 - Use `description:` so Claude knows when to load the skill
 - Search the marketplace for matching pre-built skills (see above)
@@ -141,7 +155,7 @@ description: What this skill does
 Instructions...
 ```
 
-### 3. Hooks
+### 4. Hooks
 If the request implies automated actions (formatting, building, notifications):
 - Add to `.claude/settings.json` using the CORRECT hooks format
 - Verify the tool exists before adding a hook for it
@@ -165,13 +179,11 @@ Correct hooks format:
 }
 ```
 
-### 4. Plugins
-If the request matches a marketplace category or SaaS platform:
-- Suggest the relevant plugin with install commands
-- Show the user exactly how to install it
-
 ### 5. CLAUDE.md
 Document any new capabilities, services, or patterns added.
+- Skills go under `## Skills` section
+- Agents go under `## Agents` section (separate — never mixed)
+- MCP servers go under `## MCP Servers` section
 
 ## Rules
 - Read current content above before writing. Merge/append only.
@@ -180,6 +192,9 @@ Document any new capabilities, services, or patterns added.
 - All env var refs use `${VARNAME}` syntax. Document new vars in .env.example.
 - **NEVER write a "model" key into settings.json**
 - Produce valid JSON only.
+- Agents install to `.claude/agents/` — Skills install to `.claude/skills/`
+- Every installed file must contain real, functional content (Rule 7).
+- A fetch failure is a routing signal, not a stop condition (Rule 6).
 
 ## Output — one line per file
 Updated: ✅ [path] — [what and why]