superskill 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.7] - 2026-03-23
+
+### Added
+- **Prefetch core skills on install** — 8 core skills (brainstorming, planning, TDD, code review, debugging, security, verification, shipping) fetched from source repos during `npm install` and cached at `~/.superskill/cache/` for offline availability (#6)
+- **Local analytics** — Privacy-first skill activation tracking at `~/.superskill/analytics.json`. Tracks activations, match methods, failed searches, and web discovery attempts. Auto-rotates at 1000 entries. (#9)
+- **Contributing guide** — Release discipline, PR workflow, skill submission process, test patterns, and security guidelines (#8)
+
+### Fixed
+- **Security scanner false positive** — Role-play instructions ("you are now acting as X") moved from hard block to soft warning. Skills legitimately adopt personas; only memory wipe instructions remain blocked.
+
+### Changed
+- **README overhaul** — Repositioned as product storefront. One-liner value prop, 3-step setup, collapsible skill catalog, supported tools table. Removed internal implementation details. (#13)
+- **marketplace.ts split** — 809-line god file decomposed into 5 focused modules: activate.ts, resolve.ts, generate.ts, manifest.ts, helpers.ts. Barrel re-export preserves backward compatibility.
+
+### Performance
+- **Web discovery caching** — Results cached at `~/.superskill/discovery-cache.json` with 24h TTL, max 100 entries with LRU eviction. Avoids GitHub API rate limits on repeated searches.
+
+### Testing
+- **11 integration tests** for the full activation flow — direct skill_id load, domain activation, task trigger matching, multi-domain, web discovery fallback, GitHub URL loading, 3-per-domain cap, manifest generation
+
+## [0.2.6] - 2026-03-23
+
+### Fixed
+- **Web discovery search** — Repo search now uses `in:name,description,readme` instead of restrictive topic filters. `deanpeters/Product-Manager-Skills` (2340 stars) and similar repos now discoverable
+- **Code search** — Uses `filename:SKILL` qualifier instead of `language:markdown` for more accurate results
+
+### Added
+- **Security scanning for community skills** — All discovered skills are scanned before loading for prompt injection, identity hijacking, data exfiltration, destructive commands, and script injection. Hard blocks on dangerous content, soft warnings on suspicious patterns
+- **50KB size cap** on skill files to prevent oversized payloads
+
 ## [0.2.5] - 2026-03-23
 
 ### Added
@@ -82,6 +112,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CLI shorthand commands (`r`, `w`, `s`, `c`, `t`, `l`, `sk`)
 - MCP tool annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`)
 
+[0.2.7]: https://github.com/permanu/superskill/compare/v0.2.6...v0.2.7
+[0.2.6]: https://github.com/permanu/superskill/compare/v0.2.5...v0.2.6
 [0.2.5]: https://github.com/permanu/superskill/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/permanu/superskill/compare/v0.2.0...v0.2.4
 [0.2.0]: https://github.com/permanu/superskill/compare/v0.1.2...v0.2.0

package/README.md

@@ -1,22 +1,106 @@
 # SuperSkill
 
-**Universal skill marketplace + knowledge vault for AI coding agents.** Auto-detects your stack, resolves skill collisions across repos, and loads expert methodologies on demand.
+One plugin, every skill. The package manager for AI coding agents.
 
-[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 [![npm](https://img.shields.io/npm/v/superskill)](https://www.npmjs.com/package/superskill)
-[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-green.svg)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![license](https://img.shields.io/badge/license-AGPL--3.0-blue)](https://www.gnu.org/licenses/agpl-3.0)
+[![skills](https://img.shields.io/badge/skills-87-purple)](https://github.com/permanu/superskill)
+[![tools](https://img.shields.io/badge/AI%20tools-8-green)](https://github.com/permanu/superskill)
+
+## The Problem
+
+There are 9+ open-source skill repos for AI coding agents, containing 87+ skills across 28 domains. Installing them all means token bloat and collisions — three different TDD skills fighting for context. Installing none means your agent wings it. There's no package manager.
+
+## How It Works
+
+1. **Install** — `npm install -g superskill`
+2. **Describe your task** — "write tests for my Go API"
+3. **SuperSkill finds and loads the right methodology** — resolves collisions, filters by your stack, injects only what's relevant
+
+No manual skill management. The AI agent calls SuperSkill automatically when it recognizes a matching task.
+
+## Key Features
+
+- **87 skills from 9 repos** — ECC, Superpowers, gstack, Anthropic, design repos, and more. One catalog, one resolution layer.
+- **Works across 8 AI tools** — Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, OpenCode, Crush CLI, Droid.
+- **Collision resolution** — When multiple repos provide skills for the same domain (TDD, planning, code review, etc.), profiles pick the winner.
+- **Stack-aware filtering** — Auto-detects your project (Go, React, Django, Spring Boot, etc.) and loads only relevant skills.
+- **Web discovery** — If no local skill matches, searches GitHub for community skills.
+- **Security scanning** — Community skills are scanned for prompt injection, data exfiltration, and destructive commands before loading.
+- **Progressive disclosure** — Lightweight manifest (~100 tokens/skill) for small-context models; full content on demand.
+- **Knowledge vault** — Persistent project memory: tasks, ADRs, learnings, session resume, brainstorms. Cross-tool, cross-session.
+
+## Supported AI Tools
+
+| Tool | Setup | Status |
+|------|-------|--------|
+| **Claude Code** | Plugin or MCP | Verified |
+| **Claude Desktop** | MCP config | Verified |
+| **Cursor** | MCP config | Verified |
+| **Codex CLI** | MCP config | Verified |
+| **Gemini CLI** | MCP config | Verified |
+| **OpenCode** | MCP config | Community |
+| **Crush CLI** | MCP config | Community |
+| **Droid** | MCP config | Community |
+
+## Available Skills
+
+<details>
+<summary>28 domains across 9 repos (click to expand)</summary>
+
+**Core Workflow** — loaded for every project:
+
+| Domain | Skills | Description |
+|--------|--------|-------------|
+| TDD | 8 | Red-green-refactor, Go/Python/Django/Spring/C++ testing, E2E |
+| Planning | 3 | Implementation planning, CEO/eng review, execution |
+| Code Review | 4 | PR review, Go review, Python review, feedback workflow |
+| Debugging | 2 | Systematic debugging, investigation |
+| Verification | 4 | Build/lint/type gates, Django/Spring verification |
+| Brainstorming | 2 | Structured ideation, office hours |
+| Agent Orchestration | 5 | Autonomous loops, RFC pipelines, subagents, parallel dispatch |
+| Security | 5 | OWASP review, AgentShield scanning, Django/Spring security |
+| Shipping | 2 | CI/CD, deployment patterns |
+| Frontend Design | 5 | Anthropic official, Design Taste, Bencium UX, FDP, UI/UX Pro Max |
+| Git Workflow | 2 | Worktrees, branch management |
+
+**Language & Framework** — loaded when your stack matches:
+
+| Domain | Skills | Description |
+|--------|--------|-------------|
+| Go | 2 | Idiomatic patterns, conventions |
+| Python | 2 | Pythonic idioms, PEP 8 |
+| Django | 3 | Architecture, DRF, ORM, security, TDD |
+| Spring Boot | 4 | Architecture, security, TDD, verification |
+| Swift | 4 | SwiftUI, concurrency, actors, protocol DI |
+| C++ | 2 | Core Guidelines, GoogleTest |
+| Java | 2 | Standards, JPA/Hibernate |
+| Database | 3 | PostgreSQL, migrations, ClickHouse |
+| Docker | 1 | Compose, container security |
+
+**Infrastructure & Patterns:**
+
+| Domain | Skills | Description |
+|--------|--------|-------------|
+| API Design | 1 | REST patterns, pagination, versioning |
+| Frontend Patterns | 1 | React/Next.js state and performance |
+| Backend Patterns | 1 | Node/Express server patterns |
+| Coding Standards | 1 | Universal TS/JS/React standards |
+
+**Specialized:**
+
+| Domain | Skills | Description |
+|--------|--------|-------------|
+| Content & Business | 6 | Articles, investor materials, outreach, market research |
+| 3D Animation | 5 | Three.js, GSAP, React Three Fiber, Framer Motion, Babylon.js |
+| Agent Engineering | 4 | Agent harness, eval, cost optimization |
+| Meta/Tooling | 5 | Skill management, compaction, learning, browsing |
+
+**Source repos:** [ECC](https://github.com/affaan-m/everything-claude-code), [Superpowers](https://github.com/obra/superpowers), [gstack](https://github.com/garrytan/gstack), [Anthropic Skills](https://github.com/anthropics/skills), [Design Skillstack](https://github.com/freshtechbro/claudedesignskills), [Taste](https://github.com/Leonxlnx/taste-skill), [Bencium](https://github.com/bencium/bencium-claude-code-design-skill), [Frontend Design Pro](https://github.com/claudekit/frontend-design-pro-demo), [UI/UX Pro Max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)
+
+</details>
 
-## What It Does
-
-- **Skill Marketplace** — 87 skills from 9 repos (ECC, Superpowers, gstack, Anthropic, design repos). Catalog, search, filter by domain.
-- **Collision Detection** — 12 domains where skills from different repos compete (TDD, planning, code review, etc.). Profile-based resolution picks the best skill per domain.
-- **Per-Project Filtering** — Auto-detects your stack (Go+Echo, React+Next, Django, etc.) and loads only relevant skills. Go project? No Django/Spring/frontend skills loaded.
-- **Progressive Disclosure** — Lightweight manifest (~100 tokens/skill) + on-demand loading. Small context models get essentials only.
-- **Knowledge Vault** — Persistent project memory: tasks, decisions (ADRs), learnings, sessions, brainstorms. Cross-tool, cross-session continuity.
-- **Multi-Agent Coordination** — Session registry for agent swarms. No file conflicts.
-
-## Install
+## Quick Start
 
 ### Claude Code Plugin (recommended)
 
@@ -25,97 +109,19 @@
 /plugin install superskill
 ```
 
-### npm (any MCP-compatible tool)
+### Any MCP-compatible tool
 
 ```bash
 npm install -g superskill
 ```
 
-Or use directly:
-```bash
-npx superskill
-```
-
-### From source
-
-```bash
-git clone https://github.com/permanu/superskill.git
-cd superskill
-npm install && npm run build
-```
-
-## Quick Start
-
-Once installed, SuperSkill auto-detects your project and loads skills on demand. The main MCP tool is `superskill` — the LLM calls it automatically when it recognizes a task that matches a skill domain.
-
-### How It Works
-
-1. Agent starts session → SuperSkill injects skill awareness via `vault_resume`
-2. User says "let's think about this problem"
-3. Agent recognizes brainstorming intent → calls `superskill({domain: "brainstorming"})`
-4. SuperSkill returns expert methodology → agent follows it
-
-No manual commands needed. The LLM decides when to use skills based on your intent.
-
-### Skill Domains
-
-| Domain | What It Covers |
-|--------|---------------|
-| `brainstorming` | Thinking through problems, exploring ideas, ideating |
-| `planning` | Architecture, implementation strategy, scoping |
-| `code-review` | PR review, code quality, feedback |
-| `tdd` | Writing tests, coverage, test-driven development |
-| `debugging` | Investigating errors, troubleshooting, root cause |
-| `security` | Vulnerability review, auth, OWASP, hardening |
-| `verification` | Build checks, lint, type validation |
-| `shipping` | Deployment, CI/CD, releases, rollbacks |
-| `frontend-design` | UI/UX, components, visual design |
-| `agent-orchestration` | Multi-agent, parallel tasks, subagents |
-| `database` | SQL, schemas, migrations, query optimization |
-
-### CLI
-
-```bash
-# Marketplace
-superskill-cli skill catalog                        # 87 skills, 9 repos
-superskill-cli skill catalog --search "tdd"         # search
-superskill-cli skill collisions                     # 12 collision domains
-superskill-cli skill resolve --profile ecc-first    # see winners
-
-# Generate super-skill (auto-detects stack)
-superskill-cli skill generate                       # Go project → 14 skills, React → different set
-
-# Smart activate (describe task, get skill)
-superskill-cli skill activate "brainstorm this"     # → loads brainstorming skill
-superskill-cli skill activate "write tests"         # → loads TDD skill
-superskill-cli skill activate "review PR" --domain code-review  # direct domain
-
-# Progressive disclosure
-superskill-cli skill manifest                       # lightweight index
-superskill-cli skill load ecc/tdd-workflow          # load one skill
-
-# Knowledge vault
-superskill-cli context                              # project context
-superskill-cli task add "Fix auth bug" --priority p0
-superskill-cli task board                           # kanban view
-superskill-cli learn add --title "Redis pattern"    # capture learning
-superskill-cli decide --title "Use PostgreSQL"      # log ADR
-superskill-cli resume                               # what happened last session
-```
-
-## MCP Setup (non-plugin)
-
-For tools that don't support Claude Code plugins, configure as a standard MCP server:
-
-### Claude Code
+Then configure as an MCP server. For Claude Code:
 
 ```bash
 claude mcp add superskill -e VAULT_PATH=~/Vaults/ai -- npx -y superskill
 ```
 
-### Claude Desktop / Cursor / Codex / OpenCode
-
-Add to your MCP config:
+For Cursor, Claude Desktop, Codex, Gemini CLI, and others — add to your MCP config:
 
 ```json
 {
@@ -135,59 +141,37 @@ Add to your MCP config:
 
 | Tool | Description |
 |------|-------------|
-| `superskill` | **Main tool** — load expert methodology by domain, task description, or skill ID |
+| `superskill` | Load expert methodology by domain, task description, or skill ID |
+| `vault_skill` | Skill catalog, collisions, resolution, generation |
+| `vault_project_context` | Auto-detected project context from CWD |
+| `vault_init` | Generate draft context.md from a git repo |
+| `vault_task` | Task management (add/list/update/board) |
+| `vault_decide` | Log architecture decisions |
+| `vault_learn` | Capture and list learnings |
+| `vault_resume` | Resume context — recent sessions, interrupted work, next steps |
+| `vault_session` | Multi-agent session coordination |
 | `vault_read` | Read file or directory from vault |
 | `vault_write` | Write/append/prepend content |
 | `vault_search` | Full-text search across vault |
-| `vault_project_context` | Get project context (auto-detects from CWD) |
-| `vault_init` | Generate draft context.md from a git repo |
-| `vault_decide` | Log architecture decision |
-| `vault_task` | Manage tasks (add/list/update/board) |
-| `vault_learn` | Capture/list learnings |
-| `vault_session` | Multi-agent session coordination |
-| `vault_skill` | Skill marketplace operations (catalog/collisions/resolve/generate) |
-| `vault_resume` | Resume context — recent sessions, interrupted work, next steps |
-| `vault_prune` | Archive/delete stale content |
-| `vault_stats` | Content statistics |
+| `vault_prune` | Archive stale content |
+| `vault_stats` | Vault content statistics |
 | `vault_deprecate` | Mark items as deprecated |
 
 ## Configuration
 
-| Environment Variable | Default | Description |
-|---------------------|---------|-------------|
+| Variable | Default | Description |
+|----------|---------|-------------|
 | `VAULT_PATH` | `~/Vaults/ai` | Path to knowledge vault |
 | `MAX_INJECT_TOKENS` | `1500` | Max tokens for context injection |
 | `SESSION_TTL_HOURS` | `2` | Session heartbeat TTL |
 
-## Vault Structure
+## Roadmap
 
-```
-~/Vaults/ai/
-├── project-map.json           # Path → slug mappings
-├── coordination/
-│   ├── session-registry.json  # Active agent sessions
-│   └── locks/                 # PID lockfiles
-├── skills/
-│   ├── installed/             # Installed skills
-│   ├── super-skill/           # Generated super-skill files
-│   └── registry.json          # Skill metadata
-└── projects/<slug>/
-    ├── context.md             # Project overview
-    ├── decisions/             # Architecture Decision Records
-    ├── tasks/                 # Task files
-    ├── learnings/             # Learning captures
-    ├── sessions/              # Session notes
-    ├── brainstorms/           # Brainstorm documents
-    └── _archive/              # Pruned content
-```
+See [GitHub Milestones](https://github.com/permanu/superskill/milestones) for planned work.
 
-## Testing
+## Contributing
 
-```bash
-npm test                           # Run all tests (Vitest)
-npm run test:coverage              # With coverage
-npm test src/lib/auto-profile.test.ts  # Specific file
-```
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
 
 ## License
 

package/dist/commands/skill/activate.d.ts

@@ -0,0 +1,23 @@
+export declare const TASK_DOMAIN_MAP: Array<{
+    patterns: RegExp[];
+    domains: string[];
+}>;
+export declare function matchTaskToDomains(task: string): string[];
+export interface ActivateResult {
+    success: boolean;
+    skills_loaded: Array<{
+        id: string;
+        name: string;
+        domains: string[];
+    }>;
+    content: string;
+    matched_domains: string[];
+    total_tokens: number;
+    error?: string;
+}
+export declare function activateSkills(options: {
+    task: string;
+    profile?: string;
+    skill_id?: string;
+    domain?: string;
+}): Promise<ActivateResult>;

package/dist/commands/skill/activate.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { CATALOG, DOMAINS } from "./catalog.js";
+import { searchGitHubForSkills, formatDiscoveryResults } from "./web-discovery.js";
+import { trackActivation, trackFailedSearch, trackWebDiscovery } from "../../lib/analytics.js";
+import { resolveCommand } from "./resolve.js";
+import { loadSkillContent } from "./manifest.js";
+import { fetchSkillContent, formatSection } from "./helpers.js";
+// ── Task → Domain Mapping ────────────────────────────
+export const TASK_DOMAIN_MAP = [
+    // Core workflow domains
+    { patterns: [/brainstorm/i, /ideate/i, /explore ideas/i, /think through/i, /what if/i], domains: ["brainstorming"] },
+    { patterns: [/test/i, /tdd/i, /spec/i, /coverage/i, /unit test/i, /assert/i], domains: ["tdd"] },
+    { patterns: [/review/i, /code review/i, /pr review/i, /pull request/i, /feedback/i], domains: ["code-review"] },
+    { patterns: [/plan/i, /architect/i, /design.*system/i, /implementation plan/i, /roadmap/i], domains: ["planning"] },
+    { patterns: [/debug/i, /investigate/i, /fix.*bug/i, /troubleshoot/i, /error/i, /broken/i], domains: ["debugging"] },
+    { patterns: [/secur/i, /vulnerab/i, /owasp/i, /auth.*review/i, /pentest/i, /hardening/i], domains: ["security"] },
+    { patterns: [/deploy/i, /\bship\b/i, /release/i, /ci.?cd/i, /rollback/i, /production/i], domains: ["shipping"] },
+    { patterns: [/verify/i, /validate/i, /check.*build/i, /lint/i, /type.?check/i], domains: ["verification"] },
+    { patterns: [/frontend/i, /ui\b/i, /ux\b/i, /component/i, /design.*page/i, /css/i, /tailwind/i, /layout/i], domains: ["frontend-design"] },
+    { patterns: [/agent/i, /orchestrat/i, /subagent/i, /parallel.*agent/i, /multi.*agent/i], domains: ["agent-orchestration"] },
+    { patterns: [/database/i, /sql\b/i, /schema/i, /migration/i, /postgres/i, /mysql/i, /supabase/i, /sql.*query/i, /db.*query/i], domains: ["database"] },
+    // Language and framework domains
+    { patterns: [/golang/i, /go test/i, /goroutine/i, /go mod/i, /go func/i, /go package/i], domains: ["go"] },
+    { patterns: [/python/i, /pytest/i, /pip/i, /django/i, /flask/i, /fastapi/i], domains: ["python"] },
+    { patterns: [/django/i, /drf\b/i, /django rest/i], domains: ["django"] },
+    { patterns: [/spring/i, /spring boot/i, /java\b/i, /jpa\b/i, /hibernate/i, /maven/i, /gradle/i], domains: ["spring-boot", "java"] },
+    { patterns: [/swift/i, /swiftui/i, /ios\b/i, /xcode/i, /uikit/i], domains: ["swift"] },
+    { patterns: [/\bc\+\+/i, /cpp\b/i, /cmake/i, /clang/i], domains: ["cpp"] },
+    { patterns: [/docker/i, /container/i, /compose/i, /dockerfile/i, /k8s/i, /kubernetes/i], domains: ["docker"] },
+    // API and patterns
+    { patterns: [/api design/i, /rest api/i, /endpoint/i, /pagination/i, /rate limit/i], domains: ["api-design"] },
+    { patterns: [/react/i, /next\.?js/i, /state management/i, /hooks/i, /redux/i], domains: ["frontend-patterns"] },
+    { patterns: [/express/i, /node\.?js/i, /server.*pattern/i, /middleware/i, /backend/i], domains: ["backend-patterns"] },
+    { patterns: [/coding standard/i, /style guide/i, /convention/i, /best practice/i], domains: ["coding-standards"] },
+    { patterns: [/git/i, /branch/i, /worktree/i, /merge/i, /rebase/i], domains: ["git-workflow"] },
+    // Content and business
+    { patterns: [/write.*article/i, /blog.*post/i, /content/i, /newsletter/i, /copywriting/i], domains: ["content-business"] },
+    { patterns: [/market.*research/i, /competitor/i, /competitive/i, /due diligence/i, /market siz/i], domains: ["content-business"] },
+    { patterns: [/investor/i, /pitch.*deck/i, /fundrais/i, /outreach/i, /cold email/i], domains: ["content-business"] },
+    { patterns: [/linkedin/i, /twitter/i, /social media/i, /marketing/i, /launch post/i], domains: ["content-business"] },
+    // 3D and animation
+    { patterns: [/three\.?js/i, /webgl/i, /3d\b/i, /animation/i, /gsap/i, /framer/i], domains: ["3d-animation"] },
+    // Agent engineering
+    { patterns: [/agent.*harness/i, /agent.*eval/i, /cost.*optim/i, /agent.*loop/i, /agent.*engineer/i, /eval.*pipeline/i], domains: ["agent-engineering"] },
+    // Meta / tooling
+    { patterns: [/skill.*manage/i, /compaction/i, /skill.*install/i, /learning.*capture/i], domains: ["meta"] },
+];
+export function matchTaskToDomains(task) {
+    const matched = new Set();
+    for (const entry of TASK_DOMAIN_MAP) {
+        for (const pattern of entry.patterns) {
+            if (pattern.test(task)) {
+                for (const d of entry.domains)
+                    matched.add(d);
+            }
+        }
+    }
+    return [...matched];
+}
+// ── Smart Skill Activator ─────────────────────────────
+export async function activateSkills(options) {
+    // Direct skill load by ID
+    if (options.skill_id) {
+        const result = await loadSkillContent(options.skill_id);
+        if (!result.success) {
+            return { success: false, skills_loaded: [], content: "", matched_domains: [], total_tokens: 0, error: result.error };
+        }
+        const entry = CATALOG.find((s) => s.id === options.skill_id);
+        trackActivation({ skill_id: options.skill_id, match_method: "skill_id", task_query: options.task, matched: true });
+        return {
+            success: true,
+            skills_loaded: [{ id: options.skill_id, name: entry?.name ?? options.skill_id, domains: entry?.domains ?? [] }],
+            content: result.content,
+            matched_domains: entry?.domains ?? [],
+            total_tokens: result.estimated_tokens ?? 0,
+        };
+    }
+    // Route 1: LLM passed domain directly (preferred — LLM understands intent best)
+    // Route 2: Keyword fallback from task description
+    let matchedDomains;
+    if (options.domain) {
+        // LLM picked the domain(s) — trust it. Support comma-separated.
+        matchedDomains = options.domain.split(",").map((d) => d.trim()).filter((d) => DOMAINS.some((dom) => dom.id === d));
+    }
+    else {
+        matchedDomains = matchTaskToDomains(options.task);
+    }
+    if (matchedDomains.length === 0) {
+        // Track failed domain match before attempting web discovery
+        trackFailedSearch(options.task, 0);
+        // Web discovery fallback — search GitHub for community skills
+        const discovery = await searchGitHubForSkills(options.task);
+        const content = formatDiscoveryResults(options.task, discovery.results);
+        trackWebDiscovery(options.task, discovery.results.length > 0);
+        return {
+            success: true,
+            skills_loaded: [],
+            content,
+            matched_domains: [],
+            total_tokens: 0,
+        };
+    }
+    // Resolve which skill wins per domain
+    const resolution = await resolveCommand({ profile: options.profile });
+    const winnerMap = new Map();
+    for (const r of resolution.resolutions) {
+        winnerMap.set(r.domain, r.chosen);
+    }
+    // For each matched domain, load collision winner + up to 2 alternatives (max 3 per domain)
+    const MAX_SKILLS_PER_DOMAIN = 3;
+    const skillsToLoad = [];
+    const seenIds = new Set();
+    for (const domain of matchedDomains) {
+        let domainCount = 0;
+        // Collision winner goes first if present
+        const winnerId = winnerMap.get(domain);
+        if (winnerId && !seenIds.has(winnerId)) {
+            const entry = CATALOG.find((s) => s.id === winnerId);
+            if (entry) {
+                skillsToLoad.push(entry);
+                seenIds.add(winnerId);
+                domainCount++;
+            }
+        }
+        // Then other skills in this domain, up to the cap
+        for (const skill of CATALOG) {
+            if (domainCount >= MAX_SKILLS_PER_DOMAIN)
+                break;
+            if (skill.domains.includes(domain) && !seenIds.has(skill.id)) {
+                skillsToLoad.push(skill);
+                seenIds.add(skill.id);
+                domainCount++;
+            }
+        }
+    }
+    if (skillsToLoad.length === 0) {
+        return { success: true, skills_loaded: [], content: "No skills available for matched domains: " + matchedDomains.join(", "), matched_domains: matchedDomains, total_tokens: 0 };
+    }
+    // Fetch all matched skills in parallel
+    const fetchResults = await Promise.allSettled(skillsToLoad.map(async (entry) => {
+        const raw = await fetchSkillContent(entry.source);
+        return { entry, content: formatSection(entry, raw) };
+    }));
+    const sections = [];
+    const loaded = [];
+    for (const result of fetchResults) {
+        if (result.status === "fulfilled") {
+            sections.push(result.value.content);
+            loaded.push({
+                id: result.value.entry.id,
+                name: result.value.entry.name,
+                domains: result.value.entry.domains,
+            });
+        }
+    }
+    const content = sections.join("\n\n---\n\n");
+    // Track each loaded skill activation
+    const matchMethod = options.domain ? "domain" : "trigger";
+    for (const skill of loaded) {
+        trackActivation({ skill_id: skill.id, match_method: matchMethod, task_query: options.task, matched: true });
+    }
+    return {
+        success: true,
+        skills_loaded: loaded,
+        content,
+        matched_domains: matchedDomains,
+        total_tokens: Math.ceil(content.length / 4),
+    };
+}
+//# sourceMappingURL=activate.js.map

package/dist/commands/skill/activate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.js","sourceRoot":"","sources":["../../../src/commands/skill/activate.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill/generate.d.ts

@@ -0,0 +1,28 @@
+import { VaultFS } from "../../lib/vault-fs.js";
+import { type LayerName } from "./helpers.js";
+export interface LayerInfo {
+    path: string;
+    skill_count: number;
+    estimated_tokens: number;
+}
+export interface GenerateResult {
+    success: boolean;
+    layers?: {
+        core: LayerInfo;
+        extended: LayerInfo;
+        reference: LayerInfo;
+    };
+    total_skills?: number;
+    fetch_errors?: string[];
+    error?: string;
+    filtered_out?: number;
+    pipe_content?: string;
+}
+export declare function generateCommand(vaultFs: VaultFS, _vaultPath: string, options: {
+    profile?: string;
+    includeNonColliding?: boolean;
+    outputPath?: string;
+    pipe?: boolean;
+    pipeLayer?: LayerName | 'all';
+    relevantDomains?: string[];
+}): Promise<GenerateResult>;