@zhangchi835/skill-manager 1.0.0

package/_verify/client-body.js

@@ -0,0 +1,225 @@
+return {
+  apply(ctx) {
+    const slots = ctx.get('slots')
+    if (slots === undefined) return
+
+    const CSS = [
+      '.skh-trigger-wrap{display:inline-flex;align-items:center}',
+      '.skh-trigger{display:inline-flex;align-items:center;gap:4px;height:26px;padding:0 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:transparent;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1;cursor:pointer}',
+      '.skh-trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+      '.skh-trigger-on{border-color:var(--dsw-alias-accent, #5b8cff);color:var(--dsw-alias-label-primary)}',
+      '.skh-trigger-icon{font-size:13px;line-height:1}',
+      '.skh-trigger-text{font-weight:500}',
+      '.skh-trigger-count{min-width:15px;height:15px;padding:0 4px;border-radius:8px;background:var(--dsw-alias-accent, #5b8cff);color:#fff;font-size:10px;display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box}',
+      '.skh-pop-backdrop{position:fixed;inset:0;z-index:90;background:transparent}',
+      '.skh-pop-card{position:absolute;bottom:calc(100% + 6px);left:0;z-index:100;min-width:280px;max-width:min(380px,100%);max-height:min(360px,65vh);background:var(--dsw-specific-menu, var(--dsw-alias-bg-base));border:1px solid var(--dsw-alias-border-inverted, var(--dsw-alias-border-l1));border-radius:12px;box-shadow:var(--dsw-shadow-lv3, 0 12px 32px rgba(0,0,0,.2));display:flex;flex-direction:column;overflow:hidden;padding:8px;box-sizing:border-box;color:var(--dsw-alias-label-primary);text-align:left}',
+      '.skh-pop-title{font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary);padding:2px 6px 6px}',
+      '.skh-pop-list{overflow-y:auto;min-height:0;display:flex;flex-direction:column;gap:2px}',
+      '.skh-pop-row{display:flex;align-items:flex-start;gap:8px;padding:6px 8px;border-radius:8px;cursor:pointer}',
+      '.skh-pop-row:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+      '.skh-pop-check{margin:3px 0 0;flex:none;accent-color:var(--dsw-alias-accent, #5b8cff)}',
+      '.skh-pop-meta{min-width:0;flex:1}',
+      '.skh-pop-name{font-size:13px;font-weight:600;word-break:break-all}',
+      '.skh-pop-desc{font-size:12px;color:var(--dsw-alias-label-tertiary);overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}',
+      '.skh-pop-empty{font-size:12px;color:var(--dsw-alias-label-tertiary);padding:8px}',
+      '.skh-pop-foot{display:flex;align-items:center;gap:8px;border-top:1px solid var(--dsw-alias-border-l2, transparent);margin-top:6px;padding:8px 6px 2px}',
+      '.skh-pop-folder{flex:1;min-width:0;font-size:11px;color:var(--dsw-alias-label-caption, var(--dsw-alias-label-tertiary));overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.skh-pop-done{border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-primary);border-radius:6px;padding:3px 10px;font-size:12px;cursor:pointer}',
+      '.skh-pop-done:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+      '.skh-admin{display:flex;flex-direction:column;gap:12px;color:var(--dsw-alias-label-primary);font-size:13px}',
+      '.skh-title{font-size:14px;font-weight:600}',
+      '.skh-sub{font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary)}',
+      '.skh-field{display:flex;gap:8px}',
+      '.skh-input{flex:1;min-width:0;border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-primary);border-radius:8px;padding:6px 8px;font-size:12px;outline:none}',
+      '.skh-btn{border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-primary);border-radius:8px;padding:5px 10px;font-size:12px;cursor:pointer;white-space:nowrap}',
+      '.skh-btn:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+      '.skh-status{font-size:12px;color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere}',
+      '.skh-status-err{color:var(--dsw-alias-state-error-primary)}',
+      '.skh-row{display:flex;flex-direction:column;gap:2px;border:1px solid var(--dsw-alias-border-l2, var(--dsw-alias-border-l1));border-radius:8px;padding:8px}',
+      '.skh-row-top{display:flex;align-items:center;gap:8px;min-width:0;flex-wrap:wrap}',
+      '.skh-row-name{font-weight:600;font-size:13px;word-break:break-all}',
+      '.skh-badge{flex:none;font-size:11px;border-radius:6px;padding:1px 6px;border:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-secondary)}',
+      '.skh-badge-on{border-color:var(--dsw-alias-accent, #5b8cff);color:var(--dsw-alias-accent, #5b8cff)}',
+      '.skh-row-desc{font-size:12px;color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere}',
+      '.skh-row-rel{font-size:11px;color:var(--dsw-alias-label-caption, var(--dsw-alias-label-tertiary));overflow-wrap:anywhere}',
+      '.skh-note{font-size:12px;color:var(--dsw-alias-label-tertiary);border:1px dashed var(--dsw-alias-border-l1);border-radius:8px;padding:8px}',
+      '.skh-panel{display:flex;flex-direction:column;gap:8px;color:var(--dsw-alias-label-primary);font-size:12px}',
+    ].join('\n')
+
+    const store = {
+      view: null,
+      loadError: null,
+      open: false,
+      listeners: [],
+      notify: function () { for (let i = 0; i < this.listeners.length; i++) { try { this.listeners[i]() } catch (_) {} } },
+      set: function (patch) { for (const key in patch) this[key] = patch[key]; this.notify() },
+      subscribe: function (listener) { this.listeners.push(listener); return () => { this.listeners = this.listeners.filter((l) => l !== listener) } },
+    }
+    function refresh() {
+      host.call('state').then(function (view) { store.set({ view: view, loadError: null }) }, function (error) { store.set({ loadError: String(error) }) })
+    }
+    function applySelection(names) {
+      host.call('setSelected', { names: names }).then(refresh, refresh)
+    }
+    function useStore() {
+      const [tick, setTick] = React.useState(0)
+      React.useEffect(function () { return store.subscribe(function () { setTick(function (t) { return t + 1 }) }) }, [])
+    }
+
+    function SkillsTrigger() {
+      useStore()
+      const view = store.view
+      const count = view === null ? 0 : view.selected.length
+      const on = count > 0
+      return React.createElement('div', { className: 'skh-trigger-wrap' },
+        React.createElement('button', {
+          type: 'button',
+          className: 'skh-trigger' + (on ? ' skh-trigger-on' : ''),
+          title: on ? '已启用技能: ' + view.selected.join(', ') : '选择会话技能（勾选即启用）',
+          onClick: function () { store.set({ open: !store.open }) },
+        },
+          React.createElement('span', { className: 'skh-trigger-icon', 'aria-hidden': 'true' }, '\uD83E\uDDE9'),
+          React.createElement('span', { className: 'skh-trigger-text' }, '技能'),
+          on ? React.createElement('span', { className: 'skh-trigger-count' }, String(count)) : null))
+    }
+
+    function SkillsPopup() {
+      useStore()
+      if (!store.open) return null
+      const view = store.view
+      const skills = view === null ? [] : view.skills
+      const selectedNames = view === null ? [] : view.selected
+      const selectedSet = {}
+      for (let i = 0; i < selectedNames.length; i++) selectedSet[selectedNames[i]] = true
+      const toggle = function (name) {
+        const next = []
+        for (let i = 0; i < selectedNames.length; i++) if (selectedNames[i] !== name) next.push(selectedNames[i])
+        if (selectedSet[name] !== true) next.push(name)
+        applySelection(next)
+      }
+      const emptyText = view === null || view.folder === ''
+        ? '尚未配置技能文件夹：请到 设置 → 技能管理 中设置'
+        : (view.scanError !== '' ? view.scanError : '技能文件夹中没有 .md 文件')
+      return React.createElement('div', null,
+        React.createElement('div', { className: 'skh-pop-backdrop', onClick: function () { store.set({ open: false }) } }),
+        React.createElement('div', { className: 'skh-pop-card', role: 'dialog', 'aria-label': '会话技能选择' },
+          React.createElement('div', { className: 'skh-pop-title' }, '会话技能（勾选即启用，未勾选不启用）'),
+          skills.length === 0 ? React.createElement('div', { className: 'skh-pop-empty' }, emptyText) : null,
+          React.createElement('div', { className: 'skh-pop-list' },
+            skills.map(function (s) {
+              return React.createElement('label', { key: s.name, className: 'skh-pop-row' },
+                React.createElement('input', { type: 'checkbox', className: 'skh-pop-check', checked: selectedSet[s.name] === true, onChange: function () { toggle(s.name) } }),
+                React.createElement('div', { className: 'skh-pop-meta' },
+                  React.createElement('div', { className: 'skh-pop-name' }, s.name),
+                  React.createElement('div', { className: 'skh-pop-desc' }, s.description === null || s.description === '' ? s.rel : s.description)))
+            })),
+          React.createElement('div', { className: 'skh-pop-foot' },
+            React.createElement('span', { className: 'skh-pop-folder', title: view === null ? '' : view.folder }, view === null ? '' : view.folder),
+            React.createElement('button', { type: 'button', className: 'skh-pop-done', onClick: function () { store.set({ open: false }) } }, '完成'))))
+    }
+
+    function SkillsAdmin() {
+      useStore()
+      const view = store.view
+      const [folderDraft, setFolderDraft] = React.useState(null)
+      const [draftTouched, setDraftTouched] = React.useState(false)
+      if (folderDraft === null && view !== null && !draftTouched) setFolderDraft(view.folder)
+      const skills = view === null ? [] : view.skills
+      const others = view === null ? [] : view.otherSkills
+      const selectedSet = {}
+      if (view !== null) for (let i = 0; i < view.selected.length; i++) selectedSet[view.selected[i]] = true
+      let statusText = ''
+      let statusErr = false
+      if (store.loadError !== null) { statusText = '状态读取失败: ' + store.loadError; statusErr = true }
+      else if (view === null) statusText = '正在读取状态…'
+      else if (view.scanning) statusText = '正在扫描…'
+      else if (!view.scanned) statusText = '尚未扫描'
+      else if (view.scanError !== '') { statusText = view.scanError; statusErr = true }
+      else statusText = '已扫描 ' + skills.length + ' 个技能' + (view.scanTime === null || view.scanTime === '' ? '' : ' · ' + view.scanTime)
+      const applyFolder = function () {
+        host.call('setFolder', { path: folderDraft === null ? '' : folderDraft }).then(refresh, refresh)
+      }
+      const reload = function () { host.call('reload').then(refresh, refresh) }
+      return React.createElement('div', { className: 'skh-admin' },
+        React.createElement('div', { className: 'skh-title' }, '技能管理'),
+        React.createElement('div', { className: 'skh-sub' }, '技能文件夹'),
+        React.createElement('div', { className: 'skh-field' },
+          React.createElement('input', {
+            className: 'skh-input',
+            value: folderDraft === null ? '' : folderDraft,
+            placeholder: '技能文件夹绝对路径（递归扫描所有 .md）',
+            onChange: function (event) { setDraftTouched(true); setFolderDraft(event.target.value) },
+          }),
+          React.createElement('button', { type: 'button', className: 'skh-btn', onClick: applyFolder }, '保存并加载'),
+          React.createElement('button', { type: 'button', className: 'skh-btn', onClick: reload }, '重新扫描')),
+        React.createElement('div', { className: statusErr ? 'skh-status skh-status-err' : 'skh-status' }, statusText),
+        React.createElement('div', { className: 'skh-sub' }, '本文件夹技能（' + skills.length + '）'),
+        skills.map(function (s) {
+          return React.createElement('div', { key: s.name, className: 'skh-row' },
+            React.createElement('div', { className: 'skh-row-top' },
+              React.createElement('span', { className: 'skh-row-name' }, s.name),
+              React.createElement('span', { className: selectedSet[s.name] === true ? 'skh-badge skh-badge-on' : 'skh-badge' }, selectedSet[s.name] === true ? '已选择' : '未选择')),
+            React.createElement('div', { className: 'skh-row-desc' }, s.description === null || s.description === '' ? '(无描述)' : s.description),
+            React.createElement('div', { className: 'skh-row-rel' }, s.rel))
+        }),
+        React.createElement('div', { className: 'skh-sub' }, '会话中可见的其他技能（' + others.length + '）'),
+        others.map(function (s) {
+          return React.createElement('div', { key: s.provider + '/' + s.name, className: 'skh-row' },
+            React.createElement('div', { className: 'skh-row-top' },
+              React.createElement('span', { className: 'skh-row-name' }, s.name),
+              React.createElement('span', { className: 'skh-badge' }, s.provider)),
+            React.createElement('div', { className: 'skh-row-desc' }, s.description === null || s.description === '' ? '(无描述)' : s.description))
+        }),
+        React.createElement('div', { className: 'skh-note' }, '启用/停用请在输入框工具行「模式」选择器旁的「技能」选择器中勾选；本页仅管理与查看，不提供启用/停用开关。'))
+    }
+
+    function SkillsRunPanel() {
+      useStore()
+      const view = store.view
+      const [folderDraft, setFolderDraft] = React.useState(null)
+      const [draftTouched, setDraftTouched] = React.useState(false)
+      if (folderDraft === null && view !== null && !draftTouched) setFolderDraft(view.folder)
+      const skills = view === null ? [] : view.skills
+      const selected = view === null ? [] : view.selected
+      let statusText = ''
+      let statusErr = false
+      if (store.loadError !== null) { statusText = 'RPC 失败: ' + store.loadError; statusErr = true }
+      else if (view === null) statusText = '等待 Host 状态…'
+      else if (view.scanning) statusText = '正在扫描…'
+      else if (view.scanError !== '') { statusText = view.scanError; statusErr = true }
+      else statusText = '已扫描 ' + skills.length + ' 个技能，已勾选启用 ' + selected.length + ' 个'
+      const applyFolder = function () {
+        host.call('setFolder', { path: folderDraft === null ? '' : folderDraft }).then(refresh, refresh)
+      }
+      return React.createElement('div', { className: 'skh-panel' },
+        React.createElement('div', { className: 'skh-title' }, '🧩 技能加载与管理插件 · 已安装'),
+        React.createElement('div', { className: 'skh-field' },
+          React.createElement('input', {
+            className: 'skh-input',
+            value: folderDraft === null ? '' : folderDraft,
+            placeholder: '技能文件夹路径',
+            onChange: function (event) { setDraftTouched(true); setFolderDraft(event.target.value) },
+          }),
+          React.createElement('button', { type: 'button', className: 'skh-btn', onClick: applyFolder }, '加载'),
+          React.createElement('button', { type: 'button', className: 'skh-btn', onClick: function () { host.call('reload').then(refresh, refresh) } }, '重新扫描')),
+        React.createElement('div', { className: statusErr ? 'skh-status skh-status-err' : 'skh-status' }, statusText),
+        selected.length > 0 ? React.createElement('div', { className: 'skh-status' }, '已启用: ' + selected.join(', ')) : null,
+        React.createElement('div', { className: 'skh-note' }, '使用方法：输入框工具行的「模式」选择器旁点「技能」，勾选即启用、取消勾选即停用；管理页在 设置 → 技能管理。'))
+    }
+
+    ctx.effect(function () { return styles.insert(CSS) }, 'skills-hub css')
+    slots.inject('conversation.input.left', function () {
+      return slots.register({ name: 'conversation.input.left', id: 'skills-hub-trigger', order: 0 }, SkillsTrigger)
+    })
+    slots.inject('conversation.input.overlay', function () {
+      return slots.register({ name: 'conversation.input.overlay', id: 'skills-hub-popup', order: 2 }, SkillsPopup)
+    })
+    slots.inject('settings.section', function () {
+      return slots.register({ name: 'settings.section', id: 'skills-hub', order: 25, label: '技能管理' }, SkillsAdmin)
+    })
+    slots.inject('tool.view.cordis', function () {
+      return slots.register({ name: 'tool.view.cordis', key: 'self' }, SkillsRunPanel)
+    })
+    refresh()
+  },
+}

package/_verify/host-body.js

@@ -0,0 +1,321 @@
+return {
+  apply(ctx) {
+    const skills = ctx.get('skills')
+    if (skills === undefined) return
+    const fsService = ctx.get('fs')
+    const sandboxPolicy = ctx.get('sandboxPolicy')
+
+    let workspaceRoot = ''
+    if (sandboxPolicy !== undefined && typeof sandboxPolicy.workspaceRoot === 'string') workspaceRoot = sandboxPolicy.workspaceRoot
+
+    const state = {
+      folder: workspaceRoot === '' ? '' : workspaceRoot.replace(/[\\/]+$/, '') + '/skills',
+      folderExists: false,
+      scanned: false,
+      scanning: false,
+      scanTime: null,
+      scanError: '',
+      skills: [],
+      selected: [],
+      otherSkills: [],
+    }
+    let generation = 0
+    let scanPromise = null
+    let invalidate = function () {}
+
+    function msg(error) {
+      return error !== null && typeof error === 'object' && typeof error.message === 'string' ? error.message : String(error)
+    }
+    function kebab(value) {
+      return String(value).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+/, '').replace(/-+$/, '')
+    }
+    function hashText(text) {
+      let h = 5381
+      for (let i = 0; i < text.length; i++) h = (((h << 5) + h) + text.charCodeAt(i)) >>> 0
+      return h.toString(36)
+    }
+    function firstLine(text) {
+      const match = /^\s*([^\n\r]*)/.exec(text === undefined || text === null ? '' : String(text))
+      return match === null ? '' : match[1].trim()
+    }
+
+    function parseFrontmatterFields(raw) {
+      const data = Object.create(null)
+      const lines = raw.split('\n')
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].replace(/\r$/, '')
+        const match = /^([A-Za-z0-9_-]+)\s*:\s*(.*)$/.exec(line)
+        if (match === null) continue
+        const key = match[1]
+        let value = match[2].trim()
+        const first = value.charAt(0)
+        const last = value.charAt(value.length - 1)
+        if ((first === '"' && last === '"' && value.length >= 2) || (first === "'" && last === "'" && value.length >= 2)) value = value.slice(1, -1)
+        else if (value === 'true' || value === 'false') value = value === 'true'
+        else if (/^-?\d+$/.test(value)) value = Number(value)
+        data[key] = value
+      }
+      return data
+    }
+    function parseFrontmatter(text) {
+      if (typeof text !== 'string' || text.length === 0) return null
+      const firstEnd = text.indexOf('\n')
+      if (firstEnd < 0) return null
+      if (text.slice(0, firstEnd).replace(/\r$/, '') !== '---') return null
+      let lineStart = firstEnd + 1
+      while (lineStart <= text.length) {
+        const nextNewline = text.indexOf('\n', lineStart)
+        const lineEnd = nextNewline < 0 ? text.length : nextNewline
+        if (text.slice(lineStart, lineEnd).replace(/\r$/, '') === '---') {
+          const bodyStart = nextNewline < 0 ? text.length : nextNewline + 1
+          return { data: parseFrontmatterFields(text.slice(firstEnd + 1, lineStart)), body: text.slice(bodyStart) }
+        }
+        if (nextNewline < 0) return null
+        lineStart = nextNewline + 1
+      }
+      return null
+    }
+
+    function parseSkill(text, rel) {
+      const fm = parseFrontmatter(text)
+      const fileName = rel.replace(/^.*[\\/]/, '')
+      const stem = fileName.replace(/\.md$/i, '')
+      let name = null
+      let description = null
+      let whenToUse
+      let metadata
+      if (fm !== null) {
+        if (typeof fm.data.name === 'string' && fm.data.name.trim() !== '') name = fm.data.name.trim()
+        if (typeof fm.data.description === 'string' && fm.data.description.trim() !== '') description = fm.data.description.trim()
+        if (typeof fm.data['whenToUse'] === 'string' && fm.data['whenToUse'].trim() !== '') whenToUse = fm.data['whenToUse'].trim()
+        if (fm.data.metadata !== null && typeof fm.data.metadata === 'object' && !Array.isArray(fm.data.metadata)) metadata = fm.data.metadata
+      }
+      if (name === null) name = stem
+      let finalName = kebab(name)
+      if (finalName === '') finalName = 'skill-' + hashText(rel)
+      if (finalName.length > 64) finalName = finalName.slice(0, 64).replace(/-+$/, '')
+      const body = fm === null ? text : fm.body
+      if (description === null) {
+        description = firstLine(body)
+        if (description === '') description = 'Skill loaded from ' + rel
+      }
+      return { name: finalName, description: description, whenToUse: whenToUse, metadata: metadata, content: String(body).trim() }
+    }
+
+    async function walk(dirTarget, rel, found, errors, depth, budget) {
+      if (depth > 24 || budget.count >= 4000) return
+      let entries
+      try { entries = await fsService.listDir(dirTarget, undefined) } catch (error) { errors.push('listDir failed ' + rel + ': ' + msg(error)); return }
+      for (let i = 0; i < entries.length && budget.count < 4000; i++) {
+        const entry = entries[i]
+        budget.count++
+        const childRel = rel === '' ? entry.name : rel + '/' + entry.name
+        if (entry.type === 'directory') {
+          if (entry.target === undefined || entry.target === null) continue
+          await walk(entry.target, childRel, found, errors, depth + 1, budget)
+        } else if (entry.type === 'file' && /\.md$/i.test(entry.name)) {
+          if (entry.target === undefined || entry.target === null) continue
+          let text
+          try { text = await fsService.readText(entry.target, undefined) } catch (error) { errors.push('read failed ' + childRel + ': ' + msg(error)); continue }
+          const parsed = parseSkill(text, childRel)
+          const displayPath = typeof entry.target.displayPath === 'string' ? entry.target.displayPath : state.folder + '/' + childRel
+          found.push({ name: parsed.name, description: parsed.description, whenToUse: parsed.whenToUse, rel: childRel, path: displayPath, metadata: parsed.metadata })
+        }
+      }
+    }
+
+    async function collectOtherSkills() {
+      try {
+        const list = await skills.list({ cwd: workspaceRoot === '' ? undefined : workspaceRoot })
+        const out = []
+        for (let i = 0; i < list.length; i++) {
+          const s = list[i]
+          if (s === null || typeof s !== 'object' || s.provider === 'skills-hub') continue
+          out.push({
+            name: typeof s.name === 'string' ? s.name : '',
+            description: typeof s.description === 'string' ? s.description : '',
+            provider: typeof s.provider === 'string' ? s.provider : '',
+            source: typeof s.source === 'string' ? s.source : '',
+          })
+        }
+        return out
+      } catch (error) {
+        return []
+      }
+    }
+
+    async function scanNow() {
+      const gen = ++generation
+      state.scanning = true
+      state.scanError = ''
+      const errors = []
+      const found = []
+      try {
+        if (state.folder === '') {
+          // 未配置文件夹：静默等待配置
+        } else if (fsService === undefined) {
+          errors.push('filesystem service unavailable')
+        } else {
+          let target
+          try { target = await fsService.resolve(state.folder) } catch (error) { errors.push('resolve failed: ' + msg(error)) }
+          if (target !== undefined) {
+            let info
+            try { info = await fsService.stat(target) } catch (error) { errors.push('stat failed: ' + msg(error)) }
+            if (info === undefined) { state.folderExists = false; errors.push('folder not found: ' + state.folder) }
+            else if (info.type !== 'directory') { state.folderExists = false; errors.push('not a directory: ' + state.folder) }
+            else { state.folderExists = true; await walk(target, '', found, errors, 0, { count: 0 }) }
+          }
+        }
+      } catch (error) { errors.push(msg(error)) }
+      if (gen !== generation) return
+      const seen = Object.create(null)
+      const out = []
+      for (let i = 0; i < found.length; i++) {
+        const s = found[i]
+        if (seen[s.name] === true) continue
+        seen[s.name] = true
+        out.push(s)
+      }
+      out.sort(function (a, b) { return a.name < b.name ? -1 : a.name > b.name ? 1 : 0 })
+      const keep = []
+      for (let i = 0; i < state.selected.length; i++) if (seen[state.selected[i]] === true) keep.push(state.selected[i])
+      state.selected = keep
+      state.skills = out
+      state.scanError = errors.join('; ')
+      state.scanned = true
+      state.scanning = false
+      state.scanTime = typeof Date === 'function' ? new Date().toISOString() : null
+      state.otherSkills = await collectOtherSkills()
+      try { invalidate() } catch (_) {}
+      console.log('[skills-hub] scan complete: ' + out.length + ' skills, errors: ' + (errors.length === 0 ? 'none' : errors.join('; ')))
+    }
+
+    function scheduleScan() {
+      if (scanPromise !== null) return scanPromise
+      const promise = scanNow().catch(function (error) { console.error('[skills-hub] scan failed:', msg(error)) }).finally(function () { scanPromise = null })
+      scanPromise = promise
+      return promise
+    }
+
+    ctx.effect(function () {
+      return skills.registerProvider(function (control) {
+        invalidate = function () { try { control.invalidate() } catch (_) {} }
+        return {
+          name: 'skills-hub',
+          async list(options) {
+            const signal = options === undefined ? undefined : options.signal
+            const selectedSet = Object.create(null)
+            for (let i = 0; i < state.selected.length; i++) selectedSet[state.selected[i]] = true
+            const out = []
+            for (let i = 0; i < state.skills.length; i++) {
+              if (signal !== undefined && signal.aborted) break
+              const s = state.skills[i]
+              if (selectedSet[s.name] !== true) continue
+              const candidate = {
+                name: s.name,
+                description: s.description,
+                invocation: { modelInvocable: true, userInvocable: true },
+                source: 'custom',
+                provider: 'skills-hub',
+                rank: 350,
+                locator: { path: s.path, rel: s.rel },
+                resourceBase: { kind: 'directory', path: state.folder },
+                path: s.path,
+              }
+              if (s.whenToUse !== undefined) candidate.whenToUse = s.whenToUse
+              out.push(candidate)
+            }
+            return out
+          },
+          async get(candidate, options) {
+            const signal = options === undefined ? undefined : options.signal
+            const loc = candidate === null || candidate === undefined ? null : candidate.locator
+            const path = loc === null || loc === undefined ? undefined : loc.path
+            if (typeof path !== 'string' || path === '' || fsService === undefined) return undefined
+            if (signal !== undefined && signal.aborted) return undefined
+            let target
+            try { target = await fsService.resolve(path, { signal: signal }) } catch (_) { return undefined }
+            if (signal !== undefined && signal.aborted) return undefined
+            let text
+            try { text = await fsService.readText(target, signal) } catch (_) { return undefined }
+            if (signal !== undefined && signal.aborted) return undefined
+            const rel = loc === null || loc === undefined ? '' : loc.rel
+            const parsed = parseSkill(text, typeof rel === 'string' ? rel : '')
+            const definition = {
+              name: candidate.name,
+              description: parsed.description,
+              invocation: { modelInvocable: true, userInvocable: true },
+              source: 'custom',
+              provider: 'skills-hub',
+              resourceBase: { kind: 'directory', path: state.folder },
+              path: path,
+              content: parsed.content,
+            }
+            if (parsed.whenToUse !== undefined) definition.whenToUse = parsed.whenToUse
+            if (parsed.metadata !== undefined) definition.metadata = parsed.metadata
+            return definition
+          },
+        }
+      })
+    }, 'skills-hub provider')
+
+    function selectedSetOf() {
+      const set = Object.create(null)
+      for (let i = 0; i < state.selected.length; i++) set[state.selected[i]] = true
+      return set
+    }
+    async function buildView() {
+      const set = selectedSetOf()
+      const skillRows = []
+      for (let i = 0; i < state.skills.length; i++) {
+        const s = state.skills[i]
+        skillRows.push({
+          name: s.name,
+          description: s.description,
+          whenToUse: s.whenToUse === undefined ? null : s.whenToUse,
+          rel: s.rel,
+          path: s.path,
+          selected: set[s.name] === true,
+        })
+      }
+      return {
+        folder: state.folder,
+        folderExists: state.folderExists,
+        scanned: state.scanned,
+        scanning: state.scanning,
+        scanTime: state.scanTime,
+        scanError: state.scanError,
+        skills: skillRows,
+        selected: state.selected.slice(),
+        otherSkills: state.otherSkills.slice(),
+      }
+    }
+
+    ctx.effect(function () { return harness.handle('state', function () { return buildView() }) }, 'skills-hub rpc state')
+    ctx.effect(function () {
+      return harness.handle('setFolder', function (args) {
+        const path = args !== null && typeof args === 'object' && typeof args.path === 'string' ? args.path : ''
+        const trimmed = path.trim()
+        if (trimmed !== '') state.folder = trimmed
+        return scheduleScan().then(buildView)
+      })
+    }, 'skills-hub rpc setFolder')
+    ctx.effect(function () {
+      return harness.handle('setSelected', function (args) {
+        const names = args !== null && typeof args === 'object' && Array.isArray(args.names) ? args.names.filter(function (n) { return typeof n === 'string' }) : []
+        const known = Object.create(null)
+        for (let i = 0; i < state.skills.length; i++) known[state.skills[i].name] = true
+        const next = []
+        for (let i = 0; i < names.length; i++) if (known[names[i]] === true && next.indexOf(names[i]) < 0) next.push(names[i])
+        state.selected = next
+        try { invalidate() } catch (_) {}
+        return buildView()
+      })
+    }, 'skills-hub rpc setSelected')
+    ctx.effect(function () {
+      return harness.handle('reload', function () { return scheduleScan().then(buildView) })
+    }, 'skills-hub rpc reload')
+
+    scheduleScan()
+  },
+}