@winspan/claude-forge 4.1.0 → 6.0.0

package/dist/skills/official-skills.js

@@ -0,0 +1,531 @@
+/**
+ * Official built-in skills for claude-forge
+ * Extracted from git history: c59670a:src-old/skills/official-sync/skill-definitions.ts
+ */
+/**
+ * Official skill keyword mappings
+ * Used for skill matching and orchestration
+ */
+export const OFFICIAL_SKILL_KEYWORDS = {
+    'official-tdd': ['tdd', 'test-driven', '测试驱动'],
+    'official-debug': ['debug', '调试', 'bug', '修复', 'fix', 'hotfix'],
+    'official-refactor': ['refactor', '重构', 'cleanup', 'reorganize', 'restructure'],
+    'official-pr-review': ['review', '审查', 'pr review', 'code review'],
+    'official-harness-engineering': ['harness', 'legacy', '遗留代码', '特征测试', 'characterization'],
+    'official-spec-driven-design': ['spec', 'sdd', 'spec-driven', '规格', '需求文档', 'requirements'],
+    'official-architecture-decision': ['adr', 'architecture decision', '架构决策', '技术选型'],
+    'official-api-design': ['api design', 'api 设计', 'restful', 'openapi', '接口设计'],
+    'official-db-schema-design': ['schema', 'database', '数据库设计', 'migration', '迁移', 'sql'],
+    'official-performance-optimization': ['performance', '性能', 'optimize', '优化', 'profiling', '瓶颈'],
+    'official-security-hardening': ['security', '安全', 'owasp', 'hardening', '加固', 'vulnerability', '漏洞'],
+    'official-release-checklist': ['release', 'deploy', '发布', '上线', 'checklist', '部署'],
+    'official-doc-driven': ['doc-driven', 'documentation', '文档驱动', '写文档', 'readme'],
+    'planning-with-files': ['plan', 'planning', '规划', 'task plan', 'organize', '组织任务'],
+    'code-simplifier': ['simplify', 'refine', '简化', 'cleanup', 'code quality'],
+    'find-skills': ['find skill', 'search skill', '查找技能', 'discover', 'install skill'],
+    'webapp-testing': ['test webapp', 'playwright', 'browser test', 'e2e', 'frontend test'],
+    'ui-ux-pro-max': ['ui', 'ux', 'design', 'color', 'typography', 'palette', '设计'],
+};
+/**
+ * 16 official skills covering full-stack development workflow
+ * Version changes trigger automatic updates in daemon startup
+ */
+export const OFFICIAL_SKILLS = [
+    {
+        name: 'official-harness-engineering',
+        version: '1.0.0',
+        description: 'Harness Engineering：为遗留代码建立测试防护网再安全修改',
+        keywords: ['harness', 'legacy', '遗留代码', '特征测试', 'characterization'],
+        content: `---
+name: official-harness-engineering
+version: 1.0.0
+description: "Harness Engineering：为遗留代码建立测试防护网再安全修改"
+tags: [harness, testing, legacy, refactor]
+---
+
+# Harness Engineering
+
+在修改任何现有代码前，先建立测试防护网（harness），确保改动不破坏现有行为。
+
+## 与 TDD 的区别
+- TDD 用于新功能开发（先测试后实现）
+- Harness Engineering 用于改动现有代码（先理解后保护再修改）
+
+## 步骤
+
+1. **理解现有行为** — 阅读代码，推断当前实际行为
+   - 找到所有入口点和输出点
+   - 记录边界条件和隐含假设
+
+2. **建立 Characterization Tests（特征测试）**
+   - 测试描述"代码现在做什么"，不是"应该做什么"
+   - 覆盖所有主要代码路径
+   - 全部通过后才能继续
+
+3. **最小化修改** — 在安全网保护下进行改动
+   - 每次只改一处，改完立即运行 harness
+   - 测试失败 = 立即回滚，不要积累未验证的变更
+
+4. **逐步替换** — 新行为用新测试覆盖，旧 harness 逐步退役
+
+## 适用场景
+- 修改没有测试的遗留代码
+- 重构高风险核心模块
+- 接手不熟悉的代码库
+`,
+    },
+    {
+        name: 'official-spec-driven-design',
+        version: '1.0.0',
+        description: 'SDD：先写规格文档再写代码，需求驱动实现',
+        keywords: ['spec', 'sdd', 'spec-driven', '规格', '需求文档', 'requirements'],
+        content: `---
+name: official-spec-driven-design
+version: 1.0.0
+description: "SDD：先写规格文档再写代码，需求驱动实现"
+tags: [sdd, spec, design, requirements]
+---
+
+# Spec-Driven Design（规格驱动开发）
+
+在写任何代码之前，先把规格写清楚。规格是代码的合同。
+
+## 步骤
+
+1. **写 SPEC.md**，包含：
+   - 功能目标（一句话）
+   - 输入/输出定义（含类型和边界）
+   - 不做什么（明确排除项）
+   - 验收标准（可测试的条件列表）
+
+2. **评审规格** — 在写代码前确认规格无歧义
+   - 每条验收标准都能写成测试吗？
+   - 边界条件是否覆盖？
+
+3. **按规格实现** — 代码只做规格里写的事
+   - 遇到规格未覆盖的情况，先更新规格再写代码
+
+4. **验收** — 逐条对照验收标准，全部通过才算完成
+
+## 规则
+- 规格变更必须先于代码变更
+- 实现不得超出规格范围（避免过度设计）
+`,
+    },
+    {
+        name: 'official-architecture-decision',
+        version: '1.0.0',
+        description: '架构决策记录（ADR）：结构化记录重要技术决策',
+        keywords: ['adr', 'architecture decision', '架构决策', '技术选型'],
+        content: `---
+name: official-architecture-decision
+version: 1.0.0
+description: "架构决策记录（ADR）：结构化记录重要技术决策"
+tags: [architecture, adr, design, decision]
+---
+
+# 架构决策记录（ADR）
+
+每个重要的技术决策都应该留下可追溯的记录。
+
+## 何时写 ADR
+- 技术选型（框架、数据库、消息队列）
+- 系统边界划分
+- 接口协议选择
+- 影响超过 1 个模块的设计决策
+
+## ADR 模板
+
+\\`,
+    },
+    {
+        name: 'official-api-design',
+        version: '1.0.0',
+        description: 'API 设计规范：RESTful/RPC 接口设计最佳实践',
+        keywords: ['api design', 'api 设计', 'restful', 'openapi', '接口设计'],
+        content: `---
+name: official-api-design
+version: 1.0.0
+description: "API 设计规范：RESTful/RPC 接口设计最佳实践"
+tags: [api, rest, design, backend]
+---
+
+# API 设计规范
+
+## 设计顺序
+1. 先定义资源和操作（不要先想 URL）
+2. 写 OpenAPI/Protobuf 规格
+3. 用 mock 验证调用方能用
+4. 再实现
+
+## RESTful 规范
+- URL 用名词复数：\\`,
+    },
+    {
+        name: 'official-db-schema-design',
+        version: '1.0.0',
+        description: '数据库 Schema 设计：建模、迁移和演进最佳实践',
+        keywords: ['schema', 'database', '数据库设计', 'migration', '迁移', 'sql'],
+        content: `---
+name: official-db-schema-design
+version: 1.0.0
+description: "数据库 Schema 设计：建模、迁移和演进最佳实践"
+tags: [database, schema, sql, migration]
+---
+
+# 数据库 Schema 设计
+
+## 设计原则
+- 先建模（ER 图），再建表
+- 每张表只表达一个实体
+- 外键约束在数据库层面强制
+
+## 命名规范
+- 表名：snake_case 复数（\\`,
+    },
+    {
+        name: 'official-pr-review',
+        version: '1.2.0',
+        description: '结构化 PR 审查：覆盖正确性、安全性和可维护性',
+        keywords: ['review', '审查', 'pr review', 'code review'],
+        content: `---
+name: official-pr-review
+version: 1.2.0
+description: "结构化 PR 审查：覆盖正确性、安全性和可维护性"
+tags: [review, pr, quality]
+---
+
+# Pull Request 审查
+
+## 审查顺序（重要性从高到低）
+
+### 1. 正确性
+- [ ] 逻辑在所有边界条件下正确
+- [ ] 错误处理恰当，异常不被静默吞掉
+- [ ] 无竞态条件或并发问题
+
+### 2. 安全性
+- [ ] 无注入漏洞（SQL、命令、XSS、SSRF）
+- [ ] 敏感数据未被日志记录或暴露
+- [ ] 权限检查在正确的层级
+
+### 3. 性能
+- [ ] 无 N+1 查询
+- [ ] 大数据量场景有分页或流式处理
+
+### 4. 可维护性
+- [ ] 代码可读，命名自文档化
+- [ ] 单一职责，函数不超过 40 行
+
+### 5. 测试
+- [ ] 新功能有对应测试
+- [ ] 边界条件有测试覆盖
+
+## 输出格式
+**[BLOCKER|MAJOR|MINOR]** \\`,
+    },
+    {
+        name: 'official-debug',
+        version: '1.2.0',
+        description: '系统化调试工作流：复现、隔离、修复、验证',
+        keywords: ['debug', '调试', 'bug', '修复', 'fix', 'hotfix'],
+        content: `---
+name: official-debug
+version: 1.2.0
+description: "系统化调试工作流：复现、隔离、修复、验证"
+tags: [debug, troubleshooting]
+---
+
+# 系统化调试
+
+## 步骤
+
+1. **复现** — 确认 bug 可稳定复现
+   - 记录：环境、输入、期望行为、实际行为
+
+2. **隔离** — 缩小根因范围
+   - 二分法排查代码路径
+   - 检查近期变更（\\`,
+    },
+    {
+        name: 'official-performance-optimization',
+        version: '1.0.0',
+        description: '性能优化工作流：先度量再优化，数据驱动',
+        keywords: ['performance', '性能', 'optimize', '优化', 'profiling', '瓶颈'],
+        content: `---
+name: official-performance-optimization
+version: 1.0.0
+description: "性能优化工作流：先度量再优化，数据驱动"
+tags: [performance, optimization, profiling]
+---
+
+# 性能优化
+
+## 黄金法则
+**永远先度量，再优化。** 没有数据的优化是猜测。
+
+## 步骤
+
+1. **建立基线** — 用真实数据测量当前性能
+   - 定义指标：延迟（P50/P95/P99）、吞吐量、内存
+
+2. **找瓶颈** — Profile，不要猜
+   - CPU：火焰图；内存：heap 分析；I/O：慢查询日志
+
+3. **优化** — 从收益最大的瓶颈开始
+   - 算法复杂度 > 减少 I/O > 缓存 > 并发
+
+4. **验证** — 对比基线，功能测试全部通过
+
+## 常见优化方向（按收益排序）
+- 数据库：索引、消除 N+1、连接池
+- 缓存：热点数据、计算结果
+- 异步化：I/O 密集型操作
+- 批处理：替代逐条处理
+`,
+    },
+    {
+        name: 'official-security-hardening',
+        version: '1.0.0',
+        description: '安全加固清单：覆盖 OWASP Top 10 和常见安全实践',
+        keywords: ['security', '安全', 'owasp', 'hardening', '加固', 'vulnerability', '漏洞'],
+        content: `---
+name: official-security-hardening
+version: 1.0.0
+description: "安全加固清单：覆盖 OWASP Top 10 和常见安全实践"
+tags: [security, owasp, hardening]
+---
+
+# 安全加固
+
+## 输入验证
+- 所有外部输入在边界处验证（类型、长度、格式）
+- 参数化查询，禁止字符串拼接 SQL
+- 文件上传：验证类型、大小、存储路径隔离
+
+## 认证与授权
+- 密码：bcrypt/argon2 哈希，禁止 MD5/SHA1
+- Token：短有效期 + refresh token 机制
+- 每个接口显式检查权限，不依赖前端隐藏
+
+## 数据保护
+- 敏感字段（密码、密钥、PII）不写日志
+- HTTPS only，HSTS header
+- 密钥走环境变量，不进代码库
+
+## 依赖安全
+- 定期运行 \\`,
+    },
+    {
+        name: 'official-release-checklist',
+        version: '1.0.0',
+        description: '发布上线清单：从代码冻结到生产验证的完整流程',
+        keywords: ['release', 'deploy', '发布', '上线', 'checklist', '部署'],
+        content: `---
+name: official-release-checklist
+version: 1.0.0
+description: "发布上线清单：从代码冻结到生产验证的完整流程"
+tags: [release, deploy, checklist, devops]
+---
+
+# 发布上线清单
+
+## 发布前
+- [ ] 所有测试通过（单元、集成、E2E）
+- [ ] 代码已 review 并合并到主干
+- [ ] 数据库迁移脚本已准备，可回滚
+- [ ] 配置变更已确认（环境变量、feature flag）
+- [ ] 监控告警已配置
+- [ ] 回滚方案已明确
+
+## 发布中
+- [ ] 灰度/金丝雀发布（先放 5% 流量）
+- [ ] 观察关键指标 5 分钟：错误率、P99 延迟
+
+## 发布后
+- [ ] 生产环境冒烟测试
+- [ ] 监控观察 30 分钟
+- [ ] 通知相关方
+
+## 回滚触发条件
+- 错误率上升 > 1%
+- P99 延迟上升 > 50%
+- 出现 CRITICAL 级别日志
+`,
+    },
+    {
+        name: 'official-doc-driven',
+        version: '1.0.0',
+        description: '文档驱动开发：先写文档再写代码，保持文档与代码同步',
+        keywords: ['doc-driven', 'documentation', '文档驱动', '写文档', 'readme'],
+        content: `---
+name: official-doc-driven
+version: 1.0.0
+description: "文档驱动开发：先写文档再写代码，保持文档与代码同步"
+tags: [documentation, doc-driven, readme]
+---
+
+# 文档驱动开发
+
+## 核心理念
+如果你无法清晰地写出来，说明你还没想清楚。先写文档，逼自己想清楚再动手。
+
+## 步骤
+
+1. **写 README 先于代码**
+   - 描述模块是什么、解决什么问题
+   - 写出使用示例（即使 API 还不存在）
+   - 示例写起来别扭 = 设计有问题
+
+2. **接口文档先于实现**
+   - 函数签名 + JSDoc/注释先写
+   - 参数、返回值、异常都要说明
+
+3. **保持同步**
+   - 代码变更时同步更新文档
+   - PR 模板加入"文档是否已更新"检查项
+
+## 文档层级
+- README：模块概述 + 快速开始
+- ARCHITECTURE.md：系统设计和关键决策
+- 代码注释：解释"为什么"，不解释"是什么"
+`,
+    },
+    {
+        name: 'planning-with-files',
+        version: '2.35.0',
+        description: 'Manus 风格文件式任务规划：创建 task_plan.md/findings.md/progress.md 追踪复杂任务',
+        keywords: ['plan', 'planning', '规划', 'task plan', 'organize', '组织任务'],
+        content: `---
+name: planning-with-files
+description: Implements Manus-style file-based planning to organize and track progress on complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring 5+ tool calls. Supports automatic session recovery after /clear.
+user-invocable: true
+allowed-tools: "Read Write Edit Bash Glob Grep"
+hooks:
+  UserPromptSubmit:
+    - hooks:
+        - type: command
+          command: "if [ -f task_plan.md ]; then echo '[planning-with-files] ACTIVE PLAN — current state:'; head -50 task_plan.md; echo ''; echo '=== recent progress ==='; tail -20 progress.md 2>/dev/null; echo ''; echo '[planning-with-files] Read findings.md for research context. Continue from the current phase.'; fi"
+  PreToolUse:
+    - matcher: "Write|Edit|Bash|Read|Glob|Grep"
+      hooks:
+        - type: command
+          command: "cat task_plan.md 2>/dev/null | head -30 || true"
+  PostToolUse:
+    - matcher: "Write|Edit"
+      hooks:
+        - type: command
+          command: "if [ -f task_plan.md ]; then echo '[planning-with-files] Update progress.md with what you just did. If a phase is now complete, update task_plan.md status.'; fi"
+  Stop:
+    - hooks:
+        - type: command
+          command: "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \\\\"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\\\\" 2>/dev/null || sh \\\\"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\\\\" 2>/dev/null || true"
+metadata:
+  version: "2.35.0"
+---
+
+# Planning with Files
+
+Work like Manus: Use persistent markdown files as your "working memory on disk."
+
+## FIRST: Restore Context (v2.2.0)
+
+**Before doing anything else**, check if planning files exist and read them:
+
+1. If \\`,
+    },
+    {
+        name: 'code-simplifier',
+        version: '1.0.0',
+        description: '代码简化与精炼：保持功能不变，提升清晰度和可维护性',
+        keywords: ['simplify', 'refine', '简化', 'cleanup', 'code quality'],
+        content: `---
+name: code-simplifier
+description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
+model: opus
+---
+
+You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.
+
+You will analyze recently modified code and apply refinements that:
+
+1. **Preserve Functionality**: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.
+
+2. **Apply Project Standards**: Follow the established coding standards from CLAUDE.md including:
+
+   - Use ES modules with proper import sorting and extensions
+   - Prefer \\`,
+    },
+    {
+        name: 'find-skills',
+        version: '1.0.0',
+        description: '技能发现与安装：帮助用户搜索和安装 agent skills',
+        keywords: ['find skill', 'search skill', '查找技能', 'discover', 'install skill'],
+        content: `---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (\\`,
+    },
+    {
+        name: 'webapp-testing',
+        version: '1.0.0',
+        description: 'Web 应用测试：使用 Playwright 自动化浏览器交互和前端验证',
+        keywords: ['test webapp', 'playwright', 'browser test', 'e2e', 'frontend test'],
+        content: `---
+name: webapp-testing
+description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
+license: Complete terms in LICENSE.txt
+---
+
+# Web Application Testing
+
+To test local web applications, write native Python Playwright scripts.
+
+**Helper Scripts Available**:
+- \\`,
+    },
+    {
+        name: 'ui-ux-pro-max',
+        version: '2.5.0',
+        description: 'AI 驱动的设计智能工具：67 种 UI 风格、161 种配色、57 种字体搭配、99 条 UX 准则',
+        keywords: ['ui', 'ux', 'design', 'color', 'typography', 'palette', '设计'],
+        content: `---
+name: ui-ux-pro-max
+version: 2.5.0
+description: "AI 驱动的设计智能工具：67 种 UI 风格、161 种配色、57 种字体搭配、99 条 UX 准则"
+tags: [ui, ux, design, color, typography, accessibility]
+---
+
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Antigravity Kit is an AI-powered design intelligence toolkit providing searchable databases of UI styles, color palettes, font pairings, chart types, and UX guidelines. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
+
+## Search Command
+
+\\`,
+    },
+];
+//# sourceMappingURL=official-skills.js.map

package/dist/skills/official-skills.js.map

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

package/dist/skills/registry.d.ts

@@ -0,0 +1,31 @@
+export interface Skill {
+    id: string;
+    name: string;
+    keywords: string[];
+    content: string;
+    path: string;
+    isOfficial?: boolean;
+}
+/**
+ * Simple skill registry that scans ~/.claude/skills/*.md
+ * and matches by keywords in frontmatter
+ */
+export declare class SkillRegistry {
+    private skills;
+    constructor();
+    /**
+     * Scan ~/.claude/skills/ for markdown files with frontmatter
+     * Official skills are loaded first, then user skills (which can override)
+     */
+    private scan;
+    /**
+     * Match a prompt against skill keywords (case-insensitive exact substring match).
+     * Returns the first skill whose keyword appears in the prompt, or null.
+     */
+    match(prompt: string, keywords?: string[]): Skill | null;
+    /** Return all loaded skills */
+    getAll(): Skill[];
+    /** Re-scan the skills directory */
+    reload(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/skills/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;;IAM/C;;;OAGG;IACH,OAAO,CAAC,IAAI;IA4DZ;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,KAAK,GAAG,IAAI;IAkB5D,+BAA+B;IAC/B,MAAM,IAAI,KAAK,EAAE;IAIjB,mCAAmC;IACnC,MAAM,IAAI,IAAI;CAIf"}

package/dist/skills/registry.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+import matter from 'gray-matter';
+import { logger } from '../core/utils/logger.js';
+import { OFFICIAL_SKILLS } from './official-skills.js';
+const SKILLS_DIR = path.join(homedir(), '.claude', 'skills');
+/**
+ * Simple skill registry that scans ~/.claude/skills/*.md
+ * and matches by keywords in frontmatter
+ */
+export class SkillRegistry {
+    skills = new Map();
+    constructor() {
+        this.scan();
+    }
+    /**
+     * Scan ~/.claude/skills/ for markdown files with frontmatter
+     * Official skills are loaded first, then user skills (which can override)
+     */
+    scan() {
+        // 1. Load official built-in skills first
+        for (const officialSkill of OFFICIAL_SKILLS) {
+            this.skills.set(officialSkill.name, {
+                id: officialSkill.name,
+                name: officialSkill.name,
+                keywords: officialSkill.keywords,
+                content: officialSkill.content,
+                path: '<built-in>',
+                isOfficial: true,
+            });
+        }
+        logger.info(`Loaded ${OFFICIAL_SKILLS.length} official skill(s)`);
+        // 2. Load user skills from ~/.claude/skills/ (can override official skills)
+        if (!fs.existsSync(SKILLS_DIR)) {
+            logger.debug(`Skills directory not found: ${SKILLS_DIR}`);
+            return;
+        }
+        const files = fs.readdirSync(SKILLS_DIR);
+        let userCount = 0;
+        for (const file of files) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(SKILLS_DIR, file);
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const parsed = matter(content);
+                const { data, content: body } = parsed;
+                const id = path.basename(file, '.md');
+                const name = typeof data.name === 'string' ? data.name : id;
+                const rawKeywords = data.keywords;
+                const keywords = Array.isArray(rawKeywords)
+                    ? rawKeywords.filter((k) => typeof k === 'string')
+                    : [];
+                // User skills can override official skills
+                this.skills.set(id, {
+                    id,
+                    name,
+                    keywords,
+                    content: body.trim(),
+                    path: filePath,
+                    isOfficial: false,
+                });
+                userCount++;
+            }
+            catch (err) {
+                logger.warn(`Failed to parse skill file ${file}: ${err}`);
+            }
+        }
+        if (userCount > 0) {
+            logger.info(`Loaded ${userCount} user skill(s) from ${SKILLS_DIR}`);
+        }
+    }
+    /**
+     * Match a prompt against skill keywords (case-insensitive exact substring match).
+     * Returns the first skill whose keyword appears in the prompt, or null.
+     */
+    match(prompt, keywords = []) {
+        const promptLower = prompt.toLowerCase();
+        const extraLower = keywords.map(k => k.toLowerCase());
+        for (const skill of this.skills.values()) {
+            const hasPromptMatch = skill.keywords.some(kw => promptLower.includes(kw.toLowerCase()));
+            const hasExtraMatch = skill.keywords.some(kw => extraLower.some(ek => ek.includes(kw.toLowerCase())));
+            if (hasPromptMatch || hasExtraMatch) {
+                return skill;
+            }
+        }
+        return null;
+    }
+    /** Return all loaded skills */
+    getAll() {
+        return Array.from(this.skills.values());
+    }
+    /** Re-scan the skills directory */
+    reload() {
+        this.skills.clear();
+        this.scan();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

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