Repository: qufei1993/skills-hub
Branch: main
Commit: cf6c584aa228
Files: 124
Total size: 1.1 MB

Directory structure:
gitextract_nr53l0gg/

├── .github/
│   └── workflows/
│       ├── ci.yml
│       ├── release.yml
│       └── update-featured-skills.yml
├── .gitignore
├── AGENTS.md
├── CHANGELOG.md
├── CLAUDE.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── SECURITY.md
├── docs/
│   ├── CHANGELOG.zh.md
│   ├── README.zh.md
│   ├── future/
│   │   └── profile-requirements.md
│   ├── releases/
│   │   ├── v0.1-v0.2/
│   │   │   ├── system-design.md
│   │   │   └── system-design.zh.md
│   │   ├── v0.3.0/
│   │   │   ├── plan-bug-fixes.md
│   │   │   ├── plan-explore-page-redesign.md
│   │   │   ├── plan-featured-skills.md
│   │   │   ├── plan-online-search.md
│   │   │   └── plan-skill-detail-view.md
│   │   ├── v0.3.1/
│   │   │   ├── plan-in-app-update.md
│   │   │   ├── plan-qoderwork-support.md
│   │   │   ├── plan-settings-page.md
│   │   │   └── skills-aggregation-repo.md
│   │   ├── v0.4.0/
│   │   │   ├── bugfix-language-toggle-loading-overlay.md
│   │   │   ├── plan-in-app-update.md
│   │   │   ├── plan-qoderwork-support.md
│   │   │   ├── plan-settings-page.md
│   │   │   └── skills-aggregation-repo.md
│   │   ├── v0.4.1/
│   │   │   └── plan-frontmatter-table.md
│   │   ├── v0.4.2/
│   │   │   ├── bugfix-new-tools-modal-style.md
│   │   │   └── bugfix-root-skill-install-false-exists.md
│   │   ├── v0.4.3/
│   │   │   ├── add-copaw-support.md
│   │   │   └── bugfix-github-install-and-frontmatter.md
│   │   ├── v0.5.0/
│   │   │   ├── implementation-plan.md
│   │   │   ├── project-scope-design.md
│   │   │   └── ux-optimizations.md
│   │   └── v0.6.0/
│   │       ├── minor-updates.md
│   │       └── tag-management.md
│   ├── skills_hub_design.html
│   ├── skills_hub_v2_design.html
│   └── tag_profile_interactive_prototype.html
├── eslint.config.js
├── featured-skills.json
├── index.html
├── package.json
├── scripts/
│   ├── coverage-rust.sh
│   ├── extract-changelog.mjs
│   ├── fetch-featured-skills.mjs
│   ├── tauri-icon-desktop.mjs
│   └── version.mjs
├── src/
│   ├── App.css
│   ├── App.tsx
│   ├── components/
│   │   ├── Layout.tsx
│   │   └── skills/
│   │       ├── ExplorePage.tsx
│   │       ├── FilterBar.tsx
│   │       ├── Header.tsx
│   │       ├── LoadingOverlay.tsx
│   │       ├── SettingsPage.tsx
│   │       ├── SkillCard.tsx
│   │       ├── SkillDetailView.tsx
│   │       ├── SkillsList.tsx
│   │       ├── TagsPage.tsx
│   │       ├── modals/
│   │       │   ├── AddSkillModal.tsx
│   │       │   ├── DeleteModal.tsx
│   │       │   ├── EditSkillTagsModal.tsx
│   │       │   ├── GitPickModal.tsx
│   │       │   ├── ImportModal.tsx
│   │       │   ├── LocalPickModal.tsx
│   │       │   ├── NewToolsModal.tsx
│   │       │   ├── ScopeSyncModal.tsx
│   │       │   └── SharedDirModal.tsx
│   │       └── types.ts
│   ├── i18n/
│   │   ├── index.ts
│   │   └── resources.ts
│   ├── index.css
│   ├── main.tsx
│   ├── pages/
│   │   └── Dashboard.tsx
│   └── tauri-plugin-dialog.d.ts
├── src-tauri/
│   ├── .gitignore
│   ├── Cargo.toml
│   ├── build.rs
│   ├── capabilities/
│   │   └── default.json
│   ├── icons/
│   │   └── icon.icns
│   ├── src/
│   │   ├── commands/
│   │   │   ├── mod.rs
│   │   │   └── tests/
│   │   │       └── commands.rs
│   │   ├── core/
│   │   │   ├── cache_cleanup.rs
│   │   │   ├── cancel_token.rs
│   │   │   ├── central_repo.rs
│   │   │   ├── content_hash.rs
│   │   │   ├── featured_skills.rs
│   │   │   ├── git_fetcher.rs
│   │   │   ├── github_download.rs
│   │   │   ├── github_search.rs
│   │   │   ├── installer.rs
│   │   │   ├── mod.rs
│   │   │   ├── onboarding.rs
│   │   │   ├── skill_files.rs
│   │   │   ├── skill_store.rs
│   │   │   ├── skills_search.rs
│   │   │   ├── sync_engine.rs
│   │   │   ├── temp_cleanup.rs
│   │   │   ├── tests/
│   │   │   │   ├── central_repo.rs
│   │   │   │   ├── content_hash.rs
│   │   │   │   ├── featured_skills.rs
│   │   │   │   ├── git_fetcher.rs
│   │   │   │   ├── github_search.rs
│   │   │   │   ├── installer.rs
│   │   │   │   ├── onboarding.rs
│   │   │   │   ├── skill_store.rs
│   │   │   │   ├── skills_search.rs
│   │   │   │   ├── sync_engine.rs
│   │   │   │   ├── temp_cleanup.rs
│   │   │   │   └── tool_adapters.rs
│   │   │   └── tool_adapters/
│   │   │       └── mod.rs
│   │   ├── lib.rs
│   │   └── main.rs
│   └── tauri.conf.json
├── tsconfig.app.json
├── tsconfig.json
├── tsconfig.node.json
└── vite.config.ts

================================================
FILE CONTENTS
================================================

================================================
FILE: .github/workflows/ci.yml
================================================
name: CI

on:
  pull_request:
  push:
    branches: [main]

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

jobs:
  web:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm run version:check
      - run: npm run lint
      - run: npm run build

  rust:
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: src-tauri
    steps:
      - uses: actions/checkout@v4
      - name: Install system dependencies (linux)
        run: |
          sudo apt-get update
          sudo apt-get install -y libglib2.0-dev libgtk-3-dev libjavascriptcoregtk-4.1-dev libsoup-3.0-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
        with:
          workspaces: src-tauri
      - run: cargo fmt --all -- --check
      - run: cargo clippy --all-targets --all-features -- -D warnings
      - run: cargo test --all


================================================
FILE: .github/workflows/release.yml
================================================
name: Release

on:
  push:
    tags:
      - "v*"
  workflow_dispatch:

permissions:
  contents: write

concurrency:
  group: release-${{ github.ref_name }}
  cancel-in-progress: true

jobs:
  release:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          # macOS Intel (x86_64)
          - os: macos-14
            target: x86_64-apple-darwin
            arch: x86_64
          # macOS Apple Silicon (arm64)
          - os: macos-14
            target: aarch64-apple-darwin
            arch: aarch64
          # Windows x64 (Intel/AMD)
          - os: windows-2022
            target: x86_64-pc-windows-msvc
            arch: x64
          # Windows on Arm (aarch64)
          - os: windows-2022
            target: aarch64-pc-windows-msvc
            arch: arm64

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: npm

      - name: Setup Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Rust cache
        uses: Swatinem/rust-cache@v2
        with:
          workspaces: src-tauri

      - name: Add macOS targets
        run: rustup target add ${{ matrix.target }}

      - name: Install macOS build deps
        if: matrix.os == 'macos-14'
        shell: bash
        run: |
          set -euxo pipefail
          brew install pkg-config cmake

      - name: Install Windows build deps
        if: matrix.os == 'windows-2022'
        shell: bash
        run: |
          set -euxo pipefail
          # Install Strawberry Perl for OpenSSL build (required by openssl-sys)
          choco install -y strawberryperl
          # Add Strawberry Perl to PATH
          export PATH="/c/Strawberry/perl/bin:$PATH"
          # WebView2 Runtime is pre-installed on windows-2022 runner
          rustup target add ${{ matrix.target }}

      - name: Install frontend deps
        run: npm ci

      - name: Prepare Tauri signing key
        shell: bash
        env:
          RAW_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
          RAW_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
        run: |
          node <<'NODE'
          const fs = require('fs');

          const raw = (process.env.RAW_KEY || '').trim();
          if (!raw) {
            console.warn('⚠️ 未配置 TAURI_SIGNING_PRIVATE_KEY，将生成未签名版本');
            process.exit(0);
          }

          const looksLikeBase64 = (s) => /^[A-Za-z0-9+/=]+$/.test(s);
          const startsWithUntrusted = (s) => s.split(/\r?\n/)[0].startsWith('untrusted comment:');

          let normalized = '';
          if (startsWithUntrusted(raw)) {
            normalized = raw.endsWith('\n') ? raw : raw + '\n';
          } else if (looksLikeBase64(raw)) {
            try {
              const decoded = Buffer.from(raw, 'base64').toString('utf8');
              if (startsWithUntrusted(decoded.trim())) {
                normalized = decoded.trimEnd() + '\n';
              } else {
                normalized = `untrusted comment: tauri signing key\n${raw.replace(/\s+/g, '')}\n`;
              }
            } catch {
              normalized = `untrusted comment: tauri signing key\n${raw.replace(/\s+/g, '')}\n`;
            }
          } else {
            try {
              const decoded = Buffer.from(raw, 'base64').toString('utf8');
              if (startsWithUntrusted(decoded.trim())) {
                normalized = decoded.trimEnd() + '\n';
              } else {
                throw new Error('not minisign');
              }
            } catch {
              console.error('❌ TAURI_SIGNING_PRIVATE_KEY 格式无法识别（不是两行原文/其 base64/单行 base64）');
              process.exit(1);
            }
          }

          const keyB64 = Buffer.from(normalized, 'utf8').toString('base64');
          const envFile = process.env.GITHUB_ENV;
          fs.appendFileSync(envFile, `TAURI_SIGNING_PRIVATE_KEY=${keyB64}\n`);

          const pwd = (process.env.RAW_PASSWORD || '').trim();
          if (pwd) fs.appendFileSync(envFile, `TAURI_SIGNING_PRIVATE_KEY_PASSWORD=${pwd}\n`);
          NODE

      - name: Import Apple certificate (codesign)
        shell: bash
        env:
          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
          APPLE_SIGNING_IDENTITY_INPUT: ${{ secrets.APPLE_SIGNING_IDENTITY }}
          KEYCHAIN_PASSWORD: ${{ secrets.KEYCHAIN_PASSWORD }}
        run: |
          set -euo pipefail

          if [ -z "${APPLE_CERTIFICATE:-}" ]; then
            echo "ℹ️ 未配置 APPLE_CERTIFICATE，跳过 codesign 导入"
            exit 0
          fi
          if [ -z "${APPLE_CERTIFICATE_PASSWORD:-}" ]; then
            echo "❌ 缺少 Secret：APPLE_CERTIFICATE_PASSWORD" >&2
            exit 1
          fi
          if [ -z "${KEYCHAIN_PASSWORD:-}" ]; then
            echo "❌ 缺少 Secret：KEYCHAIN_PASSWORD" >&2
            exit 1
          fi

          CERT_PATH="$RUNNER_TEMP/certificate.p12"
          KEYCHAIN_PATH="$RUNNER_TEMP/build.keychain-db"

          echo "$APPLE_CERTIFICATE" | (base64 --decode 2>/dev/null || base64 -D) > "$CERT_PATH"

          security create-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN_PATH"
          security set-keychain-settings -lut 21600 "$KEYCHAIN_PATH"
          security unlock-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN_PATH"
          security list-keychains -d user -s "$KEYCHAIN_PATH"
          security default-keychain -s "$KEYCHAIN_PATH"

          security import "$CERT_PATH" -k "$KEYCHAIN_PATH" -P "$APPLE_CERTIFICATE_PASSWORD" -T /usr/bin/codesign -T /usr/bin/security
          security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "$KEYCHAIN_PASSWORD" "$KEYCHAIN_PATH"

          echo "Available identities:"
          security find-identity -v -p codesigning "$KEYCHAIN_PATH" || true

          if [ -n "${APPLE_SIGNING_IDENTITY_INPUT:-}" ]; then
            echo "APPLE_SIGNING_IDENTITY=${APPLE_SIGNING_IDENTITY_INPUT}" >> "$GITHUB_ENV"
          else
            IDENTITY="$(security find-identity -v -p codesigning "$KEYCHAIN_PATH" | head -n 1 | sed -n 's/.*\"\\(.*\\)\".*/\\1/p' || true)"
            if [ -z "$IDENTITY" ]; then
              echo "❌ 未能从 keychain 推断 APPLE_SIGNING_IDENTITY，请配置 Secret：APPLE_SIGNING_IDENTITY" >&2
              exit 1
            fi
            echo "APPLE_SIGNING_IDENTITY=$IDENTITY" >> "$GITHUB_ENV"
          fi

      - name: Build Tauri App (macOS)
        if: matrix.os == 'macos-14'
        # updater 产物（*.tar.gz/*.sig）是基于 .app bundle 生成的，因此必须包含 app
        shell: bash
        run: |
          set -euo pipefail
          echo "=== Building Tauri App for macOS ==="
          echo "Target: ${{ matrix.target }}"
          echo "Arch: ${{ matrix.arch }}"
          if [ -n "${APPLE_SIGNING_IDENTITY:-}" ]; then
            echo "✅ 使用 APPLE_SIGNING_IDENTITY=$APPLE_SIGNING_IDENTITY 进行签名"
          else
            echo "ℹ️ 未配置 APPLE_SIGNING_IDENTITY，构建未签名版本"
            unset APPLE_SIGNING_IDENTITY
          fi
          npm run tauri:build -- --target ${{ matrix.target }} --bundles app,dmg
          echo "=== Build completed ==="
          ls -la src-tauri/target/${{ matrix.target }}/release/bundle/ || true

      - name: Build Tauri App (Windows)
        if: matrix.os == 'windows-2022'
        # Windows 产物：只生成 NSIS 安装程序
        shell: bash
        run: |
          set -euo pipefail
          echo "=== Building Tauri App for Windows ==="
          echo "Target: ${{ matrix.target }}"
          echo "Arch: ${{ matrix.arch }}"
          # Add Strawberry Perl to PATH for OpenSSL build
          export PATH="/c/Strawberry/perl/bin:$PATH"
          npm run tauri:build -- --target ${{ matrix.target }} --bundles nsis --no-sign
          echo "=== Build completed ==="
          ls -la src-tauri/target/${{ matrix.target }}/release/bundle/ || true

      - name: Verify codesign (optional)
        shell: bash
        run: |
          set -euo pipefail
          if [ -z "${APPLE_CERTIFICATE:-}" ]; then
            echo "ℹ️ 未配置 APPLE_CERTIFICATE，跳过验签"
            exit 0
          fi
          TARGET="${{ matrix.target }}"
          APP_PATH="$(find "src-tauri/target/${TARGET}/release/bundle" -type d -name "*.app" | head -n 1 || true)"
          if [ -z "$APP_PATH" ]; then
            echo "⚠️ 未找到 .app，跳过验签" >&2
            exit 0
          fi
          echo "APP_PATH=$APP_PATH"
          codesign -dv --verbose=4 "$APP_PATH" || true
          codesign --verify --deep --strict --verbose=4 "$APP_PATH"

      - name: Prepare macOS Assets
        if: matrix.os == 'macos-14'
        shell: bash
        run: |
          set -euo pipefail

          mkdir -p release-assets
          VERSION="${GITHUB_REF_NAME}" # e.g. v0.1.4
          ARCH="${{ matrix.arch }}"
          TARGET="${{ matrix.target }}"

          # 产物路径在不同 target 下可能不同：优先 target/<triple>/...，兜底 target/release/...
          BUNDLE_DIRS=(
            "src-tauri/target/${TARGET}/release/bundle"
            "src-tauri/target/release/bundle"
          )

          TAR_GZ=""
          DMG=""
          for dir in "${BUNDLE_DIRS[@]}"; do
            if [ -d "${dir}" ]; then
              if [ -z "${TAR_GZ}" ]; then
                TAR_GZ="$(find "${dir}" -type f -name "*.tar.gz" | head -n 1 || true)"
              fi
              if [ -z "${DMG}" ]; then
                DMG="$(find "${dir}" -type f -name "*.dmg" | head -n 1 || true)"
              fi
            fi
          done

          if [ -z "${TAR_GZ}" ]; then
            echo "❌ 未找到 *.tar.gz updater 产物（target=${TARGET}, arch=${ARCH}）。请确认 `src-tauri/tauri.conf.json` 已设置 `bundle.createUpdaterArtifacts=true`，且构建包含 `--bundles app`。" >&2
            for dir in "${BUNDLE_DIRS[@]}"; do
              echo "---- list: ${dir}" >&2
              ls -la "${dir}" 2>/dev/null || true
              find "${dir}" -maxdepth 6 -type f 2>/dev/null | head -n 200 >&2 || true
            done
            exit 1
          fi

          if [ ! -f "${TAR_GZ}.sig" ]; then
            echo "❌ 未找到 updater 签名文件：${TAR_GZ}.sig" >&2
            exit 1
          fi

          NEW_TAR_GZ="Skills-Hub-${VERSION}-macOS-${ARCH}.tar.gz"
          cp "${TAR_GZ}" "release-assets/${NEW_TAR_GZ}"
          cp "${TAR_GZ}.sig" "release-assets/${NEW_TAR_GZ}.sig"

          if [ -n "${DMG}" ]; then
            NEW_DMG="Skills-Hub-${VERSION}-macOS-${ARCH}.dmg"
            cp "${DMG}" "release-assets/${NEW_DMG}"
          else
            echo "⚠️ 未找到 macOS .dmg（可选）" >&2
          fi

      - name: Prepare Windows Assets
        if: matrix.os == 'windows-2022'
        shell: bash
        run: |
          set -euo pipefail

          mkdir -p release-assets
          VERSION="${GITHUB_REF_NAME}" # e.g. v0.1.4
          ARCH="${{ matrix.arch }}"
          TARGET="${{ matrix.target }}"

          # 产物路径在不同 target 下可能不同：优先 target/<triple>/...，兜底 target/release/...
          BUNDLE_DIRS=(
            "src-tauri/target/${TARGET}/release/bundle"
            "src-tauri/target/release/bundle"
          )

          EXE=""
          for dir in "${BUNDLE_DIRS[@]}"; do
            if [ -d "${dir}" ]; then
              if [ -z "${EXE}" ]; then
                EXE="$(find "${dir}" -type f -name "*.exe" | head -n 1 || true)"
              fi
            fi
          done

          if [ -z "${EXE}" ]; then
            echo "❌ 未找到 *.exe 安装程序（target=${TARGET}, arch=${ARCH}）。请确认构建包含 `--bundles nsis`。" >&2
            for dir in "${BUNDLE_DIRS[@]}"; do
              echo "---- list: ${dir}" >&2
              ls -la "${dir}" 2>/dev/null || true
              find "${dir}" -maxdepth 6 -type f 2>/dev/null | head -n 200 >&2 || true
            done
            exit 1
          fi

          NEW_EXE="Skills-Hub-${VERSION}-Windows-${ARCH}.exe"
          cp "${EXE}" "release-assets/${NEW_EXE}"

      - name: List prepared assets
        shell: bash
        run: ls -la release-assets || true

      - name: Upload workflow artifacts
        uses: actions/upload-artifact@v4
        with:
          name: release-assets-${{ matrix.arch }}
          path: release-assets/*
          if-no-files-found: error

  assemble-updater-json:
    name: Assemble updater.json
    runs-on: macos-14
    needs: release
    permissions:
      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Download workflow artifacts
        uses: actions/download-artifact@v4
        with:
          path: dl
          pattern: release-assets-*
          merge-multiple: true

      - name: Generate release notes from changelog
        env:
          TAG: ${{ github.ref_name }}
        shell: bash
        run: |
          set -euo pipefail
          node scripts/extract-changelog.mjs "$TAG" CHANGELOG.md > release-notes.md
          {
            echo
            echo '**Windows Note:** Windows SmartScreen may show a warning during installation. This is normal for unsigned executables. The application is safe to use.'
            echo
            echo '**macOS Note:** macOS Gatekeeper workaround (only needed on some macOS versions): `xattr -cr "/Applications/Skills Hub.app"` (https://v2.tauri.app/distribute/#macos).'
          } >> release-notes.md

      - name: Generate updater.json
        env:
          REPO: ${{ github.repository }}
          TAG: ${{ github.ref_name }}
        shell: bash
        run: |
          set -euo pipefail

          VERSION="${TAG#v}"
          PUB_DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ)
          base_url="https://github.com/$REPO/releases/download/$TAG"

          mac_arm_url=""; mac_arm_sig=""
          mac_x64_url=""; mac_x64_sig=""

          ls -la dl || true

          shopt -s nullglob
          for sig in dl/*.sig; do
            base=${sig%.sig}
            fname=$(basename "$base")
            url="$base_url/$fname"
            sig_content=$(tr -d '\r\n' < "$sig")
            case "$fname" in
              *-macOS-aarch64.tar.gz)
                mac_arm_url="$url"; mac_arm_sig="$sig_content";;
              *-macOS-x86_64.tar.gz)
                mac_x64_url="$url"; mac_x64_sig="$sig_content";;
            esac
          done

          if [ -z "${mac_arm_url:-}" ] && [ -z "${mac_x64_url:-}" ]; then
            echo "❌ 未找到任何 macOS updater 签名（dl/*.sig）; 请确认构建产物包含 *.tar.gz.sig" >&2
            exit 1
          fi

          # Read release notes if available (generated in prior step or inline)
          NOTES_FILE="release-notes.md"
          if [ -f "$NOTES_FILE" ]; then
            NOTES_CONTENT=$(cat "$NOTES_FILE")
          else
            NOTES_CONTENT="Release $TAG"
          fi
          # Escape for JSON: backslashes, double quotes, newlines
          NOTES_JSON=$(printf '%s' "$NOTES_CONTENT" | sed 's/\\/\\\\/g; s/"/\\"/g' | awk '{printf "%s\\n", $0}' | sed 's/\\n$//')

          tmp_json=$(mktemp)
          {
            echo '{'
            echo "  \"version\": \"$VERSION\","
            echo "  \"notes\": \"$NOTES_JSON\","
            echo "  \"pub_date\": \"$PUB_DATE\","
            echo '  "platforms": {'
            first=1
            if [ -n "${mac_arm_url:-}" ] && [ -n "${mac_arm_sig:-}" ]; then
              [ $first -eq 0 ] && echo ','
              echo "    \"darwin-aarch64\": {\"signature\": \"$mac_arm_sig\", \"url\": \"$mac_arm_url\"}"
              first=0
            fi
            if [ -n "${mac_x64_url:-}" ] && [ -n "${mac_x64_sig:-}" ]; then
              [ $first -eq 0 ] && echo ','
              echo "    \"darwin-x86_64\": {\"signature\": \"$mac_x64_sig\", \"url\": \"$mac_x64_url\"}"
              first=0
            fi
            echo '  }'
            echo '}'
          } > "$tmp_json"

          cat "$tmp_json"
          mv "$tmp_json" updater.json

      - name: Create/Update GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          name: Skills Hub ${{ github.ref_name }}
          prerelease: ${{ contains(github.ref_name, '-') }}
          body_path: release-notes.md
          files: |
            dl/*
            updater.json
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}


================================================
FILE: .github/workflows/update-featured-skills.yml
================================================
name: Update Featured Skills

on:
  schedule:
    - cron: '0 0 * * *'
  workflow_dispatch:

permissions:
  contents: write

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Fetch featured skills
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: node scripts/fetch-featured-skills.mjs

      - name: Commit if changed
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add featured-skills.json
          git diff --cached --quiet || git commit -m "chore: update featured-skills.json"
          git push


================================================
FILE: .gitignore
================================================
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*

node_modules
dist
dist-ssr
*.local
.cursor
.trae

# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?
coverage/
plans/

.env

bun.lock


================================================
FILE: AGENTS.md
================================================
# Skills Hub - Project Rules

## Overview

Skills Hub is a cross-platform desktop app (Tauri 2 + React 19) for managing AI Agent Skills and syncing them to 47+ AI coding tools. Core concept: "Install once, sync everywhere."

## Tech Stack

- **Frontend**: React 19 + TypeScript 5.9 (strict) + Vite 7 + Tailwind CSS 4
- **Backend**: Rust (Edition 2021, MSRV 1.77.2) + Tauri 2
- **Database**: SQLite (rusqlite, bundled)
- **Git**: libgit2 (git2 crate, vendored-openssl)
- **HTTP**: reqwest (rustls-tls, blocking)
- **i18n**: i18next (English / Chinese bilingual)
- **Notifications**: sonner (toast)
- **Icons**: lucide-react

## Common Commands

```bash
npm run dev              # Vite dev server (port 5173)
npm run tauri:dev        # Tauri dev window (frontend + backend)
npm run build            # tsc + vite build
npm run check            # Full check: lint + build + rust:fmt:check + rust:clippy + rust:test
npm run lint             # ESLint (flat config v9)
npm run rust:test        # cargo test
npm run rust:clippy      # Rust lint
npm run rust:fmt         # Rust format
npm run rust:fmt:check   # Rust format check
```

Always run `npm run check` before committing to ensure all checks pass.

## Directory Structure

```
src/                          # React frontend
├── App.tsx                   # Root component (centralized state, all modal states)
├── App.css                   # Global styles (all component styles live here)
├── index.css                 # CSS variables (theming) + Tailwind entry
├── components/
│   ├── Layout.tsx            # Main layout (sidebar + content area)
│   └── skills/               # Skills feature module
│       ├── Header.tsx        # Top bar (branding + language toggle + new button)
│       ├── FilterBar.tsx     # Filter/sort bar
│       ├── SkillsList.tsx    # Skills list container
│       ├── SkillCard.tsx     # Individual skill card
│       ├── LoadingOverlay.tsx
│       ├── types.ts          # Shared DTO type definitions (frontend ↔ backend)
│       └── modals/           # Modal components (8 total)
└── i18n/
    ├── index.ts              # i18next initialization
    └── resources.ts          # Translation resources (EN/ZH)

src-tauri/src/                # Rust backend
├── main.rs                   # Entry point (calls app_lib::run)
├── lib.rs                    # App initialization (plugin registration, DB, cleanup tasks)
├── commands/
│   ├── mod.rs                # Tauri command layer (23 commands + DTOs)
│   └── tests/
└── core/                     # Core business logic
    ├── skill_store.rs        # SQLite ORM (4 tables: skills, skill_targets, settings, discovered_skills)
    ├── installer.rs          # Skill installation (local/git, with multi-skill detection)
    ├── sync_engine.rs        # Sync engine (symlink/junction/copy triple fallback)
    ├── git_fetcher.rs        # Git clone/pull (with cache and TTL)
    ├── tool_adapters/mod.rs  # Tool adapter registry (47 AI tools)
    ├── onboarding.rs         # Existing skill scanning/discovery
    ├── github_search.rs      # GitHub API search
    ├── central_repo.rs       # Central repository path management
    ├── content_hash.rs       # SHA256 directory content hashing
    ├── cache_cleanup.rs      # Git cache cleanup
    ├── temp_cleanup.rs       # Temp directory cleanup
    └── tests/                # One test file per module (10 total)
```

## Architecture

### Frontend ↔ Backend Communication
- Uses Tauri IPC (`invoke`) to call backend commands
- Frontend call pattern: `const result = await invoke('command_name', { param })`
- Backend commands are defined in `commands/mod.rs` and registered in `lib.rs` via `generate_handler!`
- New commands must be registered in both places

### Frontend State Management
- **No state management library** — all state is centralized in `App.tsx` via `useState`
- Passed to child components via props drilling (modals receive many props)
- Data refresh pattern: call `invoke('get_managed_skills')` after operations to re-fetch the list

### Backend Layering
- `commands/` layer: Tauri command definitions, DTO conversions, error formatting (no business logic)
- `core/` layer: Pure business logic, independently testable
- Async commands use `tauri::async_runtime::spawn_blocking` to wrap synchronous operations
- Shared state injected via `app.manage(store)` + `State<'_, SkillStore>`

### Error Handling
- Backend uses `anyhow::Result<T>`, converted to string via `format_anyhow_error()` for the frontend
- Special error prefixes for frontend identification: `MULTI_SKILLS|`, `TARGET_EXISTS|`, `TOOL_NOT_INSTALLED|`
- Frontend catches with try-catch and displays errors via sonner toast

## Coding Conventions

### TypeScript
- Strict mode: `noUnusedLocals` and `noUnusedParameters` are enabled — unused variables/params cause compile errors
- Component files: PascalCase (`SkillCard.tsx`)
- Props types: `ComponentNameProps` (`SkillCardProps`)
- CSS class names: kebab-case (`modal-backdrop`, `skill-card`)
- Modal conditional rendering: `if (!open) return null` (full unmount, not display:none)
- Wrap presentational components with `memo()`
- All user-visible text must use i18n (`t('key')`), translation keys defined in `src/i18n/resources.ts`
- When adding new text, always provide both English and Chinese translations
- DTO types are defined in `src/components/skills/types.ts` and must stay in sync with the Rust DTOs in `commands/mod.rs`

### Rust
- Functions/methods: snake_case
- Constants: SCREAMING_SNAKE_CASE
- Tauri command parameters use camelCase (to match frontend JS calling convention)
- Use `anyhow::Context` to add context to errors
- New core modules must be exported in `core/mod.rs`
- Tests use `tempfile` crate for temp directories and `mockito` for HTTP mocking

### Styling
- Component styles go in `src/App.css` (not CSS Modules), using semantic CSS class names
- Theming via CSS variables + `[data-theme="dark"]` selector, variables defined in `src/index.css`
- Tailwind utility classes and custom CSS classes can be mixed

## Development Workflow

1. **Before implementing**: Briefly describe the approach and list the files to be modified. Wait for confirmation before writing code.
2. **Implement completely**: For features involving both frontend and backend, modify both sides in one pass — including Tauri command registration, DTO types, i18n translations (both EN and ZH), and UI.
3. **Verify after changes**: Always run `npm run check` after implementation to ensure lint, build, and all Rust checks pass. Fix any errors before presenting the result.
4. **Keep changes minimal**: Only modify what is necessary for the requirement. Do not refactor, add comments, or "improve" unrelated code.

## Important Notes

- Path handling must support `~` expansion (backend has `expand_home_path()`)
- Sync strategy uses triple fallback: symlink → junction (Windows) → copy
- Git uses vendored-openssl, HTTP uses rustls-tls — avoids system SSL issues
- Version numbers must stay in sync between `package.json` and `src-tauri/tauri.conf.json` (validate with `npm run version:check`)
- Rust crate is named `app_lib` (not the default package name) — use `app_lib::...` for imports
- Database has a schema migration mechanism (`migrate_legacy_db_if_needed`) — consider migrations when modifying table structures
- Tool adapter list is in `tool_adapters/mod.rs` — adding a new AI tool requires both a `ToolId` enum variant and an adapter instance


================================================
FILE: CHANGELOG.md
================================================
# Changelog

All notable changes to this project will be documented in this file.

## [Unreleased]

## [0.6.0] - 2026-05-05

### Added
- **Skill tags**: Add custom tags to managed skills for easier organization and filtering.
- **Tags page**: Manage tags from a dedicated Tags page, including create, rename, delete, and quick navigation back to filtered My Skills views.
- **Tag filtering**: Filter My Skills by one or more tags with OR matching, including a virtual `Untagged` filter for skills without tags.
- **Per-skill tag editor**: Edit a skill's tag assignments directly from the skill card.
- **Import search**: Search discovered skill candidates by name, description, or path before importing from a local directory or Git repository.

### Changed
- **My Skills filter bar**: Removed the manual refresh button; install, delete, sync, and tag-edit flows already refresh the list automatically.

### Fixed
- **Chinese filter bar layout**: Removing the refresh button fixes the cramped button layout in Chinese.
- **Discovered skills review**: The discovered skills review dialog now supports search and keeps selection counts aligned with filtered results.

## [0.5.0] - 2026-04-16

### Added
- **Project-level skill sync**: Skills can now be synced to selected project directories instead of only global tool directories.
- **Skill scope controls**: My Skills cards now show a scope badge (`Global` / project count) and include a scope modal for switching between global and project sync.
- **Scope filtering**: My Skills can be filtered by All / Global / Project scope.
- **Hermes Agent adapter**: Added global sync support for Hermes Agent via `~/.hermes/skills` ([#54](https://github.com/qufei1993/skills-hub/issues/54)).

### Changed
- **My Skills filter bar**: The section title now displays the total skill count, search is more compact, and filter controls stay on one line in the default window.
- **Default window size**: Increased the default desktop window from `800x600` to `960x680`.
- **macOS close behavior**: Closing the main window now hides it instead of quitting the app; reopening from the Dock restores and focuses the window.
- **Project sync support matrix**: Project-level sync is now treated as an explicit per-tool capability; tools without a confirmed project skills directory are global-only.

### Fixed
- **Import takeover for identical skills**: Importing an existing skill can now safely take over same-name targets when the content hash matches.
- **Unsynced tool re-enable entry**: Tool buttons that were unsynced from a skill remain visible so they can be re-enabled.
- **SKILL.md metadata parsing**: YAML block scalar descriptions in frontmatter now render correctly in skill cards and detail views.

## [0.4.3] - 2026-04-11

### Added
- **Copaw tool adapter**: Support for Copaw AI coding tool (thanks @LeonDevLifeLog [PR#50](https://github.com/qufei1993/skills-hub/pull/50)).

### Fixed
- **Git skill install & frontmatter rendering**: Fixed issues with Git-based skill installation and frontmatter metadata rendering.
- **Git skill discovery for container paths**: Fixed skill discovery failing when repository uses container-style directory paths.

## [0.4.2] - 2026-04-06

### Fixed
- **New tools modal style**: "New tools detected" dialog now uses consistent header/footer structure (`modal-header` + `modal-footer`) matching all other modals, fixing missing padding and border separators ([#46](https://github.com/qufei1993/skills-hub/issues/46)).
- **Git skill name derivation**: Installing a Git skill from a repo root (subpath `"."`) now correctly derives the name from the repository URL instead of using `"."` as the display name.

## [0.4.1] - 2026-03-21

### Added
- **Frontmatter metadata table**: Markdown files with YAML frontmatter now render a GitHub-style metadata table at the top of the skill detail view.

## [0.4.0] - 2026-03-20

### Added
- **In-app update check**: Check for updates directly within Settings, download and install without leaving the app ([#33](https://github.com/qufei1993/skills-hub/issues/33)).
- **QoderWork tool adapter**: Support for QoderWork desktop AI agent (`~/.qoderwork/skills/`) ([#34](https://github.com/qufei1993/skills-hub/issues/34)).

### Changed
- **Settings promoted to full page**: Settings moved from a modal dialog to a dedicated page view, consistent with My Skills / Explore navigation pattern.
- **Curated skills aggregation**: Explore page now sources skills from a curated list of 7 high-quality repositories.

### Fixed
- Language toggle briefly flashing "Installing Skills..." loading overlay on Explore page.

## [0.3.0] - 2026-03-15

### Added
- **Explore page**: Explore promoted from a modal tab to an independent page with My Skills / Explore top-level navigation.
- **Featured skills**: Explore page displays curated skills from ClawHub API (updated daily via GitHub Actions) with frontend filtering and one-click install.
- **Online skill search**: Real-time search via skills.sh API (triggered at 2+ characters, 500ms debounce), results deduplicated against the featured list and shown in separate sections.
- **Skill detail view**: Click a skill name to browse its files with a file tree, Markdown rendering (GFM + frontmatter stripping), and syntax highlighting (40+ languages, light/dark theme adaptive).
- **Skill description field**: Description extracted from SKILL.md frontmatter at install time, stored in database, and displayed on My Skills cards.
- **GitHub Token setting**: Optional GitHub Token input in settings to increase API rate limit from 60 to 5,000 requests/hour.
- **MoltBot tool adapter**: Added standalone MoltBot tool support after OpenClaw rename/split.

### Fixed
- Git install deriving skill name as "skills" when URL points to a `skills/` subdirectory, causing duplicated sync paths ([#28](https://github.com/qufei1993/skills-hub/issues/28)).
- GitHub API rate-limit errors now display the exact reset time instead of a generic message.
- Windows "Access Denied" OS error 5 when syncing to tools ([#20](https://github.com/qufei1993/skills-hub/issues/20)).
- Git repo directory structures not correctly recognized as skills ([#18](https://github.com/qufei1993/skills-hub/issues/18), [#8](https://github.com/qufei1993/skills-hub/issues/8)).
- Repos using `.claude/skills/` directory format not detected ([#27](https://github.com/qufei1993/skills-hub/issues/27)).
- OpenClaw path updated from `.moltbot/skills` to `.openclaw/skills` ([#29](https://github.com/qufei1993/skills-hub/issues/29)).

### Changed
- My Skills list: tool badges now only show synced tools, collapsing to `+N more` beyond 5.
- Manual Add modal simplified to Local Directory / Git Repository tabs only (Explore tab removed).
- Multi-skill repo online install now auto-matches target skill (exact → unique-contains → fallback to manual picker).

## [0.2.0] - 2026-02-01

### Added
- **Windows platform support**: Full support for Windows build and release (thanks @jrtxio [PR#6](https://github.com/qufei1993/skills-hub/pull/6)).
- Support and display for many new tools (e.g., Kimi Code CLI, Augment, OpenClaw, Cline, CodeBuddy, Command Code, Continue, Crush, Junie, iFlow CLI, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, OpenClaude IDE, OpenHands, Pi, Qoder, Qwen Code, Trae/Trae CN, Zencoder, Neovate, Pochi, AdaL).
- UI confirmation and linked selection for tools that share the same global skills directory.
- Local import multi-skill discovery aligned with Git rules, with a selection list and invalid-item reasons.
- New local import commands for listing candidates and installing a selected subpath with SKILL.md validation.

### Changed
- Antigravity global skills directory updated to `~/.gemini/antigravity/global_skills`.
- OpenCode global skills directory corrected to `~/.config/opencode/skills`.
- Tool status now includes `skills_dir`; frontend tool list/sync is driven by backend data and deduped by directory.
- Sync/unsync now updates records across tools sharing a skills directory to avoid duplicate filesystem work and inconsistent state.
- Local import flow now scans candidates first; single valid candidate installs directly, multi-candidate opens selection.

## [0.1.1] - 2026-01-26

### Changed
- GitHub Actions release workflow for macOS packaging and uploading `updater.json` (`.github/workflows/release.yml`).
- Cursor sync now always uses directory copy due to Cursor not following symlinks when discovering skills: https://forum.cursor.com/t/cursor-doesnt-follow-symlinks-to-discover-skills/149693/4
- Managed skill update now re-syncs copy-mode targets using copy-only overwrite, and forces Cursor targets to copy to avoid accidental relinking.

## [0.1.0] - 2026-01-25

### Added
- Initial release of Skills Hub desktop app (Tauri + React).
- Central repository for Skills; sync to multiple AI coding tools (symlink/junction preferred, copy fallback).
- Local import from folders.
- Git import via repository URL or folder URL (`/tree/<branch>/<path>`), with multi-skill selection and batch install.
- Sync and update: copy-mode targets can be refreshed; managed skills can be updated from source.
- Migration intake: scan existing tool directories, import into central repo, and one‑click sync.
- New tool detection and optional sync.
- Basic settings: storage path, language, and theme.
- Git cache with cleanup (days) and freshness window (seconds).

### Build & Release
- Local packaging scripts for macOS (dmg), Windows (msi/nsis), Linux (deb/appimage).
- GitHub Actions build validation and tag-based draft releases (release notes pulled from `CHANGELOG.md`).

### Performance
- Git import and batch install optimizations: cached clones reduce repeated fetches; timeouts and non‑interactive git improve stability.


================================================
FILE: CLAUDE.md
================================================
Read and follow all instructions in [AGENTS.md](./AGENTS.md).


================================================
FILE: CODE_OF_CONDUCT.md
================================================
# Code of Conduct

This project follows the Contributor Covenant Code of Conduct (v2.1).

## Our Pledge

We as members, contributors, and leaders pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
nationality, personal appearance, race, caste, color, religion, or sexual
identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming,
diverse, inclusive, and healthy community.

## Our Standards

Examples of behavior that contributes to a positive environment for our
community include:

- Demonstrating empathy and kindness toward other people
- Being respectful of differing opinions, viewpoints, and experiences
- Giving and gracefully accepting constructive feedback
- Accepting responsibility and apologizing to those affected by our mistakes,
  and learning from the experience
- Focusing on what is best not just for us as individuals, but for the
  overall community

Examples of unacceptable behavior include:

- The use of sexualized language or imagery, and sexual attention or advances
- Trolling, insulting or derogatory comments, and personal or political attacks
- Public or private harassment
- Publishing others' private information, such as a physical or email
  address, without their explicit permission
- Other conduct which could reasonably be considered inappropriate in a
  professional setting

## Enforcement Responsibilities

Community leaders are responsible for clarifying and enforcing our standards of
acceptable behavior and will take appropriate and fair corrective action in
response to any behavior that they deem inappropriate, threatening, offensive,
or harmful.

Community leaders have the right and responsibility to remove, edit, or reject
comments, commits, code, wiki edits, issues, and other contributions that are
not aligned to this Code of Conduct, and will communicate reasons for moderation
decisions when appropriate.

## Scope

This Code of Conduct applies within all community spaces, and also applies when
an individual is officially representing the community in public spaces.
Examples of representing our community include using an official e-mail address,
posting via an official social media account, or acting as an appointed
representative at an online or offline event.

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
`qzfweb@gmail.com`.

All complaints will be reviewed and investigated promptly and fairly.

## Enforcement Guidelines

Community leaders will follow these Community Impact Guidelines in determining
the consequences for any action they deem in violation of this Code of Conduct:

### 1. Correction

**Community Impact**: Use of inappropriate language or other behavior deemed
unprofessional or unwelcome in the community.

**Consequence**: A private, written warning from community leaders, providing
clarity around the nature of the violation and an explanation of why the
behavior was inappropriate. A public apology may be requested.

### 2. Warning

**Community Impact**: A violation through a single incident or series
of actions.

**Consequence**: A warning with consequences for continued behavior. No
interaction with the people involved, including unsolicited interaction with
those enforcing the Code of Conduct, for a specified period of time. This
includes avoiding interactions in community spaces as well as external channels
like social media. Violating these terms may lead to a temporary or permanent
ban.

### 3. Temporary Ban

**Community Impact**: A serious violation of community standards, including
sustained inappropriate behavior.

**Consequence**: A temporary ban from any sort of interaction or public
communication with the community for a specified period of time. No public or
private interaction with the people involved, including unsolicited interaction
with those enforcing the Code of Conduct, is allowed during this period.
Violating these terms may lead to a permanent ban.

### 4. Permanent Ban

**Community Impact**: Demonstrating a pattern of violation of community
standards, including sustained inappropriate behavior, harassment of an
individual, or aggression toward or disparagement of classes of individuals.

**Consequence**: A permanent ban from any sort of public interaction within the
community.

## Attribution

This Code of Conduct is adapted from the Contributor Covenant, version 2.1,
available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html


================================================
FILE: CONTRIBUTING.md
================================================
# Contributing

Thanks for taking the time to contribute to Skills Hub!

## Development Requirements

- Node.js 18+ (recommended: 20+)
- Rust (stable)
- Tauri system dependencies (install per the official Tauri docs for macOS/Windows/Linux)

## Run Locally

```bash
npm install
npm run tauri:dev
```

## Quality Checks

```bash
npm run lint
npm run build
```

## Run Unit Tests

Rust unit tests live under `src-tauri/src/core/tests/`.

```bash
cd src-tauri
cargo test
```

## Before Submitting a PR

- Ensure `npm run lint` and `npm run build` pass
- Ensure `cd src-tauri && cargo test` pass
- Keep changes small and focused (do not commit local configs/caches/build artifacts)
- For UI changes, include screenshots or a short recording

## Reporting Issues

Please include the following in your issue report:

- OS version (macOS/Windows/Linux)
- Skills Hub version
- Steps to reproduce and expected vs. actual behavior
- Relevant logs (please redact local paths and any sensitive information)


================================================
FILE: LICENSE
================================================
MIT License

Copyright (c) 2026 Skills Hub contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


================================================
FILE: README.md
================================================
# Skills Hub (Tauri Desktop)

A cross-platform desktop app (Tauri + React) to manage Agent Skills in one place and sync them to multiple AI coding tools’ global or project-level skills directories (prefer symlink/junction, fallback to copy) — “Install once, sync everywhere”.

## Documentation

- English (default): `README.md` (this file)
- 中文：[`docs/README.zh.md`](docs/README.zh.md)

## Key Features

- **Explore page**: Browse curated featured skills and search online — one-click install & sync to all detected tools
- **Tags page**: Create, rename, and delete custom tags, then jump back to matching skills from one dedicated view
- **Tag filtering**: Organize skills with multiple tags and filter My Skills by tag, including `Untagged` skills
- **Global / project sync**: Sync skills globally across all projects, or scope them to selected project directories
- **Scope controls**: Switch a skill between Global and Project scope, manage project directories, and filter My Skills by scope
- **Skill detail view**: Click a skill name to browse its files with Markdown rendering and syntax highlighting (40+ languages)
- **Unified view**: Managed skills, total skill count, scope badges, and per-tool activation status
- **Onboarding migration**: Scan existing skills in installed tools, import into the Central Repo, and sync
- **Import sources**: Local folder / Git URL (including searchable multi-skill repo selection, `.claude/skills/` directory support)
- **Update**: Refresh from source; propagate updates to copy-mode targets
- **New tool detection**: Detect newly installed tools and prompt to sync managed skills

### My Skills
![My Skills](docs/assets/my-skills.png)

### Explore & Search
![Explore](docs/assets/explore-search.png)

### Manual Add
![Manual Add](docs/assets/manual-add.png)

### Skill Detail
![Skill Detail](docs/assets/skill-detail.png)

## Supported AI Coding Tools

Project skills dirs are relative to the selected project root. Tools marked `N/A` do not have a confirmed project-level skills directory and are supported for global sync only.

| tool key | Display name | global skills dir (relative to `~`) | project skills dir (relative to project) | detected if exists (relative to `~`) |
| --- | --- | --- | --- | --- |
| `cursor` | Cursor | `.cursor/skills` | `.agents/skills` | `.cursor` |
| `claude_code` | Claude Code | `.claude/skills` | `.claude/skills` | `.claude` |
| `codex` | Codex | `.codex/skills` | `.agents/skills` | `.codex` |
| `opencode` | OpenCode | `.config/opencode/skills` | `.agents/skills` | `.config/opencode` |
| `antigravity` | Antigravity | `.gemini/antigravity/skills` | `.agents/skills` | `.gemini/antigravity` |
| `amp` | Amp | `.config/agents/skills` | `.agents/skills` | `.config/agents` |
| `kimi_cli` | Kimi Code CLI | `.config/agents/skills` | `.agents/skills` | `.config/agents` |
| `augment` | Augment | `.augment/skills` | `.augment/skills` | `.augment` |
| `openclaw` | OpenClaw | `.openclaw/skills` | `skills` | `.openclaw` |
| `copaw` | Copaw | `.copaw/skill_pool` | `.copaw/skill_pool` | `.copaw` |
| `cline` | Cline | `.agents/skills` | `.agents/skills` | `.agents` |
| `codebuddy` | CodeBuddy | `.codebuddy/skills` | `.codebuddy/skills` | `.codebuddy` |
| `command_code` | Command Code | `.commandcode/skills` | `.commandcode/skills` | `.commandcode` |
| `continue` | Continue | `.continue/skills` | `.continue/skills` | `.continue` |
| `crush` | Crush | `.config/crush/skills` | `.crush/skills` | `.config/crush` |
| `junie` | Junie | `.junie/skills` | `.junie/skills` | `.junie` |
| `iflow_cli` | iFlow CLI | `.iflow/skills` | `.iflow/skills` | `.iflow` |
| `kiro_cli` | Kiro CLI | `.kiro/skills` | `.kiro/skills` | `.kiro` |
| `kode` | Kode | `.kode/skills` | `.kode/skills` | `.kode` |
| `mcpjam` | MCPJam | `.mcpjam/skills` | `.mcpjam/skills` | `.mcpjam` |
| `mistral_vibe` | Mistral Vibe | `.vibe/skills` | `.vibe/skills` | `.vibe` |
| `mux` | Mux | `.mux/skills` | `.mux/skills` | `.mux` |
| `openclaude` | OpenClaude IDE | `.openclaude/skills` | `.openclaude/skills` | `.openclaude` |
| `openhands` | OpenHands | `.openhands/skills` | `.openhands/skills` | `.openhands` |
| `pi` | Pi | `.pi/agent/skills` | `.pi/skills` | `.pi` |
| `qoder` | Qoder | `.qoder/skills` | `.qoder/skills` | `.qoder` |
| `qoderwork` | QoderWork | `.qoderwork/skills` | `.qoderwork/skills` | `.qoderwork` |
| `qwen_code` | Qwen Code | `.qwen/skills` | `.qwen/skills` | `.qwen` |
| `trae` | Trae | `.trae/skills` | `.trae/skills` | `.trae` |
| `trae_cn` | Trae CN | `.trae-cn/skills` | `.trae/skills` | `.trae-cn` |
| `zencoder` | Zencoder | `.zencoder/skills` | `.zencoder/skills` | `.zencoder` |
| `neovate` | Neovate | `.neovate/skills` | `.neovate/skills` | `.neovate` |
| `pochi` | Pochi | `.pochi/skills` | `.pochi/skills` | `.pochi` |
| `adal` | AdaL | `.adal/skills` | `.adal/skills` | `.adal` |
| `kilo_code` | Kilo Code | `.kilocode/skills` | `.kilocode/skills` | `.kilocode` |
| `roo_code` | Roo Code | `.roo/skills` | `.roo/skills` | `.roo` |
| `goose` | Goose | `.config/goose/skills` | `.goose/skills` | `.config/goose` |
| `gemini_cli` | Gemini CLI | `.gemini/skills` | `.agents/skills` | `.gemini` |
| `github_copilot` | GitHub Copilot | `.copilot/skills` | `.agents/skills` | `.copilot` |
| `clawdbot` | Clawdbot | `.clawdbot/skills` | `.clawdbot/skills` | `.clawdbot` |
| `droid` | Droid | `.factory/skills` | `.factory/skills` | `.factory` |
| `windsurf` | Windsurf | `.codeium/windsurf/skills` | `.windsurf/skills` | `.codeium/windsurf` |
| `moltbot` | MoltBot | `.moltbot/skills` | `.moltbot/skills` | `.moltbot` |
| `hermes_agent` | Hermes Agent | `.hermes/skills` | N/A | `.hermes` |

## Development

### Prerequisites

- Node.js 18+ (recommended: 20+)
- Rust (stable)
- Tauri system dependencies (follow Tauri official docs for your OS)

```bash
npm install
npm run tauri:dev
```

### Build

```bash
npm run lint
npm run build
npm run tauri:build
```

#### Platform build commands (from `package.json`)

- macOS (dmg): `npm run tauri:build:mac:dmg`
- macOS (universal dmg): `npm run tauri:build:mac:universal:dmg`
- Windows (MSI): `npm run tauri:build:win:msi`
- Windows (NSIS exe): `npm run tauri:build:win:exe`
- Windows (MSI+NSIS): `npm run tauri:build:win:all`
- Linux (deb): `npm run tauri:build:linux:deb`
- Linux (AppImage): `npm run tauri:build:linux:appimage`
- Linux (deb+AppImage): `npm run tauri:build:linux:all`

### Tests (Rust)

```bash
cd src-tauri
cargo test
```

## Contributing & Security

- Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md)
- Code of Conduct: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)
- Security: [`SECURITY.md`](SECURITY.md)

## FAQ / Notes

- Where are skills stored? The Central Repo defaults to `~/.skillshub` (configurable in Settings).
- What are tags for? Tags help you find and organize skills. They do not change where a skill is synced or which tools can use it.
- What is project-level sync? The skill is still stored once in the Central Repo, but its sync target is a selected project directory such as `<project>/.agents/skills`, `<project>/.claude/skills`, or another tool-specific project skills path.
- Why is Cursor sync always copy? Cursor currently does not support symlink/junction-based skill directories, so Skills Hub forces directory copy when syncing to Cursor.
- Why does sync sometimes fall back to copy? Skills Hub prefers symlink/junction, but on some systems (especially Windows) symlinks may be restricted; in that case it falls back to directory copy.
- What does `TARGET_EXISTS|...` mean? The target folder already exists and the operation did not overwrite it (default is non-destructive). Remove the existing folder or retry with the appropriate overwrite flow.
- macOS Gatekeeper note (unsigned/notarized builds, may vary by macOS version): if you see “damaged” or “unverified developer”, run `xattr -cr "/Applications/Skills Hub.app"` (https://v2.tauri.app/distribute/#macos).

## Supported Platforms

- macOS (verified)
- Windows (expected by design; not validated locally)
- Linux (expected by design; not validated locally)

## License

MIT License — see `LICENSE`.


================================================
FILE: SECURITY.md
================================================
# Security Policy

## Supported Versions

Only the latest code on the `main` branch is supported.

## Reporting a Vulnerability

If you discover a security vulnerability (e.g., arbitrary file read/write, path traversal, permission bypass, information disclosure, or command injection), please do not disclose it in a public issue.

Please report it via one of the following channels:

- GitHub Security Advisories (recommended): create a private report via the repository's Security → Advisories page
- Or email: `qzfweb@gmail.com`

We will confirm receipt and provide a remediation plan as soon as possible. Please keep details private until a fix is released.


================================================
FILE: docs/CHANGELOG.zh.md
================================================
# 更新日志

本文件记录项目的重要变更（中文版本）。

## [Unreleased]

## [0.6.0] - 2026-05-05

### 新增
- **Skill 标签**：可为已托管 Skill 添加自定义标签，方便整理和筛选。
- **标签页面**：新增独立 Tags / 标签页面，支持新建、重命名、删除标签，并可快速跳回已筛选的 My Skills 视图。
- **标签筛选**：My Skills 支持按一个或多个标签筛选，使用 OR 匹配；同时提供虚拟 `Untagged` / `无标签` 筛选项。
- **单个 Skill 标签编辑**：可直接从 Skill 卡片打开标签编辑入口，调整该 Skill 的标签关联。
- **导入搜索**：从本地目录或 Git 仓库导入前，可按名称、描述或路径搜索候选 Skill。

### 变更
- **My Skills 筛选栏**：移除手动刷新按钮；安装、删除、同步和编辑标签等流程已自动刷新列表。

### 修复
- **中文筛选栏布局**：移除刷新按钮后，修复中文界面下按钮区域拥挤和样式错乱问题。
- **发现 Skill 审核弹窗**：查看已发现 Skills 时支持搜索，并让选择数量与筛选结果保持一致。

## [0.5.0] - 2026-04-16

### 新增
- **项目级 Skill 同步**：Skill 现在可以同步到指定项目目录，不再只支持同步到各工具的全局目录。
- **同步范围控制**：My Skills 卡片新增范围徽标（全局 / 项目数量），并提供范围弹窗用于切换全局同步和项目同步。
- **范围筛选**：My Skills 支持按全部 / 全局 / 项目范围筛选。
- **Hermes Agent 工具适配**：新增 Hermes Agent 全局同步支持，目录为 `~/.hermes/skills`（[#54](https://github.com/qufei1993/skills-hub/issues/54)）。

### 变更
- **My Skills 筛选栏**：标题现在显示 Skill 总数，搜索框更紧凑，默认窗口下筛选控件保持单行展示。
- **默认窗口尺寸**：桌面端默认窗口从 `800x600` 调整为 `960x680`。
- **macOS 关闭行为**：点击主窗口关闭按钮现在隐藏窗口而不是退出应用；从 Dock 重新打开时会恢复并聚焦窗口。
- **项目级同步支持矩阵**：项目级同步改为按工具显式声明；未确认项目级 skills 目录的工具仅作为全局同步目标。

### 修复
- **同名同内容 Skill 导入接管**：导入已有 Skill 时，如果目标同名目录内容一致，现在可以安全接管同步状态。
- **取消同步后的工具重新启用入口**：从 Skill 取消同步的工具按钮会继续显示，便于重新启用。
- **SKILL.md 元数据解析**：正确解析 frontmatter 中的 YAML block scalar 描述，并在卡片和详情页正常展示。

## [0.4.3] - 2026-04-11

### 新增
- **Copaw 工具适配**：新增 Copaw AI 编程工具支持（感谢 @LeonDevLifeLog [PR#50](https://github.com/qufei1993/skills-hub/pull/50)）。

### 修复
- **Git 技能安装与 frontmatter 渲染**：修复 Git 技能安装及 frontmatter 元数据渲染问题。
- **Git 技能发现（容器路径）**：修复仓库使用容器风格目录路径时技能发现失败的问题。

## [0.4.2] - 2026-04-06

### 修复
- **检测到新工具弹窗样式**：「New tools detected」弹窗改用与其他弹窗一致的 `modal-header` + `modal-footer` 结构，修复标题缺少内边距和分隔线的问题（[#46](https://github.com/qufei1993/skills-hub/issues/46)）。
- **Git 技能名称推导**：从仓库根目录（subpath 为 `"."`）安装 Git 技能时，现在正确从仓库 URL 推导名称，不再以 `"."` 作为展示名称。

## [0.4.1] - 2026-03-21

### 新增
- **Frontmatter 元数据表格**：包含 YAML frontmatter 的 Markdown 文件在技能详情页顶部以 GitHub 风格的表格展示元数据。

## [0.4.0] - 2026-03-20

### 新增
- **应用内检查更新**：在设置页内直接检查新版本，支持下载安装，无需手动访问 GitHub Releases（[#33](https://github.com/qufei1993/skills-hub/issues/33)）。
- **QoderWork 工具适配**：新增 QoderWork 桌面 AI 代理支持（`~/.qoderwork/skills/`）（[#34](https://github.com/qufei1993/skills-hub/issues/34)）。

### 变更
- **设置页面化**：设置从模态弹窗升级为独立页面视图，与 My Skills / Explore 导航风格一致。
- **精选技能聚合**：Explore 数据源改为 7 个精选高质量仓库。

### 修复
- 切换语言时 Explore 页面短暂闪现「Installing Skills...」加载遮罩。

## [0.3.0] - 2026-03-15

### 新增
- **Explore 页面**：探索功能从弹窗提升为独立页面，顶部导航新增 My Skills / Explore 两个页面级 Tab 切换。
- **精选技能推荐**：Explore 页展示由 ClawHub API 预生成的热门技能列表（GitHub Actions 每日更新），支持前端筛选和一键安装。
- **在线技能搜索**：输入 ≥ 2 字符后通过 skills.sh API 实时搜索，500ms 防抖，搜索结果与精选列表自动去重、分区展示。
- **技能详情页**：点击技能名称进入详情视图，支持文件树浏览、Markdown 渲染（GFM + frontmatter 剥离）和代码语法高亮（40+ 语言，亮/暗主题自适应）。
- **技能描述字段**：安装时从 SKILL.md frontmatter 提取 description 存入数据库，My Skills 卡片展示描述文本。
- **GitHub Token 配置**：设置页新增可选的 GitHub Token 输入，认证后 API 限额从 60 提升至 5000 次/小时。
- **MoltBot 工具适配**：OpenClaw 更名拆分后新增独立的 MoltBot 工具支持。

### 修复
- Git 安装时 skill 名称为 "skills" 导致同步路径重复（[#28](https://github.com/qufei1993/skills-hub/issues/28)）。
- GitHub API 限流错误未提示重置时间，现在显示具体重置时间。
- Windows 同步时拒绝访问 OS error 5（[#20](https://github.com/qufei1993/skills-hub/issues/20)）。
- Git 仓库目录结构无法被正确识别为 skill（[#18](https://github.com/qufei1993/skills-hub/issues/18)、[#8](https://github.com/qufei1993/skills-hub/issues/8)）。
- 不支持 `.claude/skills/` 目录格式的仓库（[#27](https://github.com/qufei1993/skills-hub/issues/27)）。
- OpenClaw 路径更新（`.moltbot/skills` → `.openclaw/skills`）（[#29](https://github.com/qufei1993/skills-hub/issues/29)）。

### 变更
- My Skills 列表优化：工具徽章只显示已同步的工具，超过 5 个折叠为 `+N more`。
- 添加技能弹窗（Manual Add）精简为仅保留 Local Directory / Git Repository 两个 Tab。
- 多技能仓库在线安装时支持自动匹配（精确 → 唯一包含 → 回退手动选择）。

## [0.2.0] - 2026-02-01
### 新增
- **Windows 平台支持**：支持 Windows 构建与发布（感谢 @jrtxio [PR#6](https://github.com/qufei1993/skills-hub/pull/6)）。
- 新增多款工具适配与显示（如 Kimi Code CLI、Augment、OpenClaw、Cline、CodeBuddy、Command Code、Continue、Crush、Junie、iFlow CLI、Kiro CLI、Kode、MCPJam、Mistral Vibe、Mux、OpenClaude IDE、OpenHands、Pi、Qoder、Qwen Code、Trae/Trae CN、Zencoder、Neovate、Pochi、AdaL 等）。
- 前端新增共享技能目录提示与联动选择：同一全局 skills 目录的工具勾选/同步/取消同步会一起生效，并弹窗确认。
- 本地导入对齐 Git 规则的 multi-skill 发现，支持批量选择并展示无效项原因。
- 新增本地导入候选列表/按子路径安装的命令，并在安装前校验 SKILL.md。

### 变更
- Antigravity 默认全局技能目录更新为 `~/.gemini/antigravity/global_skills`。
- OpenCode 全局技能目录修正为 `~/.config/opencode/skills`。
- 工具状态接口增加 `skills_dir` 字段，前端列表与同步逻辑改为后端驱动并按目录去重。
- 同一 skills 目录的工具在同步/取消同步时统一写入与清理记录，避免重复文件操作与状态不一致。
- 本地导入流程改为先扫描候选：单个有效候选直接安装，多个候选进入选择列表。

## [0.1.1] - 2026-01-26

### 变更
- GitHub Actions 发版工作流：macOS 打包并上传 `updater.json`（`.github/workflows/release.yml`）。
- Cursor 同步固定使用 Copy：因为 Cursor 在发现 skills 时不会跟随 symlink：https://forum.cursor.com/t/cursor-doesnt-follow-symlinks-to-discover-skills/149693/4
- 托管技能更新时：对 copy 模式目标使用“纯 copy 覆盖回灌”；并对 Cursor 目标强制回灌为 copy，避免误创建软链导致不可用。

## [0.1.0] - 2026-01-24

### 新增
- Skills Hub 桌面应用（Tauri + React）初始发布。
- Skills 中心仓库：统一托管并同步到多种 AI 编程工具（优先 symlink/junction，失败回退 copy）。
- 本地导入：支持从本地文件夹导入 Skill。
- Git 导入：支持仓库 URL/文件夹 URL（`/tree/<branch>/<path>`），支持多 Skill 候选选择与批量安装。
- 同步与更新：copy 模式目标支持回灌更新；托管技能支持从来源更新。
- 迁移接管：扫描工具目录中已有 Skills，导入中心仓库并可一键同步。
- 新工具检测并可选择同步。
- 基础设置：存储路径、界面语言、主题模式。
- Git 缓存：支持按天清理与新鲜期（秒）配置。

### 构建与发布
- 本地打包脚本：macOS（dmg）、Windows（msi/nsis）、Linux（deb/appimage）。
- GitHub Actions 跨平台构建验证与 tag 发布 Draft Release（从 `CHANGELOG.md` 自动提取发布说明）。

### 性能
- Git 导入/批量安装优化：缓存 clone 减少重复拉取；增加超时与无交互提示提升稳定性。


================================================
FILE: docs/README.zh.md
================================================
# Skills Hub（Tauri Desktop）

一个跨平台桌面应用（Tauri + React），用于统一管理 Agent Skills，并把它们同步到多种 AI 编程工具的全局或项目级 skills 目录（优先 symlink/junction，失败回退 copy），实现 “Install once, sync everywhere”。

> English documentation: [`README.md`](../README.md)

## 主要功能

- **Explore 探索页**：独立页面浏览精选技能推荐和在线搜索，一键安装并同步到所有已检测工具
- **Tags 标签页**：在独立页面中新建、重命名、删除自定义标签，并快速跳转到对应的 Skill 列表
- **标签筛选**：为 Skill 添加多个标签，并在 My Skills 中按标签筛选，包括查看 `无标签` Skill
- **全局 / 项目级同步**：Skill 可同步到全局目录，在所有项目中生效；也可限定到指定项目目录中生效
- **同步范围控制**：在全局和项目范围之间切换 Skill，管理项目目录，并按范围筛选 My Skills
- **技能详情页**：点击技能名称查看完整文件内容，支持文件树浏览、Markdown 渲染和代码语法高亮（40+ 语言）
- **统一视图**：查看 Hub 托管的 skills 总数、范围徽标及其在各工具的生效状态
- **迁移接管**：扫描本机工具目录已有 skills，导入到中心仓库并可一键同步
- **多来源导入**：本地目录 / Git 仓库 URL（含可搜索的 multi-skill 候选选择、`.claude/skills/` 目录格式支持）
- **更新**：从原来源更新中心仓库内容，并回灌 copy 模式的目标
- **新工具检测**：发现新安装工具时提示是否同步所有已托管 skills

### My Skills — 技能管理列表
![My Skills](./assets/my-skills.png)

### Explore — 探索与在线搜索
![Explore](./assets/explore-search.png)

### Manual Add — 手动添加技能
![Manual Add](./assets/manual-add.png)

### Skill Detail — 技能详情与文件浏览
![Skill Detail](./assets/skill-detail.png)

## 支持的 AI 编程工具

项目级 skills 目录相对所选项目根目录。标记为“不支持”的工具尚未确认项目级 skills 目录，仅支持全局同步。

| tool key | 工具 | 全局 skills 目录（相对 `~`） | 项目级 skills 目录（相对项目根目录） | 存在即视为已安装（相对 `~`） |
| --- | --- | --- | --- | --- |
| `cursor` | Cursor | `.cursor/skills` | `.agents/skills` | `.cursor` |
| `claude_code` | Claude Code | `.claude/skills` | `.claude/skills` | `.claude` |
| `codex` | Codex | `.codex/skills` | `.agents/skills` | `.codex` |
| `opencode` | OpenCode | `.config/opencode/skills` | `.agents/skills` | `.config/opencode` |
| `antigravity` | Antigravity | `.gemini/antigravity/skills` | `.agents/skills` | `.gemini/antigravity` |
| `amp` | Amp | `.config/agents/skills` | `.agents/skills` | `.config/agents` |
| `kimi_cli` | Kimi Code CLI | `.config/agents/skills` | `.agents/skills` | `.config/agents` |
| `augment` | Augment | `.augment/skills` | `.augment/skills` | `.augment` |
| `openclaw` | OpenClaw | `.openclaw/skills` | `skills` | `.openclaw` |
| `copaw` | Copaw | `.copaw/skill_pool` | `.copaw/skill_pool` | `.copaw` |
| `cline` | Cline | `.agents/skills` | `.agents/skills` | `.agents` |
| `codebuddy` | CodeBuddy | `.codebuddy/skills` | `.codebuddy/skills` | `.codebuddy` |
| `command_code` | Command Code | `.commandcode/skills` | `.commandcode/skills` | `.commandcode` |
| `continue` | Continue | `.continue/skills` | `.continue/skills` | `.continue` |
| `crush` | Crush | `.config/crush/skills` | `.crush/skills` | `.config/crush` |
| `junie` | Junie | `.junie/skills` | `.junie/skills` | `.junie` |
| `iflow_cli` | iFlow CLI | `.iflow/skills` | `.iflow/skills` | `.iflow` |
| `kiro_cli` | Kiro CLI | `.kiro/skills` | `.kiro/skills` | `.kiro` |
| `kode` | Kode | `.kode/skills` | `.kode/skills` | `.kode` |
| `mcpjam` | MCPJam | `.mcpjam/skills` | `.mcpjam/skills` | `.mcpjam` |
| `mistral_vibe` | Mistral Vibe | `.vibe/skills` | `.vibe/skills` | `.vibe` |
| `mux` | Mux | `.mux/skills` | `.mux/skills` | `.mux` |
| `openclaude` | OpenClaude IDE | `.openclaude/skills` | `.openclaude/skills` | `.openclaude` |
| `openhands` | OpenHands | `.openhands/skills` | `.openhands/skills` | `.openhands` |
| `pi` | Pi | `.pi/agent/skills` | `.pi/skills` | `.pi` |
| `qoder` | Qoder | `.qoder/skills` | `.qoder/skills` | `.qoder` |
| `qoderwork` | QoderWork | `.qoderwork/skills` | `.qoderwork/skills` | `.qoderwork` |
| `qwen_code` | Qwen Code | `.qwen/skills` | `.qwen/skills` | `.qwen` |
| `trae` | Trae | `.trae/skills` | `.trae/skills` | `.trae` |
| `trae_cn` | Trae CN | `.trae-cn/skills` | `.trae/skills` | `.trae-cn` |
| `zencoder` | Zencoder | `.zencoder/skills` | `.zencoder/skills` | `.zencoder` |
| `neovate` | Neovate | `.neovate/skills` | `.neovate/skills` | `.neovate` |
| `pochi` | Pochi | `.pochi/skills` | `.pochi/skills` | `.pochi` |
| `adal` | AdaL | `.adal/skills` | `.adal/skills` | `.adal` |
| `kilo_code` | Kilo Code | `.kilocode/skills` | `.kilocode/skills` | `.kilocode` |
| `roo_code` | Roo Code | `.roo/skills` | `.roo/skills` | `.roo` |
| `goose` | Goose | `.config/goose/skills` | `.goose/skills` | `.config/goose` |
| `gemini_cli` | Gemini CLI | `.gemini/skills` | `.agents/skills` | `.gemini` |
| `github_copilot` | GitHub Copilot | `.copilot/skills` | `.agents/skills` | `.copilot` |
| `clawdbot` | Clawdbot | `.clawdbot/skills` | `.clawdbot/skills` | `.clawdbot` |
| `droid` | Droid | `.factory/skills` | `.factory/skills` | `.factory` |
| `windsurf` | Windsurf | `.codeium/windsurf/skills` | `.windsurf/skills` | `.codeium/windsurf` |
| `moltbot` | MoltBot | `.moltbot/skills` | `.moltbot/skills` | `.moltbot` |
| `hermes_agent` | Hermes Agent | `.hermes/skills` | 不支持 | `.hermes` |

完整路径规则与检测逻辑见 [`src-tauri/src/core/tool_adapters/mod.rs`](../src-tauri/src/core/tool_adapters/mod.rs)。

## 开发

### 环境要求

- Node.js 18+（建议 20+）
- Rust（stable）
- Tauri 系统依赖（按官方文档安装）

### 启动（桌面端）

```bash
npm install
npm run tauri:dev
```

### 构建

```bash
npm run lint
npm run build
npm run tauri:build
```

#### 各系统构建命令（来自 `package.json`）

- macOS（dmg）：`npm run tauri:build:mac:dmg`
- macOS（universal dmg）：`npm run tauri:build:mac:universal:dmg`
- Windows（MSI）：`npm run tauri:build:win:msi`
- Windows（NSIS exe）：`npm run tauri:build:win:exe`
- Windows（MSI+NSIS）：`npm run tauri:build:win:all`
- Linux（deb）：`npm run tauri:build:linux:deb`
- Linux（AppImage）：`npm run tauri:build:linux:appimage`
- Linux（deb+AppImage）：`npm run tauri:build:linux:all`

### 测试（Rust）

```bash
cd src-tauri
cargo test
```

## FAQ / 备注

- Skill 存在哪里？中心仓库（Central Repo）默认是 `~/.skillshub`，可在设置里修改。
- 标签用于什么？标签只用于查找和整理 Skill，不会改变 Skill 的同步目录，也不会改变哪些工具可以使用它。
- 什么是项目级同步？Skill 仍然只在中心仓库保存一份，但同步目标变为指定项目目录，例如 `<project>/.agents/skills`、`<project>/.claude/skills` 或其它工具对应的项目级 skills 路径。
- Cursor 为什么强制 Copy？Cursor 当前不支持软链（symlink/junction）形式的技能目录，因此同步到 Cursor 时会固定使用目录复制（copy）。
- 为什么有时会变成 Copy？默认优先 symlink/junction，但在某些系统（尤其 Windows）可能因为权限/策略导致无法创建链接，会自动回退到目录复制。
- `TARGET_EXISTS|...` 是什么意思？目标目录已存在且默认不覆盖（为了安全）。你需要先清理目标目录，或在“接管/覆盖”的明确流程里重试。
- macOS Gatekeeper 备注（未签名/未公证构建，不同 macOS 版本表现可能不同）：如提示“已损坏/无法验证开发者”，可执行 `xattr -cr "/Applications/Skills Hub.app"`（https://v2.tauri.app/distribute/#macos）。

## 支持的系统

- macOS（已验证）
- Windows（按架构应支持，未做本地验证）
- Linux（按架构应支持，未做本地验证）

## License

MIT License（见 `LICENSE`）。


================================================
FILE: docs/future/profile-requirements.md
================================================
# Skill Profile / 配置方案后续需求记录

## 背景

GitHub Issue #23 提到“技能分组”能力：

- Skill 作为底层资产存在。
- 单个 Skill 可以被划分到多个组中复用。
- 组支持快速挂载与切换。
- 可根据不同项目和不同工具组合不同 Skill。

这个方向和 v0.6.0 的标签功能有关联，但不属于同一个需求。

标签解决的是：

```text
如何查找和整理 Skill。
```

Profile / 配置方案解决的是：

```text
如何让一套 Skill 作为当前工作场景实际生效。
```

因此 Profile 不纳入 v0.6.0，单独记录为后续评估需求。

---

## 建议命名

不建议使用 `Group / 分组` 作为主 UI 名称。

原因：

- “分组”容易被用户理解成分类展示。
- 它和 `Tag / 标签` 的语义过近。
- 如果同时出现“标签”和“分组”，用户容易混淆。

建议名称：

```text
Profile / 配置方案
```

中文 UI 可使用：

```text
配置方案
```

英文 UI 可使用：

```text
Profile
```

一句话定义：

```text
Profile 是一套可应用的 Skill 同步配置。
```

---

## 与 Tag 的区别

| 概念 | 目的 | 是否影响同步 | 是否可多选 |
|------|------|--------------|------------|
| Tag | 查找、筛选、整理 Skill | 否 | 是 |
| Profile | 应用一套 Skill 配置 | 是 | 建议否 |

核心区分：

```text
Tag 用于找 Skill。
Profile 用于用 Skill。
```

---

## 初步产品规则

### 1. Profile 建议单选激活

第一版建议只允许一个 Active Profile。

原因：

- Profile 表示当前工作场景配置。
- 多个 Profile 同时启用会让语义接近“标签组叠加”。
- 多 Profile 会引入工具目标合并、冲突处理和预览复杂度。

建议模型：

```text
Current Profile: Skills Hub Dev
```

切换 Profile 是替换当前同步配置，不是叠加。

### 2. Profile 内部可以包含多个 Skill

一个 Profile 可以包含多个 Skill：

```text
Skills Hub Dev
- react
- tauri-desktop
- test-driven-development
- frontend-design
```

### 3. 一个 Skill 可以属于多个 Profile

Skill 是可复用资产。

例如：

```text
frontend-design
- Skills Hub Dev
- Review Flow
- Docs Writing
```

同一个 Profile 内不能重复包含同一个 Skill。

数据层建议使用：

```sql
UNIQUE(profile_id, skill_id)
```

### 4. Profile 可以配置目标工具

Profile 可能需要记录目标工具：

```text
Profile: Skills Hub Dev
Skills: react, tauri-desktop, test-driven-development
Tools: Cursor, Codex, Claude Code
```

是否在第一版实现目标工具配置，需要后续结合现有同步模型评估。

### 5. 需要处理未加入任何 Profile 的 Skill

类似标签中的 `Untagged`，Profile 维度也可能存在：

```text
Unassigned
```

含义：

```text
没有加入任何 Profile 的 Skill。
```

`Unassigned` 不是真实 Profile，而是系统虚拟状态。

后续 UI 可在 Profiles 页面顶部提示：

```text
3 skills are not in any profile        [Review]
```

---

## 关键交互问题

后续实现前需要确认以下问题。

### 1. Profile 是否直接影响同步结果

需要明确：

- 应用 Profile 时是否会新增同步。
- 应用 Profile 时是否会移除不在 Profile 中的旧同步。
- 是否只影响当前 Profile 的目标工具。
- 是否影响全局同步和项目级同步。

### 2. 切换 Profile 是否需要预览

建议需要。

示例：

```text
Apply Docs Writing?

+ 2 skills will be added
- 3 skills will be removed
= 1 skill will stay active

[Cancel] [Apply Profile]
```

切换 Profile 涉及实际同步变更，不应该静默执行。

### 3. Profile 是否绑定项目

Issue #23 提到“针对不同项目”。

需要评估：

- Profile 是否绑定项目路径。
- 进入某项目时是否自动推荐 Profile。
- Profile 与 v0.5.0 项目级同步如何协作。
- 项目切换是否自动应用 Profile。

第一版建议不要自动应用，先做手动切换。

### 4. 是否允许多个 Profile 同时启用

当前建议不允许。

如果后续确实需要多 Profile，应明确合并规则：

- Skill 集合是并集还是交集。
- 工具集合如何合并。
- 同步移除如何判断。
- 冲突时谁优先。

在没有清晰规则前，不建议支持多 Profile 同时启用。

---

## 可能的 UI 方向

### My Skills 顶部

仅展示当前配置：

```text
Current Profile: Skills Hub Dev ▾
```

选择其他 Profile 后弹出变更预览。

### Profiles 页面

```text
Profiles                                      [+ New Profile]

左侧列表：
- Skills Hub Dev      Active
- Docs Writing
- Review Flow

右侧详情：
Skills Hub Dev
React + Tauri + Rust workspace

Tools
[Cursor] [Codex] [Claude Code]

Skills
[✓] react
[✓] tauri-desktop
[✓] test-driven-development
[ ] youtube-transcript

[Preview Changes] [Apply Profile]
```

### Unassigned 处理

Profiles 页面顶部：

```text
3 skills are not in any profile        [Review]
```

点击 `Review` 后展示未分配 Skill，并允许加入某个 Profile。

---

## 数据模型草案

仅供后续评估，不作为当前实现承诺。

```sql
CREATE TABLE skill_profiles (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL UNIQUE,
  description TEXT,
  is_active INTEGER NOT NULL DEFAULT 0,
  created_at TEXT NOT NULL,
  updated_at TEXT NOT NULL
);

CREATE TABLE skill_profile_links (
  profile_id INTEGER NOT NULL,
  skill_id INTEGER NOT NULL,
  created_at TEXT NOT NULL,
  PRIMARY KEY (profile_id, skill_id),
  FOREIGN KEY (profile_id) REFERENCES skill_profiles(id) ON DELETE CASCADE,
  FOREIGN KEY (skill_id) REFERENCES skills(id) ON DELETE CASCADE
);

CREATE TABLE skill_profile_tools (
  profile_id INTEGER NOT NULL,
  tool TEXT NOT NULL,
  created_at TEXT NOT NULL,
  PRIMARY KEY (profile_id, tool),
  FOREIGN KEY (profile_id) REFERENCES skill_profiles(id) ON DELETE CASCADE
);
```

如果坚持单一 Active Profile，需要在应用层保证同一时间只有一个 `is_active = 1`。

---

## 暂不实现内容

在需求没有进一步确认前，暂不实现：

- Profile 创建 / 编辑。
- Profile 切换。
- Profile 自动应用到项目。
- 多 Profile 同时启用。
- Profile 与同步目标的合并规则。
- Profile 未分配 Skill 的批量处理。

---

## 后续评估结论要求

进入实现前，至少需要明确：

- Profile 是否直接改变同步结果。
- 切换 Profile 的删除策略。
- 是否绑定项目路径。
- 是否配置目标工具。
- 是否只允许一个 Active Profile。
- 未加入任何 Profile 的 Skill 如何处理。

这些问题明确前，Profile 不应和 Tag 放在同一版本交付。


================================================
FILE: docs/releases/v0.1-v0.2/system-design.md
================================================
# Skills Hub (Tauri Desktop) — System Design

This document describes the system design of **Skills Hub**, aligned with the current repository implementation.

> 中文版：[`docs/system-design.zh.md`](docs/system-design.zh.md)

## 1. Background

AI coding tools (Cursor, Claude Code, Codex, etc.) often support “Skills/Agents/Tools”, but each tool stores global skills in a different location. This causes duplicated installs, drift, and a lack of a unified view.

Skills Hub solves this by storing skill contents in a **Central Repo** and mapping them into each tool via **symlink/junction/copy** — “Install once, sync everywhere”.

## 2. Goals

- Unified view of managed skills and per-tool activation
- Onboarding migration: scan existing skills in installed tools, group by name, detect conflicts via content hash, then import & sync
- Import sources: local folder and Git URLs (including multi-skill repo selection)
- Update: refresh central content from source; propagate updates to copy-mode targets
- Tool detection: detect newly installed tools and prompt to sync
- Configurable Central Repo path (default `~/.skillshub`)

## 3. Glossary

- **Skill**: a directory-based capability package (typically contains `SKILL.md`)
- **Managed Skill**: a skill stored in the Central Repo and indexed in SQLite
- **Central Repo**: canonical storage directory, default `~/.skillshub`
- **Tool/Agent**: a supported AI coding tool with a global skills directory
- **Target**: per-tool mapping of a managed skill (symlink/junction/copy), stored in `skill_targets`
- **Fingerprint / Content Hash**: directory hash used to detect identical vs conflicting variants

## 4. Architecture

### 4.1 System Context

```mermaid
flowchart TB
  user["User"]
  app["Skills Hub Desktop App\n(Tauri + React)"]

  fsTools["Tool global skills directories\n~/.cursor/skills, etc."]
  fsCentral["Central Repo\n~/.skillshub"]
  db["SQLite\nskills_hub.db"]
  cache["Cache\nskills-hub-git-*"]
  gh["GitHub / Git Remote"]

  user -->|manage/import/sync| app
  app <--> fsTools
  app <--> fsCentral
  app <--> db
  app <--> cache
  app <-->|clone/search| gh
```

### 4.2 Containers

```mermaid
flowchart LR
  subgraph WebView[Frontend: React + Vite]
    ui["UI Components\n(App/Modals/SkillCard)"]
    invoke["invoke(command,args)"]
    ui --> invoke
  end

  subgraph Tauri[Backend: Rust + Tauri]
    cmd["commands/*\nDTO + spawn_blocking"]
    core["core/*\ninstaller/sync/store/onboarding"]
    cmd --> core
  end

  invoke --> cmd
  core --> db["SQLite"]
  core --> fsCentral["Central Repo"]
  core --> fsTools["Tools Skills Dirs"]
  core --> cache["Cache Temp Git Dirs"]
```

## 5. Storage Design

### 5.1 Filesystem

- Central Repo (default): `~/.skillshub`
- Git imports: clone into cache temp, then copy into Central Repo (Central Repo does not store `.git`)
- Tool mapping: write into each tool’s skills directory via symlink/junction/copy

### 5.2 SQLite

DB path: `app_data_dir()/skills_hub.db`

Main tables:

- `skills`: managed skills in the Central Repo (source_type/source_ref/central_path/content_hash/updated_at, etc.)
- `skill_targets`: per-tool activation state (tool/target_path/mode/status/synced_at)
- `settings`: key/value settings (e.g., central repo path, installed tools set)

```mermaid
erDiagram
  skills ||--o{ skill_targets : "id = skill_id"
  skills {
    TEXT id PK
    TEXT name
    TEXT source_type
    TEXT source_ref
    TEXT source_revision
    TEXT central_path UK
    TEXT content_hash
    INTEGER created_at
    INTEGER updated_at
    INTEGER last_sync_at
    INTEGER last_seen_at
    TEXT status
  }
  skill_targets {
    TEXT id PK
    TEXT skill_id FK
    TEXT tool
    TEXT target_path
    TEXT mode
    TEXT status
    TEXT last_error
    INTEGER synced_at
  }
```

## 6. Supported Tools

Adapter definitions: `src-tauri/src/core/tool_adapters/mod.rs`.

| tool key | Display name | skills dir (relative to `~`) | detect dir (relative to `~`) |
| --- | --- | --- | --- |
| `cursor` | Cursor | `.cursor/skills` | `.cursor` |
| `claude_code` | Claude Code | `.claude/skills` | `.claude` |
| `codex` | Codex | `.codex/skills` | `.codex` |
| `opencode` | OpenCode | `.config/opencode/skills` | `.config/opencode` |
| `antigravity` | Antigravity | `.gemini/antigravity/global_skills` | `.gemini/antigravity` |
| `amp` | Amp | `.config/agents/skills` | `.config/agents` |
| `kimi_cli` | Kimi Code CLI | `.config/agents/skills` | `.config/agents` |
| `augment` | Augment | `.augment/rules` | `.augment` |
| `openclaw` | OpenClaw | `.moltbot/skills` | `.moltbot` |
| `cline` | Cline | `.cline/skills` | `.cline` |
| `codebuddy` | CodeBuddy | `.codebuddy/skills` | `.codebuddy` |
| `command_code` | Command Code | `.commandcode/skills` | `.commandcode` |
| `continue` | Continue | `.continue/skills` | `.continue` |
| `crush` | Crush | `.config/crush/skills` | `.config/crush` |
| `junie` | Junie | `.junie/skills` | `.junie` |
| `iflow_cli` | iFlow CLI | `.iflow/skills` | `.iflow` |
| `kiro_cli` | Kiro CLI | `.kiro/skills` | `.kiro` |
| `kode` | Kode | `.kode/skills` | `.kode` |
| `mcpjam` | MCPJam | `.mcpjam/skills` | `.mcpjam` |
| `mistral_vibe` | Mistral Vibe | `.vibe/skills` | `.vibe` |
| `mux` | Mux | `.mux/skills` | `.mux` |
| `openclaude` | OpenClaude IDE | `.openclaude/skills` | `.openclaude` |
| `openhands` | OpenHands | `.openhands/skills` | `.openhands` |
| `pi` | Pi | `.pi/agent/skills` | `.pi` |
| `qoder` | Qoder | `.qoder/skills` | `.qoder` |
| `qwen_code` | Qwen Code | `.qwen/skills` | `.qwen` |
| `trae` | Trae | `.trae/skills` | `.trae` |
| `trae_cn` | Trae CN | `.trae-cn/skills` | `.trae-cn` |
| `zencoder` | Zencoder | `.zencoder/skills` | `.zencoder` |
| `neovate` | Neovate | `.neovate/skills` | `.neovate` |
| `pochi` | Pochi | `.pochi/skills` | `.pochi` |
| `adal` | AdaL | `.adal/skills` | `.adal` |
| `kilo_code` | Kilo Code | `.kilocode/skills` | `.kilocode` |
| `roo_code` | Roo Code | `.roo/skills` | `.roo` |
| `goose` | Goose | `.config/goose/skills` | `.config/goose` |
| `gemini_cli` | Gemini CLI | `.gemini/skills` | `.gemini` |
| `github_copilot` | GitHub Copilot | `.copilot/skills` | `.copilot` |
| `clawdbot` | Clawdbot | `.clawdbot/skills` | `.clawdbot` |
| `droid` | Droid | `.factory/skills` | `.factory` |
| `windsurf` | Windsurf | `.codeium/windsurf/skills` | `.codeium/windsurf` |

## 7. Command Contract (overview)

Commands are exposed from `src-tauri/src/commands/mod.rs` and invoked from the frontend.

Key commands:

- `get_central_repo_path`, `set_central_repo_path`
- `get_tool_status`, `get_onboarding_plan`, `get_managed_skills`
- `install_local`, `install_git`, `list_git_skills_cmd`, `install_git_selection`
- `sync_skill_to_tool`, `unsync_skill_from_tool`
- `update_managed_skill`, `delete_managed_skill`

Frontend-visible error prefixes:

- `MULTI_SKILLS|...`
- `TARGET_EXISTS|<path>`
- `TOOL_NOT_INSTALLED|<tool>`

## 8. Key UX Flows (summary)

- Startup: load central repo path, tool status, onboarding plan, and managed skills list.
- Import discovered skills: copy a selected variant into the Central Repo, then sync to selected tools (with safe overwrite rules).
- Update: rebuild central content from source; resync copy-mode targets.


================================================
FILE: docs/releases/v0.1-v0.2/system-design.zh.md
================================================
# Skills Hub（Tauri Desktop）系统设计文档

> English version: [`docs/system-design.md`](system-design.md)

> 基于当前仓库实现（commit `b5246ab`），结合历史计划与 UI 设计稿整理，目标是给后来维护者提供一份“能落地、可对照代码”的完整系统设计说明。  

## 1. 背景与问题定义

现代 AI 编程工具（如 Cursor、Claude Code、Codex 等）往往使用“Skills/Agents/Tools”机制扩展能力，但各工具的全局 skills 目录分散在用户主目录下不同位置，导致：

- **无法统一查看**：用户很难知道“我有哪些 Skill、在哪些工具生效、版本是否一致”。
- **重复安装与漂移**：同一个 Skill 被复制到多个工具目录，更新后不一致。
- **迁移成本高**：安装 Skills Hub 后，用户机器上可能已存在大量 skills，需要安全接管并去重。

Skills Hub 的核心思路是将 Skill 内容集中存放在“中心仓库（Central Repo）”，并把各工具目录中的技能以 **symlink/junction/copy** 的方式映射到中心仓库，实现 “Install once, sync everywhere”。

## 2. 目标与非目标

### 2.1 目标（当前实现覆盖）

- **统一视图**：列出 Hub 托管的 skills、其来源（local/git）以及对各工具的生效状态。
- **多工具同步**：对已安装工具，在其默认 skills 目录生成映射（优先链接，失败回退复制）。
- **迁移接管（Onboarding）**：扫描已安装工具目录中的已有 skills，按名称聚合并通过目录指纹检测冲突，提供导入与同步能力。
- **多来源导入**：
  - 本地目录导入（复制到中心仓库并入库）
  - Git 导入（支持 GitHub repo URL 与 folder URL；支持 multi-skill 仓库的候选选择）
  - GitHub 搜索（后端已实现，前端入口当前为 disabled）
- **更新**：按来源（git/local）重建中心目录；对 copy 模式的目标回灌更新。
- **工具动态检测**：启动时检测“新安装工具”，提示是否一键同步已托管 skills。
- **可配置中心仓库路径**：默认 `~/.skillshub`。

### 2.2 非目标（当前版本不做/不保证）

- 不做复杂的版本并存（例如 `name@cursor`）与多版本依赖解析。
- 不保证对“用户手工维护的外部 symlink 链接”做完整接管策略（仅在扫描中识别为 link 并展示）。
- 不提供云同步/多设备同步能力（当前为本机文件系统 + SQLite）。
- 不包含自动定时更新（设置文案有“24h auto-update”的占位，但当前未落地定时任务）。

## 3. 术语与核心概念

- **Skill**：一个以目录为单位的能力包，通常包含 `SKILL.md` 等文件。
- **Managed Skill**：被 Skills Hub 托管并持久化到 SQLite 的 Skill（中心目录为权威内容）。
- **Central Repo（中心仓库）**：Hub 存放 skills 内容的中心目录，默认 `~/.skillshub`（可配置）。
- **Tool/Agent**：一个支持 skills 的 AI 工具（cursor/claude_code/codex/...），每个工具有默认 skills 目录。
- **Target（同步目标）**：某个 managed skill 在某个工具目录里的映射结果（symlink/junction/copy），对应 DB 表 `skill_targets`。
- **Onboarding Plan**：首次/手动扫描得到的“候选导入集合”，按 skill name 聚合为 group，并在冲突时提供 variant 选择。
- **Fingerprint/Content Hash**：对 skill 目录计算的哈希（忽略 `.git` 等），用于判断不同工具里同名 skill 是否同内容。

## 4. 总体架构（C4 风格）

> 为了便于快速建立“脑内地图”，本章提供若干 Mermaid 架构/流程图。GitHub/多数 Markdown 预览器可直接渲染；若你的编辑器不支持，可用 Mermaid Preview 插件查看。

### 4.1 系统上下文（Context）

- 用户通过桌面应用管理本机 skills。
- 应用需要读写：
  - 用户主目录下各工具的默认 skills 目录（以及 detect 目录）
  - 中心仓库目录（默认 `~/.skillshub`）
  - 应用数据目录中的 SQLite DB（`skills_hub.db`）
  - 应用缓存目录中的 git 临时 clone 目录（`skills-hub-git-*`）

```mermaid
flowchart TB
  user["用户"]
  app["Skills Hub 桌面应用\n(Tauri + React)"]

  fsTools["各工具全局 Skills 目录\n~/.cursor/skills 等"]
  fsCentral["中心仓库\n~/.skillshub"]
  db["SQLite\nskills_hub.db"]
  cache["Cache\nskills-hub-git-*"]
  gh["GitHub / 任意 Git 仓库"]

  user -->|管理/导入/同步| app
  app <--> fsTools
  app <--> fsCentral
  app <--> db
  app <--> cache
  app <-->|clone/search| gh
```

### 4.2 容器（Containers）

- **Frontend（WebView）**：React + Vite，负责 UI/交互、i18n、主题切换、调用 Tauri commands。
- **Backend（Tauri Rust）**：提供文件系统操作、Git 拉取、SQLite 持久化、工具适配与扫描、同步引擎等能力。
- **SQLite（嵌入式）**：`rusqlite`（bundled）存储托管技能与同步状态等。

```mermaid
flowchart LR
  subgraph WebView[Frontend: React + Vite]
    ui["UI Components\n(App/Modals/SkillCard)"]
    i18n["i18n + Theme"]
    invoke["invoke(command,args)"]
    ui --> invoke
    ui --> i18n
  end

  subgraph Tauri[Backend: Rust + Tauri]
    cmd["commands/*\nDTO + spawn_blocking\nerror formatting"]
    core["core/*\ninstaller/sync/store/onboarding"]
    cmd --> core
  end

  invoke --> cmd
  core --> db["SQLite"]
  core --> fsCentral["Central Repo"]
  core --> fsTools["Tools Skills Dirs"]
  core --> cache["Cache Temp Git Dirs"]
  core --> gh["GitHub API / Git clone"]
```

### 4.3 组件（Components）

前端（`src/`）：

- `src/main.tsx`：入口，初始化 i18n，渲染 `App`。
- `src/App.tsx`：单页 Dashboard，聚合状态与业务流程（扫描/导入/同步/更新/删除/设置）。
- `src/components/skills/*`：Header、FilterBar、SkillCard、SkillsList、各类 Modal。
- `src/i18n/*`：i18next 资源与初始化。
- `src/index.css`、`src/App.css`：设计稿风格的 token + 组件样式（支持 light/dark）。

后端（`src-tauri/src/`）：

- `src-tauri/src/lib.rs`：Tauri Builder，初始化 DB、注册 commands、启动临时目录清理任务。
- `src-tauri/src/commands/mod.rs`：Tauri commands 对外接口层（线程隔离、错误格式化、DTO）。
- `src-tauri/src/core/*`：核心业务模块（见 6 章）。

## 5. 数据与存储设计

### 5.1 文件系统布局

#### 中心仓库

- 默认路径：`~/.skillshub`（`src-tauri/src/core/central_repo.rs`）
- 每个 Skill 使用一个目录：`<central_repo>/<skill_name>/`
- 特性：
  - **不存完整 git repo**：git 导入使用临时 clone，再把内容复制进中心目录，避免中心目录包含 `.git`。
  - **名称即目录名**：默认取来源目录名 / repo 名 / subpath 末段；允许用户在导入时指定 display name。

#### Git 临时目录（缓存）

- 位置：Tauri `app_cache_dir()`（OS 特定）
- 命名：`skills-hub-git-<uuid>`
- 安全标记：写入 marker 文件 `.skills-hub-git-temp`
- 清理策略：应用启动后台 best-effort 清理超过 24h 的目录（仅匹配 prefix + marker）

#### 工具目录

每个 tool adapter 提供：

- `relative_skills_dir`：全局 skills 目录（相对 home）
- `relative_detect_dir`：用于判断工具是否“已安装”的目录（相对 home）

例如 Cursor：

- detect：`~/.cursor`
- skills：`~/.cursor/skills`

当前支持的 AI 编程工具（Tool Adapters，见 `src-tauri/src/core/tool_adapters/mod.rs`）如下：

| tool key | 显示名称 | skills 目录（相对 `~`） | detect 目录（相对 `~`） |
| --- | --- | --- | --- |
| `cursor` | Cursor | `.cursor/skills` | `.cursor` |
| `claude_code` | Claude Code | `.claude/skills` | `.claude` |
| `codex` | Codex | `.codex/skills` | `.codex` |
| `opencode` | OpenCode | `.config/opencode/skills` | `.config/opencode` |
| `antigravity` | Antigravity | `.gemini/antigravity/global_skills` | `.gemini/antigravity` |
| `amp` | Amp | `.config/agents/skills` | `.config/agents` |
| `kimi_cli` | Kimi Code CLI | `.config/agents/skills` | `.config/agents` |
| `augment` | Augment | `.augment/rules` | `.augment` |
| `openclaw` | OpenClaw | `.moltbot/skills` | `.moltbot` |
| `cline` | Cline | `.cline/skills` | `.cline` |
| `codebuddy` | CodeBuddy | `.codebuddy/skills` | `.codebuddy` |
| `command_code` | Command Code | `.commandcode/skills` | `.commandcode` |
| `continue` | Continue | `.continue/skills` | `.continue` |
| `crush` | Crush | `.config/crush/skills` | `.config/crush` |
| `junie` | Junie | `.junie/skills` | `.junie` |
| `iflow_cli` | iFlow CLI | `.iflow/skills` | `.iflow` |
| `kiro_cli` | Kiro CLI | `.kiro/skills` | `.kiro` |
| `kode` | Kode | `.kode/skills` | `.kode` |
| `mcpjam` | MCPJam | `.mcpjam/skills` | `.mcpjam` |
| `mistral_vibe` | Mistral Vibe | `.vibe/skills` | `.vibe` |
| `mux` | Mux | `.mux/skills` | `.mux` |
| `openclaude` | OpenClaude IDE | `.openclaude/skills` | `.openclaude` |
| `openhands` | OpenHands | `.openhands/skills` | `.openhands` |
| `pi` | Pi | `.pi/agent/skills` | `.pi` |
| `qoder` | Qoder | `.qoder/skills` | `.qoder` |
| `qwen_code` | Qwen Code | `.qwen/skills` | `.qwen` |
| `trae` | Trae | `.trae/skills` | `.trae` |
| `trae_cn` | Trae CN | `.trae-cn/skills` | `.trae-cn` |
| `zencoder` | Zencoder | `.zencoder/skills` | `.zencoder` |
| `neovate` | Neovate | `.neovate/skills` | `.neovate` |
| `pochi` | Pochi | `.pochi/skills` | `.pochi` |
| `adal` | AdaL | `.adal/skills` | `.adal` |
| `kilo_code` | Kilo Code | `.kilocode/skills` | `.kilocode` |
| `roo_code` | Roo Code | `.roo/skills` | `.roo` |
| `goose` | Goose | `.config/goose/skills` | `.config/goose` |
| `gemini_cli` | Gemini CLI | `.gemini/skills` | `.gemini` |
| `github_copilot` | GitHub Copilot | `.copilot/skills` | `.copilot` |
| `clawdbot` | Clawdbot | `.clawdbot/skills` | `.clawdbot` |
| `droid` | Droid | `.factory/skills` | `.factory` |
| `windsurf` | Windsurf | `.codeium/windsurf/skills` | `.codeium/windsurf` |

备注：
- 工具“是否安装”的判断规则：detect 目录存在即认为已安装（`is_tool_installed`）。
- 扫描 Codex 的 skills 时会过滤目录名 `.system`（避免把系统内置技能当作可迁移对象）。

### 5.2 SQLite 数据模型

DB 文件路径：`app_data_dir()/skills_hub.db`（`src-tauri/src/core/skill_store.rs`）

```mermaid
erDiagram
  skills ||--o{ skill_targets : "id = skill_id"
  skills {
    TEXT id PK
    TEXT name
    TEXT source_type
    TEXT source_ref
    TEXT source_revision
    TEXT central_path UK
    TEXT content_hash
    INTEGER created_at
    INTEGER updated_at
    INTEGER last_sync_at
    INTEGER last_seen_at
    TEXT status
  }
  skill_targets {
    TEXT id PK
    TEXT skill_id FK
    TEXT tool
    TEXT target_path
    TEXT mode
    TEXT status
    TEXT last_error
    INTEGER synced_at
  }
  settings {
    TEXT key PK
    TEXT value
  }
  discovered_skills {
    TEXT id PK
    TEXT tool
    TEXT found_path
    TEXT name_guess
    TEXT fingerprint
    INTEGER found_at
    TEXT imported_skill_id FK
  }
```

#### 表：`skills`

代表 Hub 托管的技能（中心仓库权威）。

- `id`：UUID
  - `name`：展示名称（也用于中心目录名）
  - `source_type`：`local` | `git`
  - `source_ref`：本地路径或 URL
  - `source_revision`：git commit（若可得）
  - `central_path`：中心目录路径（unique）
  - `content_hash`：目录 fingerprint（可为空）
  - `created_at` / `updated_at` / `last_sync_at` / `last_seen_at`
  - `status`：目前主要使用 `ok`

#### 表：`skill_targets`

每条记录代表一个 skill 在某个工具中的生效映射。

- `skill_id` + `tool` 唯一
- `target_path`：工具目录中的路径（最终路径）
- `mode`：`auto` | `symlink` | `junction` | `copy`
- `status` / `last_error` / `synced_at`

#### 表：`settings`

key/value 存储：

- `central_repo_path`：中心仓库路径（可选）
- `installed_tools_v1`：最近一次检测到的已安装工具 key 列表（JSON）
- `onboarding_completed`：当前实现提供 set/get 接口，但 Onboarding 是否完成逻辑尚未作为 gating 条件使用（可作为后续增强点）

#### 表：`discovered_skills`

当前 schema 存在，但前端/后端主流程使用的是“运行时扫描生成 plan”，并未将扫描结果落库（预留后续增强）。

## 6. 后端核心模块设计（Rust）

> 代码集中在 `src-tauri/src/core/*`，commands 仅做线程隔离/DTO/错误格式化。

### 6.1 Tool Adapters（工具适配层）

文件：`src-tauri/src/core/tool_adapters/mod.rs`

职责：

- 定义 `ToolId` 与 `ToolAdapter`（display name、skills 路径、detect 路径）。
- `is_tool_installed()`：通过 detect 目录存在性判断。
- `scan_tool_dir()`：遍历 skills 目录下的一级子目录作为 skill 名；Codex 额外过滤 `.system`。
- `detect_link()`：用 `symlink_metadata/read_link` 尝试识别链接，并返回 `is_link/link_target`（用于 Onboarding 展示）。

### 6.2 Onboarding（扫描与聚合）

文件：`src-tauri/src/core/onboarding.rs`

流程：

1. 遍历所有 adapters，跳过未安装工具。
2. 扫描 tools 的 skills 目录得到 `DetectedSkill` 列表。
3. 对每个 detected skill 计算 `fingerprint = hash_dir(path)`（忽略 `.git` 等）。
4. 按 `skill.name` 聚合为 group：
   - `has_conflict`：同组内 fingerprint 去重后数量 > 1（无 fingerprint 时按 1 处理）。

输出：`OnboardingPlan`（`total_tools_scanned/total_skills_found/groups`）。

### 6.3 Content Hash（目录指纹）

文件：`src-tauri/src/core/content_hash.rs`

实现要点：

- WalkDir 遍历目录（不 follow links）。
- 忽略：`.git`、`.DS_Store`、`Thumbs.db`、`.gitignore`（按名称）。
- 哈希包含相对路径 + 文件内容。

### 6.4 Sync Engine（混合同步）

文件：`src-tauri/src/core/sync_engine.rs`

核心策略：

- 目标不存在：
  1) 尝试 symlink（Unix；Windows 尝试 symlink_dir）
  2) Windows 额外尝试 junction（需要 `junction` crate）
  3) 最后回退 copy（递归复制）
- 目标已存在：
  - 若目标是指向 source 的同一个链接：视为已同步（幂等）。
  - 否则：
    - `overwrite=false`：报错 `target already exists`
    - `overwrite=true`：先删除目标目录，再按正常流程同步

设计取舍：

- 将“是否覆盖”作为显式参数，默认不覆盖，避免破坏用户既有目录。
- 通过 “先 staging、后 swap” 的更新策略，降低更新时半成品状态风险（见 installer 的 update）。

### 6.5 Installer（导入/更新）

文件：`src-tauri/src/core/installer.rs`

#### 本地导入（`install_local_skill`）

- 将 source 目录递归复制到 `central_repo/<name>`。
- 生成 `SkillRecord` 入库（`source_type=local`，`source_ref=source_path`）。
- 若中心目录已存在：报错 `skill already exists in central repo`（前端会映射为友好提示）。

#### Git 导入（`install_git_skill`）

- 解析 GitHub URL（支持 repo root、`.git`、`/tree/<branch>/<path>`、`/blob/<branch>/<path>`）。
- clone 到缓存临时目录（优先系统 `git` CLI，失败回退 libgit2），标记 `.skills-hub-git-temp`。
- 复制目标目录到中心仓库：
  - folder URL：复制 subpath
  - repo root URL：若检测到 `skills/` 下存在 >=2 个 `SKILL.md`，抛出 `MULTI_SKILLS|...` 引导用户改用 folder URL 或走候选选择流程
- 删除临时目录（best-effort）
- 入库 `source_type=git`、`source_ref=原始 URL`、`source_revision=HEAD`

#### Multi-skill 仓库候选（`list_git_skills` / `install_git_skill_from_selection`）

- `list_git_skills`：
  - root-level `SKILL.md` -> candidate `"."`
  - 扫描 `skills/*`、`skills/.curated/*`、`skills/.experimental/*`、`skills/.system/*`
  - 解析 `SKILL.md` 的 YAML front matter 获取 `name/description`（若存在）
- `install_git_skill_from_selection`：
  - clone -> copy -> 入库（类似 git 导入）
  - display name 默认取 subpath 末段或 repo 名

#### 更新（`update_managed_skill_from_source`）

- 根据 `skills.source_type` 重新构建新内容到 sibling staging dir：`.skills-hub-update-<uuid>`
- swap：删除旧中心目录 -> rename staging（跨盘 rename 失败则 copy fallback）
- 更新 `skills.updated_at/content_hash/source_revision` 等
- 若 `skill_targets.mode == "copy"`：对这些 target 执行 overwrite 同步，让工具目录内容跟随更新（symlink/junction 自动生效无需处理）

### 6.6 Git Fetcher（拉取策略）

文件：`src-tauri/src/core/git_fetcher.rs`

策略：

- 优先使用系统 `git` CLI（更符合用户本机网络/代理/证书/Keychain 配置）。
- CLI 失败再回退 libgit2（保持在无 git 环境仍可用）。

### 6.7 GitHub Search（仓库搜索）

文件：`src-tauri/src/core/github_search.rs`

- 调用 GitHub Search API：`https://api.github.com/search/repositories`
- `reqwest::blocking`，设置 `User-Agent: skills-hub`
- 返回 `RepoSummary`（full_name/html_url/description/stars/updated_at/clone_url）
- 备注：当前前端搜索 tab 为 disabled；可作为后续启用点。

### 6.8 Temp Cleanup（临时目录清理）

文件：`src-tauri/src/core/temp_cleanup.rs`

- 仅清理满足三重条件的目录：
  1) 位于 app_cache_dir
  2) 名称前缀 `skills-hub-git-`
  3) 含 marker 文件 `.skills-hub-git-temp`
- 并要求目录 `modified` 时间超过 max_age（目前 24h）。

## 7. Commands（前后端接口契约）

文件：`src-tauri/src/commands/mod.rs`

### 7.1 调用方式

前端通过 `@tauri-apps/api/core` 的 `invoke(command, args)` 调用；耗时操作统一在后端 `spawn_blocking`。

### 7.2 主要 commands 列表

- `get_central_repo_path() -> string`
- `set_central_repo_path(path: string) -> string`
- `get_tool_status() -> { tools[], installed[], newly_installed[] }`
- `get_onboarding_plan() -> OnboardingPlan`
- `get_managed_skills() -> ManagedSkill[]`
- `install_local(sourcePath: string, name?: string) -> InstallResultDto`
- `install_git(repoUrl: string, name?: string) -> InstallResultDto`
- `list_git_skills_cmd(repoUrl: string) -> GitSkillCandidate[]`
- `install_git_selection(repoUrl: string, subpath: string, name?: string) -> InstallResultDto`
- `import_existing_skill(sourcePath: string, name?: string) -> InstallResultDto`（当前与 `install_local` 等价）
- `sync_skill_dir(source_path: string, target_path: string) -> { mode_used, target_path }`（底层工具）
- `sync_skill_to_tool(sourcePath: string, skillId: string, tool: string, name: string, overwrite?: boolean) -> { mode_used, target_path }`
- `unsync_skill_from_tool(skillId: string, tool: string) -> void`
- `update_managed_skill(skillId: string) -> { skill_id, name, content_hash?, source_revision?, updated_targets[] }`
- `delete_managed_skill(skillId: string) -> void`
- `search_github(query: string, limit?: number) -> RepoSummary[]`

### 7.3 错误契约与前端分流

后端对 `anyhow::Error` 进行格式化，并保留以下前缀供前端识别：

- `MULTI_SKILLS|...`：仓库包含多个 skill，需要走候选选择或提供 folder URL。
- `TARGET_EXISTS|<path>`：目标目录存在且未覆盖，前端提示用户清理/取消勾选。
- `TOOL_NOT_INSTALLED|<tool>`：工具未安装。

此外对 GitHub clone 失败做了启发式中文提示（TLS/鉴权/DNS/超时等）。

## 8. 前端 UI 与交互设计

### 8.1 页面结构（当前为单页 Dashboard）

文件：`src/App.tsx` + `src/components/skills/*`

主要区域：

- Header：品牌、语言切换、设置、添加 Skill
- FilterBar：排序（updated/name）、搜索、刷新
- Discovered Banner：扫描到可导入 skills 时显示 “Review & Import”
- Skills List：卡片列表（每个 skill 显示来源、更新时间、工具 pills、更新/删除按钮）
- Modals：
  - AddSkillModal（local/git 两个 tab；选择 sync targets）
  - ImportModal（Onboarding plan 的 group/variant 选择与导入）
  - GitPickModal（multi-skill 仓库候选选择）
  - SettingsModal（语言、主题、中心仓库路径）
  - DeleteModal（删除确认）
  - NewToolsModal（新安装工具提示是否 sync all）
  - LoadingOverlay（耗时操作遮罩与提示）

### 8.2 i18n 与主题

- i18n：`react-i18next`，资源在 `src/i18n/resources.ts`，默认 `en`，可切换 `zh`。
- 主题：`src/index.css` 定义 CSS variables，`src/App.tsx` 使用 localStorage 保存 `skills-theme`（system/light/dark），并同步 `documentElement.dataset.theme`。

### 8.3 核心用户路径（前端侧）

#### 启动加载

1. 若运行在 Tauri 环境：
   - 拉取 `get_central_repo_path`（展示在设置）
   - 拉取 `get_tool_status`（工具安装状态 + newly installed 检测）
   - 拉取 `get_onboarding_plan`（用于 discovered banner）
   - 拉取 `get_managed_skills`（托管列表）

```mermaid
sequenceDiagram
  autonumber
  participant UI as Frontend (App.tsx)
  participant CMD as Tauri commands
  participant CORE as core/*
  participant DB as SQLite
  participant FS as FileSystem

  UI->>CMD: get_central_repo_path()
  CMD->>CORE: resolve + ensure_central_repo
  CORE->>DB: settings.get(central_repo_path)
  CORE->>FS: create_dir_all(~/.skillshub)
  CMD-->>UI: path

  UI->>CMD: get_tool_status()
  CMD->>CORE: default_tool_adapters + is_tool_installed
  CORE->>FS: exists(~/.cursor 等)
  CORE->>DB: settings.get/set(installed_tools_v1)
  CMD-->>UI: installed + newly_installed

  UI->>CMD: get_onboarding_plan()
  CMD->>CORE: build_onboarding_plan()
  CORE->>FS: scan_tool_dir + hash_dir
  CMD-->>UI: OnboardingPlan

  UI->>CMD: get_managed_skills()
  CMD->>DB: list_skills + list_skill_targets
  CMD-->>UI: ManagedSkill[]
```

#### 导入已发现 Skills（Review & Import）

1. 打开 ImportModal（若 plan 为空先调用 `get_onboarding_plan`）
2. 按 group 勾选要导入的技能
3. 若 `has_conflict`，必须在 variants 中选择一个来源路径
4. 执行导入：
   - 对每个选中 group：调用 `import_existing_skill(sourcePath=<chosen variant path>, name=<group name>)`
   - 再对“已安装且勾选的工具”逐个调用 `sync_skill_to_tool`
   - `overwrite` 策略：若同步回“来源工具”则 `overwrite=true`（接管）；否则默认不覆盖

```mermaid
sequenceDiagram
  autonumber
  participant UI as ImportModal
  participant CMD as commands
  participant INST as installer
  participant SYNC as sync_engine
  participant DB as SkillStore(SQLite)
  participant FS as FileSystem

  UI->>CMD: import_existing_skill(sourcePath, name)
  CMD->>INST: install_local_skill()
  INST->>FS: copy sourcePath -> ~/.skillshub/<name>
  INST->>DB: upsert skills row
  CMD-->>UI: {skill_id, central_path, name}

  loop 对每个已选工具
    UI->>CMD: sync_skill_to_tool(sourcePath=central_path, tool, name, overwrite?)
    CMD->>SYNC: sync_dir_hybrid_with_overwrite()
    alt 目标不存在/可覆盖
      SYNC->>FS: symlink/junction/copy -> tool skills dir
      CMD->>DB: upsert skill_targets
      CMD-->>UI: {mode_used, target_path}
    else 目标存在且不覆盖
      CMD-->>UI: TARGET_EXISTS|<path>
    end
  end
```

#### 添加 Skill（Local/Git）

- local：先 `list_local_skills_cmd` 扫描目录（规则与 Git 一致），
  - 多个候选则弹出选择列表（无效候选置灰并标注原因）
  - 单个有效候选则 `install_local_selection` -> 对选中工具逐个 `sync_skill_to_tool`
- git：
  - folder URL：直接 `install_git` -> 同步
  - repo root URL：`list_git_skills_cmd` -> GitPickModal 选择 -> `install_git_selection` -> 同步

#### 切换工具生效（Tool Pills）

- 未生效 -> 生效：`sync_skill_to_tool(sourcePath=central_path, ...)`
- 已生效 -> 取消：`unsync_skill_from_tool(skillId, tool)`

#### 更新 & 删除

- 更新：`update_managed_skill(skillId)`（后端会对 copy targets 回灌更新）
- 删除：`delete_managed_skill(skillId)`（先清理工具目录映射，再删除中心目录与 DB）

```mermaid
flowchart TB
  A[更新 update_managed_skill] --> B{source_type}
  B -->|git| C[clone 到 cache temp\nskills-hub-git-*]
  B -->|local| D[读取 source_ref 目录]
  C --> E[copy 到 staging dir\n.skills-hub-update-*]
  D --> E
  E --> F[swap: 删除旧 central_dir\nrename/copy 回 central_path]
  F --> G[更新 skills.updated_at/hash/revision]
  G --> H{targets.mode == copy ?}
  H -->|是| I[overwrite 同步到 target_path]
  H -->|否| J[symlink/junction 自动生效]
```

## 9. 关键一致性与安全策略

### 9.1 “默认不破坏用户环境”

- 同步默认 `overwrite=false`，目标存在即失败并给出 `TARGET_EXISTS|...`。
- 仅在明确需要“接管”的场景，前端才传 `overwrite=true`（当前：导入 discovered skill 且同步回来源工具）。

### 9.2 删除与清理的边界

- `delete_managed_skill` 仅清理 DB 中记录过的 `skill_targets.target_path`，不会全盘扫描/删除工具目录。
- Git 临时目录清理限定 prefix + marker + age gate，降低误删风险。

### 9.3 权限与跨平台差异

- Windows 上 symlink 可能受权限/策略限制：引擎会尝试 junction，最后回退 copy。
- 复制模式的 targets 需要在更新时显式回灌，否则工具目录可能滞后；后端已实现该传播逻辑。

## 10. 性能与稳定性

- 后端耗时操作使用 `spawn_blocking`，避免阻塞 UI。
- 前端 LoadingOverlay 在长操作期间提供提示（clone/IO 10–60s）。
- Git 拉取优先系统 git，提高 macOS 网络/证书兼容性。
- 错误信息：
  - 尽量包含 root cause
  - 对 clone “临时目录路径”做脱敏（减少噪音）
  - 对 GitHub/TLS/鉴权等提供可行动提示

## 11. 测试与验证建议（仓库当前缺少自动化测试时的落地方案）

> 当前仓库未显式提供 Rust/前端测试用例。建议按模块逐步补齐：

- Rust（core）：
  - `content_hash`：忽略文件名/顺序稳定性
  - `parse_github_url`：覆盖 repo/tree/blob/.git 组合
  - `sync_engine`：用临时目录验证 overwrite/幂等行为（平台差异可通过条件编译分组）
- 前端：
  - `App` 的业务逻辑建议逐步下沉到 hooks（便于单测）
  - Modal 表单校验与错误映射（`TARGET_EXISTS|` 等）

## 12. 现状梳理与后续路线图（建议）

### 12.1 已完成（与实现一致）

- 多工具 adapter 支持与安装检测
- Onboarding 扫描（冲突检测 + link 展示）
- local/git 导入与 multi-skill 候选选择
- 混合同步（symlink/junction/copy）
- 更新（copy targets 回灌）
- 新安装工具提示
- 中心仓库路径设置与迁移

### 12.2 后续增强方向（按价值/风险）

1. **启用 GitHub 搜索 UI**：对接 `search_github`，并支持一键安装候选仓库。
2. **扫描结果落库**：使用 `discovered_skills` 表持久化“发现但未导入”的技能，支持忽略/标记与增量刷新。
3. **Onboarding gating**：引入 `settings.onboarding_completed`，仅在首次启动/用户触发时弹出导入引导，避免每次都显示 discovered banner。
4. **更强冲突策略**：支持 `name@variant` 的版本并存（需要 UI 显式展示与命名规范）。
5. **维护任务**：提供“清理失效 targets / 修复 broken link / 重新同步所有 copy targets”入口。


================================================
FILE: docs/releases/v0.3.0/plan-bug-fixes.md
================================================
# Bug 修复计划

来源：https://github.com/qufei1993/skills-hub/issues

---

## Bug 1：Git 安装时 skill 名称为 "skills" 导致路径重复（#28）

**Issue**: https://github.com/qufei1993/skills-hub/issues/28
**严重程度**: P0
**状态**: ✅ 已修复（commit 69ab806）

### 问题描述

通过 Git URL 安装 skill 时，如果 URL 指向名为 `skills` 的子目录（如 `https://github.com/xxx/repo/tree/main/skills`），`install_git_skill` 会从 subpath 推导 name 为 `"skills"`，导致同步到工具时路径变成 `~/.claude/skills/skills/`。

### 根因

`installer.rs:94-104` 的 name 推导逻辑只看 subpath/URL，不读 SKILL.md 的 name 字段：

```rust
let name = name.unwrap_or_else(|| {
    if let Some(subpath) = &parsed.subpath {
        subpath.rsplit('/').next()  // ← subpath 是 "skills" 时，name 就是 "skills"
```

而本地导入走 `install_local_skill_from_selection`，会先从 SKILL.md 读 name，所以不受影响。

### 复现步骤

1. 在 Skills Hub 中选择「Git 仓库」
2. 输入 `https://github.com/anthropics/skills/tree/main/skills`
3. 不填显示名称，直接安装
4. 同步到 Claude Code 后，路径变成 `~/.claude/skills/skills/`

### 修复方案

修改 `installer.rs` 的 `install_git_skill`，在 name 推导后、写入 central_path 之前，尝试从已下载内容的 SKILL.md 读取 name 覆盖。同时增加保底校验：如果 name 仍为 `"skills"`，报错要求用户手动指定名称。

### 涉及文件

- `src-tauri/src/core/installer.rs` — `install_git_skill` 函数 name 推导逻辑

---

## Bug 2：GitHub API 限流错误未提示重置时间

**Issue**: 使用中发现（关联 #28 复现过程）
**严重程度**: P2
**状态**: ✅ 已修复

### 问题描述

当 GitHub API 返回 403（速率限制）时，错误提示只显示"请稍后再试"，未告诉用户具体的重置时间。GitHub 响应头中包含 `x-ratelimit-reset` 字段（Unix 时间戳），应提取并展示。

### 根因

`github_download.rs:70` 调用 `.error_for_status()` 直接将 403 转为通用错误，丢弃了响应头信息。`installer.rs:148-149` 捕获 403 时也只返回固定文案。

### 修复方案

在 `github_download.rs` 中，不使用 `.error_for_status()`，而是手动检查 status code。当遇到 403 时，从响应头提取 `x-ratelimit-reset` 和 `x-ratelimit-remaining`，将重置时间格式化为本地时间后包含在错误消息中。

示例错误消息：`"GitHub API 访问被拒绝（触发了频率限制）。将于 18:44 重置，请届时再试。"`

### 涉及文件

- `src-tauri/src/core/github_download.rs` — HTTP 请求错误处理
- `src-tauri/src/core/installer.rs` — 403 错误消息构造

---

## 改进：设置页增加 GitHub Token 配置

**严重程度**: P1
**状态**: ✅ 已实现（commit d2c1cc0）

### 问题描述

当前所有 GitHub API 请求均为未认证（60 次/小时/IP），安装 skill 时递归下载目录会快速耗尽配额。用户无法配置 Token 来提升限额。

### 方案

1. **设置页 UI**：增加一个可选的 GitHub Token 输入框（密码类型，支持显示/隐藏），存入 `settings` 表（key: `github_token`）
2. **后端传递**：`github_download.rs` 和 `github_search.rs` 发请求时，从 SkillStore 读取 token，如果存在则加上 `Authorization: Bearer <token>` 请求头
3. **限额提升**：认证后 GitHub API 限额从 60 → 5000 次/小时（按账号计算）
4. **安全**：Token 仅存本地 SQLite，不上传不同步。设置页提示用户生成 fine-grained PAT，只需 `public_repo` 读取权限

### 涉及文件

- `src-tauri/src/core/github_download.rs` — 请求时携带 token
- `src-tauri/src/core/github_search.rs` — 请求时携带 token
- `src-tauri/src/core/skill_store.rs` — 读取 `github_token` 设置
- `src/App.tsx` — 设置弹窗增加 GitHub Token 输入
- `src/i18n/resources.ts` — 新增中英文翻译

---

## Bug 3：Windows 拒绝访问 OS error 5（#20）

**Issue**: https://github.com/qufei1993/skills-hub/issues/20
**严重程度**: P0
**状态**: ✅ 已修复（commit 93d9aca）

### 问题描述

Windows 用户点击 AI-IDE 同步选项时报 OS error 5（权限不足），即使对应工具未安装。

### 可能原因

1. Windows 上创建 symlink 需要管理员权限或开发者模式，`sync_engine.rs` 的 fallback（symlink → junction → copy）可能在某些环境下全部失败
2. 尝试同步到未安装工具的目录时，`is_tool_installed` 检查可能误判（检测目录存在但无写入权限）

### 涉及文件

- `src-tauri/src/core/sync_engine.rs` — symlink/junction/copy fallback 逻辑
- `src-tauri/src/core/tool_adapters/mod.rs` — `is_tool_installed` 检测逻辑
- `src-tauri/src/commands/mod.rs` — `sync_skill_to_tool` 错误处理

---

## Bug 4：Skill 扫描逻辑对部分目录结构失效（#18 + #8）

**Issue**: https://github.com/qufei1993/skills-hub/issues/18 / https://github.com/qufei1993/skills-hub/issues/8
**严重程度**: P1
**状态**: ✅ 已修复

### 问题描述

- #18：某些 git 仓库目录结构无法被正确识别为 skill
- #8：skill 显示在仓库中但实际不存在；发现的 skill 无法导入

### 根因

**#18**：`list_git_skills` 和 `install_git_skill` 的多技能检测只扫描 `skills/` 目录下的子目录。当仓库把 skill 直接放在根目录的子文件夹（如 `repo/my-skill/SKILL.md`，不套 `skills/` 父目录）时，扫描结果为空，用户看到"该仓库中没有 Skills"。

示例仓库：`axtonliu/axton-obsidian-visual-skills`，结构为 `repo/excalidraw-diagram/SKILL.md`、`repo/mermaid-visualizer/SKILL.md` 等，无 `skills/` 目录。

**#8**：`scan_tool_dir`（onboarding 扫描）把工具 skills 目录下的**每个子目录**都当成 skill（不检查 SKILL.md），导致不含 SKILL.md 的目录也被"发现"，但导入时又因缺少 SKILL.md 失败。

### 修复方案

1. **#18**：在 `list_git_skills` 中增加扫描仓库根目录直接子目录中的 SKILL.md；在 `install_git_skill` 的多技能检测中同样覆盖根目录子目录
2. **#8**：`scan_tool_dir` 保持现有行为（不强制要求 SKILL.md），但前端导入时已有校验。或者在 `scan_tool_dir` 中区分"有 SKILL.md"和"无 SKILL.md"的目录

### 涉及文件

- `src-tauri/src/core/installer.rs` — `list_git_skills` 和 `install_git_skill` 的扫描范围
- `src-tauri/src/core/tool_adapters/mod.rs` — `scan_tool_dir` 扫描逻辑

---

## Bug 5：Skill 名称冲突无法安装（#12）

**Issue**: https://github.com/qufei1993/skills-hub/issues/12
**严重程度**: P1
**状态**: ✅ 已关闭（PR #30 合并，UI 已有「显示名称」输入框可手动指定别名，冲突时提示用户重命名）

### 涉及文件

- `src-tauri/src/core/installer.rs` — 安装时 name 冲突处理

---

## Bug 6：新增 skill 未被自动扫描（#19）

**Issue**: https://github.com/qufei1993/skills-hub/issues/19
**严重程度**: P2
**状态**: ✅ 已关闭（非 bug，预期行为）

### 调查结论

`~/.skillshub/` 是 Skills Hub 的内部存储，外部工具不应直接写入。实际上 OpenCode 创建的 skill 会落在 `~/.config/opencode/skills/` 下（普通目录），不会进入 `~/.skillshub/`。用户误以为写入了 skillshub 目录。

如需将外部工具中新建的 skill 纳入 Skills Hub 管理，可通过"导入已有 Skill"功能手动操作。

---

## Bug 7：不支持 .claude/skills/ 目录格式的仓库（#27）

**Issue**: https://github.com/qufei1993/skills-hub/issues/27
**严重程度**: P1
**状态**: ✅ 已修复（PR #31 合并）

### 问题描述

使用 `.claude-plugin/plugin.json` + `.claude/skills/` 目录结构的仓库（如 `nextlevelbuilder/ui-ux-pro-max-skill`）无法被 Skills Hub 识别和安装，因为扫描逻辑只查找 `SKILL.md` 文件。

### 根因

`list_git_skills`、`count_skills_in_repo`、`list_local_skills` 只扫描 `skills/`、`skills/.curated/` 等目录，不扫描 `.claude/skills/`。且只认 `SKILL.md` 为有效标记，`.claude/skills/` 下的目录即使内容完整也被忽略。

### 修复方案

1. 新增 `.claude/skills/` 为扫描路径（与 `skills/` 并列）
2. `.claude/skills/` 下的子目录即使没有 `SKILL.md` 也视为有效 skill
3. 无 `SKILL.md` 时用文件夹名做 name，从 `.claude-plugin/plugin.json` 读取 description

### 涉及文件

- `src-tauri/src/core/installer.rs` — `SKILL_SCAN_BASES` 常量、`is_skill_dir`、`is_claude_skill_dir`、`read_plugin_description`、`extract_skill_info` 辅助函数

---

## Bug 8：界面上没有 OpenClaw 的同步（#29）

**Issue**: https://github.com/qufei1993/skills-hub/issues/29
**严重程度**: P2
**状态**: ✅ 已关闭（PR #26 已修复代码，文档已补充更新）

### 问题描述

用户界面上找不到 OpenClaw 的同步选项。

### 根因

OpenClaw 更名后将配置目录从 `.moltbot/` 迁移到 `.openclaw/`，代码中的 `tool_adapters` 仍指向旧路径。

### 修复内容

1. PR #26（社区贡献）修复了代码：OpenClaw 路径 `.moltbot/skills` → `.openclaw/skills`，原 `.moltbot` 拆分为独立的 MoltBot 工具
2. 补充更新了 `README.md` 和 `docs/README.zh.md` 中的工具列表（OpenClaw 路径 + MoltBot 新增行）
3. 补充了 `src/i18n/resources.ts` 中缺少的 `moltbot: 'MoltBot'` 翻译

### 涉及文件

- `src-tauri/src/core/tool_adapters/mod.rs` — OpenClaw 路径更新 + MoltBot 新增（PR #26）
- `README.md` — 工具列表更新
- `docs/README.zh.md` — 工具列表更新
- `src/i18n/resources.ts` — MoltBot 翻译新增


================================================
FILE: docs/releases/v0.3.0/plan-explore-page-redesign.md
================================================
# 需求：Explore 页面独立化 + My Skills 列表优化

## 背景

当前"添加 Skill"的交互流程存在问题：探索、本地添加、Git 添加三个功能挤在一个弹窗的三个 Tab 里。用户在探索 Tab 点击一个 skill 后，只是把 URL 填入 Git Tab 并跳转，还需手动确认并点击安装，流程冗长（5 步）。

## 设计稿

`docs/skills_hub_v2_design.html` — 包含 4 个屏幕的完整交互设计。

## 改动概览

### 一、导航结构调整

**现状**：单页面 + 弹窗内 3 个 Tab（探索/本地/Git）
**目标**：顶部导航 2 个页面级 Tab + 弹窗仅保留手动添加

- App Header 内新增 **My Skills** / **Explore** 两个导航 Tab
- 点击切换页面视图（非路由，纯前端状态切换）
- 默认展示 My Skills 页

### 二、Explore 页（新页面）

将探索功能从弹窗提升为独立页面，作为"获取新 Skill 的唯一入口"。

#### 布局
- 顶部：搜索栏 + **Manual** 按钮（触发手动添加弹窗）
- 搜索栏下方：提示文字 "Data from clawhub.ai · Have a Git URL or local path? Click Manual to add directly"
- 内容区：双列卡片网格

#### Explore 卡片
每张卡片展示：
- Skill 名称
- 作者/来源（repo 路径）
- 描述（最多 2 行截断）
- 下载量 / Stars
- 兼容工具小标签（折叠显示，如 `Cursor` `Claude` `+5`）
- **Install 按钮**（右上角，一键安装）
- 已安装的 Skill 显示为绿色 **Installed** 状态（禁用按钮）

#### 一键安装流程
- 点击 Install → 自动使用所有已检测到的工具作为同步目标 → 安装并同步
- 安装成功后底部 toast 提示："xxx installed and synced to N tools"
- 安装完成后按钮状态变为 Installed

#### 搜索态
- 输入 ≥ 2 字符触发搜索
- 结果分为 "Featured Matches" 和 "Online Results" 两个区域
- 搜索关键词高亮

### 三、Manual Add 弹窗（精简）

- 从 Explore 页的 Manual 按钮触发
- **移除探索 Tab**，仅保留 Local Directory / Git Repository 两个 Tab
- 其余逻辑不变（工具选择器、安装流程）

### 四、My Skills 页（列表优化）

#### 移除
- 移除 Add 按钮（添加功能统一收口到 Explore 页）

#### 卡片增加 description
- 每张卡片新增描述文本，显示在名称下方，最多 2 行截断
- 信息层次：名称 → 描述 → 来源+时间 → 工具徽章

#### 工具徽章优化
- **只显示已同步的工具**（绿色带圆点），不再显示未同步的灰色徽章
- 超过 5 个折叠为 `+N more`
- 减少视觉噪音，让每张卡片高度一致

## 后端改动

### 新增 description 字段

当前 `ManagedSkillDto` 没有 description 字段，需要：

1. 从 Skill 目录的 `SKILL.md` frontmatter 中解析 `description` 字段
2. 在安装时提取并存入数据库（`skills` 表新增 `description` 列）
3. `ManagedSkillDto` 新增 `description: Option<String>` 字段返回给前端

### 涉及文件
- `src-tauri/src/core/skill_store.rs` — 表结构迁移，新增 description 列
- `src-tauri/src/core/installer.rs` — 安装时解析 SKILL.md 提取 description
- `src-tauri/src/commands/mod.rs` — DTO 新增字段

## 前端改动

### 涉及文件
- `src/App.tsx` — 新增页面级 Tab 状态，拆分 Explore 视图逻辑
- `src/App.css` — Explore 页样式、卡片优化样式
- `src/components/skills/types.ts` — DTO 同步新增 description 字段
- `src/components/skills/modals/AddSkillModal.tsx` — 移除探索 Tab，仅保留 Local/Git
- `src/i18n/resources.ts` — 新增/调整翻译 key（My Skills / Explore 导航等）

### 可能新增文件
- `src/components/skills/ExplorePage.tsx` — Explore 页面组件
- `src/components/skills/ExploreCard.tsx` — Explore 卡片组件

## 实施顺序建议

1. **后端**：description 字段（表迁移 + SKILL.md 解析 + DTO）
2. **前端**：导航 Tab 切换 + My Skills 列表优化（description 展示 + 工具徽章折叠）
3. **前端**：Explore 页面（搜索 + 卡片网格 + 一键安装）
4. **前端**：Manual Add 弹窗精简（移除探索 Tab，改为从 Explore 页触发）
5. **联调 & 测试**


================================================
FILE: docs/releases/v0.3.0/plan-featured-skills.md
================================================
# 需求一：精选技能推荐列表 — 实施计划

## Context

用户打开"添加技能"时，只有手动输入本地路径或 Git URL，缺乏发现能力。需要在 AddSkillModal 中新增"探索"标签页，展示由 CI 预生成的热门技能列表，用户点击后自动走现有 Git 安装流程。

数据源：ClawHub API (`clawhub.ai/api/v1/skills`)，由 GitHub Actions 每日拉取生成 `featured-skills.json` 提交到仓库。应用运行时从 GitHub raw URL 获取该 JSON（带本地缓存兜底），避免直接依赖 ClawHub API。

## 关键发现

- AddSkillModal 已有一个 **disabled 的搜索标签按钮**（第 88-90 行），可直接改造为"探索"
- `addModalTab` 类型当前为 `'local' | 'git'`，需扩展为三值联合
- 后端已有 `reqwest::blocking::Client` + `github_search.rs` 的 HTTP 模式可复用
- `SkillStore` 已有 `get_setting` / `set_setting` 可用于缓存
- `parse_github_url` 已支持 `https://github.com/owner/repo/tree/branch/path` 格式
- 安装 URL 格式：`https://github.com/openclaw/skills/tree/main/skills/{username}/{slug}`

## 步骤 1：CI — GitHub Actions 工作流 + 拉取脚本

### 新建 `.github/workflows/update-featured-skills.yml`

- 每日 UTC 0:00 定时运行 + 支持手动触发
- 执行 Node.js 脚本 `scripts/fetch-featured-skills.mjs`
- 若 JSON 有变化则自动提交

### 新建 `scripts/fetch-featured-skills.mjs`

逻辑：
1. 调用 `GET https://clawhub.ai/api/v1/skills?sort=downloads&limit=100`
2. 调用 GitHub API 获取 `openclaw/skills` 仓库 `skills/` 目录结构（用于匹配 slug → 实际路径）
3. 对每个 ClawHub 技能，在 `openclaw/skills` 目录中按 slug 匹配找到 `{username}/{slug}` 路径
4. 生成 `featured-skills.json`，结构：

```json
{
  "updated_at": "2026-03-13T00:00:00Z",
  "skills": [
    {
      "slug": "self-improving-agent",
      "name": "self-improving-agent",
      "summary": "Captures learnings, errors...",
      "downloads": 197815,
      "stars": 1934,
      "source_url": "https://github.com/openclaw/skills/tree/main/skills/username/self-improving-agent"
    }
  ]
}
```

5. 未匹配到 GitHub 路径的技能，`source_url` 留空，前端不显示安装按钮

### 同时先手动运行一次脚本，生成初始 `featured-skills.json` 提交到仓库根目录

## 步骤 2：后端 — 新建 `core/featured_skills.rs`

参考 `github_search.rs` (src-tauri/src/core/github_search.rs) 模式。

```rust
// 数据结构
pub struct FeaturedSkillsData { updated_at: String, skills: Vec<FeaturedSkill> }
pub struct FeaturedSkill { slug, name, summary, downloads: u64, stars: u64, source_url: String }

// 核心函数
pub fn fetch_featured_skills(store: &SkillStore) -> Result<Vec<FeaturedSkill>>
```

逻辑：
1. `reqwest::blocking::Client` 请求 `https://raw.githubusercontent.com/{owner}/{repo}/main/featured-skills.json`
2. 成功 → 解析 JSON，缓存到 `store.set_setting("featured_skills_cache", &json_str)`
3. 失败 → 从 `store.get_setting("featured_skills_cache")` 读缓存
4. 都失败 → 返回空 Vec（优雅降级，不 bail）
5. 过滤掉 `source_url` 为空的条目

### 修改 `core/mod.rs`

添加 `pub mod featured_skills;`

## 步骤 3：后端 — 注册 Tauri 命令

### 修改 `src-tauri/src/commands/mod.rs`

新增 DTO 和命令：

```rust
#[derive(Debug, Serialize)]
pub struct FeaturedSkillDto {
    pub slug: String,
    pub name: String,
    pub summary: String,
    pub downloads: u64,
    pub stars: u64,
    pub source_url: String,
}

#[tauri::command]
pub async fn get_featured_skills(store: State<'_, SkillStore>) -> Result<Vec<FeaturedSkillDto>, String>
```

使用标准的 `spawn_blocking` + `format_anyhow_error` 模式。

### 修改 `src-tauri/src/lib.rs`

在 `generate_handler!` 中注册 `commands::get_featured_skills`。

## 步骤 4：前端 — 类型定义

### 修改 `src/components/skills/types.ts`

```typescript
export type FeaturedSkillDto = {
  slug: string
  name: string
  summary: string
  downloads: number
  stars: number
  source_url: string
}
```

## 步骤 5：前端 — App.tsx 状态管理

### 修改 `src/App.tsx`

1. **Tab 类型扩展**：`useState<'local' | 'git' | 'explore'>('explore')` — 默认打开探索标签
2. **新增状态**：
   - `const [featuredSkills, setFeaturedSkills] = useState<FeaturedSkillDto[]>([])`
   - `const [featuredLoading, setFeaturedLoading] = useState(false)`
   - `const [exploreFilter, setExploreFilter] = useState('')`
3. **新增 `loadFeaturedSkills`**：调用 `invoke('get_featured_skills')`，在 `handleOpenAdd` 中触发（仅首次或数据为空时）
4. **新增 `handleSelectFeaturedSkill(sourceUrl: string)`**：
   - `setGitUrl(sourceUrl)`
   - `setAddModalTab('git')` — 自动跳转到 Git 标签
5. **传递新 props 给 AddSkillModal**：`featuredSkills`, `featuredLoading`, `exploreFilter`, `onExploreFilterChange`, `onSelectFeaturedSkill`

## 步骤 6：前端 — 修改 AddSkillModal

### 修改 `src/components/skills/modals/AddSkillModal.tsx`

1. **Props 类型扩展**：添加 explore 相关的 6 个新 props
2. **启用探索标签**：替换第 88-90 行 disabled 按钮为可点击的 explore 标签
3. **三分支条件渲染**：
   - `addModalTab === 'explore'` → 探索内容
   - `addModalTab === 'local'` → 本地表单（现有）
   - `addModalTab === 'git'` → Git 表单（现有）
4. **探索标签内容**：
   - 筛选输入框（前端过滤 name + summary）
   - 可滚动列表（max-height ~400px）
   - 每项显示：name（粗体）、summary（截断）、downloads + stars 统计
   - 点击 → 调用 `onSelectFeaturedSkill(source_url)`
   - Loading / Empty 状态
5. **条件隐藏底部区域**：explore 标签时隐藏 "Install to tools" 复选框区域和 footer 按钮（用户在此标签只浏览，安装在 git 标签完成）

## 步骤 7：前端 — i18n 翻译

### 修改 `src/i18n/resources.ts`

```
EN:
  exploreTab: 'Explore'
  exploreFilterPlaceholder: 'Filter skills...'
  exploreEmpty: 'No featured skills available.'
  exploreLoading: 'Loading featured skills...'
  exploreError: 'Failed to load featured skills.'

ZH:
  exploreTab: '探索'
  exploreFilterPlaceholder: '筛选技能...'
  exploreEmpty: '暂无精选技能。'
  exploreLoading: '加载精选技能中...'
  exploreError: '加载精选技能失败。'
```

## 步骤 8：前端 — CSS 样式

### 修改 `src/App.css`

添加探索标签页样式：
- `.explore-filter` — 输入框
- `.explore-list` — 可滚动容器 (max-height: 400px, overflow-y: auto)
- `.explore-skill-item` — 单条技能行 (cursor: pointer, hover 高亮)
- `.explore-skill-name` — 名称
- `.explore-skill-summary` — 简介 (text-overflow: ellipsis)
- `.explore-skill-stats` — 统计数字
- `.explore-empty` / `.explore-loading` — 状态提示

## 步骤 9：后端测试

### 新建 `src-tauri/src/core/tests/featured_skills.rs`

使用 `mockito` mock HTTP：
- 测试正常 JSON 解析
- 测试 HTTP 失败时缓存 fallback
- 测试空/畸形 JSON 的优雅降级

## 修改文件清单

| 文件 | 操作 | 说明 |
|------|------|------|
| `.github/workflows/update-featured-skills.yml` | 新建 | CI 定时任务 |
| `scripts/fetch-featured-skills.mjs` | 新建 | 数据拉取脚本 |
| `featured-skills.json` | 新建 | CI 生成的精选列表 |
| `src-tauri/src/core/featured_skills.rs` | 新建 | 后端核心逻辑 |
| `src-tauri/src/core/mod.rs` | 修改 | 导出新模块 |
| `src-tauri/src/commands/mod.rs` | 修改 | 新增命令 + DTO |
| `src-tauri/src/lib.rs` | 修改 | 注册命令 |
| `src/components/skills/types.ts` | 修改 | 新增前端 DTO |
| `src/App.tsx` | 修改 | 状态 + 回调 + props |
| `src/components/skills/modals/AddSkillModal.tsx` | 修改 | UI 改造核心 |
| `src/i18n/resources.ts` | 修改 | 中英文翻译 |
| `src/App.css` | 修改 | 探索标签样式 |
| `src-tauri/src/core/tests/featured_skills.rs` | 新建 | 后端测试 |

## 验证方式

1. `npm run check` — lint + build + rust:clippy + rust:test 全部通过
2. `npm run tauri:dev` — 打开 AddSkillModal，默认显示"探索"标签
3. 确认列表加载正常（或网络失败时显示友好提示）
4. 输入关键词，确认筛选功能工作
5. 点击某个技能，确认自动跳转到 Git 标签并填充 URL
6. 在 Git 标签点击安装，确认走通完整安装流程


================================================
FILE: docs/releases/v0.3.0/plan-online-search.md
================================================
# 需求二：在线技能搜索与安装 — 实施计划（已完成）

## Context

需求一已实现"探索"标签页，展示精选技能列表。但精选列表覆盖有限，用户有明确需求时（如"找 React 相关技能"），需要实时搜索能力。搜索功能内嵌在探索标签页中：用户输入关键词 → 精选本地过滤秒出 + 在线搜索结果分区展示，清空搜索框 → 恢复精选列表。

数据源：`skills.sh/api/search?q={query}&limit=20`（无需认证，模糊搜索，最少 2 字符）。无 CORS，必须从 Rust 后端调用。

### API 返回字段

```json
{
  "id": "vercel-labs/agent-skills/vercel-react-best-practices",
  "skillId": "vercel-react-best-practices",
  "name": "vercel-react-best-practices",
  "installs": 205992,
  "source": "vercel-labs/agent-skills"
}
```

> **重要发现**：`id` 和 `name` 不能直接映射到仓库内的文件路径。例如 API `name: "json-render-react"` 对应仓库目录 `skills/react/`、SKILL.md `name: "react"`。skills.sh 平台对名称做了转换，与仓库实际 SKILL.md frontmatter name 不一致。

## 核心设计决策

### 方案：分区展示，精选 + 在线互补

输入框升级为双模式，两个数据源分区展示：
- 输入 < 2 字符：仅前端本地过滤精选列表（现有行为不变）
- 输入 >= 2 字符：上方显示精选列表本地过滤结果（秒出，有 summary），下方分割线后显示在线搜索结果（500ms 防抖，有 installs）
- 清空输入框：隐藏在线搜索区域，恢复完整精选列表

```
用户输入 "react"
  ↓ 立刻
  ┌─ 精选推荐（本地过滤） ──────────────┐
  │  vercel-react-best-practices        │  ← 有 summary
  │  vercel-react-native-skills         │
  └─────────────────────────────────────┘
  ↓ 500ms 后
  ┌─ 在线搜索 skills.sh ───────────────┐
  │  react-expert (203K installs)       │  ← 无 summary，有 installs
  │  react (57K installs)               │
  └─────────────────────────────────────┘
```

### 在线搜索去重

在线结果中与精选列表 name 重复的条目自动过滤（`useMemo` 按 name 去重）。

### 点击安装 — 多技能仓库自动匹配

点击在线搜索结果时，`source_url` 是仓库地址（`https://github.com/owner/repo`），不含子目录路径（因为 API 数据无法可靠映射到仓库文件路径）。安装流程：

1. 设置 `gitUrl` = 仓库地址，`autoSelectSkillName` = API 返回的 skill name
2. 用户点安装 → `list_git_skills_cmd` 克隆仓库列出所有候选 skill
3. **自动匹配策略**（三级回退）：
   - 精确匹配：API name === SKILL.md name（如 `vercel-react-best-practices`）
   - 唯一包含匹配：API name 包含某个 SKILL.md name，且仅一个候选命中（如 `json-render-react` 包含 `react`）
   - 回退 picker：匹配失败或多个候选命中时，弹出选择弹窗让用户手动选
4. 单技能仓库：直接安装（现有逻辑不变）

## 实现步骤

### 步骤 1：后端 — `core/skills_search.rs`（新建）

参考 `github_search.rs` 模式。

```rust
#[derive(Debug, Deserialize)]
struct SkillsShResponse { skills: Vec<SkillsShItem> }
struct SkillsShItem { name: String, installs: u64, source: String }

pub struct OnlineSkillResult {
    pub name: String,
    pub installs: u64,
    pub source: String,        // "owner/repo"
    pub source_url: String,    // "https://github.com/owner/repo"
}

pub fn search_skills_online(query: &str, limit: usize) -> Result<Vec<OnlineSkillResult>>
// 内部函数 search_skills_online_inner(base_url, query, limit) 支持测试注入
```

`source_url` 由 `source` 字段拼接（`https://github.com/{source}`）。不使用 `id` 字段构造路径（无法映射到仓库实际目录结构）。

在 `core/mod.rs` 添加 `pub mod skills_search;`。

### 步骤 2：后端 — 注册 Tauri 命令

`commands/mod.rs` 新增：

```rust
#[derive(Debug, Serialize)]
pub struct OnlineSkillDto { name, installs, source, source_url }

impl From<OnlineSkillResult> for OnlineSkillDto { ... }

#[tauri::command]
pub async fn search_skills_online(query: String, limit: Option<u32>) -> Result<Vec<OnlineSkillDto>, String>
```

不需要 `State<SkillStore>`（纯 HTTP 调用）。在 `lib.rs` 的 `generate_handler!` 中注册。

### 步骤 3：前端 — 类型定义

`src/components/skills/types.ts` 新增：

```typescript
export type OnlineSkillDto = {
  name: string
  installs: number
  source: string      // "owner/repo"
  source_url: string  // "https://github.com/owner/repo"
}
```

### 步骤 4：前端 — App.tsx 状态与逻辑

1. **新增状态**：
   - `searchResults: OnlineSkillDto[]` — 在线搜索结果
   - `searchLoading: boolean` — 搜索加载中
   - `searchTimerRef: useRef` — 500ms 防抖 timer
   - `autoSelectSkillName: string | null` — 从在线搜索点击时记录的目标 skill 名称

2. **`handleExploreFilterChange`**：
   - 设置 `exploreFilter`（驱动精选列表本地过滤，秒出）
   - < 2 字符 → 清除 timer + 清空搜索结果
   - >= 2 字符 → 500ms 防抖后调用 `invoke('search_skills_online', { query, limit: 20 })`

3. **`handleSelectSearchResult(sourceUrl, skillName)`**：
   - `setGitUrl(sourceUrl)` + `setAutoSelectSkillName(skillName)` + 切换到 git tab

4. **`handleCreateGit` 中多技能分支增加自动匹配**：
   - 当 `autoSelectSkillName` 存在且 `candidates.length > 1` 时，按三级回退策略自动匹配
   - 匹配成功 → 直接 `install_git_selection` 安装
   - 匹配失败 → 回退到 picker 弹窗

### 步骤 5：前端 — AddSkillModal 分区布局

Props 新增：`searchResults`, `searchLoading`, `onSelectSearchResult(sourceUrl, skillName)`

```
{/* 区域 1：精选推荐（始终显示，本地过滤） */}
{isSearchActive && <SectionTitle>精选推荐</SectionTitle>}
<explore-list>精选过滤结果</explore-list>

{/* 区域 2：在线搜索（仅 >= 2 字符时显示） */}
{isSearchActive && <>
  <SectionTitle>在线搜索</SectionTitle>
  {searchLoading ? <Loading /> : deduplicatedResults.map(skill => (
    <SkillItem name={skill.name} source={skill.source} installs={skill.installs}
               onClick={() => onSelectSearchResult(skill.source_url, skill.name)} />
  ))}
</>}

{/* 全局空状态 */}
{无精选 && 无搜索 && <Empty />}
```

去重：`useMemo` 从 `searchResults` 中过滤掉 name 已存在于 `filteredSkills` 的条目。

### 步骤 6：i18n 翻译

```
EN:
  exploreFilterPlaceholder: 'Filter or search skills online...'
  exploreFeaturedTitle: 'Featured'
  exploreOnlineTitle: 'Online Results'
  searchLoading: 'Searching skills.sh...'
  searchEmpty: 'No additional results found.'
  searchError: 'Online search failed.'

ZH:
  exploreFilterPlaceholder: '筛选精选或在线搜索技能...'
  exploreFeaturedTitle: '精选推荐'
  exploreOnlineTitle: '在线搜索'
  searchLoading: '正在搜索 skills.sh...'
  searchEmpty: '未找到更多结果。'
  searchError: '在线搜索失败。'
```

### 步骤 7：CSS 样式

- `.explore-section-title` — 分区标题（小字灰色，带上边框分隔，uppercase）
- `.explore-skill-source` — source 字段（灰色小字 12px）
- 复用现有 `.explore-skill-item` / `.explore-list` 样式

### 步骤 8：后端测试

`src-tauri/src/core/tests/skills_search.rs`，使用 `mockito` mock：
- `parses_search_results` — 正常解析 + source_url 拼接
- `source_url_is_constructed_from_source` — source → GitHub URL
- `http_error_returns_error` — HTTP 500 错误处理
- `empty_results` — 空结果

## 修改文件清单

| 文件 | 操作 | 说明 |
|------|------|------|
| `src-tauri/src/core/skills_search.rs` | 新建 | 搜索核心逻辑（请求 skills.sh API） |
| `src-tauri/src/core/mod.rs` | 修改 | 导出 `skills_search` 模块 |
| `src-tauri/src/commands/mod.rs` | 修改 | 新增 `OnlineSkillDto` + `search_skills_online` 命令 |
| `src-tauri/src/lib.rs` | 修改 | 在 `generate_handler!` 注册命令 |
| `src-tauri/src/core/tests/skills_search.rs` | 新建 | 4 个后端测试 |
| `src/components/skills/types.ts` | 修改 | 新增 `OnlineSkillDto` 类型 |
| `src/App.tsx` | 修改 | 搜索状态 + 防抖 + `autoSelectSkillName` 自动匹配 |
| `src/components/skills/modals/AddSkillModal.tsx` | 修改 | 分区展示 UI + 去重 |
| `src/i18n/resources.ts` | 修改 | 搜索相关中英文翻译 |
| `src/App.css` | 修改 | 分区标题 + source 样式 |

## 验证方式

1. `npm run check` — 全部通过（lint + build + rust fmt/clippy/test）
2. 打开探索标签，输入 1 个字符 → 仅本地过滤精选列表，无在线搜索区域
3. 输入 2+ 字符 → 精选过滤结果秒出（上方），500ms 后在线搜索区域出现
4. 在线搜索结果中不包含精选列表已有的条目（去重）
5. 搜索结果正确展示（name, installs, source）
6. 清空输入框 → 在线搜索区域消失，恢复完整精选列表
7. 点击搜索结果 → 跳转到 Git 标签填充仓库 URL → 安装时自动匹配目标 skill
8. 多技能仓库自动匹配失败时 → 回退到手动选择弹窗
9. 断网时搜索 → 在线区域显示错误提示，精选列表不受影响

## 已知限制

- skills.sh API 的 `name` 与仓库 SKILL.md frontmatter `name` 不一定一致（如 `json-render-react` vs `react`），自动匹配使用精确 + 唯一包含策略，极端情况可能回退到手动选择
- `source_url` 只包含仓库地址，不含子目录路径（API `id` 字段无法可靠映射到仓库文件路径）
- 多技能仓库首次安装需克隆完整仓库以获取候选列表（后续命中缓存）


================================================
FILE: docs/releases/v0.3.0/plan-skill-detail-view.md
================================================
# 技能详情页（Skill Detail View）— 实施计划（已完成）

## Context

当前已安装的技能以卡片列表展示，但无法查看技能的具体文件内容。用户希望点击技能卡片后能看到技能的所有文件，默认显示 SKILL.md，支持切换文件和返回列表。

### 设计原型

原型图位于 `docs/skills_hub_v2_design.html` 的 Screen 5A–5D 部分。

### 交互流程

1. 在 My Skills 列表中，技能名称为可点击链接（hover 变蓝色）
2. 点击后整个内容区替换为详情视图（非模态框），Header 导航栏保持不变，My Skills tab 保持高亮
3. 详情视图顶部显示返回按钮、技能名称、描述、来源、更新时间、文件数
4. 下方为左右分栏：左侧文件树（260px），右侧文件内容（语法高亮 / Markdown 渲染）
5. 默认选中 SKILL.md（排首位），点击左侧其他文件切换内容
6. 文件夹默认折叠，点击展开/收起
7. 点击返回按钮回到列表视图

## 核心设计决策

### 视图切换而非模态框

采用扩展 `activeView` 状态增加 `'detail'` 视图的方式，与现有的 `'myskills'` / `'explore'` 视图切换机制一致。优势：
- 复用现有视图切换逻辑
- 详情视图可占满整个内容区域，空间充足
- detail 时 Header 仍高亮 My Skills tab，保持导航一致性

### 文件内容渲染策略（三层）

根据文件类型选择不同渲染方式：
1. **Markdown 文件**（`.md`/`.mdx`）：使用 `react-markdown` + `remark-gfm` + `remark-frontmatter` 渲染为 GitHub 风格 Markdown（标题、表格、代码块高亮、引用块等），YAML frontmatter 自动剥离不显示
2. **代码文件**（`.ts`/`.js`/`.py`/`.rs` 等 40+ 种语言）：使用 `react-syntax-highlighter`（Prism）语法高亮 + 行号，自动检测暗色/亮色主题切换 `oneDark`/`oneLight` 配色
3. **其他文件**：纯文本显示 + 行号

### 左侧文件树（自建，非第三方库）

将扁平路径构建为树形结构，文件夹可折叠/展开，默认折叠。排序：目录在前 → 文件在后，SKILL.md 排首位，其余按字母排序。

### 文件遍历复用 content_hash.rs 的过滤模式

`list_files` 使用与 `content_hash.rs` 相同的 walkdir + IGNORE_NAMES 过滤（排除 `.git`、`.DS_Store` 等），保持一致性。

---

## 步骤一：后端 — 新建 `src-tauri/src/core/skill_files.rs`

复用 `content_hash.rs` 的 walkdir + IGNORE_NAMES 过滤模式。

### 两个函数

**`list_files(central_path: &Path) -> Result<Vec<FileEntry>>`**
- 使用 walkdir 遍历目录，过滤 IGNORE_NAMES
- 返回 `Vec<FileEntry>`（相对路径 + 文件大小）
- SKILL.md 排在首位（排序时特殊处理）
- 其余文件按路径字母排序

**`read_file(central_path: &Path, relative_path: &str) -> Result<String>`**
- 路径穿越防护：禁止包含 `..`，canonicalize 后验证仍在 central_path 内
- 1MB 大小限制，超出返回友好错误信息
- 非 UTF-8 文件返回明确错误提示
- 读取并返回文件内容字符串

### FileEntry 结构体

```rust
pub struct FileEntry {
    pub path: String,  // 相对路径
    pub size: u64,     // 文件大小（字节）
}
```

### 模块导出

在 `src-tauri/src/core/mod.rs` 中添加 `pub mod skill_files;`。

---

## 步骤二：后端 — 新增 Tauri 命令

在 `src-tauri/src/commands/mod.rs` 中：

### DTO

```rust
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub struct SkillFileEntry {
    pub path: String,
    pub size: u64,
}
```

### 命令

```rust
#[tauri::command]
pub async fn list_skill_files(central_path: String) -> Result<Vec<SkillFileEntry>, String>
// 调用 core::skill_files::list_files，转换为 DTO

#[tauri::command]
pub async fn read_skill_file(central_path: String, file_path: String) -> Result<String, String>
// 调用 core::skill_files::read_file
```

### 注册

在 `src-tauri/src/lib.rs` 的 `generate_handler!` 中添加：
- `commands::list_skill_files`
- `commands::read_skill_file`

---

## 步骤三：前端 — 类型定义

在 `src/components/skills/types.ts` 中新增：

```typescript
export type SkillFileEntry = {
  path: string
  size: number
}
```

---

## 步骤四：前端 — 新建 `src/components/skills/SkillDetailView.tsx`

### 依赖

- `react-syntax-highlighter`（Prism 版）— 代码高亮 + 行号，40+ 语言，oneLight/oneDark 主题
- `react-markdown` — Markdown 渲染
- `remark-gfm` — GitHub Flavored Markdown（表格、删除线、任务列表等）
- `remark-frontmatter` — 剥离 YAML frontmatter（SKILL.md 头部 metadata）

### Props

```typescript
type SkillDetailViewProps = {
  skill: ManagedSkill
  onBack: () => void
  invokeTauri: <T>(command: string, args?: Record<string, unknown>) => Promise<T>
  formatRelative: (ms: number | null | undefined) => string
  t: TFunction
}
```

### 内部状态

- `files: SkillFileEntry[]` — 文件列表
- `activeFile: string | null` — 当前选中的文件路径
- `fileContent: string` — 当前文件内容
- `loadingFiles: boolean` — 文件列表加载中
- `loadingContent: boolean` — 文件内容加载中
- `expanded: Set<string>` — 已展开的文件夹路径集合

### 内部子组件

- **`FileTreeNode`**（memo）— 递归渲染文件树节点，文件夹带 ChevronRight/ChevronDown + Folder/FolderOpen 图标
- **`FileContentRenderer`**（memo）— 根据文件类型选择 Markdown / SyntaxHighlighter / 纯文本渲染

### 行为

- `useEffect` 挂载时调用 `invoke('list_skill_files', { centralPath })` 获取文件列表
- 将扁平路径通过 `buildTree()` 构建为树形结构
- 文件夹默认折叠（`expanded` 初始为空 Set）
- 获取到文件列表后，默认选中第一个文件（应为 SKILL.md）
- `activeFile` 变化时调用 `invoke('read_skill_file', { centralPath, filePath })` 读取内容
- 自动检测暗色/亮色主题（读取 `data-theme` 属性），切换语法高亮配色
- 错误处理：通过 toast 显示错误信息

### 布局

```
┌──────────────────────────────────────────────────────┐
│ [← Back]                                              │
│ 技能名称                                               │
│ 描述                                                   │
│ 来源 · 更新时间 · N files                               │
├──────────────┬───────────────────────────────────────┤
│ FILES        │  file-path                      size   │
│ ▸ skills/    │┌─────────────────────────────────────┐│
│ ▾ examples/  ││  Markdown 渲染 / 语法高亮 + 行号     ││
│   basic.md   ││                                     ││
│   adv.md     ││                                     ││
│ SKILL.md ●   │└─────────────────────────────────────┘│
└──────────────┴───────────────────────────────────────┘
```

---

## 步骤五：前端 — 修改 `src/App.tsx`

### 状态变更

- `activeView` 类型扩展为 `'myskills' | 'explore' | 'detail'`
- 新增 `detailSkill: ManagedSkill | null` 状态

### 回调函数

```typescript
const handleOpenDetail = useCallback((skill: ManagedSkill) => {
  setDetailSkill(skill)
  setActiveView('detail')
}, [])

const handleBackToList = useCallback(() => {
  setDetailSkill(null)
  setActiveView('myskills')
}, [])
```

### 渲染

在 `skills-main` 区域增加 `activeView === 'detail'` 分支，渲染 `<SkillDetailView>`。

---

## 步骤六：前端 — 修改 `src/components/skills/SkillCard.tsx`

- 新增 `onOpenDetail: (skill: ManagedSkill) => void` prop
- `.skill-name` 改为 `<button>` 元素，添加 `onClick={() => onOpenDetail(skill)}`
- 添加 `clickable` CSS class（hover 变蓝色）

---

## 步骤七：前端 — 修改 `src/components/skills/SkillsList.tsx`

- 新增 `onOpenDetail` prop
- 透传到每个 `<SkillCard>` 组件

---

## 步骤八：前端 — 修改 `src/components/skills/Header.tsx`

- `activeView` 类型扩展为 `'myskills' | 'explore' | 'detail'`
- detail 视图时 My Skills tab 保持高亮状态（判断条件改为 `activeView === 'myskills' || activeView === 'detail'`）

---

## 步骤九：样式 — `src/App.css`

新增详情视图相关 CSS class：

**布局结构：**
- `.detail-view` — 整体容器（flex column, 填满空间）
- `.detail-header` — 顶部技能信息区
- `.detail-back-btn` — 返回按钮（hover 变蓝）
- `.detail-skill-name` — 技能名称（大号加粗）
- `.detail-desc` — 描述文字
- `.detail-meta` — 来源/时间/文件数元信息行
- `.detail-body` — 左右分栏容器（flex row）

**文件树侧栏（260px）：**
- `.detail-file-list` — 侧栏容器（bg-panel 背景）
- `.file-list-title` — "Files" 标题
- `.file-tree` — 树容器
- `.tree-item` — 树节点（通用，28px 最小高度）
- `.tree-dir` — 目录节点
- `.tree-file` — 文件节点（active 蓝色高亮）
- `.tree-chevron` — 折叠箭头
- `.tree-icon-folder` — 文件夹图标（蓝色）
- `.tree-icon-file` — 文件图标
- `.tree-name` — 名称（ellipsis 截断）
- `.tree-size` — 文件大小

**文件内容区：**
- `.detail-file-content` — 右侧内容区
- `.file-content-header` — 文件路径 + 大小（sticky top, bg-panel 背景）
- `.file-content-body` — 内容容器

**Markdown 渲染样式：**
- `.markdown-body` — Markdown 容器（max-width 860px，GitHub 风格排版）
- `.markdown-body h1/h2` — 标题带底部边框
- `.markdown-body pre` — 代码块（border + border-radius）
- `.markdown-body .md-inline-code` — 行内代码
- `.markdown-body table/th/td` — 表格样式
- `.markdown-body blockquote` — 引用块（蓝色左边框）

**通用：**
- `.skill-name.clickable` — 卡片中可点击的技能名称

暗色主题通过 CSS 变量自动适配，无需额外样式。

---

## 步骤十：i18n — `src/i18n/resources.ts`

新增翻译 key（`detail` 命名空间）：

| Key | EN | ZH |
|-----|----|----|
| `detail.back` | Back | 返回 |
| `detail.files` | Files | 文件 |
| `detail.noFiles` | No files found | 未找到文件 |
| `detail.loadingFiles` | Loading files... | 加载文件中... |
| `detail.loadingContent` | Loading file content... | 加载文件内容中... |
| `detail.readError` | Failed to read file | 读取文件失败 |
| `detail.fileCount` | {{count}} files | {{count}} 个文件 |

---

## 新增依赖

| 包名 | 用途 |
|------|------|
| `react-syntax-highlighter` | 代码语法高亮 + 行号（Prism 版，oneLight/oneDark 主题） |
| `@types/react-syntax-highlighter` | TypeScript 类型定义 |
| `react-markdown` | Markdown 渲染 |
| `remark-gfm` | GitHub Flavored Markdown 支持 |
| `remark-frontmatter` | YAML frontmatter 剥离 |

---

## 修改文件清单

| 文件 | 操作 | 说明 |
|------|------|------|
| `package.json` | 修改 | 新增 5 个依赖 |
| `src-tauri/src/core/skill_files.rs` | **新建** | list_files + read_file 核心逻辑 |
| `src-tauri/src/core/mod.rs` | 修改 | 导出 skill_files 模块 |
| `src-tauri/src/commands/mod.rs` | 修改 | 新增 2 个命令 + SkillFileEntry DTO |
| `src-tauri/src/lib.rs` | 修改 | 注册 list_skill_files、read_skill_file |
| `src/components/skills/types.ts` | 修改 | 新增 SkillFileEntry 类型 |
| `src/components/skills/SkillDetailView.tsx` | **新建** | 详情视图组件（文件树 + Markdown/高亮渲染） |
| `src/components/skills/SkillCard.tsx` | 修改 | 新增 onOpenDetail prop + 点击事件 |
| `src/components/skills/SkillsList.tsx` | 修改 | 透传 onOpenDetail prop |
| `src/components/skills/Header.tsx` | 修改 | activeView 类型扩展 |
| `src/App.tsx` | 修改 | 新增状态 + 渲染分支 + import SkillDetailView |
| `src/App.css` | 修改 | 新增文件树 + Markdown + 详情视图样式 |
| `src/i18n/resources.ts` | 修改 | 新增翻译 key（中英双语） |

---

## 验证

1. `npm run check` — 确保 lint + build + rust clippy/test 全部通过 ✅
2. `npm run tauri:dev` — 手动测试：
   - 点击技能名称进入详情视图
   - 默认显示 SKILL.md 内容（Markdown 渲染，frontmatter 已剥离）
   - 切换代码文件，语法高亮 + 行号正确显示
   - 文件树目录可折叠/展开，默认折叠
   - 点击返回按钮回到列表
   - Header 导航状态正确（detail 时 My Skills 高亮）
   - 暗色/亮色主题下显示正常
   - 加载状态正确显示


================================================
FILE: docs/releases/v0.3.1/plan-in-app-update.md
================================================
# 需求：应用内检查更新（Issue #33）

## Context

来源：https://github.com/qufei1993/skills-hub/issues/33

用户每次跟进版本都需要手动进入 GitHub releases 页面下载，体验不便。需要在软件内支持手动检查更新功能。

## 现状分析

后端 Tauri updater 插件已完全就绪：
- `tauri-plugin-updater` v2 已安装（Cargo.toml + package.json）
- `tauri.conf.json` 已配置更新端点（GitHub releases）+ 公钥签名验证
- `lib.rs` 已注册插件
- i18n 翻译键已全部就绪（EN/ZH）

唯一缺失：前端没有调用更新 API 的 UI。

## 实施方案

在 SettingsModal 底部版本信息区域扩展为"检查更新"功能块：

1. **SettingsModal.tsx** — 添加更新状态管理 + UI
   - 状态：idle → checking → up-to-date / available → downloading → done / error
   - 使用 `@tauri-apps/plugin-updater` 的 `check()` 和 `downloadAndInstall()` API
   - 保存 update 对象引用避免重复请求
   - 弹窗关闭时重置状态

2. **App.css** — 添加更新区块样式
   - 版本号 + 按钮水平排列
   - 更新可用时显示高亮区块
   - 错误/成功状态样式

3. **版本号** — 0.3.0 → 0.3.1

## 涉及文件

| 文件 | 改动 |
|------|------|
| `src/components/skills/modals/SettingsModal.tsx` | 添加更新检查 UI + 逻辑 |
| `src/App.css` | 添加更新区块样式 |
| `package.json` | 版本号 → 0.3.1 |
| `src-tauri/tauri.conf.json` | 版本号 → 0.3.1 |
| `src-tauri/Cargo.toml` | 版本号 → 0.3.1 |


================================================
FILE: docs/releases/v0.3.1/plan-qoderwork-support.md
================================================
# 需求：支持 QoderWork 目录（Issue #34）

## Context

来源：https://github.com/qufei1993/skills-hub/issues/34

QoderWork 是 Qoder 推出的桌面 AI 代理产品，与 Qoder IDE 独立，使用 `~/.qoderwork/skills/` 目录存放技能。当前代码库已支持 Qoder（`.qoder/skills`），但尚未支持 QoderWork。

## 实施方案

参照现有 Qoder 适配器模式，在 3 处添加 QoderWork 支持：

### 1. `src-tauri/src/core/tool_adapters/mod.rs`

- **ToolId 枚举**：在 `Qoder` 之后添加 `QoderWork`
- **as_key() 方法**：添加 `ToolId::QoderWork => "qoderwork"`
- **default_tool_adapters()**：添加 ToolAdapter 实例：
  ```rust
  ToolAdapter {
      id: ToolId::QoderWork,
      display_name: "QoderWork",
      relative_skills_dir: ".qoderwork/skills",
      relative_detect_dir: ".qoderwork",
  },
  ```

### 2. `src/i18n/resources.ts`

- 英文 tools 对象：添加 `qoderwork: 'QoderWork'`
- 中文 tools 对象：添加 `qoderwork: 'QoderWork'`

## 验证

- `npm run check` 确保 lint、build、Rust clippy/test 全部通过


================================================
FILE: docs/releases/v0.3.1/plan-settings-page.md
================================================
# 需求：设置弹窗改为独立页面

## Context

设置功能原来是一个 560px 宽的模态弹窗（SettingsModal），在小窗口下容易被遮挡，需要最大化窗口才能完整查看。将其改为 `activeView` 视图系统中的独立页面，与 myskills/explore/detail 并列，UX 更自然。

## 实施方案

### 1. 组件迁移：`modals/SettingsModal.tsx` → `SettingsPage.tsx`

- 移动到 `src/components/skills/SettingsPage.tsx`，与 `ExplorePage`、`SkillDetailView` 同级
- 类型名 `SettingsModalProps` → `SettingsPageProps`
  - 删除 `open: boolean`
  - `onRequestClose` → `onBack`
- 去掉 modal 外壳（`modal-backdrop` / `modal` / `modal-header` / `modal-footer`）
- 复用 `detail-header` + `detail-back-btn` 样式，与 SkillDetailView 保持一致
- useEffect 从依赖 `open` 改为挂载/卸载模式
- 删除 `if (!open) return null` 守卫
- 删除底部 "Done" 按钮

### 2. `App.tsx` — 状态和路由

- `activeView` 类型扩展为 `'myskills' | 'explore' | 'detail' | 'settings'`
- 删除 `showSettingsModal` 布尔状态
- `handleOpenSettings` 改为 `setActiveView('settings')`
- `handleCloseSettings` 改为 `setActiveView('myskills')`
- `<main>` 条件渲染新增 `settings` 分支，渲染 `<SettingsPage>`
- 删除底部的 `<SettingsModal>` 渲染块

### 3. `Header.tsx` — 导航状态

- `activeView` 类型加 `| 'settings'`
- 设置齿轮按钮在 `activeView === 'settings'` 时添加 `active` 样式

### 4. `App.css` — 样式调整

- 删除 `.settings-modal` 和 `.settings-body` 规则
- 新增 `.settings-page`（居中布局）和 `.settings-page-body`（560px 最大宽度，居中）
- 复用 `.detail-header` / `.detail-back-btn` / `.detail-skill-name` 样式
- 所有 `.settings-field` 等子样式保持不变

### 不需要改动

- **i18n**：复用已有的 `detail.back`、`settings` key
- **Rust 后端**：纯前端改动
- **types.ts**：无 DTO 变更


================================================
FILE: docs/releases/v0.3.1/skills-aggregation-repo.md
================================================
# 需求：Skills 聚合数据源升级 — 精选仓库列表方案

## 背景

Skills Hub 应用的"探索"功能依赖 `featured-skills.json` 提供精选技能列表。早期方案通过 GitHub Search API 搜索 `claude-code-skill` 等 topic 标签自动发现仓库，但属于盲目搜索，质量不可控，噪音多。

**新方案**：维护一份精选仓库列表（Curated Repos），直接从已知的高质量仓库中获取 skills。质量可控、API 调用极少、维护简单。

## 目标

重写 `scripts/fetch-featured-skills.mjs` 脚本，从精选仓库列表直接获取元数据并深入检测 skill 目录结构，为每个 skill 生成独立条目，最终输出 `featured-skills.json`（最多 300 条）。保持现有的 GitHub Actions 定时更新机制不变。

## 架构（保持不变）

```
skills-desktop-app/
├── featured-skills.json                          # 精选技能数据（应用内嵌 fallback + 在线更新源）
├── scripts/
│   └── fetch-featured-skills.mjs                 # 聚合脚本（需重写）
└── .github/workflows/
    └── update-featured-skills.yml                # 每日定时运行（保持不变）
```

## 数据源 — 精选仓库列表

从 GitHub Topic 盲目搜索改为直接指定高质量仓库：

| 仓库 | Stars | 说明 |
|------|-------|------|
| `anthropics/skills` | ~96k | Anthropic 官方 Agent Skills |
| `sickn33/antigravity-awesome-skills` | ~24.7k | 1000+ 社区 skills 集合 |
| `K-Dense-AI/claude-scientific-skills` | ~15.3k | 170+ 科学研究 skills |
| `travisvn/awesome-claude-skills` | ~9.1k | 精选 Claude skills 列表 |
| `VoltAgent/awesome-agent-skills` | ~8.4k | 500+ Agent skills |
| `anthropics/knowledge-work-plugins` | ~7.7k | 官方知识工作插件 |
| `alirezarezvani/claude-skills` | ~5.2k | 192+ 社区 skills |

列表定义在脚本顶部 `CURATED_REPOS` 常量中，新增/移除仓库只需编辑此数组。

## 脚本重写逻辑

### 1. 数据采集（仓库元数据）

通过 GitHub Repos API 逐个获取精选仓库的元数据：

```
GET /repos/{owner}/{repo}
```

返回：`full_name`, `description`, `stargazers_count`, `topics[]`, `updated_at`, `html_url`, `default_branch`

认证：**必须**使用环境变量 `GITHUB_TOKEN`，脚本启动时校验。

失败处理：获取失败的仓库跳过（打印警告），不影响其余仓库。

### 2. Skill 检测（仓库内深入扫描）

使用 GitHub Git Trees API 获取仓库目录结构（单次请求，`recursive=1`）：

```
GET /repos/{owner}/{repo}/git/trees/{default_branch}?recursive=1
```

#### Skill 目录扫描规则（与应用端 `installer.rs` 保持一致）

扫描以下基础路径下的子目录：

```
skills/
skills/.curated/
skills/.experimental/
skills/.system/
.claude/skills/
```

以及**根目录的直接子目录**（排除 `skills/`、`.claude/`、`.git/` 等特殊目录）。

#### 新增：`.claude-plugin/plugin.json` 检测

为兼容 `anthropics/knowledge-work-plugins` 等使用插件格式的仓库，增加检测规则：

- 根级子目录包含 `.claude-plugin/plugin.json` 文件 → 视为有效 skill

#### Skill 判定条件

一个目录被视为有效 skill，需满足以下任一条件：
- 目录内存在 `SKILL.md` 文件
- 目录位于 `.claude/skills/` 路径下（即使没有 `SKILL.md`）
- 目录内存在 `.claude-plugin/plugin.json` 文件（插件格式）

#### 单 skill 仓库

如果仓库根目录本身就是一个 skill（根目录有 `SKILL.md`），且没有检测到子目录 skill，则整个仓库视为单 skill，`source_url` 指向仓库根路径。

#### Skill 名称与描述

- **名称**：从 skill 目录名生成（kebab-case → Title Case）
- **描述**：使用仓库的 `description` 字段（同仓库内所有 skill 共享）

> 注：不使用 Contents API 获取 SKILL.md 内容，避免大量 API 调用。目录名 + 仓库 description 已满足展示需求。

### 3. 自动分类

基于仓库 `topics[]` 和 `description` 关键词匹配（分类继承自仓库，同仓库内所有 skill 共享分类）：

| 关键词 | 分类 |
|--------|------|
| browser, automation, playwright, puppeteer | browser-automation |
| security, audit, vulnerability, pentest | security |
| devops, deploy, infra, docker, kubernetes | devops |
| marketing, seo, ads, advertising | marketing |
| database, sql, postgres, mongo | database |
| git, github, pr, code-review | development |
| ai, llm, agent, model | ai-assistant |
| 以上都不匹配 | general |

### 4. 排序与截取

1. 按仓库 `stargazers_count` 降序，同星数按 skill 名称字母序
2. **截取前 300 条**（`MAX_SKILLS = 300`），避免输出过大

### 5. 输出

生成 `featured-skills.json`，**向前兼容现有数据结构**：

```json
{
  "updated_at": "2026-03-19T00:00:00Z",
  "total": 300,
  "categories": ["general", "browser-automation", "security", "devops", ...],
  "skills": [
    {
      "slug": "commit",
      "name": "Conventional Commit",
      "summary": "Generate conventional commit messages...",
      "downloads": 0,
      "stars": 96000,
      "category": "development",
      "tags": ["claude-code-skill", "git", "commit"],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/commit",
      "updated_at": "2026-03-17T15:10:09Z"
    }
  ]
}
```

#### 向前兼容策略

新格式**必须保留现有字段**，确保后端 `FeaturedSkillRaw` 和前端 `FeaturedSkillDto` 无需任何改动即可解析新数据：

| 字段 | 现有 | 新版 | 兼容处理 |
|------|------|------|----------|
| `slug` | ✅ | ✅ | 不变 |
| `name` | ✅ | ✅ | 不变 |
| `summary` | ✅ | ✅ | 不变 |
| `downloads` | ✅ | ✅ | **保留，固定为 0**（无真实数据源） |
| `stars` | ✅ | ✅ | 填入 GitHub 真实 star 数 |
| `source_url` | ✅ | ✅ | 精确到 skill 目录的路径 |
| `category` | ❌ | ✅ 新增 | 后端 `#[serde(default)]` 自动忽略未知字段 |
| `tags` | ❌ | ✅ 新增 | 同上 |
| `updated_at`（skill 级） | ❌ | ✅ 新增 | 同上 |

**结论**：脚本输出格式升级后，后端和前端代码**零改动**即可正常工作。

#### 字段说明

- `slug`：skill 目录名（单 skill 仓库则为仓库名）
- `name`：基于 skill 目录名生成（kebab-case → Title Case）
- `summary`：仓库 `description`（同仓库内所有 skill 共享）
- `downloads`：固定为 `0`（向前兼容，无真实数据源）
- `stars`：所属仓库的 GitHub star 数
- `category`：基于仓库 topics/description 的自动分类结果
- `tags`：仓库 `topics[]`（最多取 5 个）
- `source_url`：**精确到 skill 目录的 GitHub URL**，格式为 `https://github.com/{owner}/{repo}/tree/{branch}/{skill-path}`；单 skill 仓库则为 `https://github.com/{owner}/{repo}`
- `updated_at`：仓库最后更新时间

## API 用量估算

| 阶段 | API | 请求数 | 说明 |
|------|-----|--------|------|
| 获取仓库元数据 | Repos API | 7 | 每个精选仓库 1 次 |
| 获取目录树 | Git Trees API | 7 | 每个仓库 1 次 |
| **合计** | | **14** | |

对比旧方案（Topic 搜索）的 ~412 次请求，新方案仅需 14 次，**几乎不可能触发速率限制**。

GitHub API 限额（已认证）：5000 次/小时。即使未认证（60 次/小时）也完全够用，但仍建议使用 token 以确保稳定性。

## GitHub Actions 配置

保持现有 `.github/workflows/update-featured-skills.yml` 不变：

```yaml
- name: Fetch featured skills
  run: node scripts/fetch-featured-skills.mjs
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```

## Skills Hub 应用端适配

**后端和前端代码无需任何改动**（向前兼容）：

- `FeaturedSkillRaw` / `FeaturedSkillDto` 结构体不变
- 新增的 `category`、`tags`、`updated_at` 等字段被 serde 自动忽略
- 内嵌 fallback（`featured-skills.json`）随脚本运行自动更新

### 后续可选增强（独立需求）

1. 后端 DTO 新增 `category`、`tags` 字段以支持前端展示
2. 探索页面增加按分类筛选
3. 排序改为按星数排序

## 技术要点

- **精选仓库列表**：质量可控，新增仓库只需编辑 `CURATED_REPOS` 数组
- **极低 API 用量**：14 次请求 vs 旧方案 412 次，无速率限制风险
- **零外部依赖**：仅依赖 GitHub API（公开、稳定、有 SLA）
- **Skill 粒度聚合**：每条记录精确到仓库内具体 skill 目录
- **与应用检测逻辑一致**：skill 扫描规则与 `installer.rs` 保持同步
- **新增插件格式支持**：兼容 `.claude-plugin/plugin.json` 结构
- **数量上限**：最多 300 条，按星数排序取 top
- **项目内维护**：脚本、数据、CI 全部在 skills-desktop-app 仓库内

## 变更清单

| 文件 | 操作 |
|------|------|
| `scripts/fetch-featured-skills.mjs` | 重写（精选仓库列表 + Repos API + Trees API） |
| `featured-skills.json` | 内容更新（精选仓库来源，≤300 条） |
| `docs/requirements/skills-aggregation-repo.md` | 更新需求文档 |
| `.github/workflows/update-featured-skills.yml` | **无需改动** |
| 后端代码 | **无需改动**（向前兼容） |
| 前端代码 | **无需改动**（向前兼容） |


================================================
FILE: docs/releases/v0.4.0/bugfix-language-toggle-loading-overlay.md
================================================
# Bugfix：切换语言时闪现 "Installing Skills..." 弹窗

## 问题描述

在 Explore 页面点击语言切换按钮（EN/中）时，会短暂弹出 "Installing Skills..." 加载遮罩，一两秒后自动消失。

## 根因分析

`invokeTauri` 函数的 `useCallback` 依赖数组包含了 `t`（i18next 翻译函数）：

```ts
const invokeTauri = useCallback(async (...) => {
  if (!isTauri) throw new Error(t('errors.notTauri'))
  ...
}, [isTauri, t])  // ← t 导致级联重建
```

切换语言时的级联链：

1. `i18n.changeLanguage()` → `t` 引用变化
2. `t` 变化 → `invokeTauri` 重新创建（依赖 `t`）
3. `invokeTauri` 变化 → `loadPlan` 重新创建（依赖 `invokeTauri`）
4. `loadPlan` 变化 → `useEffect([isTauri, loadPlan])` 重新触发
5. `loadPlan()` 执行 → `setLoading(true)` → 显示加载弹窗
6. 请求完成 → `setLoading(false)` → 弹窗消失

## 修复方案

将 `invokeTauri` 中的 `t('errors.notTauri')` 替换为硬编码字符串，从依赖数组移除 `t`：

```ts
const invokeTauri = useCallback(async (...) => {
  if (!isTauri) throw new Error('Tauri API is not available')
  ...
}, [isTauri])  // ← 不再依赖 t
```

该错误消息仅在非 Tauri 环境下触发（实际不可能发生），无需翻译。

## 修改文件

- `src/App.tsx`：`invokeTauri` useCallback 依赖数组移除 `t`


================================================
FILE: docs/releases/v0.4.0/plan-in-app-update.md
================================================
# 需求：应用内检查更新（Issue #33）

## Context

来源：https://github.com/qufei1993/skills-hub/issues/33

用户每次跟进版本都需要手动进入 GitHub releases 页面下载，体验不便。需要在软件内支持手动检查更新功能。

## 现状分析

后端 Tauri updater 插件已完全就绪：
- `tauri-plugin-updater` v2 已安装（Cargo.toml + package.json）
- `tauri.conf.json` 已配置更新端点（GitHub releases）+ 公钥签名验证
- `lib.rs` 已注册插件
- i18n 翻译键已全部就绪（EN/ZH）

唯一缺失：前端没有调用更新 API 的 UI。

## 实施方案

在 SettingsModal 底部版本信息区域扩展为"检查更新"功能块：

1. **SettingsModal.tsx** — 添加更新状态管理 + UI
   - 状态：idle → checking → up-to-date / available → downloading → done / error
   - 使用 `@tauri-apps/plugin-updater` 的 `check()` 和 `downloadAndInstall()` API
   - 保存 update 对象引用避免重复请求
   - 弹窗关闭时重置状态

2. **App.css** — 添加更新区块样式
   - 版本号 + 按钮水平排列
   - 更新可用时显示高亮区块
   - 错误/成功状态样式

3. **版本号** — 0.3.0 → 0.3.1

## 涉及文件

| 文件 | 改动 |
|------|------|
| `src/components/skills/modals/SettingsModal.tsx` | 添加更新检查 UI + 逻辑 |
| `src/App.css` | 添加更新区块样式 |
| `package.json` | 版本号 → 0.3.1 |
| `src-tauri/tauri.conf.json` | 版本号 → 0.3.1 |
| `src-tauri/Cargo.toml` | 版本号 → 0.3.1 |


================================================
FILE: docs/releases/v0.4.0/plan-qoderwork-support.md
================================================
# 需求：支持 QoderWork 目录（Issue #34）

## Context

来源：https://github.com/qufei1993/skills-hub/issues/34

QoderWork 是 Qoder 推出的桌面 AI 代理产品，与 Qoder IDE 独立，使用 `~/.qoderwork/skills/` 目录存放技能。当前代码库已支持 Qoder（`.qoder/skills`），但尚未支持 QoderWork。

## 实施方案

参照现有 Qoder 适配器模式，在 3 处添加 QoderWork 支持：

### 1. `src-tauri/src/core/tool_adapters/mod.rs`

- **ToolId 枚举**：在 `Qoder` 之后添加 `QoderWork`
- **as_key() 方法**：添加 `ToolId::QoderWork => "qoderwork"`
- **default_tool_adapters()**：添加 ToolAdapter 实例：
  ```rust
  ToolAdapter {
      id: ToolId::QoderWork,
      display_name: "QoderWork",
      relative_skills_dir: ".qoderwork/skills",
      relative_detect_dir: ".qoderwork",
  },
  ```

### 2. `src/i18n/resources.ts`

- 英文 tools 对象：添加 `qoderwork: 'QoderWork'`
- 中文 tools 对象：添加 `qoderwork: 'QoderWork'`

## 验证

- `npm run check` 确保 lint、build、Rust clippy/test 全部通过


================================================
FILE: docs/releases/v0.4.0/plan-settings-page.md
================================================
# 需求：设置弹窗改为独立页面

## Context

设置功能原来是一个 560px 宽的模态弹窗（SettingsModal），在小窗口下容易被遮挡，需要最大化窗口才能完整查看。将其改为 `activeView` 视图系统中的独立页面，与 myskills/explore/detail 并列，UX 更自然。

## 实施方案

### 1. 组件迁移：`modals/SettingsModal.tsx` → `SettingsPage.tsx`

- 移动到 `src/components/skills/SettingsPage.tsx`，与 `ExplorePage`、`SkillDetailView` 同级
- 类型名 `SettingsModalProps` → `SettingsPageProps`
  - 删除 `open: boolean`
  - `onRequestClose` → `onBack`
- 去掉 modal 外壳（`modal-backdrop` / `modal` / `modal-header` / `modal-footer`）
- 复用 `detail-header` + `detail-back-btn` 样式，与 SkillDetailView 保持一致
- useEffect 从依赖 `open` 改为挂载/卸载模式
- 删除 `if (!open) return null` 守卫
- 删除底部 "Done" 按钮

### 2. `App.tsx` — 状态和路由

- `activeView` 类型扩展为 `'myskills' | 'explore' | 'detail' | 'settings'`
- 删除 `showSettingsModal` 布尔状态
- `handleOpenSettings` 改为 `setActiveView('settings')`
- `handleCloseSettings` 改为 `setActiveView('myskills')`
- `<main>` 条件渲染新增 `settings` 分支，渲染 `<SettingsPage>`
- 删除底部的 `<SettingsModal>` 渲染块

### 3. `Header.tsx` — 导航状态

- `activeView` 类型加 `| 'settings'`
- 设置齿轮按钮在 `activeView === 'settings'` 时添加 `active` 样式

### 4. `App.css` — 样式调整

- 删除 `.settings-modal` 和 `.settings-body` 规则
- 新增 `.settings-page`（居中布局）和 `.settings-page-body`（560px 最大宽度，居中）
- 复用 `.detail-header` / `.detail-back-btn` / `.detail-skill-name` 样式
- 所有 `.settings-field` 等子样式保持不变

### 不需要改动

- **i18n**：复用已有的 `detail.back`、`settings` key
- **Rust 后端**：纯前端改动
- **types.ts**：无 DTO 变更


================================================
FILE: docs/releases/v0.4.0/skills-aggregation-repo.md
================================================
# 需求：Skills 聚合数据源升级 — 精选仓库列表方案

## 背景

Skills Hub 应用的"探索"功能依赖 `featured-skills.json` 提供精选技能列表。早期方案通过 GitHub Search API 搜索 `claude-code-skill` 等 topic 标签自动发现仓库，但属于盲目搜索，质量不可控，噪音多。

**新方案**：维护一份精选仓库列表（Curated Repos），直接从已知的高质量仓库中获取 skills。质量可控、API 调用极少、维护简单。

## 目标

重写 `scripts/fetch-featured-skills.mjs` 脚本，从精选仓库列表直接获取元数据并深入检测 skill 目录结构，为每个 skill 生成独立条目，最终输出 `featured-skills.json`（最多 300 条）。保持现有的 GitHub Actions 定时更新机制不变。

## 架构（保持不变）

```
skills-desktop-app/
├── featured-skills.json                          # 精选技能数据（应用内嵌 fallback + 在线更新源）
├── scripts/
│   └── fetch-featured-skills.mjs                 # 聚合脚本（需重写）
└── .github/workflows/
    └── update-featured-skills.yml                # 每日定时运行（保持不变）
```

## 数据源 — 精选仓库列表

从 GitHub Topic 盲目搜索改为直接指定高质量仓库：

| 仓库 | Stars | 说明 |
|------|-------|------|
| `anthropics/skills` | ~96k | Anthropic 官方 Agent Skills |
| `sickn33/antigravity-awesome-skills` | ~24.7k | 1000+ 社区 skills 集合 |
| `K-Dense-AI/claude-scientific-skills` | ~15.3k | 170+ 科学研究 skills |
| `travisvn/awesome-claude-skills` | ~9.1k | 精选 Claude skills 列表 |
| `VoltAgent/awesome-agent-skills` | ~8.4k | 500+ Agent skills |
| `anthropics/knowledge-work-plugins` | ~7.7k | 官方知识工作插件 |
| `alirezarezvani/claude-skills` | ~5.2k | 192+ 社区 skills |

列表定义在脚本顶部 `CURATED_REPOS` 常量中，新增/移除仓库只需编辑此数组。

## 脚本重写逻辑

### 1. 数据采集（仓库元数据）

通过 GitHub Repos API 逐个获取精选仓库的元数据：

```
GET /repos/{owner}/{repo}
```

返回：`full_name`, `description`, `stargazers_count`, `topics[]`, `updated_at`, `html_url`, `default_branch`

认证：**必须**使用环境变量 `GITHUB_TOKEN`，脚本启动时校验。

失败处理：获取失败的仓库跳过（打印警告），不影响其余仓库。

### 2. Skill 检测（仓库内深入扫描）

使用 GitHub Git Trees API 获取仓库目录结构（单次请求，`recursive=1`）：

```
GET /repos/{owner}/{repo}/git/trees/{default_branch}?recursive=1
```

#### Skill 目录扫描规则（与应用端 `installer.rs` 保持一致）

扫描以下基础路径下的子目录：

```
skills/
skills/.curated/
skills/.experimental/
skills/.system/
.claude/skills/
```

以及**根目录的直接子目录**（排除 `skills/`、`.claude/`、`.git/` 等特殊目录）。

#### 新增：`.claude-plugin/plugin.json` 检测

为兼容 `anthropics/knowledge-work-plugins` 等使用插件格式的仓库，增加检测规则：

- 根级子目录包含 `.claude-plugin/plugin.json` 文件 → 视为有效 skill

#### Skill 判定条件

一个目录被视为有效 skill，需满足以下任一条件：
- 目录内存在 `SKILL.md` 文件
- 目录位于 `.claude/skills/` 路径下（即使没有 `SKILL.md`）
- 目录内存在 `.claude-plugin/plugin.json` 文件（插件格式）

#### 单 skill 仓库

如果仓库根目录本身就是一个 skill（根目录有 `SKILL.md`），且没有检测到子目录 skill，则整个仓库视为单 skill，`source_url` 指向仓库根路径。

#### Skill 名称与描述

- **名称**：从 skill 目录名生成（kebab-case → Title Case）
- **描述**：使用仓库的 `description` 字段（同仓库内所有 skill 共享）

> 注：不使用 Contents API 获取 SKILL.md 内容，避免大量 API 调用。目录名 + 仓库 description 已满足展示需求。

### 3. 自动分类

基于仓库 `topics[]` 和 `description` 关键词匹配（分类继承自仓库，同仓库内所有 skill 共享分类）：

| 关键词 | 分类 |
|--------|------|
| browser, automation, playwright, puppeteer | browser-automation |
| security, audit, vulnerability, pentest | security |
| devops, deploy, infra, docker, kubernetes | devops |
| marketing, seo, ads, advertising | marketing |
| database, sql, postgres, mongo | database |
| git, github, pr, code-review | development |
| ai, llm, agent, model | ai-assistant |
| 以上都不匹配 | general |

### 4. 排序与截取

1. 按仓库 `stargazers_count` 降序，同星数按 skill 名称字母序
2. **截取前 300 条**（`MAX_SKILLS = 300`），避免输出过大

### 5. 输出

生成 `featured-skills.json`，**向前兼容现有数据结构**：

```json
{
  "updated_at": "2026-03-19T00:00:00Z",
  "total": 300,
  "categories": ["general", "browser-automation", "security", "devops", ...],
  "skills": [
    {
      "slug": "commit",
      "name": "Conventional Commit",
      "summary": "Generate conventional commit messages...",
      "downloads": 0,
      "stars": 96000,
      "category": "development",
      "tags": ["claude-code-skill", "git", "commit"],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/commit",
      "updated_at": "2026-03-17T15:10:09Z"
    }
  ]
}
```

#### 向前兼容策略

新格式**必须保留现有字段**，确保后端 `FeaturedSkillRaw` 和前端 `FeaturedSkillDto` 无需任何改动即可解析新数据：

| 字段 | 现有 | 新版 | 兼容处理 |
|------|------|------|----------|
| `slug` | ✅ | ✅ | 不变 |
| `name` | ✅ | ✅ | 不变 |
| `summary` | ✅ | ✅ | 不变 |
| `downloads` | ✅ | ✅ | **保留，固定为 0**（无真实数据源） |
| `stars` | ✅ | ✅ | 填入 GitHub 真实 star 数 |
| `source_url` | ✅ | ✅ | 精确到 skill 目录的路径 |
| `category` | ❌ | ✅ 新增 | 后端 `#[serde(default)]` 自动忽略未知字段 |
| `tags` | ❌ | ✅ 新增 | 同上 |
| `updated_at`（skill 级） | ❌ | ✅ 新增 | 同上 |

**结论**：脚本输出格式升级后，后端和前端代码**零改动**即可正常工作。

#### 字段说明

- `slug`：skill 目录名（单 skill 仓库则为仓库名）
- `name`：基于 skill 目录名生成（kebab-case → Title Case）
- `summary`：仓库 `description`（同仓库内所有 skill 共享）
- `downloads`：固定为 `0`（向前兼容，无真实数据源）
- `stars`：所属仓库的 GitHub star 数
- `category`：基于仓库 topics/description 的自动分类结果
- `tags`：仓库 `topics[]`（最多取 5 个）
- `source_url`：**精确到 skill 目录的 GitHub URL**，格式为 `https://github.com/{owner}/{repo}/tree/{branch}/{skill-path}`；单 skill 仓库则为 `https://github.com/{owner}/{repo}`
- `updated_at`：仓库最后更新时间

## API 用量估算

| 阶段 | API | 请求数 | 说明 |
|------|-----|--------|------|
| 获取仓库元数据 | Repos API | 7 | 每个精选仓库 1 次 |
| 获取目录树 | Git Trees API | 7 | 每个仓库 1 次 |
| **合计** | | **14** | |

对比旧方案（Topic 搜索）的 ~412 次请求，新方案仅需 14 次，**几乎不可能触发速率限制**。

GitHub API 限额（已认证）：5000 次/小时。即使未认证（60 次/小时）也完全够用，但仍建议使用 token 以确保稳定性。

## GitHub Actions 配置

保持现有 `.github/workflows/update-featured-skills.yml` 不变：

```yaml
- name: Fetch featured skills
  run: node scripts/fetch-featured-skills.mjs
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```

## Skills Hub 应用端适配

**后端和前端代码无需任何改动**（向前兼容）：

- `FeaturedSkillRaw` / `FeaturedSkillDto` 结构体不变
- 新增的 `category`、`tags`、`updated_at` 等字段被 serde 自动忽略
- 内嵌 fallback（`featured-skills.json`）随脚本运行自动更新

### 后续可选增强（独立需求）

1. 后端 DTO 新增 `category`、`tags` 字段以支持前端展示
2. 探索页面增加按分类筛选
3. 排序改为按星数排序

## 技术要点

- **精选仓库列表**：质量可控，新增仓库只需编辑 `CURATED_REPOS` 数组
- **极低 API 用量**：14 次请求 vs 旧方案 412 次，无速率限制风险
- **零外部依赖**：仅依赖 GitHub API（公开、稳定、有 SLA）
- **Skill 粒度聚合**：每条记录精确到仓库内具体 skill 目录
- **与应用检测逻辑一致**：skill 扫描规则与 `installer.rs` 保持同步
- **新增插件格式支持**：兼容 `.claude-plugin/plugin.json` 结构
- **数量上限**：最多 300 条，按星数排序取 top
- **项目内维护**：脚本、数据、CI 全部在 skills-desktop-app 仓库内

## 变更清单

| 文件 | 操作 |
|------|------|
| `scripts/fetch-featured-skills.mjs` | 重写（精选仓库列表 + Repos API + Trees API） |
| `featured-skills.json` | 内容更新（精选仓库来源，≤300 条） |
| `docs/requirements/skills-aggregation-repo.md` | 更新需求文档 |
| `.github/workflows/update-featured-skills.yml` | **无需改动** |
| 后端代码 | **无需改动**（向前兼容） |
| 前端代码 | **无需改动**（向前兼容） |


================================================
FILE: docs/releases/v0.4.1/plan-frontmatter-table.md
================================================
# Plan: Skill 详情页 Frontmatter 元数据表格展示

## Context
当前 `SkillDetailView` 使用 `remarkFrontmatter` 插件，该插件只是让 react-markdown 忽略 YAML frontmatter（不报错），但不会渲染它。用户希望像 GitHub 一样，将 frontmatter 中的字段以表格形式展示在 markdown 内容顶部。

## 修改方案

### 仅需修改 1 个文件
**`src/components/skills/SkillDetailView.tsx`** — `FileContentRenderer` 组件

### 实现步骤

1. **添加 frontmatter 解析函数** — 在 `FileContentRenderer` 中，对 markdown 文件的 content 进行简单的 YAML frontmatter 提取：
   - 检测 `---` 开头和结束标记
   - 逐行解析 `key: value` 对，得到 `Record<string, string>`
   - 分离出 frontmatter 数据和剩余的 markdown body

2. **渲染 frontmatter 表格** — 在 `<Markdown>` 组件之前，如果存在 frontmatter 数据，渲染一个 HTML 表格：
   - 表头为 frontmatter 的 key（如 name, description, license）
   - 表体为对应的 value
   - 复用现有的 `.markdown-body table/th/td` 样式（已在 App.css 中定义）

3. **传递剩余内容给 Markdown** — 将去除 frontmatter 后的 body 传给 `<Markdown>` 组件，同时保留 `remarkFrontmatter` 插件（作为安全兜底）

### 不需要的改动
- 不需要安装新依赖（不用 `gray-matter` 等库，简单的字符串解析即可）
- 不需要修改后端
- 不需要新增 CSS（已有 table 样式）
- 不需要 i18n（表头直接使用 frontmatter 的 key 名）

## 验证
- `npm run check` 通过
- 打开一个包含 frontmatter 的 skill（如 SKILL.md），确认顶部显示元数据表格，下方正常渲染 markdown 内容
- 打开没有 frontmatter 的文件，确认不会显示表格，渲染正常


================================================
FILE: docs/releases/v0.4.2/bugfix-new-tools-modal-style.md
================================================
# Bugfix：首次安装后打开时"检测到新工具"弹窗样式异常

## 问题描述

安装后第一次打开 Skills Hub，"New tools detected"（检测到新工具）弹窗的样式与其他弹窗不一致：标题文字紧贴弹窗边框顶部，操作按钮缺少内边距和分隔线。

## 根因分析

`NewToolsModal` 的 DOM 结构与项目其他弹窗不一致：

```tsx
// 修复前（错误结构）
<div className="modal">
  <div className="modal-title">...</div>   // 无 padding，贴顶
  <div className="modal-body">...</div>
  <div className="modal-actions">...</div> // 只有 margin-top，无 padding
</div>
```

- `.modal-title` 本身只有 `font-size` / `font-weight` / `color`，依赖 `.modal-header` 提供 `padding: 16px 20px` 和 `border-bottom`
- `.modal-actions` 只有 `margin-top: 16px`，没有水平和底部内边距，按钮会贴近弹窗边缘
- 缺少 `role="dialog"` 和 `aria-modal="true"` 无障碍属性

## 修复方案

将结构统一为与其他弹窗一致的 `.modal-header` + `.modal-footer` 模式：

```tsx
// 修复后（正确结构）
<div className="modal" role="dialog" aria-modal="true">
  <div className="modal-header">
    <div className="modal-title">...</div>  // padding: 16px 20px + border-bottom
  </div>
  <div className="modal-body">...</div>
  <div className="modal-footer">...</div>   // padding: 16px 20px + border-top
</div>
```

## 修改文件

- `src/components/skills/modals/NewToolsModal.tsx`：补充 `.modal-header` 包裹标题，将 `.modal-actions` 改为 `.modal-footer`，新增 `role`/`aria-modal` 属性


================================================
FILE: docs/releases/v0.4.2/bugfix-root-skill-install-false-exists.md
================================================
# Bugfix：从探索页安装根目录级 Skill 时误报"已存在于 Hub"

## 问题描述

在探索页搜索并点击安装某个 Skill（如 `titanwings/colleague-skill`）时，弹出错误提示：

> 「.」已存在于 Hub，可前往"我的 Skills"中更新。

实际上该 Skill 从未安装过。

## 根因分析

`titanwings/colleague-skill` 是一个**根目录级 Skill**，即 `SKILL.md` 位于仓库根目录。`list_git_skills` 为此类 Skill 返回的候选项中 `subpath = "."`。

`install_git_skill_from_selection` 在推导 `display_name` 时，直接对 subpath 做字符串处理：

```rust
// 修复前
let mut display_name = name.unwrap_or_else(|| {
    subpath
        .rsplit('/')
        .next()
        .map(|s| s.to_string())
        .unwrap_or_else(|| derive_name_from_repo_url(&parsed.clone_url))
});
```

当 `subpath = "."` 时，`rsplit('/').next()` 返回 `"."`，导致：

- `display_name = "."`
- `central_path = central_dir.join(".") = central_dir`（即中央仓库目录本身）
- `central_path.exists()` 永远为 `true`
- 触发错误：`skill already exists in central repo: /path/to/central/.`

前端 `formatErrorMessage` 从路径中提取名称时调用 `.split('/').pop()` 得到 `"."`，最终显示「.」已存在于 Hub。

## 修复方案

当 `subpath == "."` 时，改为从 repo URL 推导初始名称，后续逻辑会继续用 `SKILL.md` 中的名称做最终重命名：

```rust
// 修复后
let mut display_name = name.unwrap_or_else(|| {
    if subpath == "." {
        derive_name_from_repo_url(&parsed.clone_url)
    } else {
        subpath
            .rsplit('/')
            .next()
            .map(|s| s.to_string())
            .unwrap_or_else(|| derive_name_from_repo_url(&parsed.clone_url))
    }
});
```

## 修改文件

- `src-tauri/src/core/installer.rs`：`install_git_skill_from_selection` 函数中对 `subpath == "."` 单独处理，避免用 `"."` 作为 skill 名称


================================================
FILE: docs/releases/v0.4.3/add-copaw-support.md
================================================
# 新增：支持 Copaw 工具

> 贡献者：[@LeonDevLifeLog](https://github.com/LeonDevLifeLog)，PR [qufei1993/skills-hub#50](https://github.com/qufei1993/skills-hub/pull/50)

## 更新内容

新增对 [CoPaw](https://github.com/agentscope-ai/CoPaw) 的支持。CoPaw 是 AgentScope 出品的 AI 个人助理，支持多端接入（钉钉、飞书、微信、Discord 等）、技能扩展与多智能体协作。

安装 skill 后，Skills Hub 可自动将其同步到 CoPaw 的本地技能池。

## 技术细节

CoPaw 的技能池路径与大多数工具不同，使用 `skill_pool` 而非 `skills`：

| 字段 | 值 |
|------|-----|
| Tool ID | `copaw` |
| 显示名称 | Copaw |
| 技能目录 | `~/.copaw/skill_pool/` |
| 检测目录 | `~/.copaw/` |

## 修改文件

- `src-tauri/src/core/tool_adapters/mod.rs`：新增 `ToolId::Copaw` 枚举变体及对应的 `ToolAdapter`
- `README.md`：工具支持列表新增 Copaw
- `docs/README.zh.md`：同步更新中文版工具支持列表


================================================
FILE: docs/releases/v0.4.3/bugfix-github-install-and-frontmatter.md
================================================
# Bugfix：优化 GitHub Skill 安装速度并修复多行 Frontmatter 渲染

## 问题 1：从 GitHub 仓库安装 Skill 很慢并最终超时

### 问题描述

从 GitHub 仓库安装某些 Skill 时，安装弹窗会长时间停留在加载状态，最后超时失败。典型表现：

- 弹窗持续显示「正在安装技能...」
- 日志提示正在执行文件/网络操作
- GitHub 网络较慢或仓库文件较多时更容易复现

### 根因分析

对于形如 `https://github.com/owner/repo/tree/branch/path` 的 GitHub 子目录 URL，原逻辑会优先使用 GitHub Contents API 递归下载目录。

该方式的问题是：

- 需要按目录递归请求 GitHub API
- 文件下载是串行 HTTP 请求
- 文件较多时请求数量快速增加
- API 下载失败后还会 fallback 到 `git clone`，导致慢路径被走两遍

因此在网络不稳定或仓库较大时，用户会看到长时间转圈后超时。

### 修复方案

新增 `clone_or_pull_sparse`，对 GitHub 子目录安装优先使用系统 `git` 执行浅克隆 + 稀疏检出：

```bash
git clone --depth 1 --filter=blob:none --sparse --no-tags ...
git sparse-checkout set --no-cone <subpath>
```

这样只检出目标 Skill 子目录，避免下载整个仓库或逐文件调用 GitHub API。

修复后流程：

- 子目录 GitHub URL：优先走 sparse checkout
- sparse checkout 失败：再 fallback 到 GitHub Contents API
- 更新已安装 Skill：如果记录了 `source_subpath`，同样优先走 sparse checkout
- 缓存 key 加入 `subpath`，避免不同子目录复用同一个稀疏工作区造成冲突

### 影响范围

该优化主要改善精确到子目录的安装链接，例如：

```text
https://github.com/anthropics/skills/tree/main/skills/frontend-design
```

如果用户输入的是仓库根 URL，应用仍需要先扫描仓库中的 Skill 候选项，该场景仍可能触发完整浅克隆。

## 问题 2：搜索/手动添加无法处理非标准 Skill 容器目录

### 问题描述

从探索页在线搜索安装 `technical-writer` 时，搜索结果来自 `skills.sh`：

```json
{
  "name": "technical-writer",
  "skillId": "technical-writer",
  "source": "shubhamsaboo/awesome-llm-apps"
}
```

前端只能拿到仓库根地址：

```text
https://github.com/Shubhamsaboo/awesome-llm-apps
```

实际 Skill 位于：

```text
awesome_agent_skills/technical-writer/SKILL.md
```

原扫描逻辑只识别固定目录（如 `skills/*`、`.claude/skills/*`）和根目录直接子目录，无法发现 `awesome_agent_skills/*` 这种容器目录下的 Skill，导致搜索安装失败或回退到错误提示。

手动添加也存在类似问题：如果输入容器目录链接，例如：

```text
https://github.com/Shubhamsaboo/awesome-llm-apps/blob/main/awesome_agent_skills
```

原逻辑会尝试把整个容器目录当成 Skill 安装，导致 Hub 中出现大量子目录而不是一个有效 Skill。

### 根因分析

问题分为两层：

- 搜索结果只提供仓库根 `source`，不包含实际 Skill 文件夹路径
- 后端发现逻辑依赖目录白名单，无法覆盖 `awesome_agent_skills`、`agent-skills`、`custom-agent-skills` 等变体
- 手动 `tree/blob` 子路径绕过候选发现，直接调用安装命令，因此容器目录不会进入 picker
- 安装入口缺少最终校验，子路径存在但不是有效 Skill 目录时也可能被复制进 Hub

### 修复方案

将 Git Skill 发现改为分层模型，避免继续堆具体目录名白名单：

1. 固定目录快速扫描：
   - `skills/*`
   - `skills/.curated/*`
   - `skills/.experimental/*`
   - `skills/.system/*`
   - `.claude/skills/*`
2. 根目录直接 Skill：
   - `repo/my-skill/SKILL.md`
3. 根目录 Skill 容器：
   - 只扫描根目录下名称包含 `skill` 的容器目录的一层子目录
   - 示例：`repo/awesome_agent_skills/technical-writer/SKILL.md`
   - 示例：`repo/custom-agent-skills/python-expert/SKILL.md`

该方案不是全仓库递归扫描，只多扫一层 `*skill*` 容器目录，性能可控。

同时调整手动添加流程：

- `tree/blob` 路径先调用 `list_git_skills_cmd` 做候选发现
- 路径本身是 Skill：返回 1 个候选并自动安装
- 路径是 Skill 容器：列出容器下一层候选，单个自动安装，多个弹 picker
- 完全找不到 Skill：才提示未找到可导入 Skill

并在安装入口增加最终校验：

- 复制源必须是有效 Skill 目录
- 有 `SKILL.md`，或是允许的 `.claude/skills/*` 目录
- 容器目录本身没有 `SKILL.md` 时，拒绝安装并提示粘贴具体 Skill 文件夹链接

另外保留对 `blob/.../SKILL.md` 的规范化：

```text
.../blob/main/awesome_agent_skills/technical-writer/SKILL.md
```

会转换为：

```text
awesome_agent_skills/technical-writer
```

## 问题 3：`description: |` 只渲染出一个 `|`

### 问题描述

部分 `SKILL.md` 使用 YAML block scalar 写多行描述：

```yaml
---
name: technical-writer
description: |
  Creates clear documentation, API references, guides, and
  technical content for developers and users.
author: awesome-llm-apps
---
```

详情页 Frontmatter 表格中只显示 `|`，后面的描述内容没有显示。

### 根因分析

前端详情页的 `parseFrontmatter` 和后端 `parse_skill_md` 都只支持简单的 `key: value` 单行解析。

当遇到 `description: |` 时：

- `description` 被解析成字面量 `|`
- 后续缩进的多行文本没有关联到 `description`
- 后端存入数据库的描述也可能变成 `|`

### 修复方案

前端和后端同时支持 YAML block scalar：

- `description: |`：保留换行，适合多行描述
- `description: >`：折叠为单段文本，适合普通段落

同时调整 Markdown 表格样式：

- `td` 使用 `white-space: pre-wrap` 保留多行文本
- 单元格顶部对齐
- 长文本允许换行，避免撑破布局

## 验证

已完成以下验证：

- `npm run build` 通过
- `cargo test -q` 通过，`79 passed`
- `cargo fmt --all -- --check` 通过
- 新增 Rust 测试覆盖 `description: |` 解析
- 新增 Rust 测试覆盖 `blob/.../SKILL.md` 路径规范化
- 新增 Rust 测试覆盖 `*skill*` 容器目录发现、非 skill 容器跳过、候选去重
- 新增 Rust 测试覆盖容器目录拒绝安装、容器下具体子 Skill 可安装
- 使用真实 GitHub 仓库验证 sparse checkout 可在约 2 秒内检出目标子目录

## 修改文件

- `src-tauri/src/core/git_fetcher.rs`：新增 `clone_or_pull_sparse`
- `src-tauri/src/core/installer.rs`：GitHub 子目录安装和更新优先使用 sparse checkout；补充 block scalar 解析；新增分层 Skill 发现和安装前校验
- `src-tauri/src/core/github_download.rs`：避免将根目录 `.` 走 GitHub Contents API 子目录下载路径
- `src-tauri/src/core/tests/git_fetcher.rs`：新增 sparse checkout 测试
- `src-tauri/src/core/tests/installer.rs`：新增 `description: |`、路径规范化、分层发现、容器目录校验相关测试
- `src/App.tsx`：手动 `tree/blob` 路径改为先发现候选，再自动安装或弹出选择器
- `src/components/skills/SkillDetailView.tsx`：前端 Frontmatter 解析支持 `|` 和 `>`
- `src/App.css`：修复 Frontmatter 表格中多行描述的展示样式


================================================
FILE: docs/releases/v0.5.0/implementation-plan.md
================================================
# 项目级 Skill 同步功能实现计划

## Context

Skills Hub v0.4.x 只有全局同步。Skill 安装到中央仓库 `~/.skillshub/` 后，再同步到各工具的全局 Skills 目录。

v0.5.0 增加项目级同步能力：同一个 Skill 可以选择同步到全局，或同步到一个或多个项目目录下的工具 Skills 目录。

当前实现已经从原始方案做过几轮交互收敛，本计划按最新代码实现记录。

---

## 已确认的产品规则

### 1. 安装流程不变

Skill 仍然只安装到中央仓库：

```text
~/.skillshub/<skill-name>/
```

全局 / 项目只影响同步目标路径。

### 2. Scope 是 Skill 级别设置

每个 Skill 当前只有一个主要 scope：

```text
global | project
```

工具按钮不单独配置 scope，只控制该工具是否参与当前 scope 的同步。

### 3. 切换 scope 后默认同步当前已安装工具

切换范围时，以 `get_tool_status().installed` 返回的当前已安装工具为准：

- 全局 → 项目：同步到所选项目下所有当前已安装工具。
- 项目 → 全局：同步到所有当前已安装工具的全局目录。

不能把系统支持的全部工具展示出来，也不能根据历史同步过的工具推断同步范围。

### 4. 工具按钮样式不区分 scope

工具按钮只表达同步状态：

- active：已同步
- inactive：未同步

项目级状态通过范围徽标表达，例如 `1 个项目`。项目级工具按钮不使用蓝色样式。

### 5. 项目列表是草稿态

同步范围弹窗中的项目目录列表在点击“应用”前都是草稿：

- 添加项目后点取消，不保存、不统计、不同步。
- 删除项目后点取消，不解除同步。
- 只有点击应用后，才提交最终项目列表。

切换到项目范围时，必须至少选择一个项目目录才能应用。

---

## 1. 数据库迁移

**文件**：`src-tauri/src/core/skill_store.rs`

### Schema

`SCHEMA_VERSION` 升级到 4。

`skill_targets` 新增：

```sql
scope TEXT NOT NULL DEFAULT 'global',
project_path TEXT NULL
```

唯一索引：

```sql
CREATE UNIQUE INDEX idx_skill_targets_unique_scope
ON skill_targets(skill_id, tool, scope, COALESCE(project_path, ''));
```

### 迁移规则

V3 → V4 使用重建表迁移：

1. 创建 `skill_targets_new`
2. 复制旧表数据，旧记录统一写为：

   ```text
   scope = 'global'
   project_path = NULL
   ```

3. 删除旧表
4. 重命名新表
5. 创建新的唯一索引

### Rust 结构

`SkillTargetRecord` 增加：

```rust
pub scope: String,
pub project_path: Option<String>,
```

相关方法签名调整：

```rust
get_skill_target(skill_id, tool, scope, project_path)
delete_skill_target(skill_id, tool, scope, project_path)
```

### 兼容性

老用户升级后，既有全局同步记录会保留，并被识别为全局 scope。不会影响原有全局同步状态。

---

## 2. Tool Adapter 扩展

**文件**：`src-tauri/src/core/tool_adapters/mod.rs`

### 新增函数

```rust
resolve_project_path(adapter, project_root)
supports_project_scope(adapter)
project_relative_skills_dir(adapter)
adapters_sharing_project_skills_dir(adapter)
```

### 当前实现规则

- `supports_project_scope()` 当前返回 `true`。
- UI 不根据支持矩阵展示全部工具，只展示当前已安装工具。
- 项目路径不直接复用全局 `relative_skills_dir`，而是先走 `project_relative_skills_dir()` 的显式映射。
- 未显式映射的工具回退到 adapter 自身的 `relative_skills_dir`。

### 关键路径映射

| 工具 | 项目级路径 |
|------|------------|
| Cursor | `.agents/skills` |
| Codex | `.agents/skills` |
| OpenCode | `.agents/skills` |
| Gemini CLI | `.agents/skills` |
| GitHub Copilot | `.agents/skills` |
| Amp | `.agents/skills` |
| Kimi Code CLI | `.agents/skills` |
| Antigravity | `.agents/skills` |
| Cline | `.agents/skills` |
| Claude Code | `.claude/skills` |
| OpenClaw | `skills` |
| Windsurf | `.windsurf/skills` |
| Qwen Code | `.qwen/skills` |

完整映射以 `project_relative_skills_dir()` 为准。

### 共享目录

项目级同步会按项目路径分组：

```rust
adapters_sharing_project_skills_dir(adapter)
```

共享同一目录的工具只写一份文件系统目标，但会为当前已安装的共享工具写入各自的 `skill_targets` 记录。

---

## 3. 后端命令

**文件**：`src-tauri/src/commands/mod.rs`

### DTO

`ToolInfoDto` 增加：

```rust
supports_project_scope: bool
```

`SkillTargetDto` 增加：

```rust
scope: String,
project_path: Option<String>,
```

### `sync_skill_to_tool`

新增可选参数：

```rust
scope: Option<String>,
projectPath: Option<String>,
```

规则：

- `scope` 默认为 `global`。
- 只允许 `global` / `project`。
- `scope = project` 时，`projectPath` 必填，且必须是已存在目录。
- `scope = global` 时继续检查工具是否安装。
- `scope = project` 时使用 `resolve_project_path()` 生成目标目录。
- 如果同 scope / projectPath 下已有有效 target，且目标存在，则幂等返回成功。
- 同步成功后，对共享同一 Skills 目录且当前已安装的工具写入同步记录。

错误前缀沿用：

```text
TARGET_EXISTS|
TOOL_NOT_INSTALLED|
TOOL_NOT_WRITABLE|
```

### `unsync_skill_from_tool`

新增参数同上。

规则：

- 按 `skillId + tool + scope + projectPath` 定位记录。
- 共享目录工具一起更新 DB 记录。
- 文件系统目标只删除一次。
- 全局范围下，如果共享组内没有任何工具已安装，则视为已经无效，直接成功。

### 最近项目

新增命令：

```rust
get_recent_projects()
save_recent_project(projectPath)
```

实现：

- 存储在 settings 表的 `recent_projects_v1`
- JSON 数组
- 新路径插到最前
- 去重
- 最多保留 8 条
- 只在用户点击“应用”提交项目范围后保存

### 命令注册

**文件**：`src-tauri/src/lib.rs`

注册：

```rust
commands::get_recent_projects
commands::save_recent_project
```

---

## 4. 前端类型

**文件**：`src/components/skills/types.ts`

`ManagedSkill.targets` 增加：

```ts
scope: 'global' | 'project' | string
project_path?: string | null
```

`ToolInfoDto` 增加：

```ts
supports_project_scope: boolean
```

---

## 5. 前端 UI

### FilterBar

**文件**：`src/components/skills/FilterBar.tsx`

新增 scope 下拉筛选：

```text
全部 / 全局 / 项目
```

布局要求：

- 靠右，和排序、搜索、刷新同一组。
- 下拉样式参考排序按钮。
- 不显示额外“范围”文案。
- 排序按钮不显示“排序：”前缀。

### SkillCard

**文件**：`src/components/skills/SkillCard.tsx`

新增范围徽标：

```text
全局
N 个项目
```

项目数量从后端真实 `project` target 中统计，不使用弹窗草稿或本地缓存。

工具按钮：

- 只展示当前用户已安装工具。
- active / inactive 样式保持此前一致。
- 不因为项目级 scope 改成蓝色。

### ScopeSyncModal

**文件**：`src/components/skills/modals/ScopeSyncModal.tsx`

新增同步范围弹窗。

文案：

```text
选择这个 Skill 生效的位置。

全局
在所有项目中可用

项目
仅在选择的项目中可用
```

交互：

- radio 切换后直接展示对应内容，不弹额外确认框。
- 项目模式下展示项目目录列表、选择项目目录按钮、最近项目。
- 项目目录列表使用组件内部 `draftProjects`。
- 点击取消丢弃草稿。
- 点击应用调用 `onScopeChange(draftScope, draftProjects)`。
- 项目模式下 `draftProjects.length === 0` 时禁用应用按钮并显示提示。

### App

**文件**：`src/App.tsx`

新增状态：

```ts
scopeFilter
scopeModalSkill
recentProjects
skillScopeState
```

关键逻辑：

- `getSkillScope(skill)` 以后端实际 target 为主，本地缓存只作兜底。
- `getSkillProjects(skill)` 只从后端 project target 统计项目路径。
- `handleScopeChange(nextScope, nextProjects)`：
  - 清理目标 scope 之外的旧 target。
  - 项目 scope 下，同时清理不在最终项目列表中的旧项目 target。
  - 切到项目时，同步到 `nextProjects × installedToolIds`。
  - 切到全局时，同步到 `installedToolIds`。
  - 应用成功后才写入最近项目和本地 scope 缓存。
- `handlePickProject()` 只返回文件夹选择结果，不直接写入 Skill 状态。

---

## 6. i18n

**文件**：`src/i18n/resources.ts`

新增或更新 key：

| Key | EN | ZH |
|-----|----|----|
| `scope.all` | All | 全部 |
| `scope.global` | Global | 全局 |
| `scope.project` | Project | 项目 |
| `scope.globalBadge` | Global | 全局 |
| `scope.projectCount` | `{{count}} projects` | `{{count}} 个项目` |
| `projectSync.title` | Sync Scope | 同步范围 |
| `projectSync.help` | Choose where this Skill is available. | 选择这个 Skill 生效的位置。 |
| `projectSync.globalDesc` | Available in all projects | 在所有项目中可用 |
| `projectSync.projectDesc` | Available only in selected projects | 仅在选择的项目中可用 |
| `projectSync.projectRequired` | Select at least one project directory to apply project scope. | 请至少选择一个项目目录后再应用项目范围。 |

历史确认弹窗相关 key 可保留，但当前交互不再使用。

---

## 7. 关键文件清单

| 文件 | 改动类型 |
|------|----------|
| `src-tauri/src/core/skill_store.rs` | V4 迁移、结构体、查询方法 |
| `src-tauri/src/core/tool_adapters/mod.rs` | 项目路径映射、共享项目目录分组 |
| `src-tauri/src/commands/mod.rs` | 命令参数、DTO、最近项目命令 |
| `src-tauri/src/lib.rs` | 注册新命令 |
| `src/components/skills/types.ts` | DTO 类型更新 |
| `src/components/skills/FilterBar.tsx` | 范围筛选下拉 |
| `src/components/skills/SkillCard.tsx` | 范围徽标、工具展示 |
| `src/components/skills/modals/ScopeSyncModal.tsx` | 新增范围弹窗 |
| `src/App.tsx` | 状态、筛选、切换、同步逻辑 |
| `src/i18n/resources.ts` | 翻译 |
| `src/App.css` | 新增弹窗、范围徽标、筛选样式 |

---

## 8. 验证方式

1. `npm run check` 通过。
2. 旧数据库升级后，旧 `skill_targets` 均为 `scope = global`，`project_path = NULL`。
3. 全局同步一个 Skill，确认工具按钮保持原 active 样式，范围徽标为“全局”。
4. 打开同步范围弹窗，选择“项目”但不选项目时，“应用”不可点。
5. 选择项目后点取消，卡片项目数量不变化，目录不被同步，最近项目不保存。
6. 选择项目后点应用，确认同步到项目目录下当前已安装工具。
7. 再次打开弹窗，删除项目后点取消，原项目同步仍保留。
8. 删除项目后点应用，确认该项目 target 被清理。
9. 项目切回全局后，确认项目 target 被清理，全局 target 写入当前已安装工具。
10. FilterBar 的“全部 / 全局 / 项目”筛选结果正确。


================================================
FILE: docs/releases/v0.5.0/project-scope-design.md
================================================
# 项目级 Skill 同步 — 设计文档

## 背景

Skills Hub v0.4.x 只支持全局同步：Skill 安装到中央仓库后，同步到各工具的全局目录，在所有项目中均可使用。

v0.5.0 新增**项目级同步**：Skill 可以同步到指定项目中的工具目录，使其只在这些项目中生效。

---

## 核心原则

### 安装位置不变

Skill 文件仍然只安装并维护在中央仓库中：

```text
~/.skillshub/<skill-name>/
```

全局 / 项目只决定同步目标，不改变 Hub 中的 Skill 文件。

### 同步范围是 Skill 级别设置

每个 Skill 有一个当前同步范围：

| 范围 | 含义 |
|------|------|
| 全局 | 同步到各工具的全局 Skills 目录 |
| 项目 | 同步到所选项目下各工具的项目级 Skills 目录 |

同步范围不是每个工具单独设置。工具按钮只表示该工具是否参与当前范围的同步。

### 切换范围默认同步当前已安装工具

全局和项目之间切换时，系统会以**当前用户已安装的工具**为准重新同步：

- 全局 → 项目：移除非项目范围的旧同步记录，并将该 Skill 同步到所选项目下所有当前已安装工具。
- 项目 → 全局：移除非全局范围的旧同步记录，并将该 Skill 同步到所有当前已安装工具的全局目录。

这里的“所有工具”不是系统支持的全部工具，而是当前检测到已安装的工具。

---

## 同步路径

### 全局路径

全局同步继续使用各工具 adapter 中已有的全局路径，例如：

```text
~/.claude/skills/<skill-name>
~/.codex/skills/<skill-name>
```

### 项目路径

项目级同步使用独立的项目路径映射。部分工具的项目级路径和全局路径不一致，不能直接复用全局 `relative_skills_dir`。

当前实现中所有工具都允许项目级同步；UI 只展示当前用户已安装的工具。

主要项目级路径如下：

| 工具 | 项目级 Skills 目录 |
|------|--------------------|
| Cursor / Codex / OpenCode / Gemini CLI / GitHub Copilot / Amp / Kimi Code CLI / Antigravity / Cline | `<project>/.agents/skills/` |
| Claude Code | `<project>/.claude/skills/` |
| OpenClaw | `<project>/skills/` |
| Windsurf | `<project>/.windsurf/skills/` |
| Qwen Code | `<project>/.qwen/skills/` |
| OpenHands | `<project>/.openhands/skills/` |
| 其他已映射工具 | 使用 `project_relative_skills_dir()` 中的显式映射 |
| 未显式映射工具 | 回退到该工具的全局 `relative_skills_dir` |

共享同一项目级目录的工具会共用同一个同步目标。例如多个工具都使用 `<project>/.agents/skills/` 时，文件系统只写一份，数据库只为当前已安装且共享该目录的工具记录同步状态。

---

## 同步方式

同步引擎仍沿用现有策略：

```text
symlink -> junction（Windows）-> copy
```

因此文档中“同步目标”不承诺一定是软链接；具体模式由同步引擎决定，并记录在 `skill_targets.mode` 中。

---

## 交互设计

### Skill Card

Skill 卡片 meta 行新增范围徽标：

```text
ux-designer
Expert UX design assistance...
shubhamsaboo/awesome-llm-apps · 10 小时前 · [1 个项目]

[● Cursor] [● Claude Code] [● Codex] [OpenClaw]
```

范围徽标：

| 文案 | 含义 |
|------|------|
| 全局 | 当前 Skill 使用全局同步 |
| N 个项目 | 当前 Skill 使用项目级同步，且已同步到 N 个项目 |

点击范围徽标打开“同步范围”弹窗。

### 工具按钮

工具按钮颜色不区分全局 / 项目，继续沿用原有语义：

| 状态 | 含义 | 样式 |
|------|------|------|
| 已同步 | 该工具已参与当前范围同步 | 原有 active 样式 |
| 未同步 | 该工具未参与当前范围同步 | 原有 inactive 样式 |

全局 / 项目的区别由范围徽标表达，不通过工具按钮颜色表达。

### 同步范围弹窗

弹窗只暴露用户决策需要的信息：

```text
同步范围 · ux-designer

选择这个 Skill 生效的位置。

○ 全局
  在所有项目中可用

● 项目
  仅在选择的项目中可用

项目目录
  /Users/may/Desktop/test/cc-weixin-test    [x]
  [选择项目目录...]

最近使用
  /Users/may/Desktop/test/cursor-browser    [添加]

[取消] [应用]
```

交互规则：

- 切换 radio 后立即展示对应区域，不再弹出额外确认框。
- 选择“项目”时，必须至少选择一个项目目录才能点击“应用”。
- 新增、移除项目目录均为弹窗内草稿状态。
- 点击“取消”不会保存项目列表，不会影响卡片项目数量，也不会触发同步。
- 点击“应用”后才提交范围和项目列表，并执行同步。
- 最近项目只在应用项目范围后保存，最多保留 8 个。

### 筛选栏

范围筛选使用下拉样式，和排序 / 搜索 / 刷新保持同一行布局：

```text
全部 Skills                         [全部 v] [最近更新 ↕] [搜索 skills...] [刷新]
```

筛选项：

| 选项 | 显示内容 |
|------|----------|
| 全部 | 所有 Skill |
| 全局 | 当前范围为全局的 Skill |
| 项目 | 当前范围为项目的 Skill |

筛选在前端完成，不需要新增后端查询接口。

---

## 数据模型

`skill_targets` 增加范围维度：

```text
scope TEXT NOT NULL DEFAULT 'global'
project_path TEXT NULL
```

唯一索引：

```sql
UNIQUE(skill_id, tool, scope, COALESCE(project_path, ''))
```

含义：

- 全局 target：`scope = 'global'`，`project_path = NULL`
- 项目 target：`scope = 'project'`，`project_path = <project root>`

旧数据库升级到 v0.5.0 时，既有同步记录会迁移为：

```text
scope = 'global'
project_path = NULL
```

因此老用户升级后，原有全局同步状态保持不变。

---

## 前后端接口

### `sync_skill_to_tool`

新增可选参数：

```text
scope?: 'global' | 'project'
projectPath?: string
```

规则：

- `scope` 缺省为 `global`，保持向后兼容。
- `scope = project` 时必须传 `projectPath`，且路径必须是已存在目录。
- 全局同步会检查工具是否已安装。
- 项目同步不依赖全局工具安装路径，但最终记录只写入当前已安装工具。
- 同一路径已有有效 target 时视为幂等成功。

### `unsync_skill_from_tool`

同样新增：

```text
scope?: 'global' | 'project'
projectPath?: string
```

规则：

- 按 `skill_id + tool + scope + project_path` 删除目标记录。
- 共享同一 Skills 目录的工具会一起更新数据库状态。
- 文件系统目标只删除一次，避免共享目录重复删除。

### 最近项目

新增命令：

```text
get_recent_projects
save_recent_project(projectPath)
```

最近项目存入 `settings.recent_projects_v1`，用于项目级弹窗快捷添加。

---

## 实现变更概览

| 层 | 文件 | 变更 |
|----|------|------|
| DB | `skill_store.rs` | `skill_targets` 增加 `scope`、`project_path`，V3→V4 重建表迁移 |
| 后端 | `tool_adapters/mod.rs` | 新增项目级路径解析、共享项目目录分组、项目路径映射 |
| 后端 | `commands/mod.rs` | `sync/unsync` 增加 `scope`、`projectPath`；新增最近项目命令 |
| 后端 | `lib.rs` | 注册 `get_recent_projects`、`save_recent_project` |
| 前端 | `types.ts` | DTO 增加 `scope`、`project_path`、`supports_project_scope` |
| 前端 | `FilterBar.tsx` | 新增范围下拉筛选 |
| 前端 | `SkillCard.tsx` | meta 行增加范围徽标；工具按钮保持原有 active/inactive 样式 |
| 前端 | `ScopeSyncModal.tsx` | 新建同步范围弹窗，使用草稿项目列表，应用后提交 |
| 前端 | `App.tsx` | 新增范围状态、筛选、切换、项目同步逻辑 |
| i18n | `resources.ts` | 新增 `scope.*`、`projectSync.*` 翻译键 |

详细实现步骤见：[实现计划](./implementation-plan.md)


================================================
FILE: docs/releases/v0.5.0/ux-optimizations.md
================================================
# UX 优化记录

收录不需要单独文档的小型 UX 改进。

---

## 关闭按钮改为隐藏窗口（macOS）

**变更：** 点击红色 X 按钮不再退出应用，而是隐藏窗口。

**原因：** macOS 上许多主流应用（Slack、Discord 等）均采用此交互模式——应用在后台持续运行，下次打开时响应更快。需要真正退出时使用 `Cmd+Q` 或菜单栏退出。

**实现方式：**
- 拦截 `CloseRequested` 窗口事件，阻止默认关闭行为，改为隐藏窗口。
- 点击 Dock 图标时触发 `RunEvent::Reopen`，重新显示窗口并聚焦。

**涉及文件：** `src-tauri/src/lib.rs`

---

## Skill 描述与 Markdown 预览优化

**变更：** 修复 `SKILL.md` frontmatter 在列表和详情页中的展示问题。

**原因：** 部分 Skill 使用 YAML 折叠块语法（例如 `description: >-`）。旧解析逻辑没有识别 `>-`、`>+`、`|-`、`|+`，导致列表卡片错误显示 `>-`，详情页元信息也可能出现描述缺失或排版异常。

**实现方式：**
- 后端 `SKILL.md` 解析支持 YAML block scalar 的 chomping indicator：`>`、`>-`、`>+`、`|`、`|-`、`|+`。
- 启动时重新从 `SKILL.md` 比对并回填描述，纠正已入库的旧错误值。
- 详情页 frontmatter 改为响应式 key/value 元信息区，避免短字段被表格挤压成竖排。
- Markdown 预览内容区居中展示，并保留最大可读宽度。

**涉及文件：**
- `src-tauri/src/core/installer.rs`
- `src-tauri/src/core/skill_store.rs`
- `src-tauri/src/core/tests/installer.rs`
- `src-tauri/src/core/tests/skill_store.rs`
- `src/components/skills/SkillDetailView.tsx`
- `src/App.css`

---

## 取消同步后的 Agent 重新启用入口

**变更：** 修复在“我的 skills”页面取消部分 agent 同步后，已取消同步的 agent 没有重新启用入口的问题。

**原因：** v0.4.3 中未同步 agent 只会在卡片展开状态下渲染。触发场景是：某个 skill 同步到多个 agent 后，用户取消 Qoder、GitHub Copilot 等部分 agent；如果该 skill 剩余已同步 agent 数量不超过 5 个，卡片不会显示 `+N more` 展开按钮，导致被取消同步的 agent 无法以灰色按钮显示，看起来像“消失了，无法重新添加”。关闭重开应用也不会恢复，因为这是渲染条件问题，不是临时状态卡住。

**实现方式：**
- 当卡片不需要折叠时，直接显示未同步 agent 的灰色按钮。
- 保留折叠场景下通过 `+N more` 展开查看完整 agent 列表的行为。

**涉及文件：** `src/components/skills/SkillCard.tsx`

---

## Bug：导入同名且内容一致的 Skill 时同步冲突

**关联 Issue：** https://github.com/qufei1993/skills-hub/issues/51

**状态：** 已在本地验证修复，待 v0.5.0 发版后关闭 issue。

**变更：** 修复从一个工具导入 Skill 后，同名且内容一致的其它工具目录仍被判定为同步冲突的问题；同时修复导入弹窗在部分同步失败后不关闭、未选择任何 Skill 时仍可点击“导入并同步”的问题。

**原因：** 旧同步逻辑只判断目标目录是否存在。即使 Codex、Cursor 等工具下的同名 Skill 内容完全一致，也会返回 `TARGET_EXISTS`，导致该工具永远无法被 Hub 接管。导入流程还会在部分失败时只显示错误 toast，不关闭 `ImportModal`。

**实现方式：**
- `sync_skill_to_tool` 增加 `overwriteIfSameContent` 参数。
- 后端在目标目录已存在时比较 Hub 中央仓库 Skill 与目标目录的内容 hash；内容一致时允许安全接管，内容不一致时继续阻止覆盖。
- 所有前端同步入口都传入 `overwriteIfSameContent: true`，确保导入、创建后同步、单个工具同步、批量同步和范围切换行为一致。
- 导入流程改为逐项处理，单个 Skill 导入或同步失败不会中断后续项。
- 导入结束后统一关闭弹窗；有错误时只显示错误提示，全部成功时才显示成功提示。
- 未选择任何 Skill 时禁用“导入并同步”，并在提交入口增加空选择校验。

**涉及文件：**
- `src-tauri/src/commands/mod.rs`
- `src/App.tsx`
- `src/components/skills/modals/ImportModal.tsx`

---

## 新增：Hermes Agent 全局同步支持

**关联 Issue：** https://github.com/qufei1993/skills-hub/issues/54

**状态：** 已在本地验证，纳入 v0.5.0。

**变更：** 新增 Hermes Agent 工具适配，支持将 Skill 全局同步到 `~/.hermes/skills`。

**原因：** Issue #54 请求支持 Hermes Agent。调研 Hermes Agent 官方文档后，仅确认默认 `HERMES_HOME` 为 `~/.hermes`，Skills 位于 `HERMES_HOME/skills`。没有找到明确的项目级 skills 目录规范，因此本次只声明并实现全局同步支持，避免为项目级同步捏造路径。

**实现方式：**
- 新增 `hermes_agent` 工具 key，展示名为 `Hermes Agent`。
- 全局 skills 目录配置为 `.hermes/skills`，安装检测目录为 `.hermes`。
- `supports_project_scope` 对 Hermes Agent 返回 `false`。
- 后端在项目级同步入口拒绝不支持项目级同步的工具，返回 `PROJECT_SCOPE_UNSUPPORTED|<tool>`。
- 前端在项目级批量同步时跳过 Hermes Agent；用户在项目级 Skill 上单独点击 Hermes Agent 时显示“不支持项目级同步”提示。
- README 和 CHANGELOG 同步标注 Hermes Agent 仅支持全局同步，并列入 v0.5.0。

**涉及文件：**
- `src-tauri/src/core/tool_adapters/mod.rs`
- `src-tauri/src/commands/mod.rs`
- `src-tauri/src/core/tests/tool_adapters.rs`
- `src/App.tsx`
- `src/i18n/resources.ts`
- `README.md`
- `docs/README.zh.md`
- `CHANGELOG.md`
- `docs/CHANGELOG.zh.md`


================================================
FILE: docs/releases/v0.6.0/minor-updates.md
================================================
# v0.6.0 小需求与体验优化记录

这个文件用于记录 v0.6.0 周期内较小的需求、体验优化和界面修正。后续同类变更继续追加到这里，避免为每个小项单独创建发布记录文件。

## 2026-05-05

### 删除 My Skills 筛选栏刷新按钮

- 删除 My Skills 筛选栏中的 `Refresh` / `刷新` 按钮，解决中文界面下按钮样式错乱问题（GitHub Issue #61，PR #63）。
- 确认该按钮仅手动重新读取当前 Skill 列表和标签，不触发重新扫描工具、Git 更新或重新同步。
- 安装、删除、同步、编辑标签等操作后已有自动刷新，不影响现有数据更新流程。
- 修复验证（PR #63）：`npm run check`。

### 查看并导入 Skill 增加搜索栏

- 在“查看并导入 Skill”弹窗中新增搜索栏，支持按名称、描述和路径筛选候选项（GitHub Issue #57）。
- 搜索结果会同步影响“全选”和已选数量统计，方便在多个 Skill 中快速定位目标。
- 本地目录导入和 Git 仓库导入两个入口都已支持该交互。
- “查看发现的 Skills”弹窗也已补上搜索栏，支持按 Skill 名称或路径筛选已发现条目。
- 修复验证：`npm run lint`、`npx tsc -b`、`npm run rust:fmt:check`、`npm run rust:clippy`、`npm run rust:test`。


================================================
FILE: docs/releases/v0.6.0/tag-management.md
================================================
# Skill 标签管理功能设计与实现计划

## 背景

随着用户安装的 Skill 数量增加，当前列表主要依赖名称、描述和同步状态浏览。用户很难按技术方向或使用场景快速定位 Skill，例如：

- 前端 / React / UI
- Rust / Tauri
- 文档 / 图表 / 自动化
- 测试 / 代码审查

v0.6.0 聚焦解决这个问题：为 Skill 增加**自定义标签**能力，用于整理和筛选 Skill。

关联需求：

- GitHub Issue #15：添加 tag 功能。

---

## 本期目标

v0.6.0 只实现标签功能。

标签用于：

- 给 Skill 添加一个或多个自定义标签。
- 在 My Skills 页面按标签筛选 Skill。
- 找出还没有设置标签的 Skill。
- 通过独立的 Tags 页面查看和编辑标签。

标签不用于：

- 控制 Skill 是否同步。
- 控制 Skill 同步到哪些工具。
- 作为一套可切换的工作配置。

一句话定义：

```text
Tag 用于找 Skill，不用于改变 Skill 的生效范围。
```

---

## 产品规则

### 1. Skill 可以没有标签

没有标签是合法状态。

系统提供虚拟筛选项：

```text
Untagged
```

含义：

```text
显示没有任何标签的 Skill。
```

`Untagged` 不是用户创建的真实标签，不能重命名、删除，也不写入标签表。

### 2. Skill 可以有多个标签

一个 Skill 可以关联多个标签：

```text
frontend-design: Frontend, Docs, UI
```

同一个 Skill 下不能重复添加同一个标签。

### 3. 标签筛选支持多选

My Skills 页面提供 `Tags` 下拉筛选器：

```text
[All ▾] [Most recent ⇅] [Tags ▾] [Search skills...] [Refresh]
```

下拉内容：

```text
Tags                              Match any

[Search tags...]

[ ] Untagged                  5
[✓] Frontend                  8
[✓] React                     3
[ ] Rust                      2
[ ] Docs                      6

Clear all
```

筛选逻辑使用 `OR`：

```text
选择 Frontend + Docs
```

显示包含 `Frontend` 或 `Docs` 的 Skill。

### 4. 筛选即时生效

标签筛选只影响列表展示，不修改数据，因此不需要 `Apply`。

交互规则：

- 勾选标签后，Skill 列表立即更新。
- 取消勾选后，Skill 列表立即更新。
- 下拉保持打开，方便连续选择。
- 点击外部关闭下拉。
- `Clear all` 立即清空标签筛选。

### 5. 标签页面是独立入口

标签不放在 Settings 中，避免入口过深。

入口：

- 顶部主导航的 `Tags` / `标签`
- My Skills 页面标签筛选区的辅助入口（保留一个快速跳转点）

页面层级：

```text
Tags
```

页面内容：

```text
Tags

标签用于筛选和整理 skills，不会改变同步结果。

5 skills have no tags                         [Review]

[Search tags...]                              [+ New Tag]

Tag name        Skills      Last used       Actions
Frontend        8           2d ago          View  Rename  Delete
Docs            6           5d ago          View  Rename  Delete
Rust            2           9d ago          View  Rename  Delete
```

`Review` 点击后回到 My Skills，并应用 `Untagged` 筛选。

`View` 点击后回到 My Skills，并应用对应标签筛选。

---

## UI 行为

### Skill 卡片

Skill 卡片展示最多 2-3 个标签，避免挤压工具同步状态。

有标签：

```text
frontend-design    #Frontend #Docs
```

无标签：

```text
legacy-shell-helper
```

没有标签时不展示空文案，只保留标签编辑入口。

### 标签编辑

每个 Skill 需要有入口编辑标签。

当前实现使用 Skill 卡片右侧的标签图标按钮作为快捷入口，点击后打开标签编辑。

编辑内容：

```text
Edit Tags: frontend-design

[✓] Frontend
[✓] Docs
[ ] Rust
[ ] Testing

[Done]
```

### 新建标签

新建标签入口在 `Tags` 页面。

规则：

- 标签名不能为空。
- 标签名去除首尾空格。
- 标签名大小写不敏感去重。
- 新建后出现在标签管理表和筛选下拉中。

### 重命名标签

重命名标签会更新所有关联 Skill 的标签展示。

规则：

- 不能重命名为已存在标签。
- 重命名后保留原有关联关系。
- 如果当前正在按旧标签筛选，筛选条件同步切换为新标签名。

### 删除标签

删除标签只删除标签和关联关系，不删除 Skill。

删除前需要确认：

```text
Delete "Docs" from 6 skills?
This only removes the tag, not the skills.
```

删除后：

- 标签从所有 Skill 上移除。
- 如果某些 Skill 因此没有任何标签，它们会进入 `Untagged`。

---

## 数据模型

新增两张表：

```sql
CREATE TABLE skill_tags (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL UNIQUE,
  created_at TEXT NOT NULL,
  updated_at TEXT NOT NULL
);

CREATE TABLE skill_tag_links (
  skill_id INTEGER NOT NULL,
  tag_id INTEGER NOT NULL,
  created_at TEXT NOT NULL,
  PRIMARY KEY (skill_id, tag_id),
  FOREIGN KEY (skill_id) REFERENCES skills(id) ON DELETE CASCADE,
  FOREIGN KEY (tag_id) REFERENCES skill_tags(id) ON DELETE CASCADE
);
```

约束：

- `skill_tags.name` 唯一。
- `skill_tag_links` 使用 `(skill_id, tag_id)` 主键，防止同一 Skill 重复关联同一标签。
- `Untagged` 不入库，由 `NOT EXISTS skill_tag_links` 动态计算。

迁移：

- 升级数据库 schema 版本。
- 老用户升级后，既有 Skill 默认没有标签。
- 不自动生成标签，避免误分类。

---

## 后端能力

建议新增 core 方法：

```rust
create_tag(name)
rename_tag(tag_id, name)
delete_tag(tag_id)
list_tags_with_counts()
set_skill_tags(skill_id, tag_ids)
get_skill_tags(skill_id)
list_untagged_skill_ids()
```

建议新增 Tauri commands：

```text
get_tags
create_tag
rename_tag
delete_tag
set_skill_tags
get_skill_tags
```

`get_managed_skills` 返回的 Skill DTO 增加：

```ts
tags: TagDto[]
```

`TagDto`：

```ts
type TagDto = {
  id: number;
  name: string;
};
```

标签筛选第一版可在前端完成，不需要新增服务端筛选参数。

---

## 前端改动

主要涉及：

- `src/App.tsx`
- `src/components/skills/types.ts`
- `src/components/skills/FilterBar.tsx`
- `src/components/skills/SkillCard.tsx`
- 新增 Tags 页面组件
- 新增标签编辑弹窗或详情页 Tags 区块
- `src/i18n/resources.ts`
- `src/App.css`

### 状态

新增状态：

```ts
tags
selectedTagIds
tagSearch
tagManagerSearch
tagEditorSkill
```

### 筛选

前端筛选逻辑：

```text
selectedTags 为空 -> 显示全部
selectedTags 包含普通标签 -> 命中任意一个标签
selectedTags 包含 Untagged -> skill.tags.length === 0
```

### i18n

所有用户可见文案需要提供英文和中文：

- Tags
- Untagged
- New Tag
- Rename
- Delete
- Review
- Clear all
- Match any

---

## 测试重点

### 后端

- 新建标签成功。
- 重复标签名被拒绝。
- 重命名标签保留关联关系。
- 删除标签后关联关系清理。
- 同一 Skill 不能重复关联同一标签。
- 删除 Skill 后标签关联被清理。
- `Untagged` 统计正确。

### 前端

- 多选标签即时筛选。
- `Untagged` 筛选正确。
- `Clear all` 清空筛选。
- 顶部 `Tags` 进入标签页面。
- Tags 页面 `Review` 能筛选无标签 Skill。
- Tags 页面 `View` 能筛选指定标签。
- 无标签 Skill 不显示空文案。
- 编辑标签后卡片和筛选结果刷新。
- 在添加 Skill 弹窗中可直接选择标签，创建后自动绑定。

---

## 发布范围

v0.6.0 包含：

- 自定义标签数据模型。
- 标签 CRUD。
- Skill 标签关联编辑。
- My Skills 标签多选筛选。
- `Untagged` 虚拟筛选项。
- 独立 Tags 页面。
- 添加 Skill 时选择标签。
- 中英文文案。
- 后端和前端测试。

v0.6.0 不包含：

- 标签自动推荐。
- 批量给多个 Skill 添加标签。


================================================
FILE: docs/skills_hub_design.html
================================================
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Skills Hub - Design Preview (Optimized Light Mode)</title>
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Fira+Sans:wght@300;400;500;600;700&family=Fira+Code:wght@400;500;600;700&display=swap" rel="stylesheet">
    <style>
        :root {
            /* Colors - Clean Light Theme */
            --bg-app: #ffffff;
            --bg-panel: #fcfcfc;
            --bg-element: #f4f4f5;
            --bg-element-hover: #e4e4e7;
            
            --border-subtle: #e4e4e7;
            --border-strong: #d4d4d8;
            
            --text-primary: #18181b;
            --text-secondary: #52525b;
            --text-tertiary: #a1a1aa;
            
            /* Executive Dashboard Accent Palette */
            --accent-primary: #2563EB; /* Slightly darker blue for white bg */
            --accent-primary-hover: #1D4ED8;
            --accent-primary-fg: #FFFFFF;
            
            --status-success: #059669;
            --status-warning: #d97706;
            --status-error: #dc2626;
            --status-info: #2563EB;
            
            /* Typography */
            --font-ui: 'Fira Sans', system-ui, -apple-system, sans-serif;
            --font-mono: 'Fira Code', monospace;
            
            /* Spacing & Layout */
            --radius-sm: 4px;
            --radius-md: 8px;
            --radius-lg: 12px;
            
            /* Effects */
            --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
            --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.05);
            --glow-text: none;
        }

        * {
            box-sizing: border-box;
            margin: 0;
            padding: 0;
        }

        body {
            background-color: #e5e5e5;
            color: var(--text-primary);
            font-family: var(--font-ui);
            padding: 40px;
            display: flex;
            flex-direction: column;
            align-items: center;
            gap: 60px;
            min-height: 100vh;
            -webkit-font-smoothing: antialiased;
        }

        /* Presentation Label */
        .design-label {
            position: absolute;
            top: -30px;
            left: 0;
            font-family: var(--font-mono);
            font-size: 12px;
            color: var(--text-secondary);
            text-transform: uppercase;
            letter-spacing: 0.1em;
            text-shadow: none;
        }

        /* App Window Frame Container */
        .window-frame {
            position: relative;
            width: 1000px; /* Slightly wider for data density */
            height: 700px;
            background: var(--bg-app);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
            display: flex;
            flex-direction: column;
            overflow: hidden;
        }

        /* Title Bar */
        .title-bar {
            height: 40px;
            background: var(--bg-app);
            border-bottom: 1px solid var(--border-subtle);
            display: flex;
            align-items: center;
            padding: 0 16px;
            -webkit-app-region: drag;
        }

        .traffic-lights {
            display: flex;
            gap: 8px;
        }

        .traffic-light {
            width: 12px;
            height: 12px;
            border-radius: 50%;
        }
        .traffic-light.close { background: #ff5f56; border: 1px solid rgba(0,0,0,0.1); }
        .traffic-light.minimize { background: #ffbd2e; border: 1px solid rgba(0,0,0,0.1); }
        .traffic-light.maximize { background: #27c93f; border: 1px solid rgba(0,0,0,0.1); }

        .app-layout {
            display: flex;
            flex-direction: column;
            flex: 1;
            overflow: hidden;
        }

        /* Top Navigation Header */
        .app-header {
            height: 64px;
            padding: 0 24px;
            display: flex;
            align-items: center;
            justify-content: space-between;
            border-bottom: 1px solid var(--border-subtle);
            background: rgba(255, 255, 255, 0.8); /* Glass effect base */
            backdrop-filter: blur(12px);
            -webkit-backdrop-filter: blur(12px);
            z-index: 10;
        }

        .brand-area {
            display: flex;
            align-items: center;
            gap: 12px;
        }

        .logo-icon {
            width: 36px;
            height: 36px;
            display: block;
            object-fit: contain;
            border-radius: 8px;
        }
        
        .brand-text {
            font-weight: 700;
            font-size: 20px;
            letter-spacing: -0.03em;
            /* UI UX Pro Max Gradient: Blue -> Purple -> Orange */
            background: linear-gradient(to right, #2563EB, #9333EA, #EA580C);
            -webkit-background-clip: text;
            -webkit-text-fill-color: transparent;
        }

        .header-actions {
            display: flex;
            align-items: center;
            gap: 16px;
        }

        /* Optimized Language Switcher */
        .lang-btn {
            font-size: 12px;
            font-weight: 600;
            color: var(--text-secondary);
            cursor: pointer;
            padding: 6px 10px;
            border-radius: var(--radius-sm);
            background: transparent;
            transition: all 0.2s;
            border: 1px solid var(--border-subtle);
            font-family: var(--font-mono);
            display: flex;
            align-items: center;
            gap: 6px;
        }
        .lang-btn:hover {
            color: var(--text-primary);
            background: var(--bg-element);
            border-color: var(--text-tertiary);
        }

        .icon-btn-header {
            width: 36px;
            height: 36px;
            display: flex;
            align-items: center;
            justify-content: center;
            border-radius: var(--radius-md);
            color: var(--text-secondary);
            cursor: pointer;
            transition: all 0.2s;
            overflow: visible;
        }
        .icon-btn-header:hover {
            background: var(--bg-element);
            color: var(--text-primary);
            transform: translateY(-1px);
        }
        
        .icon-btn-header svg {
            width: 20px;
            height: 20px;
        }

        .btn {
            height: 36px;
            padding: 0 16px;
            border-radius: var(--radius-md);
            font-size: 13px;
            font-weight: 600;
            cursor: pointer;
            display: flex;
            align-items: center;
            gap: 8px;
            border: 1px solid transparent;
            transition: all 0.2s;
            position: relative;
            overflow: hidden;
        }

        .btn-primary {
            background: var(--accent-primary);
            color: var(--accent-primary-fg);
            box-shadow: 0 4px 6px -1px rgba(37, 99, 235, 0.2);
        }
        .btn-primary:hover {
            background: var(--accent-primary-hover);
            transform: translateY(-1px);
            box-shadow: 0 6px 8px -1px rgba(37, 99, 235, 0.3);
        }
        .btn-primary:active {
            transform: translateY(0);
        }

        .btn-secondary {
            background: transparent;
            border-color: var(--border-subtle);
            color: var(--text-primary);
        }
        .btn-secondary:hover {
            border-color: var(--border-strong);
            background: var(--bg-element);
        }
        
        .btn-danger {
            background: #fef2f2;
            color: var(--status-error);
            border: 1px solid #fee2e2;
        }
        .btn-danger:hover {
            background: #fee2e2;
            border-color: var(--status-error);
        }
        .btn-danger-solid {
            background: var(--status-error);
            color: #fff;
            box-shadow: 0 4px 6px -1px rgba(220, 38, 38, 0.2);
        }
        .btn-danger-solid:hover {
            opacity: 0.9;
            transform: translateY(-1px);
        }

        /* Stats Grid (New) */
        .stats-grid {
            display: grid;
            grid-template-columns: repeat(3, 1fr);
            gap: 16px;
            padding: 24px 32px 0 32px;
        }

        .stat-card {
            background: var(--bg-panel);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            padding: 16px;
            display: flex;
            flex-direction: column;
            gap: 4px;
            transition: all 0.2s;
        }
        .stat-card:hover {
            border-color: var(--border-strong);
            transform: translateY(-1px);
        }

        .stat-label {
            font-size: 12px;
            color: var(--text-tertiary);
            font-weight: 500;
            text-transform: uppercase;
            letter-spacing: 0.05em;
        }
        .stat-value {
            font-size: 24px;
            font-weight: 600;
            color: var(--text-primary);
            letter-spacing: -0.02em;
        }

        /* Sub-Header / Filter Bar */
        .filter-bar {
            padding: 20px 32px 0 32px;
            display: flex;
            justify-content: space-between;
            align-items: center;
        }

        .filter-title {
            font-size: 14px;
            font-weight: 500;
            color: var(--text-secondary);
            font-family: var(--font-mono);
        }

        .search-container {
            position: relative;
        }

        .search-input {
            background: var(--bg-panel);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            height: 36px;
            padding: 0 12px 0 36px;
            color: var(--text-primary);
            width: 280px;
            font-size: 13px;
            transition: all 0.2s;
            font-family: var(--font-ui);
        }
        .search-input:focus {
            outline: none;
            border-color: var(--accent-primary);
            background: var(--bg-app);
            box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
        }

        .search-icon-abs {
            position: absolute;
            left: 12px;
            top: 50%;
            transform: translateY(-50%);
            width: 16px;
            height: 16px;
            color: var(--text-tertiary);
            pointer-events: none;
        }


        /* Main Content */
        .main-content {
            flex: 1;
            display: flex;
            flex-direction: column;
            background: var(--bg-app);
            overflow: hidden;
        }

        /* Skills List - Data Dense */
        .skills-list {
            padding: 16px 32px 32px 32px;
            display: flex;
            flex-direction: column;
            gap: 12px;
            overflow-y: auto;
        }

        .skill-card {
            background: var(--bg-app);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            padding: 16px 20px;
            display: grid;
            grid-template-columns: 48px 2fr 1.5fr auto;
            gap: 20px;
            align-items: center;
            transition: all 0.2s;
            position: relative;
        }

        .skill-card:hover {
            border-color: var(--border-strong);
            background: var(--bg-panel);
            transform: translateY(-1px);
            box-shadow: var(--shadow-sm);
            z-index: 1;
        }

        .skill-icon {
            width: 48px;
            height: 48px;
            background: var(--bg-element);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            display: flex;
            align-items: center;
            justify-content: center;
            color: var(--text-secondary);
            font-size: 20px;
            transition: all 0.2s;
        }
        .skill-card:hover .skill-icon {
            color: var(--text-primary);
            border-color: var(--border-strong);
            background: #fff;
        }

        .skill-main {
            display: flex;
            flex-direction: column;
            gap: 4px;
            justify-content: center;
        }

        .skill-header-row {
            display: flex;
            align-items: center;
            gap: 10px;
        }

        .skill-name {
            font-weight: 600;
            color: var(--text-primary);
            font-size: 15px;
            letter-spacing: -0.01em;
        }

        .skill-version-badge {
            font-family: var(--font-mono);
            font-size: 10px;
            color: var(--text-secondary);
            background: var(--bg-element);
            padding: 2px 6px;
            border-radius: 4px;
            border: 1px solid var(--border-subtle);
        }

        .skill-meta-row {
            display: flex;
            align-items: center;
            gap: 12px;
            margin-top: 4px;
        }

        .skill-source {
            font-family: var(--font-mono);
            font-size: 11px;
            color: var(--text-tertiary);
            display: flex;
            align-items: center;
            gap: 6px;
        }

        .skill-status-col {
            display: flex;
            flex-direction: column;
            gap: 6px;
            justify-content: center;
        }
        
        .status-label {
            font-size: 11px;
            font-weight: 500;
            color: var(--text-tertiary);
            text-transform: uppercase;
            letter-spacing: 0.05em;
        }

        /* Discovery Styles */
        .discovery-header {
            display: flex;
            align-items: center;
            gap: 8px;
            margin-bottom: 8px;
            padding: 0 4px;
        }
        .discovery-title {
            font-size: 12px;
            font-weight: 600;
            color: var(--text-secondary);
            text-transform: uppercase;
            letter-spacing: 0.05em;
        }
        .discovery-count {
            background: var(--status-warning);
            color: white;
            font-size: 10px;
            font-weight: 700;
            padding: 1px 6px;
            border-radius: 10px;
        }
        .skill-card.discovery {
            background: #FFFBEB; /* Light yellow tint for discovery */
            border-style: dashed;
            border-color: #FCD34D;
        }
        .skill-card.discovery:hover {
            border-color: var(--status-warning);
            background: #FEF3C7;
            border-style: solid;
        }

        /* Tool Matrix - Optimized for Density */
        .tool-matrix {
            display: flex;
            align-items: center;
            gap: 6px;
            flex-wrap: wrap;
        }

        .tool-pill {
            height: 22px;
            padding: 0 8px;
            border-radius: 4px;
            font-size: 11px;
            font-weight: 500;
            display: flex;
            align-items: center;
            gap: 6px;
            cursor: pointer;
            transition: all 0.2s;
            border: 1px solid var(--border-subtle);
            font-family: var(--font-ui);
            background: #fff;
            color: var(--text-secondary);
        }

        /* Active Tool State - High Contrast */
        .tool-pill.active {
            background: #fff;
            color: var(--status-success);
            border-color: #d1fae5;
        }
        .tool-pill.active .status-badge {
            background: var(--status-success);
            box-shadow: 0 0 0 2px #d1fae5;
        }
        
        .tool-pill.active:hover {
            border-color: var(--status-success);
            transform: translateY(-1px);
        }

        /* Inactive Tool State */
        .tool-pill.inactive {
            background: var(--bg-element);
            color: var(--text-tertiary);
            border-color: transparent;
        }

        .tool-pill.inactive:hover {
            color: var(--text-secondary);
            background: var(--bg-element-hover);
        }
        
        /* Not Installed / Unknown State */
        .tool-pill.disabled {
            opacity: 0.5;
            cursor: not-allowed;
            border: 1px dashed var(--border-strong);
            background: transparent;
            color: var(--text-tertiary);
        }

        .status-badge {
            width: 6px;
            height: 6px;
            border-radius: 50%;
            background: var(--text-tertiary);
        }

        .skill-actions-col {
            display: flex;
            flex-direction: row;
            align-items: center;
            gap: 8px;
            align-self: center;
        }

        /* Card Action Buttons */
        .card-btn {
            height: 32px;
            width: 32px;
            padding: 0;
            border-radius: var(--radius-md);
            background: transparent;
            color: var(--text-tertiary);
            border: 1px solid transparent;
            cursor: pointer;
            display: flex;
            align-items: center;
            justify-content: center;
            gap: 8px;
            transition: all 0.2s;
        }
        .card-btn:hover {
            color: var(--text-primary);
            background: var(--bg-element);
            border-color: var(--border-subtle);
            transform: translateY(-1px);
            box-shadow: var(--shadow-sm);
        }
        .card-btn.primary-action {
            color: var(--accent-primary);
            background: #eff6ff;
            border-color: #dbeafe;
        }
        .card-btn.primary-action:hover {
            background: var(--accent-primary);
            color: #fff;
            border-color: var(--accent-primary);
        }
        .card-btn.danger-action:hover {
            color: var(--status-error);
            background: #fef2f2;
            border-color: #fee2e2;
        }


        /* Modal Overlay */
        .modal-showcase {
            display: flex;
            gap: 40px;
            justify-content: center;
            flex-wrap: wrap;
            width: 1000px;
        }

        .modal-window {
            width: 480px;
            background: var(--bg-app);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            box-shadow: var(--shadow-lg);
            overflow: hidden;
            position: relative;
            animation: modalFadeIn 0.2s ease-out;
        }

        @keyframes modalFadeIn {
            from { opacity: 0; transform: translateY(10px); }
            to { opacity: 1; transform: translateY(0); }
        }

        .modal-header {
            padding: 20px 24px;
            border-bottom: 1px solid var(--border-subtle);
            display: flex;
            justify-content: space-between;
            align-items: center;
        }
        .modal-title { font-weight: 600; font-size: 16px; color: var(--text-primary); }
        .modal-close { color: var(--text-tertiary); cursor: pointer; transition: color 0.2s; }
        .modal-close:hover { color: var(--text-primary); }

        .modal-body {
            padding: 24px;
        }

        /* Onboarding Styles */
        .onboarding-list {
            display: flex;
            flex-direction: column;
            gap: 10px;
            margin-bottom: 24px;
        }

        .import-item {
            display: flex;
            align-items: flex-start;
            gap: 14px;
            padding: 14px;
            background: var(--bg-panel);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            transition: border-color 0.2s;
        }
        .import-item:hover { border-color: var(--border-strong); }

        .checkbox {
            width: 18px;
            height: 18px;
            border: 1px solid var(--text-tertiary);
            border-radius: 4px;
            margin-top: 2px;
            display: grid;
            place-items: center;
            cursor: pointer;
            transition: all 0.2s;
        }
        .checkbox.checked {
            background: var(--accent-primary);
            border-color: var(--accent-primary);
        }
        .checkbox.checked::after {
            content: "✓";
            color: #fff;
            font-size: 12px;
            font-weight: bold;
        }

        .import-details {
            flex: 1;
        }
        .import-name { font-weight: 600; font-size: 14px; margin-bottom: 4px; color: var(--text-primary); }
        .import-path { font-family: var(--font-mono); font-size: 12px; color: var(--text-tertiary); word-break: break-all; }
        
        .conflict-badge {
            font-size: 11px;
            color: var(--status-warning);
            background: #fffbeb;
            padding: 2px 8px;
            border-radius: 4px;
            margin-top: 8px;
            display: inline-block;
            border: 1px solid #fcd34d;
        }

        /* Tabs */
        .tabs {
            display: flex;
            gap: 24px;
            border-bottom: 1px solid var(--border-subtle);
            margin-bottom: 24px;
        }
        .tab-item {
            padding-bottom: 10px;
            font-size: 14px;
            color: var(--text-secondary);
            cursor: pointer;
            border-bottom: 2px solid transparent;
            transition: all 0.2s;
        }
        .tab-item:hover { color: var(--text-primary); }
        .tab-item.active {
            color: var(--accent-primary);
            border-color: var(--accent-primary);
            font-weight: 500;
        }

        /* Form Elements */
        .form-group {
            margin-bottom: 20px;
        }
        .label {
            display: block;
            font-size: 13px;
            font-weight: 500;
            color: var(--text-secondary);
            margin-bottom: 8px;
        }
        .input {
            width: 100%;
            background: var(--bg-app);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            padding: 10px 14px;
            color: var(--text-primary);
            font-family: var(--font-mono);
            font-size: 13px;
            transition: all 0.2s;
        }
        .input:focus {
            border-color: var(--accent-primary);
            outline: none;
            box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
        }

        .helper-text {
            font-size: 12px;
            color: var(--text-tertiary);
            margin-top: 6px;
        }
        
        /* Settings List */
        .settings-list {
            display: flex;
            flex-direction: column;
        }
        
        .setting-item {
            display: flex;
            align-items: center;
            justify-content: space-between;
            padding: 16px 0;
            border-bottom: 1px solid var(--border-subtle);
        }
        .setting-item:last-child { border-bottom: none; }
        
        .setting-info { flex: 1; margin-right: 20px; }
        .setting-label { font-size: 14px; font-weight: 500; color: var(--text-primary); }
        .setting-desc { font-size: 12px; color: var(--text-tertiary); margin-top: 4px; line-height: 1.4; }
        
        .toggle {
            width: 44px;
            height: 24px;
            background: var(--bg-element);
            border-radius: 12px;
            position: relative;
            cursor: pointer;
            transition: background 0.2s;
            border: 1px solid var(--border-subtle);
        }
        .toggle.checked { background: var(--status-success); border-color: var(--status-success); }
        .toggle-knob {
            width: 18px;
            height: 18px;
            background: white;
            border-radius: 50%;
            position: absolute;
            top: 2px;
            left: 2px;
            transition: transform 0.2s cubic-bezier(0.4, 0.0, 0.2, 1);
            box-shadow: 0 1px 2px rgba(0,0,0,0.2);
        }
        .toggle.checked .toggle-knob { transform: translateX(20px); }

        .modal-footer {
            padding: 20px 24px;
            border-top: 1px solid var(--border-subtle);
            display: flex;
            justify-content: flex-end;
            gap: 12px;
            background: var(--bg-panel);
        }
        
        .modal-footer.space-between {
            justify-content: space-between;
        }
        
        /* Loading States */
        .loader-spinner {
            width: 24px;
            height: 24px;
            border: 2px solid var(--border-subtle);
            border-top-color: var(--accent-primary);
            border-radius: 50%;
            animation: spin 0.8s linear infinite;
        }
        
        @keyframes spin {
            to { transform: rotate(360deg); }
        }

        .progress-bar {
            height: 6px;
            background: var(--bg-element);
            border-radius: 3px;
            width: 100%;
            overflow: hidden;
            margin-top: 12px;
        }
        .progress-fill {
            height: 100%;
            background: var(--accent-primary);
            width: 60%;
            border-radius: 3px;
            animation: shimmer 1.5s infinite linear;
            background: linear-gradient(90deg, var(--accent-primary) 0%, #60A5FA 50%, var(--accent-primary) 100%);
            background-size: 200% 100%;
        }
        
        @keyframes shimmer {
            0% { background-position: 100% 0; }
            100% { background-position: -100% 0; }
        }
        
        /* Loading Modal Content */
        .loading-content {
            display: flex;
            flex-direction: column;
            align-items: center;
            justify-content: center;
            padding: 40px 20px;
            text-align: center;
        }
        .loading-text {
            margin-top: 20px;
            font-size: 15px;
            font-weight: 500;
            color: var(--text-primary);
        }
        .loading-subtext {
            margin-top: 8px;
            font-size: 13px;
            color: var(--text-tertiary);
            font-family: var(--font-mono);
        }

    </style>
</head>
<body>

    <!-- 1. MAIN WINDOW DASHBOARD -->
    <div style="position: relative;">
        <div class="design-label">01. Dashboard</div>
        <div class="window-frame">
            <div class="title-bar">
                <div class="traffic-lights">
                    <div class="traffic-light close"></div>
                    <div class="traffic-light minimize"></div>
                    <div class="traffic-light maximize"></div>
                </div>
            </div>
            
            <div class="app-layout">
                <!-- Header -->
                <header class="app-header">
                    <div class="brand-area">
                        <img class="logo-icon" src="../public/logo.png" alt="" />
                        <div class="brand-text">Skills Hub</div>
                    </div>

                    <div class="header-actions">
                        <!-- Language Switcher -->
                        <button class="lang-btn">
                            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
                            EN
                        </button>

                        <!-- Settings Icon -->
                        <div class="icon-btn-header" title="Settings">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                                <circle cx="12" cy="12" r="3"></circle>
                                <path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"></path>
                            </svg>
                        </div>

                        <!-- New Skill Button -->
                        <button class="btn btn-primary">
                            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3">
                                <line x1="12" y1="5" x2="12" y2="19"></line>
                                <line x1="5" y1="12" x2="19" y2="12"></line>
                            </svg>
                            New Skill
                        </button>
                    </div>
                </header>

                <!-- Content -->
                <main class="main-content">
                    
                    <!-- Filter/Search Bar Area -->
                    <div class="filter-bar">
                        <div class="filter-title">All Skills</div>
                        <div style="display: flex; gap: 12px;">
                             <!-- Sort Simulation -->
                            <button class="btn btn-secondary" style="height: 36px; padding: 0 12px; font-weight: normal;">
                                <span style="color: var(--text-tertiary); margin-right: 4px;">Sort:</span> Recently Updated
                                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" style="margin-left: 4px;"><path d="M6 9l6 6 6-6"/></svg>
                            </button>
                            <div class="search-container">
                                <svg class="search-icon-abs" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                                    <circle cx="11" cy="11" r="8"></circle>
                                    <line x1="21" y1="21" x2="16.65" y2="16.65"></line>
                                </svg>
                                <input type="text" class="search-input" placeholder="Search skills..." />
                            </div>
                        </div>
                    </div>

                    <div class="skills-list">
                        
                        <!-- Discovered Section Banner -->
                        <div class="discovery-banner" style="display: flex; align-items: center; justify-content: space-between; background: #FFFBEB; border: 1px dashed #FCD34D; border-radius: var(--radius-lg); padding: 12px 20px; margin-bottom: 20px;">
                            <div style="display: flex; align-items: center; gap: 12px;">
                                <div style="width: 32px; height: 32px; background: rgba(245, 158, 11, 0.1); border-radius: var(--radius-md); display: flex; align-items: center; justify-content: center; color: var(--status-warning);">
                                    <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z"></path></svg>
                                </div>
                                <div>
                                    <div style="font-weight: 600; color: var(--text-primary); font-size: 14px;">3 New Skills Discovered</div>
                                    <div style="font-size: 12px; color: var(--text-secondary);">Found unmanaged skills in your local tools (Cursor, VS Code).</div>
                                </div>
                            </div>
                            <button class="btn btn-primary" style="background: var(--status-warning); border-color: var(--status-warning); color: #fff; height: 32px;">Review & Import</button>
                        </div>

                        <!-- Skill Card 1: Git Source -->
                        <div class="skill-card">
                            <div class="skill-icon">
                                <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg>
                            </div>
                            
                            <!-- Main Info -->
                            <div class="skill-main">
                                <div class="skill-header-row">
                                    <div class="skill-name">frontend-design</div>
                                    <div class="skill-version-badge">v2.1.0</div>
                                </div>
                                <div class="skill-meta-row">
                                    <div class="skill-source">
                                        <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg>
                                        vercel-labs/ai-sdk
                                    </div>
                                    <div class="skill-source">
                                        <span style="color: var(--text-tertiary);">•</span> Updated 2h ago
                                    </div>
                                </div>
                            </div>
                            
                            <!-- Status & Tools -->
                            <div class="skill-status-col">
                                <div class="status-label">Active Tools</div>
                                <div class="tool-matrix">
                                    <div class="tool-pill active" title="Synced"><div class="status-badge"></div> Cursor</div>
                                    <div class="tool-pill active" title="Synced"><div class="status-badge"></div> Claude</div>
                                    <div class="tool-pill inactive" title="Click to sync">VS Code</div>
                                </div>
                            </div>

                            <!-- Actions -->
                            <div class="skill-actions-col">
                                <button class="card-btn primary-action" title="Sync / Update">
                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                                        <path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16"></path>
                                        <path d="M8 16H3v5"></path>
                                        <path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8"></path>
                                        <path d="M16 8h5V3"></path>
                                    </svg>
                                </button>
                                <button class="card-btn danger-action" title="Delete">
                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 6h18"></path><path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6"></path><path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2"></path></svg>
                                </button>
                            </div>
                        </div>

                        <!-- Skill Card 2: Local Source -->
                        <div class="skill-card">
                            <div class="skill-icon">
                                <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></svg>
                            </div>
                            
                            <!-- Main Info -->
                            <div class="skill-main">
                                <div class="skill-header-row">
                                    <div class="skill-name">company-utils</div>
                                    <div class="skill-version-badge">local</div>
                                </div>
                                <div class="skill-meta-row">
                                    <div class="skill-source">
                                        <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></svg>
                                        ~/dev/company/skills/utils
                                    </div>
                                    <div class="skill-source">
                                        <span style="color: var(--text-tertiary);">•</span> Edited just now
                                    </div>
                                </div>
                            </div>
                            
                            <!-- Status & Tools -->
                            <div class="skill-status-col">
                                <div class="status-label">Active Tools</div>
                                <div class="tool-matrix">
                                    <div class="tool-pill active"><div class="status-badge"></div> Cursor</div>
                                    <div class="tool-pill disabled">Windsurf</div>
                                </div>
                            </div>

                            <!-- Actions -->
                            <div class="skill-actions-col">
                                <button class="card-btn primary-action" title="Sync / Update">
                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                                        <path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16"></path>
                                        <path d="M8 16H3v5"></path>
                                        <path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8"></path>
                                        <path d="M16 8h5V3"></path>
                                    </svg>
                                </button>
                                <button class="card-btn danger-action" title="Delete">
                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 6h18"></path><path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6"></path><path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2"></path></svg>
                                </button>
                            </div>
                        </div>

                    </div>
                </main>
            </div>
        </div>
    </div>

    <!-- 2. ADD SKILL FLOW (Replaces previous modal section) -->
    <div class="modal-showcase">
        
        <!-- Step 1: Add Skill (Simplified) -->
        <div style="position: relative;">
            <div class="design-label">02. Add Skill</div>
            <div class="modal-window">
                <div class="modal-header">
                    <div class="modal-title">Add New Skill</div>
                    <div class="modal-close">✕</div>
                </div>
                <div class="modal-body">
                    <div class="tabs">
                        <div class="tab-item">Local Folder</div>
                        <div class="tab-item active">Git Repository</div>
                        <div class="tab-item">Search</div>
                    </div>

                    <div class="form-group">
                        <label class="label">Repository URL</label>
                        <input type="text" class="input" value="https://github.com/cntrl-b/mono-skills" />
                    </div>

                    <div class="form-group" style="margin-top: 20px;">
                        <label class="label">Install to Tools</label>
                        <div class="tool-matrix" style="gap: 8px;">
                            <!-- Simulated installed tools (selected by default) -->
                            <div class="tool-pill active" style="cursor: pointer;">
                                <div class="status-badge"></div> Cursor
                            </div>
                            <div class="tool-pill active" style="cursor: pointer;">
                                <div class="status-badge"></div> Claude
                            </div>
                            <div class="tool-pill active" style="cursor: pointer;">
                                <div class="status-badge"></div> VS Code
                            </div>
                            <!-- Simulated uninstalled tool -->
                            <div class="tool-pill disabled" title="Not installed">
                                Windsurf
                            </div>
                        </div>
                        <div class="helper-text">Selected tools will sync immediately after installation.</div>
                    </div>
                </div>
                <div class="modal-footer">
                    <button class="btn btn-secondary">Cancel</button>
                    <button class="btn btn-primary">Install</button>
                </div>
            </div>
        </div>

        <!-- Step 2: Multi-Skill Selection -->
        <div style="position: relative;">
            <div class="design-label">03. Select Skills from Repo</div>
            <div class="modal-window">
                <div class="modal-header">
                    <div class="modal-title">Select Skills to Install</div>
                    <div class="modal-close">✕</div>
                </div>
                <div class="modal-body">
                    <p class="label" style="margin-bottom: 12px; color: var(--text-primary);">
                        We found multiple skills in this repository. Select the ones you want to install:
                    </p>
                    
                    <div class="onboarding-list" style="max-height: 200px; overflow-y: auto;">
                        <div class="import-item">
                            <div class="checkbox checked"></div>
                            <div class="import-details">
                                <div class="import-name">react-expert</div>
                                <div class="import-path">/packages/react-expert</div>
                            </div>
                        </div>
                        <div class="import-item">
                            <div class="checkbox"></div>
                            <div class="import-details">
                                <div class="import-name">python-data</div>
                                <div class="import-path">/packages/python-data</div>
                            </div>
                        </div>
                         <div class="import-item">
                            <div class="checkbox checked"></div>
                            <div class="import-details">
                                <div class="import-name">git-workflow</div>
                                <div class="import-path">/packages/git-workflow</div>
                            </div>
                        </div>
                    </div>
                </div>
                <div class="modal-footer">
                    <button class="btn btn-secondary">Cancel</button>
                    <button class="btn btn-primary">Install Selected (2)</button>
                </div>
            </div>
        </div>

        <!-- Step 3: Loading State -->
        <div style="position: relative;">
            <div class="design-label">04. Installing / Loading</div>
            <div class="modal-window" style="height: 200px;">
                <div class="loading-content">
                    <div class="loader-spinner"></div>
                    <div class="loading-text">Installing Skills...</div>
                    <div class="loading-subtext">Cloning repository and syncing to tools</div>
                    
                    <div style="width: 200px; margin-top: 12px;">
                        <div class="progress-bar">
                            <div class="progress-fill"></div>
                        </div>
                    </div>
                </div>
            </div>
        </div>

    </div>

    <!-- 3. OTHER MODALS -->
    <div class="modal-showcase" style="margin-top: 60px;">
        <!-- Settings Modal (Cleaned up) -->
        <div style="position: relative;">
            <div class="design-label">05. Settings Modal (I18n)</div>
            <div class="modal-window" style="width: 540px;">
                <div class="modal-header">
                    <div class="modal-title">Settings</div>
                    <div class="modal-close">✕</div>
                </div>
                <div class="modal-body">
                    
                    <!-- Language Setting -->
                    <div class="form-group" style="margin-bottom: 24px;">
                        <label class="label">Interface Language</label>
                        <div style="position: relative;">
                            <select class="input" style="appearance: none; cursor: pointer; font-family: var(--font-ui);">
                                <option value="en" selected>English</option>
                                <option value="zh">中文 (Chinese)</option>
                            </select>
                            <svg style="position: absolute; right: 12px; top: 50%; transform: translateY(-50%); pointer-events: none; color: var(--text-tertiary);" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg>
                        </div>
                    </div>

                    <div class="form-group" style="margin-top: 8px;">
                        <label class="label">Skills Storage Path</label>
                        <div style="display: flex; gap: 8px;">
                            <input type="text" class="input" value="/Users/username/.skills-hub/storage" readonly />
                            <button class="btn btn-secondary">Browse</button>
                        </div>
                        <div class="helper-text">Local copies of Git skills will be stored here.</div>
                    </div>
                    
                    <h3 style="font-size: 13px; font-weight: 600; color: var(--text-primary); margin: 24px 0 12px 0;">Updates & Maintenance</h3>
                    <div class="settings-list">
                        <div class="setting-item">
                            <div class="setting-info">
                                <div class="setting-label">Auto-update Skills</div>
                                <div class="setting-desc">Automatically pull changes for Git skills every 24h</div>
                            </div>
                            <div class="toggle checked"><div class="toggle-knob"></div></div>
                        </div>
                        <div class="setting-item">
                            <div class="setting-info">
                                <div class="setting-label">Storage Cleanup</div>
                                <div class="setting-desc">Clean up temporary download files (240MB)</div>
                            </div>
                            <button class="btn btn-secondary" style="height: 28px;">Clean Now</button>
                        </div>
                    </div>
                    <div style="margin-top: 24px; padding-top: 20px; border-top: 1px solid var(--border-subtle); text-align: center;">
                         <div style="font-size: 12px; color: var(--text-tertiary);">Skills Hub v1.0.0</div>
                    </div>
                </div>
                <div class="modal-footer">
                    <button class="btn btn-primary" style="width: 100%;">Done</button>
                </div>
            </div>
        </div>

        <!-- Delete Confirmation Modal -->
        <div style="position: relative;">
            <div class="design-label">06. Delete Confirmation</div>
            <div class="modal-window" style="width: 400px;">
                <div class="modal-header" style="border-bottom: none; padding-bottom: 0;">
                    <div class="modal-title" style="color: var(--status-error); display: flex; align-items: center; gap: 8px;">
                        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"></path><line x1="12" y1="9" x2="12" y2="13"></line><line x1="12" y1="17" x2="12.01" y2="17"></line></svg>
                        Delete Skill?
                    </div>
                </div>
                <div class="modal-body">
                    <p style="font-size: 14px; color: var(--text-secondary); line-height: 1.5; margin-bottom: 16px;">
                        Are you sure you want to delete <strong style="color: var(--text-primary);">frontend-design</strong>?
                    </p>
                    <div style="background: rgba(220, 38, 38, 0.05); border: 1px solid rgba(220, 38, 38, 0.1); border-radius: var(--radius-md); padding: 12px;">
                        <ul style="list-style: none; font-size: 12px; color: var(--text-secondary);">
                            <li style="display: flex; gap: 8px; margin-bottom: 4px;"><span style="color: var(--status-error);">•</span> Remove from <strong style="color: var(--text-primary);">Cursor</strong>, <strong style="color: var(--text-primary);">Claude</strong></li>
                            <li style="display: flex; gap: 8px;"><span style="color: var(--status-error);">•</span> Delete local copy from Hub</li>
                        </ul>
                    </div>
                </div>
                <div class="modal-footer space-between">
                    <button class="btn btn-secondary">Cancel</button>
                    <button class="btn btn-danger-solid">Yes, Delete</button>
                </div>
            </div>
        </div>

        <!-- Import Discovered Skills Modal -->
        <div style="position: relative;">
            <div class="design-label">07. Import Discovered</div>
            <div class="modal-window" style="width: 500px;">
                <div class="modal-header">
                    <div class="modal-title">Import Discovered Skills</div>
                    <div class="modal-close">✕</div>
                </div>
                <div class="modal-body">
                    <p class="label" style="margin-bottom: 12px; color: var(--text-secondary);">
                        Select skills to take over and manage in Hub.
                    </p>
                    
                    <div class="onboarding-list" style="max-height: 250px; overflow-y: auto;">
                        <div class="import-item">
                            <div class="checkbox checked"></div>
                            <div class="import-details">
                                <div class="import-name">legacy-chat-skills</div>
                                <div class="import-path" style="margin-bottom: 4px;">~/.cursor/extensions/cursor-skills/legacy</div>
                                <div style="display: flex; gap: 8px; align-items: center;">
                                    <div class="tool-pill active" style="height: 18px; font-size: 10px; border-color: rgba(245, 158, 11, 0.3); background: rgba(245, 158, 11, 0.05); color: var(--status-warning);">
                                        Found in Cursor
                                    </div>
                                </div>
                            </div>
                        </div>
                        <div class="import-item">
                            <div class="checkbox checked"></div>
                            <div class="import-details">
                                <div class="import-name">python-snippets</div>
                                <div class="import-path" style="margin-bottom: 4px;">~/.vscode/extensions/python-snippets</div>
                                <div style="display: flex; gap: 8px; align-items: center;">
                                    <div class="tool-pill active" style="height: 18px; font-size: 10px; border-color: rgba(245, 158, 11, 0.3); background: rgba(245, 158, 11, 0.05); color: var(--status-warning);">
                                        Found in VS Code
                                    </div>
                                </div>
                            </div>
                        </div>
                        <div class="import-item">
                            <div class="checkbox"></div>
                            <div class="import-details">
                                <div class="import-name">random-utils</div>
                                <div class="import-path" style="margin-bottom: 4px;">~/Downloads/random-utils</div>
                                <div style="display: flex; gap: 8px; align-items: center;">
                                    <div class="tool-pill active" style="height: 18px; font-size: 10px; border-color: rgba(245, 158, 11, 0.3); background: rgba(245, 158, 11, 0.05); color: var(--status-warning);">
                                        Found in Cursor
                                    </div>
                                    <span style="font-size: 10px; color: var(--text-tertiary);">Duplicate?</span>
                                </div>
                            </div>
                        </div>
                    </div>
                </div>
                <div class="modal-footer">
                    <button class="btn btn-secondary">Ignore All</button>
                    <button class="btn btn-primary">Import Selected (2)</button>
                </div>
            </div>
        </div>
    </div>

</body>
</html>


================================================
FILE: docs/skills_hub_v2_design.html
================================================
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Skills Hub V2 - Design Preview</title>
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Fira+Sans:wght@300;400;500;600;700&family=Fira+Code:wght@400;500;600;700&display=swap" rel="stylesheet">
    <style>
        :root {
            --bg-app: #ffffff;
            --bg-panel: #fcfcfc;
            --bg-element: #f4f4f5;
            --bg-element-hover: #e4e4e7;
            --border-subtle: #e4e4e7;
            --border-strong: #d4d4d8;
            --text-primary: #18181b;
            --text-secondary: #52525b;
            --text-tertiary: #a1a1aa;
            --accent-primary: #2563EB;
            --accent-primary-hover: #1D4ED8;
            --accent-primary-fg: #FFFFFF;
            --accent-primary-light: #EFF6FF;
            --accent-primary-border: #BFDBFE;
            --status-success: #059669;
            --status-success-light: #ECFDF5;
            --status-success-border: #A7F3D0;
            --status-warning: #d97706;
            --status-warning-light: #FFFBEB;
            --status-error: #dc2626;
            --status-info: #2563EB;
            --font-ui: 'Fira Sans', system-ui, -apple-system, sans-serif;
            --font-mono: 'Fira Code', monospace;
            --radius-sm: 4px;
            --radius-md: 8px;
            --radius-lg: 12px;
            --radius-xl: 16px;
            --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
            --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.07), 0 2px 4px -2px rgb(0 0 0 / 0.05);
            --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.08), 0 4px 6px -4px rgb(0 0 0 / 0.03);
        }

        * { box-sizing: border-box; margin: 0; padding: 0; }

        body {
            background-color: #e5e5e5;
            color: var(--text-primary);
            font-family: var(--font-ui);
            padding: 40px;
            display: flex;
            flex-direction: column;
            align-items: center;
            gap: 60px;
            min-height: 100vh;
            -webkit-font-smoothing: antialiased;
        }

        /* ===== Design Labels ===== */
        .design-label {
            position: absolute;
            top: -30px;
            left: 0;
            font-family: var(--font-mono);
            font-size: 12px;
            color: var(--text-secondary);
            text-transform: uppercase;
            letter-spacing: 0.1em;
        }

        /* ===== Window Frame ===== */
        .window-frame {
            position: relative;
            width: 1000px;
            height: 700px;
            background: var(--bg-app);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
            display: flex;
            flex-direction: column;
            overflow: hidden;
        }

        .title-bar {
            height: 40px;
            background: var(--bg-app);
            border-bottom: 1px solid var(--border-subtle);
            display: flex;
            align-items: center;
            padding: 0 16px;
            flex-shrink: 0;
        }
        .traffic-lights { display: flex; gap: 8px; }
        .traffic-light { width: 12px; height: 12px; border-radius: 50%; }
        .traffic-light.close { background: #ff5f56; border: 1px solid rgba(0,0,0,0.1); }
        .traffic-light.minimize { background: #ffbd2e; border: 1px solid rgba(0,0,0,0.1); }
        .traffic-light.maximize { background: #27c93f; border: 1px solid rgba(0,0,0,0.1); }

        /* ===== App Header ===== */
        .app-header {
            height: 56px;
            padding: 0 24px;
            display: flex;
            align-items: center;
            justify-content: space-between;
            border-bottom: 1px solid var(--border-subtle);
            background: var(--bg-app);
            flex-shrink: 0;
            z-index: 10;
        }
        .header-left {
            display: flex;
            align-items: center;
            gap: 24px;
        }
        .brand-area {
            display: flex;
            align-items: center;
            gap: 10px;
        }
        .brand-icon {
            width: 28px;
            height: 28px;
            background: linear-gradient(135deg, #2563EB, #7C3AED);
            border-radius: var(--radius-md);
            display: flex;
            align-items: center;
            justify-content: center;
        }
        .brand-icon svg { width: 16px; height: 16px; color: white; }
        .brand-text {
            font-weight: 700;
            font-size: 17px;
            letter-spacing: -0.03em;
            color: var(--text-primary);
        }

        /* ===== Nav Tabs (in header) ===== */
        .nav-tabs {
            display: flex;
            align-items: center;
            gap: 4px;
            height: 100%;
        }
        .nav-tab {
            height: 100%;
            display: flex;
            align-items: center;
            gap: 6px;
            padding: 0 14px;
            font-size: 13px;
            font-weight: 500;
            color: var(--text-tertiary);
            cursor: pointer;
            border: none;
            background: none;
            position: relative;
            transition: color 0.2s;
            font-family: var(--font-ui);
        }
        .nav-tab:hover { color: var(--text-secondary); }
        .nav-tab.active {
            color: var(--accent-primary);
            font-weight: 600;
        }
        .nav-tab.active::after {
            content: '';
            position: absolute;
            bottom: 0;
            left: 8px;
            right: 8px;
            height: 2px;
            background: var(--accent-primary);
            border-radius: 2px 2px 0 0;
        }
        .nav-tab svg { width: 16px; height: 16px; }

        .header-actions {
            display: flex;
            align-items: center;
            gap: 10px;
        }
        .lang-btn {
            font-size: 12px;
            font-weight: 500;
            color: var(--text-secondary);
            cursor: pointer;
            padding: 5px 10px;
            border-radius: var(--radius-sm);
            background: transparent;
            border: 1px solid var(--border-subtle);
            font-family: var(--font-mono);
            transition: all 0.2s;
        }
        .lang-btn:hover {
            color: var(--text-primary);
            background: var(--bg-element);
        }
        .icon-btn {
            width: 32px;
            height: 32px;
            display: flex;
            align-items: center;
            justify-content: center;
            border-radius: var(--radius-md);
            color: var(--text-secondary);
            cursor: pointer;
            transition: all 0.2s;
            border: none;
            background: none;
        }
        .icon-btn:hover {
            background: var(--bg-element);
            color: var(--text-primary);
        }
        .icon-btn svg { width: 18px; height: 18px; }

        /* ===== Shared ===== */
        .app-body { flex: 1; display: flex; flex-direction: column; overflow: hidden; }

        .btn {
            height: 32px;
            padding: 0 14px;
            border-radius: var(--radius-md);
            font-size: 13px;
            font-weight: 500;
            cursor: pointer;
            display: inline-flex;
            align-items: center;
            gap: 6px;
            border: 1px solid transparent;
            transition: all 0.2s;
            font-family: var(--font-ui);
            white-space: nowrap;
        }
        .btn svg { width: 14px; height: 14px; }
        .btn-primary {
            background: var(--accent-primary);
            color: var(--accent-primary-fg);
        }
        .btn-primary:hover {
            background: var(--accent-primary-hover);
        }
        .btn-secondary {
            background: transparent;
            border-color: var(--border-subtle);
            color: var(--text-primary);
        }
        .btn-secondary:hover {
            border-color: var(--border-strong);
            background: var(--bg-element);
        }
        .btn-ghost {
            background: transparent;
            color: var(--text-secondary);
            border: none;
            padding: 0 8px;
        }
        .btn-ghost:hover { color: var(--text-primary); background: var(--bg-element); }
        .btn-sm { height: 28px; padding: 0 10px; font-size: 12px; }
        .btn-install {
            background: var(--accent-primary);
            color: white;
            height: 30px;
            padding: 0 14px;
            font-size: 12px;
            font-weight: 600;
            border-radius: var(--radius-md);
            border: none;
            cursor: pointer;
            transition: all 0.2s;
            font-family: var(--font-ui);
        }
        .btn-install:hover { background: var(--accent-primary-hover); }
        .btn-installed {
            background: var(--status-success-light);
            color: var(--status-success);
            height: 30px;
            padding: 0 14px;
            font-size: 12px;
            font-weight: 600;
            border-radius: var(--radius-md);
            border: 1px solid var(--status-success-border);
            cursor: default;
            font-family: var(--font-ui);
        }

        /* ============================================
           VIEW 1: MY SKILLS
           ============================================ */
        .view-myskills { flex: 1; display: flex; flex-direction: column; overflow: hidden; }

        /* Sub-header / toolbar */
        .toolbar {
            padding: 16px 24px;
            display: flex;
            align-items: center;
            justify-content: space-between;
            flex-shrink: 0;
        }
        .toolbar-left {
            display: flex;
            align-items: center;
            gap: 12px;
        }
        .toolbar-title {
            font-size: 13px;
            font-weight: 500;
            color: var(--text-secondary);
        }
        .toolbar-count {
            font-size: 12px;
            color: var(--text-tertiary);
            font-family: var(--font-mono);
            background: var(--bg-element);
            padding: 2px 8px;
            border-radius: 10px;
        }
        .toolbar-right {
            display: flex;
            align-items: center;
            gap: 8px;
        }

        .search-box {
            position: relative;
        }
        .search-box input {
            background: var(--bg-panel);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            height: 32px;
            padding: 0 12px 0 32px;
            color: var(--text-primary);
            width: 200px;
            font-size: 13px;
            transition: all 0.2s;
            font-family: var(--font-ui);
        }
        .search-box input:focus {
            outline: none;
            border-color: var(--accent-primary);
            box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
            width: 240px;
        }
        .search-box input::placeholder { color: var(--text-tertiary); }
        .search-box svg {
            position: absolute;
            left: 10px;
            top: 50%;
            transform: translateY(-50%);
            width: 14px;
            height: 14px;
            color: var(--text-tertiary);
            pointer-events: none;
        }

        /* Skills List */
        .skills-scroll {
            flex: 1;
            overflow-y: auto;
            padding: 0 24px 24px 24px;
        }

        /* Discovery banner */
        .discovery-banner {
            display: flex;
            align-items: center;
            justify-content: space-between;
            padding: 12px 16px;
            background: var(--accent-primary-light);
            border: 1px solid var(--accent-primary-border);
            border-radius: var(--radius-lg);
            margin-bottom: 12px;
        }
        .discovery-left {
            display: flex;
            align-items: center;
            gap: 10px;
        }
        .discovery-icon {
            width: 32px;
            height: 32px;
            background: var(--accent-primary);
            border-radius: var(--radius-md);
            display: flex;
            align-items: center;
            justify-content: center;
            color: white;
            flex-shrink: 0;
        }
        .discovery-icon svg { width: 16px; height: 16px; }
        .discovery-text { font-size: 13px; color: var(--text-primary); font-weight: 500; }
        .discovery-sub { font-size: 12px; color: var(--text-secondary); margin-top: 1px; }

        /* Skill Card - matches current implementation */
        .skill-row {
            display: flex;
            align-items: flex-start;
            gap: 16px;
            padding: 16px 20px;
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            margin-bottom: 8px;
            transition: all 0.2s;
            cursor: pointer;
            background: var(--bg-app);
            position: relative;
        }
        .skill-row:hover {
            border-color: var(--border-strong);
            background: var(--bg-panel);
            box-shadow: var(--shadow-sm);
        }

        .skill-icon-sm {
            width: 44px;
            height: 44px;
            background: var(--bg-element);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            display: flex;
            align-items: center;
            justify-content: center;
            color: var(--text-secondary);
            flex-shrink: 0;
            margin-top: 2px;
        }
        .skill-icon-sm svg { width: 20px; height: 20px; }
        .skill-row:hover .skill-icon-sm {
            border-color: var(--border-strong);
            color: var(--text-primary);
        }

        .skill-info { display: flex; flex-direction: column; gap: 6px; min-width: 0; flex: 1; }
        .skill-name-row { display: flex; align-items: center; gap: 8px; }
        .skill-name {
            font-weight: 700;
            font-size: 15px;
            color: var(--text-primary);
            white-space: nowrap;
            overflow: hidden;
            text-overflow: ellipsis;
        }
        .skill-desc {
            font-size: 13px;
            color: var(--text-secondary);
            line-height: 1.5;
            display: -webkit-box;
            -webkit-line-clamp: 2;
            -webkit-box-orient: vertical;
            overflow: hidden;
        }
        .skill-source-row {
            display: flex;
            align-items: center;
            gap: 8px;
        }
        .skill-source {
            font-family: var(--font-mono);
            font-size: 12px;
            color: var(--text-tertiary);
            background: var(--bg-element);
            padding: 2px 8px;
            border-radius: var(--radius-sm);
            white-space: nowrap;
            overflow: hidden;
            text-overflow: ellipsis;
            max-width: 260px;
        }
        .skill-time {
            font-size: 12px;
            color: var(--text-tertiary);
        }

        /* Tool Badges - only show synced, compact */
        .tool-badges { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 2px; }
        .tool-badge {
            font-size: 11px;
            font-weight: 500;
            padding: 2px 8px;
            border-radius: 10px;
            white-space: nowrap;
            display: flex;
            align-items: center;
            gap: 4px;
        }
        .tool-badge.synced {
            background: var(--status-success-light);
            color: var(--status-success);
            border: 1px solid var(--status-success-border);
        }
        .tool-badge.synced::before {
            content: '';
            width: 5px;
            height: 5px;
            border-radius: 50%;
            background: var(--status-success);
        }
        .tool-badge.more {
            background: var(--bg-element);
            color: var(--text-tertiary);
            border: 1px solid var(--border-subtle);
            font-family: var(--font-mono);
            font-size: 10px;
        }

        /* Row actions - always visible, top-right */
        .row-actions {
            display: flex;
            align-items: center;
            gap: 2px;
            flex-shrink: 0;
            margin-top: 2px;
        }
        .action-btn {
            width: 32px;
            height: 32px;
            display: flex;
            align-items: center;
            justify-content: center;
            border-radius: var(--radius-md);
            color: var(--text-tertiary);
            cursor: pointer;
            transition: all 0.15s;
            border: none;
            background: none;
        }
        .action-btn:hover { background: var(--bg-element); color: var(--text-primary); }
        .action-btn.danger:hover { background: #FEF2F2; color: var(--status-error); }
        .action-btn svg { width: 16px; height: 16px; }



        /* ============================================
           VIEW 2: EXPLORE SKILLS
           ============================================ */
        .view-explore { flex: 1; display: flex; flex-direction: column; overflow: hidden; }

        /* Explore Hero / Search */
        .explore-hero {
            padding: 28px 32px 20px 32px;
            flex-shrink: 0;
        }
        .explore-search-row {
            display: flex;
            align-items: center;
            gap: 12px;
        }
        .explore-search {
            flex: 1;
            position: relative;
        }
        .explore-search input {
            width: 100%;
            height: 40px;
            background: var(--bg-panel);
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            padding: 0 16px 0 40px;
            font-size: 14px;
            color: var(--text-primary);
            transition: all 0.2s;
            font-family: var(--font-ui);
        }
        .explore-search input:focus {
            outline: none;
            border-color: var(--accent-primary);
            box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.1);
        }
        .explore-search input::placeholder { color: var(--text-tertiary); }
        .explore-search svg {
            position: absolute;
            left: 14px;
            top: 50%;
            transform: translateY(-50%);
            width: 16px;
            height: 16px;
            color: var(--text-tertiary);
            pointer-events: none;
        }
        .explore-source-label {
            font-size: 11px;
            color: var(--text-tertiary);
            margin-top: 8px;
            padding-left: 4px;
        }
        .explore-source-label a {
            color: var(--accent-primary);
            text-decoration: none;
        }

        /* Category Pills */
        .category-bar {
            display: flex;
            align-items: center;
            gap: 6px;
            padding: 0 32px 16px 32px;
            flex-shrink: 0;
            overflow-x: auto;
        }
        .category-pill {
            height: 28px;
            padding: 0 12px;
            border-radius: 14px;
            font-size: 12px;
            font-weight: 500;
            border: 1px solid var(--border-subtle);
            background: var(--bg-app);
            color: var(--text-secondary);
            cursor: pointer;
            transition: all 0.2s;
            white-space: nowrap;
            font-family: var(--font-ui);
        }
        .category-pill:hover {
            border-color: var(--border-strong);
            background: var(--bg-element);
        }
        .category-pill.active {
            background: var(--accent-primary);
            color: white;
            border-color: var(--accent-primary);
        }

        /* Explore Grid */
        .explore-scroll {
            flex: 1;
            overflow-y: auto;
            padding: 0 32px 32px 32px;
        }
        .explore-section-title {
            font-size: 13px;
            font-weight: 600;
            color: var(--text-secondary);
            text-transform: uppercase;
            letter-spacing: 0.04em;
            margin-bottom: 12px;
            display: flex;
            align-items: center;
            gap: 8px;
        }
        .explore-section-title svg { width: 14px; height: 14px; color: var(--text-tertiary); }

        .explore-grid {
            display: grid;
            grid-template-columns: repeat(2, 1fr);
            gap: 10px;
            margin-bottom: 28px;
        }

        .explore-card {
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-lg);
            padding: 16px;
            display: flex;
            flex-direction: column;
            gap: 10px;
            transition: all 0.2s;
            cursor: pointer;
            background: var(--bg-app);
        }
        .explore-card:hover {
            border-color: var(--border-strong);
            box-shadow: var(--shadow-md);
        }

        .explore-card-top {
            display: flex;
            align-items: flex-start;
            justify-content: space-between;
            gap: 12px;
        }
        .explore-card-info {
            flex: 1;
            min-width: 0;
        }
        .explore-card-name {
            font-weight: 600;
            font-size: 14px;
            color: var(--text-primary);
            margin-bottom: 2px;
        }
        .explore-card-author {
            font-family: var(--font-mono);
            font-size: 11px;
            color: var(--text-tertiary);
        }
        .explore-card-desc {
            font-size: 12.5px;
            color: var(--text-secondary);
            line-height: 1.5;
            display: -webkit-box;
            -webkit-line-clamp: 2;
            -webkit-box-orient: vertical;
            overflow: hidden;
        }
        .explore-card-bottom {
            display: flex;
            align-items: center;
            justify-content: space-between;
            gap: 8px;
        }
        .explore-card-stats {
            display: flex;
            align-items: center;
            gap: 12px;
        }
        .explore-stat {
            display: flex;
            align-items: center;
            gap: 4px;
            font-size: 11px;
            color: var(--text-tertiary);
        }
        .explore-stat svg { width: 12px; height: 12px; }
        .explore-card-tools {
            display: flex;
            gap: 3px;
            flex-wrap: wrap;
        }
        .mini-tool-badge {
            font-size: 10px;
            font-weight: 500;
            padding: 1px 6px;
            border-radius: 8px;
            background: var(--bg-element);
            color: var(--text-tertiary);
            border: 1px solid var(--border-subtle);
        }

        /* ============================================
           VIEW 3: MANUAL ADD (modal - kept simple)
           ============================================ */
        .modal-backdrop {
            position: absolute;
            inset: 0;
            background: rgba(0,0,0,0.3);
            display: flex;
            align-items: center;
            justify-content: center;
            z-index: 100;
            backdrop-filter: blur(2px);
        }
        .modal {
            background: var(--bg-app);
            border-radius: var(--radius-xl);
            width: 460px;
            box-shadow: var(--shadow-lg);
            border: 1px solid var(--border-subtle);
            overflow: hidden;
        }
        .modal-header {
            padding: 20px 24px 16px 24px;
            display: flex;
            align-items: center;
            justify-content: space-between;
        }
        .modal-title { font-size: 16px; font-weight: 600; color: var(--text-primary); }
        .modal-close {
            width: 28px; height: 28px;
            display: flex; align-items: center; justify-content: center;
            border-radius: var(--radius-md);
            border: none; background: none;
            color: var(--text-tertiary); cursor: pointer;
            font-size: 16px; transition: all 0.15s;
        }
        .modal-close:hover { background: var(--bg-element); color: var(--text-primary); }

        .modal-tabs {
            display: flex;
            gap: 0;
            padding: 0 24px;
            border-bottom: 1px solid var(--border-subtle);
        }
        .modal-tab {
            padding: 8px 14px;
            font-size: 13px;
            font-weight: 500;
            color: var(--text-tertiary);
            cursor: pointer;
            border: none;
            background: none;
            position: relative;
            transition: color 0.2s;
            font-family: var(--font-ui);
        }
        .modal-tab:hover { color: var(--text-secondary); }
        .modal-tab.active { color: var(--accent-primary); }
        .modal-tab.active::after {
            content: '';
            position: absolute;
            bottom: -1px;
            left: 8px; right: 8px;
            height: 2px;
            background: var(--accent-primary);
            border-radius: 2px 2px 0 0;
        }

        .modal-body { padding: 20px 24px; }
        .form-group { margin-bottom: 16px; }
        .form-label {
            display: block;
            font-size: 13px;
            font-weight: 500;
            color: var(--text-secondary);
            margin-bottom: 6px;
        }
        .form-input {
            width: 100%;
            height: 36px;
            border: 1px solid var(--border-subtle);
            border-radius: var(--radius-md);
            padding: 0 12px;
            font-size: 13px;
            color: var(--text-primary);
            background: var(--bg-panel);
            font-family: var(--font-ui);
            transition: all 0.2s;
        }
        .form-input:focus {
            outline: none;
            border-color: var(--accent-primary);
            box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
        }
        .form-input::placeholder { color: var(--text-tertiary); }
        .form-hint { font-size: 11px; color: var(--text-tertiary); margin-top: 4px; }

        .tool-selector { display: flex; flex-wrap: wrap; gap: 6px; }
        .tool-chip {
            display: flex;
            align-items: center;
            gap: 4px;
            height: 28px;
            padding: 0 10px;
            border-radius: 14px;
            font-size: 12px;
            font-weight: 500;
            border: 1px solid var(--border-subtle);
            background: var(--bg-app);
            color: var(--text-secondary);
            cursor: pointer;
            transition: all 0.15s;
        }
        .tool-chip:hover { border-color: var(--border-strong); }
        .tool-chip.selected {
            background: var(--accent-primary-light);
            border-color: var(--accent-primary-border);
            color: var(--accent-primary);
        }
        .tool-chip .dot {
            width: 6px; height: 6px; border-radius: 50%;
            background: var(--status-success);
            display: none;
        }
        .tool-chip.selected .dot { display: block; }

        .modal-footer {
            padding: 16px 24px;
            display: flex;
            justify-content: flex-end;
            gap: 8px;
            border-top: 1px solid var(--border-subtle);
        }

        /* ===== Install Confirmation Toast ===== */
        .install-toast {
            position: absolute;
            bottom: 20px;
            left: 50%;
            transform: translateX(-50%);
            background: var(--text-primary);
            color: white;
            padding: 10px 20px;
            border-radius: var(--radius-lg);
            font-size: 13px;
            font-weight: 500;
            display: flex;
            align-items: center;
            gap: 8px;
            box-shadow: var(--shadow-lg);
            z-index: 200;
        }
        .install-toast svg { width: 16px; height: 16px; color: #34D399; }

        /* ===== Utilities ===== */
        .hidden { display: none !important; }
        .flex-center { display: flex; align-items: center; justify-content: center; }

        /* Scrollbar */
        ::-webkit-scrollbar { width: 6px; }
        ::-webkit-scrollbar-track { background: transparent; }
        ::-webkit-scrollbar-thumb {
            background: var(--border-strong);
            border-radius: 3px;
        }
        ::-webkit-scrollbar-thumb:hover { background: var(--text-tertiary); }

        /* ===== Annotation callouts ===== */
        .annotation {
            position: absolute;
            font-family: var(--font-mono);
            font-size: 11px;
            color: var(--accent-primary);
            pointer-events: none;
            z-index: 50;
        }
        .annotation::before {
            content: '';
            position: absolute;
            width: 6px; height: 6px;
            background: var(--accent-primary);
            border-radius: 50%;
        }
    </style>
</head>
<body>

<!-- ==========================================
     SCREEN 1: MY SKILLS (Main View)
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 1 — My Skills</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab active">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/><line x1="12" y1="13" x2="12" y2="17"/><line x1="8" y1="13" x2="8" y2="17"/><line x1="16" y1="13" x2="16" y2="17"/></svg>
                    My Skills
                </button>
                <button class="nav-tab">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    Explore
                </button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn" aria-label="Settings">
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>
            </button>
        </div>
    </div>

    <div class="app-body">
        <div class="view-myskills">
            <div class="toolbar">
                <div class="toolbar-left">
                    <span class="toolbar-title">All Skills</span>
                    <span class="toolbar-count">5</span>
                    <button class="btn btn-sm btn-secondary">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"/></svg>
                        Latest
                    </button>
                </div>
                <div class="toolbar-right">
                    <div class="search-box">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                        <input type="text" placeholder="Search skills..." />
                    </div>
                    <button class="btn btn-sm btn-secondary">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg>
                        Refresh
                    </button>
                </div>
            </div>

            <div class="skills-scroll">
                <!-- Discovery Banner -->
                <div class="discovery-banner">
                    <div class="discovery-left">
                        <div class="discovery-icon">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                        </div>
                        <div>
                            <div class="discovery-text">Found 5 existing skills on your system</div>
                            <div class="discovery-sub">Click to review and import them</div>
                        </div>
                    </div>
                    <button class="btn btn-sm btn-primary">Review & Import</button>
                </div>

                <!-- Skill Row 1: react -->
                <div class="skill-row">
                    <div class="skill-icon-sm">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                    </div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name">react</span>
                        </div>
                        <div class="skill-desc">React renderer for json-render that turns JSON specs into React components. Use when working with @json-render/react, building React UIs from JSON, creating component catalogs.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">vercel-labs/json-render</span>
                            <span class="skill-time">&middot; 22 min ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Codex</span>
                            <span class="tool-badge synced">OpenCode</span>
                            <span class="tool-badge synced">Antigravity</span>
                            <span class="tool-badge more">+5 more</span>
                        </div>

                    </div>
                    <div class="row-actions">
                        <button class="action-btn" aria-label="Sync">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg>
                        </button>
                        <button class="action-btn danger" aria-label="Delete">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg>
                        </button>
                    </div>
                </div>

                <!-- Skill Row 2: baoyu-article-illustrator (9/10 synced, Cline unsynced) -->
                <div class="skill-row">
                    <div class="skill-icon-sm">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                    </div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name">baoyu-article-illustrator</span>
                        </div>
                        <div class="skill-desc">Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type x Style two-dimension approach.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">JimLiu/baoyu-skills</span>
                            <span class="skill-time">&middot; 31 days ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Codex</span>
                            <span class="tool-badge synced">OpenCode</span>
                            <span class="tool-badge synced">Antigravity</span>
                            <span class="tool-badge more">+4 more</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn" aria-label="Sync"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger" aria-label="Delete"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>

                <!-- Skill Row 3: excalidraw-diagram -->
                <div class="skill-row">
                    <div class="skill-icon-sm">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                    </div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name">excalidraw-diagram</span>
                        </div>
                        <div class="skill-desc">Generate Excalidraw diagrams from text content. Supports Obsidian, Standard, and Animated output modes for flowcharts, mind maps, and visualizations.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">axtonliu/axton-obsidian-visual-skills</span>
                            <span class="skill-time">&middot; 37 days ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Codex</span>
                            <span class="tool-badge synced">OpenCode</span>
                            <span class="tool-badge synced">Antigravity</span>
                            <span class="tool-badge more">+4 more</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn" aria-label="Sync"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger" aria-label="Delete"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>

                <!-- Skill Row 4: youtube-transcript (local, fewer synced) -->
                <div class="skill-row">
                    <div class="skill-icon-sm">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z"/></svg>
                    </div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name">youtube-transcript</span>
                        </div>
                        <div class="skill-desc">Download YouTube video transcripts. Use when user provides a YouTube URL or asks to download/get/fetch captions or subtitles from a video.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">/Users/may/Library/Application Support/com...</span>
                            <span class="skill-time">&middot; 45 days ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Codex</span>
                            <span class="tool-badge synced">OpenCode</span>
                            <span class="tool-badge synced">Antigravity</span>
                            <span class="tool-badge more">+3 more</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn" aria-label="Sync"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger" aria-label="Delete"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>

                <!-- Skill Row 5: frontend-design -->
                <div class="skill-row">
                    <div class="skill-icon-sm">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                    </div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name">frontend-design</span>
                        </div>
                        <div class="skill-desc">Frontend design best practices and guidelines for building modern, accessible web interfaces with React and CSS.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">anthropics/skills</span>
                            <span class="skill-time">&middot; 46 days ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Codex</span>
                            <span class="tool-badge synced">OpenCode</span>
                            <span class="tool-badge synced">Antigravity</span>
                            <span class="tool-badge more">+3 more</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn" aria-label="Sync"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger" aria-label="Delete"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>


<!-- ==========================================
     SCREEN 2: EXPLORE SKILLS (Marketplace)
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 2 — Explore Skills (Marketplace)</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/><line x1="12" y1="13" x2="12" y2="17"/><line x1="8" y1="13" x2="8" y2="17"/><line x1="16" y1="13" x2="16" y2="17"/></svg>
                    My Skills
                </button>
                <button class="nav-tab active">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    Explore
                </button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn" aria-label="Settings">
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>
            </button>
        </div>
    </div>

    <div class="app-body">
        <div class="view-explore">
            <!-- Search Area -->
            <div class="explore-hero">
                <div class="explore-search-row">
                    <div class="explore-search">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                        <input type="text" placeholder="Search skills by name, description, or keyword..." />
                    </div>
                    <button class="btn btn-secondary" style="height:40px; padding: 0 16px; flex-shrink:0;">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="width:15px;height:15px;"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>
                        Manual
                    </button>
                </div>
                <div class="explore-source-label">Data from <a>clawhub.ai</a> &middot; Have a Git URL or local path? Click <b>Manual</b> to add directly</div>
            </div>

            <!-- Skills Grid -->
            <div class="explore-scroll">
                <!-- Featured Section -->
                <div class="explore-section-title">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                    Featured
                </div>
                <div class="explore-grid">
                    <!-- Card 1 -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">self-improving-agent</div>
                                <div class="explore-card-author">dmarx/bench-warmers</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or approach fails...</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    199.1K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    1.9K
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+5</span>
                            </div>
                        </div>
                    </div>

                    <!-- Card 2 -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Find Skills</div>
                                <div class="explore-card-author">anthropics/skills</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X"...</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    193.0K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    800
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+4</span>
                            </div>
                        </div>
                    </div>

                    <!-- Card 3 - Already Installed -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Summarize</div>
                                <div class="explore-card-author">anthropics/skills</div>
                            </div>
                            <button class="btn-installed">
                                <svg style="width:12px;height:12px;margin-right:2px;" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>
                                Installed
                            </button>
                        </div>
                        <div class="explore-card-desc">Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    147.8K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    566
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+3</span>
                            </div>
                        </div>
                    </div>

                    <!-- Card 4 -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Agent Browser</div>
                                <div class="explore-card-author">nicobailon/browser-tools</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click...</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    121.2K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    539
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+6</span>
                            </div>
                        </div>
                    </div>

                    <!-- Card 5 -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Gog</div>
                                <div class="explore-card-author">erniebrodeur/gog</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    109.2K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    714
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+3</span>
                            </div>
                        </div>
                    </div>

                    <!-- Card 6 -->
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Github</div>
                                <div class="explore-card-author">anthropics/skills</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs...</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    103.9K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    336
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+5</span>
                            </div>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>

    <!-- Install Success Toast -->
    <div class="install-toast">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 11-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
        "Agent Browser" installed and synced to 3 tools
    </div>
</div>


<!-- ==========================================
     SCREEN 3: MANUAL ADD (Modal on Explore)
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 3 — Manual Add (overlays Explore page)</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header" style="opacity: 0.5;">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs" style="opacity:0.5;">
                <button class="nav-tab">My Skills</button>
                <button class="nav-tab active">Explore</button>
            </nav>
        </div>
    </div>

    <div class="app-body" style="position: relative;">
        <!-- Dimmed Explore page background -->
        <div style="flex:1; background: var(--bg-element); opacity: 0.15;"></div>

        <!-- Modal -->
        <div class="modal-backdrop">
            <div class="modal">
                <div class="modal-header">
                    <div class="modal-title">Add Skill</div>
                    <button class="modal-close" aria-label="Close">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="width:16px;height:16px;"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                    </button>
                </div>

                <div class="modal-tabs">
                    <button class="modal-tab">Local Directory</button>
                    <button class="modal-tab active">Git Repository</button>
                </div>

                <div class="modal-body">
                    <div class="form-group">
                        <label class="form-label">Repository URL</label>
                        <input class="form-input" placeholder="https://github.com/user/repo" value="https://github.com/anthropics/skills" />
                    </div>
                    <div class="form-group">
                        <label class="form-label">Name (optional)</label>
                        <input class="form-input" placeholder="Auto-detected from repo" />
                        <div class="form-hint">Leave blank to auto-detect from repository</div>
                    </div>
                    <div class="form-group">
                        <label class="form-label">Sync to tools</label>
                        <div class="tool-selector">
                            <label class="tool-chip selected"><span class="dot"></span> Cursor</label>
                            <label class="tool-chip selected"><span class="dot"></span> Claude Code</label>
                            <label class="tool-chip selected"><span class="dot"></span> Codex</label>
                            <label class="tool-chip">OpenCode</label>
                            <label class="tool-chip">Windsurf</label>
                            <label class="tool-chip">Amp</label>
                            <label class="tool-chip">Cline</label>
                        </div>
                    </div>
                </div>

                <div class="modal-footer">
                    <button class="btn btn-secondary">Cancel</button>
                    <button class="btn btn-primary">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="width:14px;height:14px;"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                        Install
                    </button>
                </div>
            </div>
        </div>
    </div>
</div>


<!-- ==========================================
     SCREEN 4: EXPLORE WITH SEARCH RESULTS
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 4 — Explore with search active</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/><line x1="12" y1="13" x2="12" y2="17"/><line x1="8" y1="13" x2="8" y2="17"/><line x1="16" y1="13" x2="16" y2="17"/></svg>
                    My Skills
                </button>
                <button class="nav-tab active">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    Explore
                </button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn" aria-label="Settings">
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>
            </button>
        </div>
    </div>

    <div class="app-body">
        <div class="view-explore">
            <div class="explore-hero">
                <div class="explore-search-row">
                    <div class="explore-search">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                        <input type="text" placeholder="Search skills..." value="browser" style="border-color: var(--accent-primary); box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.1);" />
                    </div>
                    <button class="btn btn-secondary" style="height:40px; padding: 0 16px; flex-shrink:0;">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="width:15px;height:15px;"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>
                        Manual
                    </button>
                </div>
                <div class="explore-source-label">3 results from <a>clawhub.ai</a></div>
            </div>

            <div class="explore-scroll">
                <!-- Featured matches -->
                <div class="explore-section-title">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                    Featured Matches
                </div>
                <div class="explore-grid">
                    <div class="explore-card" style="border-color: var(--accent-primary-border);">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name">Agent <mark style="background:#DBEAFE;color:var(--accent-primary);padding:0 2px;border-radius:2px;">Browser</mark></div>
                                <div class="explore-card-author">nicobailon/browser-tools</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click...</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    121.2K
                                </span>
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
                                    539
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                                <span class="mini-tool-badge">+6</span>
                            </div>
                        </div>
                    </div>
                </div>

                <!-- Online search results -->
                <div class="explore-section-title">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 014 10 15.3 15.3 0 01-4 10 15.3 15.3 0 01-4-10 15.3 15.3 0 014-10z"/></svg>
                    Online Results
                </div>
                <div class="explore-grid">
                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name"><mark style="background:#DBEAFE;color:var(--accent-primary);padding:0 2px;border-radius:2px;">Browser</mark> Use</div>
                                <div class="explore-card-author">anthropics/browser-use-skill</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Enables AI agents to control a headless browser for web research, form filling, and data extraction tasks.</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    45.3K installs
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                            </div>
                        </div>
                    </div>

                    <div class="explore-card">
                        <div class="explore-card-top">
                            <div class="explore-card-info">
                                <div class="explore-card-name"><mark style="background:#DBEAFE;color:var(--accent-primary);padding:0 2px;border-radius:2px;">Browser</mark> Screenshot</div>
                                <div class="explore-card-author">nicobailon/screenshot-tools</div>
                            </div>
                            <button class="btn-install">Install</button>
                        </div>
                        <div class="explore-card-desc">Take screenshots of web pages and convert them to various formats for analysis.</div>
                        <div class="explore-card-bottom">
                            <div class="explore-card-stats">
                                <span class="explore-stat">
                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    12.8K installs
                                </span>
                            </div>
                            <div class="explore-card-tools">
                                <span class="mini-tool-badge">Cursor</span>
                                <span class="mini-tool-badge">Claude</span>
                            </div>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>


<!-- ==========================================
     SCREEN 5: SKILL DETAIL VIEW (from My Skills)
     ========================================== -->
<style>
    /* ===== Detail View Styles ===== */
    .detail-view { flex: 1; display: flex; flex-direction: column; overflow: hidden; min-height: 0; }

    .detail-header {
        padding: 16px 24px;
        border-bottom: 1px solid var(--border-subtle);
        flex-shrink: 0;
        display: flex;
        flex-direction: column;
        gap: 6px;
    }
    .detail-back-btn {
        display: inline-flex;
        align-items: center;
        gap: 6px;
        font-size: 13px;
        font-weight: 500;
        color: var(--text-secondary);
        cursor: pointer;
        background: none;
        border: none;
        padding: 4px 8px;
        border-radius: var(--radius-sm);
        transition: all 0.2s;
        font-family: var(--font-ui);
    }
    .detail-back-btn:hover { color: var(--accent-primary); background: rgba(37,99,235,0.06); }
    .detail-back-btn svg { width: 16px; height: 16px; }

    .detail-skill-name {
        font-size: 20px;
        font-weight: 700;
        color: var(--text-primary);
        letter-spacing: -0.02em;
    }
    .detail-desc {
        font-size: 13px;
        color: var(--text-secondary);
        line-height: 1.5;
    }
    .detail-meta {
        display: flex;
        align-items: center;
        gap: 14px;
        font-size: 12px;
        color: var(--text-tertiary);
    }
    .detail-meta-item { display: flex; align-items: center; gap: 5px; }
    .detail-meta-item svg { width: 13px; height: 13px; }
    .detail-meta-dot { color: var(--border-strong); }

    /* Split pane */
    .detail-body { flex: 1; display: flex; overflow: hidden; min-height: 0; }

    .detail-file-list {
        width: 220px;
        border-right: 1px solid var(--border-subtle);
        overflow-y: auto;
        flex-shrink: 0;
        background: var(--bg-panel);
        padding: 8px 0;
    }
    .file-list-title {
        font-size: 11px;
        font-weight: 600;
        text-transform: uppercase;
        letter-spacing: 0.06em;
        color: var(--text-tertiary);
        padding: 8px 16px 6px;
    }
    .file-item {
        display: flex;
        align-items: center;
        gap: 8px;
        padding: 7px 16px;
        font-size: 13px;
        color: var(--text-secondary);
        cursor: pointer;
        transition: all 0.15s;
        border-left: 2px solid transparent;
    }
    .file-item:hover { background: var(--bg-element); color: var(--text-primary); }
    .file-item.active {
        background: rgba(37,99,235,0.06);
        color: var(--accent-primary);
        font-weight: 500;
        border-left-color: var(--accent-primary);
    }
    .file-item svg { width: 14px; height: 14px; flex-shrink: 0; }
    .file-item-name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; flex: 1; }
    .file-item-size { font-size: 11px; color: var(--text-tertiary); flex-shrink: 0; font-family: var(--font-mono); }

    .detail-file-content { flex: 1; overflow: auto; min-width: 0; background: var(--bg-app); }
    .file-content-header {
        padding: 10px 24px;
        border-bottom: 1px solid var(--border-subtle);
        display: flex;
        align-items: center;
        justify-content: space-between;
        position: sticky;
        top: 0;
        background: var(--bg-app);
        z-index: 5;
    }
    .file-content-path {
        font-family: var(--font-mono);
        font-size: 12px;
        color: var(--text-secondary);
        display: flex;
        align-items: center;
        gap: 6px;
    }
    .file-content-path svg { width: 14px; height: 14px; color: var(--text-tertiary); }
    .file-content-size { font-size: 11px; color: var(--text-tertiary); font-family: var(--font-mono); }
    .file-content-pre {
        padding: 16px 24px;
        font-family: var(--font-mono);
        font-size: 13px;
        line-height: 1.7;
        color: var(--text-primary);
        white-space: pre-wrap;
        word-break: break-word;
        margin: 0;
        tab-size: 4;
    }

    /* Loading state */
    .file-content-loading {
        display: flex;
        align-items: center;
        justify-content: center;
        height: 200px;
        color: var(--text-tertiary);
        font-size: 13px;
        gap: 8px;
    }
    .spinner-sm {
        width: 16px;
        height: 16px;
        border: 2px solid var(--border-subtle);
        border-top-color: var(--accent-primary);
        border-radius: 50%;
        animation: detail-spin 0.8s linear infinite;
    }
    @keyframes detail-spin { to { transform: rotate(360deg); } }

    /* Clickable skill name in card */
    .skill-name.clickable { cursor: pointer; transition: color 0.15s; }
    .skill-name.clickable:hover { color: var(--accent-primary); }

    /* Click indicator */
    .click-ring {
        position: absolute;
        width: 22px; height: 22px;
        border-radius: 50%;
        background: rgba(225,29,72,0.12);
        border: 2px solid #e11d48;
        animation: ring-pulse 1.5s ease-in-out infinite;
        pointer-events: none;
    }
    @keyframes ring-pulse {
        0% { transform: scale(1); opacity: 1; }
        50% { transform: scale(1.3); opacity: 0.5; }
        100% { transform: scale(1); opacity: 1; }
    }
    .callout {
        position: absolute;
        font-family: var(--font-mono);
        font-size: 11px;
        color: #e11d48;
        white-space: nowrap;
    }
    .callout::before { content: '→ '; font-weight: bold; }

    /* Flow arrow between screens */
    .flow-arrow-v {
        display: flex;
        align-items: center;
        justify-content: center;
        padding: 8px 0;
        color: #999;
    }
    .flow-arrow-v svg { width: 32px; height: 32px; }
</style>

<!-- 5A: List view - showing clickable skill name -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 5A — Click skill name to open detail</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab active">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/></svg>
                    My Skills
                </button>
                <button class="nav-tab">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    Explore
                </button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg></button>
        </div>
    </div>

    <div class="app-body">
        <div class="view-myskills">
            <div class="toolbar">
                <div class="toolbar-left">
                    <span class="toolbar-title">All Skills</span>
                    <span class="toolbar-count">3</span>
                </div>
            </div>
            <div class="skills-scroll">
                <!-- Card 1 - click indicator on name -->
                <div class="skill-row" style="position: relative;">
                    <div class="skill-icon-sm"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg></div>
                    <div class="skill-info">
                        <div class="skill-name-row">
                            <span class="skill-name clickable" style="color: var(--accent-primary); text-decoration: underline; text-underline-offset: 3px;">react</span>
                        </div>
                        <div class="skill-desc">React renderer for json-render that turns JSON specs into React components.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">vercel-labs/json-render</span>
                            <span class="skill-time">&middot; 22 min ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge more">+3</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                    <!-- Click indicator -->
                    <div class="click-ring" style="top: 16px; left: 90px;"></div>
                    <span class="callout" style="top: 10px; right: -180px;">Click name to view detail</span>
                </div>

                <!-- Card 2 -->
                <div class="skill-row">
                    <div class="skill-icon-sm"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z"/></svg></div>
                    <div class="skill-info">
                        <div class="skill-name-row"><span class="skill-name clickable">commit-message</span></div>
                        <div class="skill-desc">Generate conventional commit messages with scope and body.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">/Users/may/skills/commit-msg</span>
                            <span class="skill-time">&middot; 1 day ago</span>
                        </div>
                        <div class="tool-badges"><span class="tool-badge synced">Cursor</span></div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>

                <!-- Card 3 -->
                <div class="skill-row">
                    <div class="skill-icon-sm"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg></div>
                    <div class="skill-info">
                        <div class="skill-name-row"><span class="skill-name clickable">debug-helper</span></div>
                        <div class="skill-desc">Systematic debugging workflow with root cause analysis.</div>
                        <div class="skill-source-row">
                            <span class="skill-source">org/debug-tools</span>
                            <span class="skill-time">&middot; 3 days ago</span>
                        </div>
                        <div class="tool-badges">
                            <span class="tool-badge synced">Claude Code</span>
                            <span class="tool-badge synced">Cursor</span>
                            <span class="tool-badge synced">Windsurf</span>
                        </div>
                    </div>
                    <div class="row-actions">
                        <button class="action-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg></button>
                        <button class="action-btn danger"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 01-2 2H7a2 2 0 01-2-2V6m3 0V4a2 2 0 012-2h4a2 2 0 012 2v2"/></svg></button>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>

<!-- Flow Arrow -->
<div class="flow-arrow-v">
    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="5" x2="12" y2="19"/><polyline points="19 12 12 19 5 12"/></svg>
</div>


<!-- ==========================================
     SCREEN 5B: DETAIL VIEW (SKILL.md selected)
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 5B — Skill Detail View (SKILL.md default)</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab active">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/></svg>
                    My Skills
                </button>
                <button class="nav-tab">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    Explore
                </button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg></button>
        </div>
    </div>

    <div class="app-body">
        <div class="detail-view">
            <div class="detail-header">
                <button class="detail-back-btn">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m15 18-6-6 6-6"/></svg>
                    Back
                </button>
                <div class="detail-skill-name">react</div>
                <div class="detail-desc">React renderer for json-render that turns JSON specs into React components.</div>
                <div class="detail-meta">
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                        vercel-labs/json-render
                    </span>
                    <span class="detail-meta-dot">&middot;</span>
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
                        Updated 22 min ago
                    </span>
                    <span class="detail-meta-dot">&middot;</span>
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        4 files
                    </span>
                </div>
            </div>

            <div class="detail-body">
                <!-- File sidebar -->
                <div class="detail-file-list">
                    <div class="file-list-title">Files</div>
                    <div class="file-item active">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">SKILL.md</span>
                        <span class="file-item-size">2.4 KB</span>
                    </div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">component-spec.md</span>
                        <span class="file-item-size">1.8 KB</span>
                    </div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">examples/basic.md</span>
                        <span class="file-item-size">3.1 KB</span>
                    </div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">examples/advanced.md</span>
                        <span class="file-item-size">1.1 KB</span>
                    </div>
                </div>

                <!-- File content -->
                <div class="detail-file-content">
                    <div class="file-content-header">
                        <span class="file-content-path">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                            SKILL.md
                        </span>
                        <span class="file-content-size">2.4 KB</span>
                    </div>
                    <pre class="file-content-pre"># React Renderer

## Description
React renderer for json-render that turns JSON specs
into React components.

## When to use
- Working with @json-render/react
- Building React UIs from JSON specifications
- Creating component catalogs from JSON definitions

## Usage
```jsx
import { render } from '@json-render/react';

const spec = {
  type: 'Card',
  props: { title: 'Hello' },
  children: [
    { type: 'Text', props: { value: 'World' } }
  ]
};

const App = () => render(spec);
```

## Configuration
- `strict`: Enable strict type checking (default: true)
- `components`: Custom component registry map
- `fallback`: Fallback component for unknown types

## Supported Components
Button, Card, Text, Input, List, Grid, Modal, Tabs</pre>
                </div>
            </div>
        </div>
    </div>
</div>

<!-- Flow Arrow -->
<div class="flow-arrow-v">
    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="5" x2="12" y2="19"/><polyline points="19 12 12 19 5 12"/></svg>
</div>


<!-- ==========================================
     SCREEN 5C: DETAIL VIEW (switched file)
     ========================================== -->
<div class="window-frame" style="position: relative;">
    <span class="design-label">Screen 5C — Detail View (switched to another file)</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab active">My Skills</button>
                <button class="nav-tab">Explore</button>
            </nav>
        </div>
        <div class="header-actions">
            <button class="lang-btn">EN</button>
            <button class="icon-btn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg></button>
        </div>
    </div>

    <div class="app-body">
        <div class="detail-view">
            <div class="detail-header">
                <button class="detail-back-btn">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m15 18-6-6 6-6"/></svg>
                    Back
                </button>
                <div class="detail-skill-name">react</div>
                <div class="detail-desc">React renderer for json-render that turns JSON specs into React components.</div>
                <div class="detail-meta">
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 00-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0020 4.77 5.07 5.07 0 0019.91 1S18.73.65 16 2.48a13.38 13.38 0 00-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 005 4.77a5.44 5.44 0 00-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 009 18.13V22"/></svg>
                        vercel-labs/json-render
                    </span>
                    <span class="detail-meta-dot">&middot;</span>
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
                        Updated 22 min ago
                    </span>
                    <span class="detail-meta-dot">&middot;</span>
                    <span class="detail-meta-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        4 files
                    </span>
                </div>
            </div>

            <div class="detail-body">
                <div class="detail-file-list">
                    <div class="file-list-title">Files</div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">SKILL.md</span>
                        <span class="file-item-size">2.4 KB</span>
                    </div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">component-spec.md</span>
                        <span class="file-item-size">1.8 KB</span>
                    </div>
                    <div class="file-item active">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">examples/basic.md</span>
                        <span class="file-item-size">3.1 KB</span>
                    </div>
                    <div class="file-item">
                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                        <span class="file-item-name">examples/advanced.md</span>
                        <span class="file-item-size">1.1 KB</span>
                    </div>
                </div>

                <div class="detail-file-content">
                    <div class="file-content-header">
                        <span class="file-content-path">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
                            examples/basic.md
                        </span>
                        <span class="file-content-size">3.1 KB</span>
                    </div>
                    <pre class="file-content-pre"># Basic Examples

## Simple Card
```json
{
  "type": "Card",
  "props": {
    "title": "Welcome",
    "variant": "outlined"
  },
  "children": [
    {
      "type": "Text",
      "props": { "value": "Hello, World!" }
    }
  ]
}
```

## Button Group
```json
{
  "type": "ButtonGroup",
  "props": { "direction": "horizontal" },
  "children": [
    {
      "type": "Button",
      "props": { "label": "Save", "variant": "primary" }
    },
    {
      "type": "Button",
      "props": { "label": "Cancel", "variant": "secondary" }
    }
  ]
}
```

## Form with Input
```json
{
  "type": "Form",
  "props": { "onSubmit": "handleSubmit" },
  "children": [
    {
      "type": "Input",
      "props": {
        "name": "email",
        "label": "Email Address",
        "type": "email",
        "required": true
      }
    }
  ]
}
```</pre>
                </div>
            </div>
        </div>
    </div>
</div>

<!-- Flow Arrow -->
<div class="flow-arrow-v">
    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="5" x2="12" y2="19"/><polyline points="19 12 12 19 5 12"/></svg>
</div>


<!-- ==========================================
     SCREEN 5D: DETAIL VIEW (loading state)
     ========================================== -->
<div class="window-frame" style="position: relative; height: 420px;">
    <span class="design-label">Screen 5D — Detail View (loading state)</span>
    <div class="title-bar">
        <div class="traffic-lights">
            <div class="traffic-light close"></div>
            <div class="traffic-light minimize"></div>
            <div class="traffic-light maximize"></div>
        </div>
    </div>

    <div class="app-header">
        <div class="header-left">
            <div class="brand-area">
                <div class="brand-icon">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
                </div>
                <span class="brand-text">Skills Hub</span>
            </div>
            <nav class="nav-tabs">
                <button class="nav-tab active">My Skills</button>
                <button class="nav-tab">Explore</button>
            </nav>
        </div>
    </div>

    <div class="app-body">
        <div class="detail-view">
            <div class="detail-header">
                <button class="detail-back-btn">
                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m15 18-6-6 6-6"/></svg>
                    Back
                </button>
                <div class="detail-skill-name">react</div>
            </div>

            <div class="detail-body">
                <div class="detail-file-list">
                    <div class="file-list-title">Files</div>
                    <div class="file-content-loading" style="height: 120px;">
                        <div class="spinner-sm"></div>
                        Loading...
                    </div>
                </div>
                <div class="detail-file-content">
                    <div class="file-content-loading">
                        <div class="spinner-sm"></div>
                        Loading file content...
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>

</body>
</html>


================================================
FILE: docs/tag_profile_interactive_prototype.html
================================================
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Skills Hub - Tags and Profiles Prototype</title>
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  <link href="https://fonts.googleapis.com/css2?family=Fira+Sans:wght@300;400;500;600;700&family=Fira+Code:wght@400;500;600&display=swap" rel="stylesheet">
  <style>
    :root {
      --bg-app: #ffffff;
      --bg-page: #e5e5e5;
      --bg-panel: #fcfcfc;
      --bg-element: #f4f4f5;
      --bg-element-hover: #e4e4e7;
      --border-subtle: #e4e4e7;
      --border-strong: #d4d4d8;
      --text-primary: #18181b;
      --text-secondary: #52525b;
      --text-tertiary: #a1a1aa;
      --accent-primary: #2563EB;
      --accent-primary-hover: #1D4ED8;
      --accent-primary-fg: #FFFFFF;
      --accent-primary-light: #EFF6FF;
      --accent-primary-border: #BFDBFE;
      --status-success: #059669;
      --status-success-light: #ECFDF5;
      --status-success-border: #A7F3D0;
      --status-warning: #d97706;
      --status-warning-light: #FFFBEB;
      --status-warning-border: #FDE68A;
      --status-error: #dc2626;
      --status-error-light: #FEF2F2;
      --status-error-border: #FECACA;
      --font-ui: 'Fira Sans', system-ui, -apple-system, sans-serif;
      --font-mono: 'Fira Code', monospace;
      --radius-sm: 4px;
      --radius-md: 8px;
      --radius-lg: 12px;
      --radius-xl: 16px;
      --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
      --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.07), 0 2px 4px -2px rgb(0 0 0 / 0.05);
      --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.08), 0 4px 6px -4px rgb(0 0 0 / 0.03);
    }

    * { box-sizing: border-box; margin: 0; padding: 0; }

    body {
      min-height: 100vh;
      background: var(--bg-page);
      color: var(--text-primary);
      font-family: var(--font-ui);
      display: flex;
      align-items: center;
      justify-content: center;
      padding: 32px;
      -webkit-font-smoothing: antialiased;
    }

    button,
    input {
      font: inherit;
    }

    button {
      cursor: pointer;
    }

    .window-frame {
      width: min(1180px, calc(100vw - 48px));
      height: min(760px, calc(100vh - 48px));
      min-height: 680px;
      background: var(--bg-app);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.16);
      display: flex;
      flex-direction: column;
      overflow: hidden;
      position: relative;
    }

    .title-bar {
      height: 40px;
      background: var(--bg-app);
      border-bottom: 1px solid var(--border-subtle);
      display: flex;
      align-items: center;
      padding: 0 16px;
      flex-shrink: 0;
    }

    .traffic-lights { display: flex; gap: 8px; }
    .traffic-light { width: 12px; height: 12px; border-radius: 50%; }
    .traffic-light.close { background: #ff5f56; border: 1px solid rgba(0,0,0,0.1); }
    .traffic-light.minimize { background: #ffbd2e; border: 1px solid rgba(0,0,0,0.1); }
    .traffic-light.maximize { background: #27c93f; border: 1px solid rgba(0,0,0,0.1); }

    .app-header {
      height: 56px;
      padding: 0 24px;
      display: flex;
      align-items: center;
      justify-content: space-between;
      border-bottom: 1px solid var(--border-subtle);
      background: var(--bg-app);
      flex-shrink: 0;
      z-index: 10;
    }

    .header-left,
    .header-actions,
    .brand-area,
    .nav-tabs,
    .toolbar-left,
    .toolbar-right {
      display: flex;
      align-items: center;
    }

    .header-left { gap: 24px; }
    .brand-area { gap: 10px; }
    .brand-icon {
      width: 28px;
      height: 28px;
      background: linear-gradient(135deg, #2563EB, #7C3AED);
      border-radius: var(--radius-md);
      display: flex;
      align-items: center;
      justify-content: center;
      color: white;
    }
    .brand-icon svg { width: 16px; height: 16px; }
    .brand-text {
      font-weight: 700;
      font-size: 17px;
      color: var(--text-primary);
    }

    .nav-tabs {
      gap: 4px;
      height: 56px;
    }

    .nav-tab {
      height: 100%;
      display: flex;
      align-items: center;
      gap: 6px;
      padding: 0 14px;
      font-size: 13px;
      font-weight: 500;
      color: var(--text-tertiary);
      border: none;
      background: none;
      position: relative;
      transition: color 0.2s;
    }

    .nav-tab:hover { color: var(--text-secondary); }
    .nav-tab.active {
      color: var(--accent-primary);
      font-weight: 600;
    }
    .nav-tab.active::after {
      content: '';
      position: absolute;
      bottom: 0;
      left: 8px;
      right: 8px;
      height: 2px;
      background: var(--accent-primary);
      border-radius: 2px 2px 0 0;
    }
    .nav-tab svg { width: 16px; height: 16px; }

    .header-actions { gap: 10px; }
    .lang-btn {
      height: 32px;
      font-size: 12px;
      font-weight: 500;
      color: var(--text-secondary);
      padding: 0 10px;
      border-radius: var(--radius-sm);
      background: transparent;
      border: 1px solid var(--border-subtle);
      font-family: var(--font-mono);
    }

    .icon-btn,
    .action-btn {
      width: 32px;
      height: 32px;
      display: inline-flex;
      align-items: center;
      justify-content: center;
      border-radius: var(--radius-md);
      color: var(--text-secondary);
      border: none;
      background: none;
      transition: all 0.15s;
    }
    .icon-btn:hover,
    .action-btn:hover {
      background: var(--bg-element);
      color: var(--text-primary);
    }
    .icon-btn svg,
    .action-btn svg { width: 16px; height: 16px; }

    .btn {
      height: 32px;
      padding: 0 14px;
      border-radius: var(--radius-md);
      font-size: 13px;
      font-weight: 500;
      display: inline-flex;
      align-items: center;
      justify-content: center;
      gap: 6px;
      border: 1px solid transparent;
      transition: all 0.2s;
      white-space: nowrap;
    }
    .btn svg { width: 14px; height: 14px; }
    .btn-primary {
      background: var(--accent-primary);
      color: var(--accent-primary-fg);
    }
    .btn-primary:hover { background: var(--accent-primary-hover); }
    .btn-secondary {
      background: transparent;
      border-color: var(--border-subtle);
      color: var(--text-primary);
    }
    .btn-secondary:hover {
      border-color: var(--border-strong);
      background: var(--bg-element);
    }
    .btn-ghost {
      background: transparent;
      color: var(--text-secondary);
      border-color: transparent;
      padding: 0 8px;
    }
    .btn-ghost:hover {
      color: var(--text-primary);
      background: var(--bg-element);
    }
    .btn-sm { height: 28px; padding: 0 10px; font-size: 12px; }

    .app-body {
      flex: 1;
      min-height: 0;
      display: flex;
      flex-direction: column;
      overflow: hidden;
    }

    .view {
      flex: 1;
      min-height: 0;
      display: none;
      flex-direction: column;
      overflow: hidden;
    }
    .view.active { display: flex; }

    .toolbar {
      padding: 16px 24px 12px;
      display: flex;
      align-items: center;
      justify-content: space-between;
      flex-shrink: 0;
      gap: 16px;
    }
    .toolbar-left { gap: 12px; min-width: 0; }
    .toolbar-right { gap: 8px; }
    .toolbar-title {
      font-size: 13px;
      font-weight: 600;
      color: var(--text-secondary);
      white-space: nowrap;
    }
    .toolbar-count {
      font-size: 12px;
      color: var(--text-tertiary);
      font-family: var(--font-mono);
      background: var(--bg-element);
      padding: 2px 8px;
      border-radius: 10px;
    }

    .profile-switcher {
      height: 32px;
      display: inline-flex;
      align-items: center;
      gap: 8px;
      padding: 0 10px;
      border: 1px solid var(--accent-primary-border);
      border-radius: var(--radius-md);
      background: var(--accent-primary-light);
      color: var(--accent-primary);
      font-size: 13px;
      font-weight: 600;
      position: relative;
    }
    .profile-switcher svg { width: 14px; height: 14px; }
    .profile-menu {
      position: absolute;
      top: 36px;
      left: 0;
      width: 250px;
      padding: 6px;
      background: var(--bg-app);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      box-shadow: var(--shadow-lg);
      z-index: 30;
      display: none;
    }
    .profile-menu.open { display: block; }
    .profile-menu-item {
      width: 100%;
      display: flex;
      align-items: center;
      justify-content: space-between;
      border: none;
      background: transparent;
      padding: 9px 10px;
      border-radius: var(--radius-md);
      color: var(--text-secondary);
      text-align: left;
      font-size: 13px;
    }
    .profile-menu-item:hover { background: var(--bg-element); color: var(--text-primary); }
    .profile-menu-item.active { color: var(--accent-primary); background: var(--accent-primary-light); }
    .profile-menu-item small {
      font-size: 11px;
      color: var(--text-tertiary);
      font-family: var(--font-mono);
    }
    .profile-menu-divider {
      height: 1px;
      background: var(--border-subtle);
      margin: 6px 4px;
    }

    .search-box {
      position: relative;
      flex-shrink: 0;
    }
    .search-box input {
      background: var(--bg-panel);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-md);
      height: 32px;
      padding: 0 12px 0 32px;
      color: var(--text-primary);
      width: 230px;
      font-size: 13px;
      transition: all 0.2s;
    }
    .search-box input:focus {
      outline: none;
      border-color: var(--accent-primary);
      box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
      width: 260px;
    }
    .search-box svg {
      position: absolute;
      left: 10px;
      top: 50%;
      transform: translateY(-50%);
      width: 14px;
      height: 14px;
      color: var(--text-tertiary);
      pointer-events: none;
    }

    .filter-select {
      height: 32px;
      padding: 0 12px;
      border-radius: var(--radius-md);
      border: 1px solid var(--border-subtle);
      background: var(--bg-app);
      color: var(--text-primary);
      font-size: 13px;
      font-weight: 600;
      display: inline-flex;
      align-items: center;
      gap: 7px;
      white-space: nowrap;
      transition: all 0.2s;
      position: relative;
    }
    .filter-select:hover {
      border-color: var(--border-strong);
      background: var(--bg-element);
    }
    .filter-select.active {
      color: var(--accent-primary);
      border-color: var(--accent-primary-border);
      background: var(--accent-primary-light);
    }
    .filter-select svg { width: 14px; height: 14px; }
    .filter-dropdown {
      position: absolute;
      top: 36px;
      left: 0;
      width: 292px;
      background: var(--bg-app);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      box-shadow: var(--shadow-lg);
      padding: 10px;
      z-index: 40;
      display: none;
      color: var(--text-primary);
    }
    .filter-dropdown.open { display: block; }
    .dropdown-title {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 10px;
      font-size: 13px;
      font-weight: 700;
      margin-bottom: 8px;
    }
    .dropdown-search {
      position: relative;
      margin-bottom: 8px;
    }
    .dropdown-search input {
      width: 100%;
      height: 32px;
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-md);
      background: var(--bg-panel);
      padding: 0 10px 0 30px;
      font-size: 12px;
      color: var(--text-primary);
    }
    .dropdown-search input:focus {
      outline: none;
      border-color: var(--accent-primary);
      box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
    }
    .dropdown-search svg {
      position: absolute;
      left: 10px;
      top: 50%;
      transform: translateY(-50%);
      width: 13px;
      height: 13px;
      color: var(--text-tertiary);
    }
    .tag-option-list {
      max-height: 230px;
      overflow: auto;
      margin: 0 -4px;
    }
    .tag-option {
      width: 100%;
      min-height: 34px;
      display: grid;
      grid-template-columns: 24px minmax(0, 1fr) auto;
      align-items: center;
      gap: 8px;
      border: none;
      background: transparent;
      border-radius: var(--radius-md);
      padding: 0 8px;
      color: var(--text-secondary);
      text-align: left;
      font-size: 13px;
    }
    .tag-option:hover {
      background: var(--bg-element);
      color: var(--text-primary);
    }
    .tag-option .option-count {
      font-family: var(--font-mono);
      font-size: 11px;
      color: var(--text-tertiary);
    }
    .dropdown-footer {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 8px;
      border-top: 1px solid var(--border-subtle);
      margin-top: 8px;
      padding-top: 8px;
    }

    .skills-scroll {
      flex: 1;
      overflow: auto;
      padding: 0 24px 24px;
    }

    .skill-row {
      display: flex;
      align-items: flex-start;
      gap: 16px;
      padding: 16px 20px;
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      margin-bottom: 8px;
      transition: all 0.2s;
      background: var(--bg-app);
      position: relative;
    }
    .skill-row:hover {
      border-color: var(--border-strong);
      background: var(--bg-panel);
      box-shadow: var(--shadow-sm);
    }
    .skill-icon-sm {
      width: 44px;
      height: 44px;
      background: var(--bg-element);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-md);
      display: flex;
      align-items: center;
      justify-content: center;
      color: var(--text-secondary);
      flex-shrink: 0;
      margin-top: 2px;
    }
    .skill-icon-sm svg { width: 20px; height: 20px; }
    .skill-info {
      display: flex;
      flex-direction: column;
      gap: 6px;
      min-width: 0;
      flex: 1;
    }
    .skill-name-row {
      display: flex;
      align-items: center;
      gap: 8px;
      min-width: 0;
      padding-right: 80px;
    }
    .skill-name {
      font-weight: 700;
      font-size: 15px;
      color: var(--text-primary);
      white-space: nowrap;
      overflow: hidden;
      text-overflow: ellipsis;
    }
    .skill-desc {
      font-size: 13px;
      color: var(--text-secondary);
      line-height: 1.5;
      display: -webkit-box;
      -webkit-line-clamp: 2;
      -webkit-box-orient: vertical;
      overflow: hidden;
    }
    .skill-meta-row,
    .tool-badges,
    .skill-tags {
      display: flex;
      align-items: center;
      flex-wrap: wrap;
      gap: 5px;
    }
    .skill-source {
      font-family: var(--font-mono);
      font-size: 12px;
      color: var(--text-tertiary);
      background: var(--bg-element);
      padding: 2px 8px;
      border-radius: var(--radius-sm);
      white-space: nowrap;
      overflow: hidden;
      text-overflow: ellipsis;
      max-width: 260px;
    }
    .skill-time {
      font-size: 12px;
      color: var(--text-tertiary);
    }
    .inline-tag {
      height: 20px;
      padding: 0 7px;
      border-radius: 10px;
      background: var(--bg-element);
      color: var(--text-secondary);
      border: 1px solid var(--border-subtle);
      font-size: 11px;
      font-weight: 500;
      display: inline-flex;
      align-items: center;
    }
    .inline-tag.empty {
      color: var(--text-tertiary);
      border-style: dashed;
      background: var(--bg-panel);
    }
    .tool-badge {
      font-size: 11px;
      font-weight: 500;
      padding: 2px 8px;
      border-radius: 10px;
      white-space: nowrap;
      display: flex;
      align-items: center;
      gap: 4px;
    }
    .tool-badge.synced {
      background: var(--status-success-light);
      color: var(--status-success);
      border: 1px solid var(--status-success-border);
    }
    .tool-badge.ghost {
      background: var(--bg-element);
      color: var(--text-tertiary);
      border: 1px solid var(--border-subtle);
      font-family: var(--font-mono);
      font-size: 10px;
    }
    .row-actions {
      display: flex;
      align-items: center;
      gap: 2px;
      flex-shrink: 0;
      margin-top: 2px;
      position: absolute;
      top: 14px;
      right: 14px;
    }

    .empty-state {
      border: 1px dashed var(--border-strong);
      border-radius: var(--radius-lg);
      padding: 44px 20px;
      text-align: center;
      color: var(--text-secondary);
      background: var(--bg-panel);
    }
    .empty-state strong {
      display: block;
      color: var(--text-primary);
      font-size: 15px;
      margin-bottom: 4px;
    }

    .profiles-layout {
      flex: 1;
      min-height: 0;
      display: grid;
      grid-template-columns: 300px minmax(0, 1fr);
      border-top: 1px solid var(--border-subtle);
    }
    .tags-page {
      flex: 1;
      min-height: 0;
      overflow: auto;
      padding: 20px 24px 24px;
      border-top: 1px solid var(--border-subtle);
    }
    .page-heading {
      display: flex;
      align-items: flex-start;
      justify-content: space-between;
      gap: 16px;
      margin-bottom: 18px;
    }
    .breadcrumb-button {
      border: none;
      background: transparent;
      color: var(--text-secondary);
      font-size: 13px;
      font-weight: 600;
      display: inline-flex;
      align-items: center;
      gap: 6px;
      margin-bottom: 8px;
      padding: 0;
    }
    .breadcrumb-button:hover { color: var(--accent-primary); }
    .page-title {
      font-size: 22px;
      font-weight: 700;
      color: var(--text-primary);
      margin-bottom: 4px;
    }
    .page-desc {
      font-size: 13px;
      color: var(--text-secondary);
      line-height: 1.5;
      max-width: 620px;
    }
    .tag-table-toolbar {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 12px;
      margin-bottom: 12px;
    }
    .untagged-callout {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 16px;
      padding: 14px 16px;
      border: 1px dashed var(--accent-primary-border);
      border-radius: var(--radius-lg);
      background: var(--accent-primary-light);
      margin-bottom: 12px;
    }
    .untagged-callout strong {
      display: block;
      font-size: 13px;
      color: var(--text-primary);
      margin-bottom: 2px;
    }
    .untagged-callout span {
      font-size: 12px;
      color: var(--text-secondary);
    }
    .tag-table {
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      overflow: hidden;
      background: var(--bg-app);
    }
    .tag-table-row {
      min-height: 52px;
      display: grid;
      grid-template-columns: minmax(0, 1fr) 100px 130px auto;
      align-items: center;
      gap: 12px;
      padding: 0 14px;
      border-bottom: 1px solid var(--border-subtle);
    }
    .tag-table-row:last-child { border-bottom: none; }
    .tag-table-row.header {
      min-height: 40px;
      background: var(--bg-panel);
      color: var(--text-tertiary);
      font-size: 12px;
      font-weight: 700;
    }
    .tag-table-actions {
      display: flex;
      justify-content: flex-end;
      gap: 4px;
    }
    .profiles-sidebar {
      border-right: 1px solid var(--border-subtle);
      background: var(--bg-panel);
      overflow: auto;
      padding: 16px;
    }
    .profile-card {
      width: 100%;
      text-align: left;
      background: var(--bg-app);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      padding: 14px;
      margin-bottom: 8px;
      transition: all 0.2s;
    }
    .profile-card:hover {
      border-color: var(--border-strong);
      box-shadow: var(--shadow-sm);
    }
    .profile-card.active {
      border-color: var(--accent-primary-border);
      background: var(--accent-primary-light);
    }
    .profile-card-top {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 8px;
      margin-bottom: 5px;
    }
    .profile-name {
      font-size: 14px;
      font-weight: 700;
      color: var(--text-primary);
    }
    .status-pill {
      height: 20px;
      padding: 0 7px;
      border-radius: 10px;
      font-size: 10px;
      font-weight: 700;
      text-transform: uppercase;
      display: inline-flex;
      align-items: center;
      white-space: nowrap;
    }
    .status-pill.active {
      background: var(--status-success-light);
      color: var(--status-success);
      border: 1px solid var(--status-success-border);
    }
    .status-pill.draft {
      background: var(--status-warning-light);
      color: var(--status-warning);
      border: 1px solid var(--status-warning-border);
    }
    .profile-card-desc {
      font-size: 12px;
      color: var(--text-secondary);
      line-height: 1.45;
      margin-bottom: 10px;
    }
    .profile-card-meta {
      display: flex;
      gap: 8px;
      flex-wrap: wrap;
    }
    .profile-card-meta span {
      font-family: var(--font-mono);
      font-size: 11px;
      color: var(--text-tertiary);
      background: var(--bg-element);
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-sm);
      padding: 2px 6px;
    }

    .profile-detail {
      min-width: 0;
      overflow: auto;
      padding: 20px 24px 24px;
    }
    .detail-header {
      display: flex;
      align-items: flex-start;
      justify-content: space-between;
      gap: 16px;
      margin-bottom: 18px;
    }
    .detail-title {
      font-size: 22px;
      font-weight: 700;
      color: var(--text-primary);
      margin-bottom: 4px;
    }
    .detail-desc {
      font-size: 13px;
      color: var(--text-secondary);
      line-height: 1.5;
      max-width: 620px;
    }
    .detail-actions {
      display: flex;
      gap: 8px;
      flex-shrink: 0;
    }
    .section {
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      background: var(--bg-app);
      margin-bottom: 12px;
      overflow: hidden;
    }
    .section-header {
      min-height: 44px;
      padding: 0 14px;
      display: flex;
      align-items: center;
      justify-content: space-between;
      border-bottom: 1px solid var(--border-subtle);
      background: var(--bg-panel);
    }
    .section-title {
      display: flex;
      align-items: center;
      gap: 8px;
      font-size: 13px;
      font-weight: 700;
      color: var(--text-primary);
    }
    .section-title svg { width: 15px; height: 15px; color: var(--text-tertiary); }
    .section-note {
      font-size: 12px;
      color: var(--text-tertiary);
    }
    .tool-grid {
      padding: 14px;
      display: flex;
      gap: 8px;
      flex-wrap: wrap;
    }
    .select-chip {
      min-height: 32px;
      display: inline-flex;
      align-items: center;
      gap: 7px;
      padding: 0 10px;
      border-radius: 16px;
      border: 1px solid var(--border-subtle);
      background: var(--bg-app);
      color: var(--text-secondary);
      font-size: 12px;
      font-weight: 500;
      transition: all 0.15s;
    }
    .select-chip:hover { border-color: var(--border-strong); background: var(--bg-element); }
    .select-chip.selected {
      background: var(--accent-primary-light);
      border-color: var(--accent-primary-border);
      color: var(--accent-primary);
    }
    .select-chip .check-dot {
      width: 7px;
      height: 7px;
      border-radius: 50%;
      background: var(--accent-primary);
      display: none;
    }
    .select-chip.selected .check-dot { display: block; }

    .profile-skill-list {
      padding: 8px 14px 14px;
    }
    .profile-skill-row {
      min-height: 48px;
      display: grid;
      grid-template-columns: 28px minmax(0, 1fr) auto;
      align-items: center;
      gap: 10px;
      border-bottom: 1px solid var(--border-subtle);
    }
    .profile-skill-row:last-child { border-bottom: none; }
    .checkbox {
      width: 18px;
      height: 18px;
      border-radius: var(--radius-sm);
      border: 1px solid var(--border-strong);
      background: var(--bg-app);
      display: inline-flex;
      align-items: center;
      justify-content: center;
      color: white;
      transition: all 0.15s;
    }
    .checkbox.checked {
      background: var(--accent-primary);
      border-color: var(--accent-primary);
    }
    .checkbox svg {
      width: 13px;
      height: 13px;
      display: none;
    }
    .checkbox.checked svg { display: block; }
    .profile-skill-main { min-width: 0; }
    .profile-skill-name {
      font-size: 13px;
      font-weight: 700;
      color: var(--text-primary);
      margin-bottom: 2px;
    }
    .profile-skill-description {
      font-size: 12px;
      color: var(--text-secondary);
      white-space: nowrap;
      overflow: hidden;
      text-overflow: ellipsis;
    }
    .profile-skill-tags {
      display: flex;
      justify-content: flex-end;
      gap: 5px;
      flex-wrap: wrap;
      max-width: 260px;
    }

    .preview-grid {
      display: grid;
      grid-template-columns: repeat(3, 1fr);
      gap: 8px;
      padding: 14px;
    }
    .preview-card {
      border-radius: var(--radius-md);
      border: 1px solid var(--border-subtle);
      background: var(--bg-panel);
      padding: 12px;
    }
    .preview-card strong {
      display: block;
      font-size: 18px;
      margin-bottom: 3px;
    }
    .preview-card span {
      font-size: 12px;
      color: var(--text-secondary);
    }
    .preview-card.add strong { color: var(--status-success); }
    .preview-card.remove strong { color: var(--status-error); }
    .preview-card.keep strong { color: var(--accent-primary); }

    .modal-backdrop {
      position: absolute;
      inset: 0;
      background: rgba(0,0,0,0.34);
      display: none;
      align-items: center;
      justify-content: center;
      z-index: 100;
      backdrop-filter: blur(2px);
    }
    .modal-backdrop.open { display: flex; }
    .modal {
      width: 520px;
      max-width: calc(100% - 48px);
      background: var(--bg-app);
      border-radius: var(--radius-xl);
      border: 1px solid var(--border-subtle);
      box-shadow: var(--shadow-lg);
      overflow: hidden;
    }
    .modal-header {
      padding: 18px 22px 14px;
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 12px;
    }
    .modal-title {
      font-size: 16px;
      font-weight: 700;
      color: var(--text-primary);
    }
    .modal-close {
      width: 30px;
      height: 30px;
      border-radius: var(--radius-md);
      border: none;
      background: transparent;
      color: var(--text-tertiary);
      font-size: 18px;
    }
    .modal-close:hover { background: var(--bg-element); color: var(--text-primary); }
    .modal-body {
      padding: 0 22px 18px;
    }
    .modal-footer {
      padding: 14px 22px;
      display: flex;
      justify-content: flex-end;
      gap: 8px;
      border-top: 1px solid var(--border-subtle);
      background: var(--bg-panel);
    }
    .change-list {
      display: grid;
      gap: 8px;
      margin-top: 12px;
    }
    .change-item {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 12px;
      padding: 10px 12px;
      border-radius: var(--radius-md);
      border: 1px solid var(--border-subtle);
      background: var(--bg-panel);
      font-size: 13px;
    }
    .change-item .kind {
      font-family: var(--font-mono);
      font-size: 11px;
      font-weight: 700;
    }
    .change-item.add { border-color: var(--status-success-border); background: var(--status-success-light); }
    .change-item.add .kind { color: var(--status-success); }
    .change-item.remove { border-color: var(--status-error-border); background: var(--status-error-light); }
    .change-item.remove .kind { color: var(--status-error); }
    .change-item.keep .kind { color: var(--accent-primary); }

    .tag-editor-list {
      display: flex;
      flex-wrap: wrap;
      gap: 8px;
      margin-top: 12px;
    }
    .tag-manager-toolbar {
      display: flex;
      align-items: center;
      gap: 8px;
      margin-top: 12px;
    }
    .tag-manager-toolbar .form-input {
      flex: 1;
      height: 34px;
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-md);
      padding: 0 10px;
      background: var(--bg-panel);
      color: var(--text-primary);
      font-size: 13px;
    }
    .tag-manager-toolbar .form-input:focus {
      outline: none;
      border-color: var(--accent-primary);
      box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
    }
    .tag-manager-list {
      margin-top: 14px;
      border: 1px solid var(--border-subtle);
      border-radius: var(--radius-lg);
      overflow: hidden;
    }
    .tag-manager-row {
      min-height: 46px;
      display: grid;
      grid-template-columns: minmax(0, 1fr) 90px auto;
      align-items: center;
      gap: 12px;
      padding: 8px 10px;
      border-bottom: 1px solid var(--border-subtle);
      background: var(--bg-app);
    }
    .tag-manager-row:last-child { border-bottom: none; }
    .tag-manager-name {
      display: flex;
      align-items: center;
      gap: 8px;
      min-width: 0;
      font-size: 13px;
      font-weight: 600;
    }
    .tag-color-dot {
      width: 8px;
      height: 8px;
      border-radius: 50%;
      background: var(--accent-primary);
      flex-shrink: 0;
    }
    .tag-manager-count {
      font-family: var(--font-mono);
      font-size: 11px;
      color: var(--text-tertiary);
      white-space: nowrap;
    }
    .tag-manager-actions {
      display: flex;
      justify-content: flex-end;
      gap: 4px;
    }

    .toast {
      position: absolute;
      left: 50%;
      bottom: 18px;
      transform: translateX(-50%) translateY(24px);
      opacity: 0;
      pointer-events: none;
      background: var(--text-primary);
      color: white;
      border-radius: var(--radius-lg);
      padding: 10px 16px;
      display: flex;
      align-items: center;
      gap: 8px;
      font-size: 13px;
      font-weight: 600;
      box-shadow: var(--shadow-lg);
      transition: all 0.2s;
      z-index: 200;
    }
    .toast.show {
      transform: translateX(-50%) translateY(0);
      opacity: 1;
    }
    .toast svg { width: 16px; height: 16px; color: #34D399; }

    @media (max-width: 900px) {
      body { padding: 16px; align-items: flex-start; }
      .window-frame {
        width: calc(100vw - 32px);
        height: calc(100vh - 32px);
        min-height: 720px;
      }
      .profiles-layout {
        grid-template-columns: 1fr;
      }
      .profiles-sidebar {
        max-height: 220px;
        border-right: none;
        border-bottom: 1px solid var(--border-subtle);
      }
      .toolbar {
        align-items: flex-start;
        flex-direction: column;
      }
      .toolbar-right,
      .search-box,
      .search-box input {
        width: 100%;
      }
      .search-box input:focus { width: 100%; }
      .preview-grid { grid-template-columns: 1fr; }
    }
  </style>
</head>
<body>
  <main class="window-frame" aria-label="Skills Hub tags and profiles prototype">
    <div class="title-bar">
      <div class="traffic-lights" aria-hidden="true">
        <div class="traffic-light close"></div>
        <div class="traffic-light minimize"></div>
        <div class="traffic-light maximize"></div>
      </div>
    </div>

    <header class="app-header">
      <div class="header-left">
        <div class="brand-area">
          <div class="brand-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
          </div>
          <span class="brand-text">Skills Hub</span>
        </div>
        <nav class="nav-tabs" aria-label="Primary">
          <button class="nav-tab active" data-nav="skills" type="button">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/><line x1="12" y1="13" x2="12" y2="17"/></svg>
            My Skills
          </button>
          <button class="nav-tab" data-nav="profiles" type="button">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 8h10M7 12h6M7 16h8"/></svg>
            Profiles
          </button>
          <button class="nav-tab" type="button">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
            Explore
          </button>
        </nav>
      </div>
      <div class="header-actions">
        <button class="lang-btn" type="button">EN</button>
        <button class="icon-btn" aria-label="Settings" type="button">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>
        </button>
      </div>
    </header>

    <div class="app-body">
      <section class="view active" id="skillsView" aria-label="My Skills">
        <div class="toolbar">
          <div class="toolbar-left">
            <span class="toolbar-title">All Skills</span>
            <span class="toolbar-count" id="skillCount">0</span>
            <button class="filter-select" type="button">
              All
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="6 9 12 15 18 9"/></svg>
            </button>
            <button class="filter-select" type="button">
              Most recent
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M7 3v18M7 21l-4-4M7 21l4-4M17 21V3M17 3l-4 4M17 3l4 4"/></svg>
            </button>
            <div class="filter-select" id="tagFilterButton" role="button" tabindex="0" aria-haspopup="true" aria-expanded="false">
              <span id="tagFilterLabel">Tags</span>
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="6 9 12 15 18 9"/></svg>
              <div class="filter-dropdown" id="tagFilterDropdown"></div>
            </div>
            <div class="profile-switcher" id="profileSwitcher" role="button" tabindex="0" aria-haspopup="true" aria-expanded="false">
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 8h10M7 12h6"/></svg>
              <span>Current Profile: <span id="currentProfileName">Skills Hub Dev</span></span>
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="6 9 12 15 18 9"/></svg>
              <div class="profile-menu" id="profileMenu" role="menu"></div>
            </div>
          </div>
          <div class="toolbar-right">
            <div class="search-box">
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
              <input id="skillSearch" type="search" placeholder="Search skills..." />
            </div>
          </div>
        </div>

        <div class="skills-scroll">
          <div id="skillsList"></div>
        </div>
      </section>

      <section class="view" id="tagsView" aria-label="Manage Tags">
        <div class="tags-page">
          <div class="page-heading">
            <div>
              <button class="breadcrumb-button" type="button" id="backToSkillsFromTags">
                <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2"><polyline points="15 18 9 12 15 6"/></svg>
                My Skills
              </button>
              <h1 class="page-title">Tags</h1>
              <p class="page-desc">标签用于筛选和整理 skills，不会改变 Profile，也不会影响同步结果。</p>
            </div>
            <button class="btn btn-primary" type="button" id="newTagFromPage">New Tag</button>
          </div>
          <div class="tag-table-toolbar">
            <div class="search-box">
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
              <input id="tagManagerSearch" type="search" placeholder="Search tags..." />
            </div>
            <span class="section-note" id="tagManagerCount">0 tags</span>
          </div>
          <div id="untaggedCallout"></div>
          <div class="tag-table" id="tagTable"></div>
        </div>
      </section>

      <section class="view" id="profilesView" aria-label="Profiles">
        <div class="toolbar">
          <div class="toolbar-left">
            <span class="toolbar-title">Profiles</span>
            <span class="toolbar-count" id="profileCount">0</span>
            <span class="section-note">一套 Profile = skills + target tools，用于批量同步</span>
          </div>
          <div class="toolbar-right">
            <button class="btn btn-sm btn-secondary" type="button" id="duplicateProfile">
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="8" y="8" width="12" height="12" rx="2"/><path d="M16 8V6a2 2 0 00-2-2H6a2 2 0 00-2 2v8a2 2 0 002 2h2"/></svg>
              Duplicate
            </button>
            <button class="btn btn-sm btn-primary" type="button" id="newProfile">
              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>
              New Profile
            </button>
          </div>
        </div>

        <div class="profiles-layout">
          <aside class="profiles-sidebar" id="profilesSidebar" aria-label="Profile list"></aside>
          <div class="profile-detail">
            <div class="detail-header">
              <div>
                <h1 class="detail-title" id="detailTitle"></h1>
                <p class="detail-desc" id="detailDesc"></p>
              </div>
              <div class="detail-actions">
                <button class="btn btn-secondary" type="button" id="previewProfileButton">Preview Changes</button>
                <button class="btn btn-primary" type="button" id="applyProfileButton">Apply Profile</button>
              </div>
            </div>

            <section class="section">
              <div class="section-header">
                <div class="section-title">
                  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 7h16M4 12h16M4 17h10"/></svg>
                  Target Tools
                </div>
                <span class="section-note">这些工具会使用当前 Profile 的 skill 集合</span>
              </div>
              <div class="tool-grid" id="toolGrid"></div>
            </section>

            <section class="section">
              <div class="section-header">
                <div class="section-title">
                  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/></svg>
                  Included Skills
                </div>
                <span class="section-note" id="selectedSkillNote"></span>
              </div>
              <div class="profile-skill-list" id="profileSkillList"></div>
            </section>

            <section class="section">
              <div class="section-header">
                <div class="section-title">
                  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 20h9"/><path d="M16.5 3.5a2.12 2.12 0 113 3L7 19l-4 1 1-4Z"/></svg>
                  Apply Preview
                </div>
                <span class="section-note">切换前先展示增删变化，避免误改工具内实际生效的 skills</span>
              </div>
              <div class="preview-grid" id="previewGrid"></div>
            </section>
          </div>
        </div>
      </section>
    </div>

    <div class="modal-backdrop" id="applyModal" role="dialog" aria-modal="true" aria-labelledby="applyModalTitle">
      <div class="modal">
        <div class="modal-header">
          <div>
            <div class="modal-title" id="applyModalTitle">Apply Profile</div>
            <div class="section-note" id="applyModalSubtitle"></div>
          </div>
          <button class="modal-close" type="button" data-close-modal aria-label="Close">x</button>
        </div>
        <div class="modal-body">
          <div class="change-list" id="changeList"></div>
        </div>
        <div class="modal-footer">
          <button class="btn btn-secondary" type="button" data-close-modal>Cancel</button>
          <button class="btn btn-primary" type="button" id="confirmApply">Apply Changes</button>
        </div>
      </div>
    </div>

    <div class="modal-backdrop" id="tagModal" role="dialog" aria-modal="true" aria-labelledby="tagModalTitle">
      <div class="modal">
        <div class="modal-header">
          <div>
            <div class="modal-title" id="tagModalTitle">Edit Tags</div>
            <div class="section-note" id="tagModalSubtitle"></div>
          </div>
          <button class="modal-close" type="button" data-close-modal aria-label="Close">x</button>
        </div>
        <div class="modal-body">
          <div class="section-note">Tag 是检索维度，不会改变 Profile 或同步结果。</div>
          <div class="tag-editor-list" id="tagEditorList"></div>
        </div>
        <div class="modal-footer">
          <button class="btn btn-secondary" type="button" data-close-modal>Done</button>
        </div>
      </div>
    </div>

    <div class="modal-backdrop" id="tagManagerModal" role="dialog" aria-modal="true" aria-labelledby="tagManagerTitle">
      <div class="modal">
        <div class="modal-header">
          <div>
            <div class="modal-title" id="tagManagerTitle">Manage Tags</div>
            <div class="section-note">全局标签管理：创建、重命名、删除标签；不会改变 Profile 或同步状态。</div>
          </div>
          <button class="modal-close" type="button" data-close-modal aria-label="Close">x</button>
        </div>
        <div class="modal-body">
          <div class="tag-manager-toolbar">
            <input class="form-input" id="newTagInput" type="text" placeholder="New tag name, e.g. Backend" />
            <button class="btn btn-primary" type="button" id="createTagButton">New Tag</button>
          </div>
          <div class="tag-manager-list" id="tagManagerList"></div>
        </div>
        <div class="modal-footer">
          <button class="btn btn-secondary" type="button" data-close-modal>Done</button>
        </div>
      </div>
    </div>

    <div class="toast" id="toast" role="status" aria-live="polite">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3"><polyline points="20 6 9 17 4 12"/></svg>
      <span id="toastText">Applied</span>
    </div>
  </main>

  <script>
    const tools = ['Cursor', 'Codex', 'Claude Code', 'OpenCode', 'Windsurf', 'Cline'];
    let allTags = ['Frontend', 'React', 'Rust', 'Tauri', 'Docs', 'Testing', 'Diagram', 'Automation'];

    const skills = [
      {
        id: 'react',
        name: 'react',
        desc: 'React renderer for JSON specs and component catalogs.',
        source: 'vercel-labs/json-render',
        time: '22 min ago',
        tags: ['Frontend', 'React'],
        syncedTools: ['Cursor', 'Codex', 'Claude Code']
      },
      {
        id: 'tauri',
        name: 'tauri-desktop',
        desc: 'Desktop app guidance for Tauri 2, Rust commands, and frontend bridge work.',
        source: 'local/skills/tauri-desktop',
        time: '2 days ago',
        tags: ['Rust', 'Tauri'],
        syncedTools: ['Cursor', 'Codex']
      },
      {
        id: 'test-driven',
        name: 'test-driven-development',
        desc: 'Use when implementing a feature or bugfix with focused verification.',
        source: 'skills/test-driven-development',
        time: '7 days ago',
        tags: ['Testing', 'Automation'],
        syncedTools: ['Cursor', 'Codex', 'Claude Code']
      },
      {
        id: 'excalidraw',
        name: 'excalidraw-diagram',
        desc: 'Generate Excalidraw diagrams from text content, flowcharts, and mind maps.',
        source: 'axtonliu/axton-visual-skills',
        time: '37 days ago',
        tags: ['Docs', 'Diagram'],
        syncedTools: ['Cursor', 'Claude Code']
      },
      {
        id: 'youtube',
        name: 'youtube-transcript',
        desc: 'Download YouTube transcripts and captions from video URLs.',
        source: 'local/plugins/youtube-transcript',
        time: '45 days ago',
        tags: ['Docs', 'Automation'],
        syncedTools: ['Cursor', 'OpenCode']
      },
      {
        id: 'frontend-design',
        name: 'frontend-design',
        desc: 'Frontend design best practices for accessible React and CSS interfaces.',
        source: 'anthropics/skills',
        time: '46 days ago',
        tags: ['Frontend', 'Docs'],
        syncedTools: ['Cursor', 'Codex', 'Windsurf']
      },
      {
        id: 'legacy-shell',
        name: 'legacy-shell-helper',
        desc: 'Local helper skill imported from an existing tool directory and not organized yet.',
        source: 'local/skills/legacy-shell-helper',
        time: '52 days ago',
        tags: [],
        syncedTools: ['Cursor']
      }
    ];

    const profiles = [
      {
        id: 'skills-hub-dev',
        name: 'Skills Hub Dev',
        desc: 'React + Tauri + Rust 桌面应用开发场景，适合当前仓库。',
        skillIds: ['react', 'tauri', 'test-driven', 'frontend-design'],
        tools: ['Cursor', 'Codex', 'Claude Code'],
        active: true
      },
      {
        id: 'docs-writing',
        name: 'Docs Writing',
        desc: '资料处理、转写、画图和技术文档写作。',
        skillIds: ['excalidraw', 'youtube', 'frontend-design'],
        tools: ['Codex', 'Claude Code'],
        active: false
      },
      {
        id: 'review-flow',
        name: 'Review Flow',
        desc: '代码审查、测试补齐、设计检查的轻量配置。',
        skillIds: ['test-driven', 'frontend-design', 'react'],
        tools: ['Cursor', 'Codex'],
        active: false
      }
    ];

    let activeView = 'skills';
    let selectedTags = [];
    let selectedProfileId = profiles.find((profile) => profile.active).id;
    let selectedProfileInEditor = selectedProfileId;
    let searchTerm = '';
    let tagSearchTerm = '';
    let tagManagerSearchTerm = '';
    let pendingApplyProfileId = selectedProfileId;
    let editingSkillId = null;

    const state = {
      liveSkillIds: new Set(profiles.find((profile) => profile.active).skillIds),
      liveTools: new Set(profiles.find((profile) => profile.active).tools)
    };

    const iconBox = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 9h18V5a2 2 0 00-2-2H5a2 2 0 00-2 2v4z"/><path d="M3 9v10a2 2 0 002 2h14a2 2 0 002-2V9"/></svg>';
    const iconTag = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M20.59 13.41l-7.17 7.17a2 2 0 01-2.83 0L2 12V2h10l8.59 8.59a2 2 0 010 2.82z"/><line x1="7" y1="7" x2="7.01" y2="7"/></svg>';
    const iconSync = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg>';
    const iconCheck = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3"><polyline points="20 6 9 17 4 12"/></svg>';
    const UNTAGGED_FILTER = '__untagged__';
    const UNTAGGED_LABEL = 'Untagged';

    function getProfile(id) {
      return profiles.find((profile) => profile.id === id);
    }

    function getSkill(id) {
      return skills.find((skill) => skill.id === id);
    }

    function getFilterLabel(tag) {
      return tag === UNTAGGED_FILTER ? UNTAGGED_LABEL : tag;
    }

    function getUntaggedCount() {
      return skills.filter((skill) => skill.tags.length === 0).length;
    }

    function switchView(view) {
      activeView = view;
      document.querySelectorAll('.nav-tab[data-nav]').forEach((tab) => {
        tab.classList.toggle('active', tab.dataset.nav === view);
      });
      document.getElementById('skillsView').classList.toggle('active', view === 'skills');
      document.getElementById('tagsView').classList.toggle('active', view === 'tags');
      document.getElementById('profilesView').classList.toggle('active', view === 'profiles');
      renderAll();
    }

    function calculatePreview(profile) {
      const targetSkills = new Set(profile.skillIds);
      const targetTools = new Set(profile.tools);
      const add = [...targetSkills].filter((id) => !state.liveSkillIds.has(id));
      const remove = [...state.liveSkillIds].filter((id) => !targetSkills.has(id));
      const keep = [...targetSkills].filter((id) => state.liveSkillIds.has(id));
      const toolAdd = [...targetTools].filter((tool) => !state.liveTools.has(tool));
      const toolRemove = [...state.liveTools].filter((tool) => !targetTools.has(tool));
      return { add, remove, keep, toolAdd, toolRemove };
    }

    function renderNavProfileMenu() {
      const menu = document.getElementById('profileMenu');
      menu.innerHTML = profiles.map((profile) => `
        <button class="profile-menu-item ${profile.id === selectedProfileId ? 'active' : ''}" type="button" data-menu-profile="${profile.id}">
          <span>${profile.name}</span>
          <small>${profile.skillIds.length} skills</small>
        </button>
      `).join('') + `
        <div class="profile-menu-divider"></div>
        <button class="profile-menu-item" type="button" id="manageProfilesMenuItem">
          <span>Manage Profiles</span>
          <small>Open</small>
        </button>
      `;

      menu.querySelectorAll('[data-menu-profile]').forEach((button) => {
        button.addEventListener('click', (event) => {
          event.stopPropagation();
          const profileId = button.dataset.menuProfile;
          selectedProfileId = profileId;
          selectedProfileInEditor = profileId;
          pendingApplyProfileId = profileId;
          menu.classList.remove('open');
          document.getElementById('profileSwitcher').setAttribute('aria-expanded', 'false');
          renderAll();
          openApplyModal(profileId);
        });
      });
      document.getElementById('manageProfilesMenuItem').addEventListener('click', (event) => {
        event.stopPropagation();
        menu.classList.remove('open');
        document.getElementById('profileSwitcher').setAttribute('aria-expanded', 'false');
        switchView('profiles');
      });
    }

    function renderTagFilter() {
      const label = document.getElementById('tagFilterLabel');
      const button = document.getElementById('tagFilterButton');
      const dropdown = document.getElementById('tagFilterDropdown');
      label.textContent = selectedTags.length === 0
        ? 'Tags'
        : selectedTags.length === 1
          ? `Tag: ${getFilterLabel(selectedTags[0])}`
          : `Tags: ${selectedTags.length} selected`;
      button.classList.toggle('active', selectedTags.length > 0);

      const normalizedSearch = tagSearchTerm.toLowerCase();
      const tagOptions = [
        { id: UNTAGGED_FILTER, label: UNTAGGED_LABEL, count: getUntaggedCount(), virtual: true },
        ...allTags.map((tag) => ({ id: tag, label: tag, count: getTagUsageCount(tag), virtual: false }))
      ];
      const visibleTags = tagOptions.filter((tag) => tag.label.toLowerCase().includes(normalizedSearch));
      dropdown.innerHTML = `
        <div class="dropdown-title">
          <span>${selectedTags.length ? `Tags: ${selectedTags.length} selected` : 'Tags'}</span>
          <span class="section-note">Match any</span>
        </div>
        <div class="dropdown-search">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
          <input id="tagFilterSearch" type="search" placeholder="Search tags..." value="${tagSearchTerm}" />
        </div>
        <div class="tag-option-list">
          ${visibleTags.map((tag) => `
            <button class="tag-option" type="button" data-toggle-filter-tag="${tag.id}">
              <span class="checkbox ${selectedTags.includes(tag.id) ? 'checked' : ''}">${iconCheck}</span>
              <span>${tag.label}${tag.virtual ? '<span class="section-note"> · no tags</span>' : ''}</span>
              <span class="option-count">${tag.count}</span>
            </button>
          `).join('') || '<div class="empty-state"><strong>No tags</strong><span>Try another keyword.</span></div>'}
        </div>
        <div class="dropdown-footer">
          <button class="btn btn-sm btn-ghost" type="button" id="clearTagFilter">Clear all</button>
          <button class="btn btn-sm btn-ghost" type="button" id="openTagsPageFromDropdown">Manage Tags...</button>
        </div>
      `;

      dropdown.querySelectorAll('[data-toggle-filter-tag]').forEach((item) => {
        item.addEventListener('click', (event) => {
          event.stopPropagation();
          const tag = item.dataset.toggleFilterTag;
          selectedTags = selectedTags.includes(tag)
            ? selectedTags.filter((itemTag) => itemTag !== tag)
            : [...selectedTags, tag];
          renderTagFilter();
          renderSkills();
          document.getElementById('tagFilterDropdown').classList.add('open');
        });
      });
      document.getElementById('tagFilterSearch').addEventListener('click', (event) => event.stopPropagation());
      document.getElementById('tagFilterSearch').addEventListener('input', (event) => {
        tagSearchTerm = event.target.value;
        renderTagFilter();
        document.getElementById('tagFilterDropdown').classList.add('open');
        document.getElementById('tagFilterSearch').focus();
      });
      document.getElementById('clearTagFilter').addEventListener('click', (event) => {
        event.stopPropagation();
        selectedTags = [];
        tagSearchTerm = '';
        renderTagFilter();
        renderSkills();
        document.getElementById('tagFilterDropdown').classList.add('open');
      });
      document.getElementById('openTagsPageFromDropdown').addEventListener('click', (event) => {
        event.stopPropagation();
        closeTagDropdown();
        switchView('tags');
      });
    }

    function closeTagDropdown() {
      document.getElementById('tagFilterDropdown').classList.remove('open');
      document.getElementById('tagFilterButton').setAttribute('aria-expanded', 'false');
    }

    function renderSkills() {
      const list = document.getElementById('skillsList');
      const filteredSkills = skills.filter((skill) => {
        const tagMatch = selectedTags.length === 0 || selectedTags.some((tag) => {
          if (tag === UNTAGGED_FILTER) return skill.tags.length === 0;
          return skill.tags.includes(tag);
        });
        const searchMatch = !searchTerm
          || skill.name.toLowerCase().includes(searchTerm)
          || skill.desc.toLowerCase().includes(searchTerm)
          || skill.tags.some((tag) => tag.toLowerCase().includes(searchTerm));
        return tagMatch && searchMatch;
      });

      document.getElementById('skillCount').textContent = filteredSkills.length;

      if (filteredSkills.length === 0) {
        list.innerHTML = '<div class="empty-state"><strong>No matching skills</strong><span>Try another tag or search keyword.</span></div>';
        return;
      }

      list.innerHTML = filteredSkills.map((skill) => {
        const toolBadges = skill.syncedTools.slice(0, 4).map((tool) => `<span class="tool-badge synced">${tool}</span>`).join('');
        const more = skill.syncedTools.length > 4 ? `<span class="tool-badge ghost">+${skill.syncedTools.length - 4}</span>` : '';
        const tagChips = skill.tags.length
          ? skill.tags.map((tag) => `<button class="inline-tag" type="button" data-inline-tag="${tag}">#${tag}</button>`).join('')
          : `<button class="inline-tag empty" type="button" data-edit-tags="${skill.id}">No tags</button>`;
        return `
          <article class="skill-row">
            <div class="skill-icon-sm" aria-hidden="true">${iconBox}</div>
            <div class="skill-info">
              <div class="skill-name-row">
                <span class="skill-name">${skill.name}</span>
                <div class="skill-tags">${tagChips}</div>
              </div>
              <div class="skill-desc">${skill.desc}</div>
              <div class="skill-meta-row">
                <span class="skill-source">${skill.source}</span>
                <span class="skill-time">&middot; ${skill.time}</span>
              </div>
              <div class="tool-badges">${toolBadges}${more}</div>
            </div>
            <div class="row-actions">
              <button class="action-btn" type="button" data-edit-tags="${skill.id}" aria-label="Edit tags">${iconTag}</button>
              <button class="action-btn" type="button" aria-label="Sync">${iconSync}</button>
            </div>
          </article>
        `;
      }).join('');

      list.querySelectorAll('[data-inline-tag]').forEach((button) => {
        button.addEventListener('click', () => {
          selectedTags = [button.dataset.inlineTag];
          renderTagFilter();
          renderSkills();
        });
      });

      list.querySelectorAll('[data-edit-tags]').forEach((button) => {
        button.addEventListener('click', () => openTagModal(button.dataset.editTags));
      });
    }

    function renderProfileSummary() {
      const profile = getProfile(selectedProfileId);
      document.getElementById('currentProfileName').textContent = profile.name;
    }

    function renderProfilesSidebar() {
      const sidebar = document.getElementById('profilesSidebar');
      document.getElementById('profileCount').textContent = profiles.length;
      sidebar.innerHTML = profiles.map((profile) => `
        <button class="profile-card ${profile.id === selectedProfileInEditor ? 'active' : ''}" type="button" data-profile-card="${profile.id}">
          <div class="profile-card-top">
            <span class="profile-name">${profile.name}</span>
            ${profile.id === selectedProfileId ? '<span class="status-pill active">Active</span>' : '<span class="status-pill draft">Draft</span>'}
          </div>
          <div class="profile-card-desc">${profile.desc}</div>
          <div class="profile-card-meta">
            <span>${profile.skillIds.length} skills</span>
            <span>${profile.tools.length} tools</span>
          </div>
        </button>
      `).join('');

      sidebar.querySelectorAll('[data-profile-card]').forEach((button) => {
        button.addEventListener('click', () => {
          selectedProfileInEditor = button.dataset.profileCard;
          renderProfiles();
        });
      });
    }

    function renderProfileDetail() {
      const profile = getProfile(selectedProfileInEditor);
      const preview = calculatePreview(profile);

      document.getElementById('detailTitle').textContent = profile.name;
      document.getElementById('detailDesc').textContent = profile.desc;
      document.getElementById('selectedSkillNote').textContent = `${profile.skillIds.length} selected, group 内不重复，跨 Profile 可复用`;

      const toolGrid = document.getElementById('toolGrid');
      toolGrid.innerHTML = tools.map((tool) => `
        <button class="select-chip ${profile.tools.includes(tool) ? 'selected' : ''}" type="button" data-toggle-tool="${tool}">
          <span class="check-dot"></span>${tool}
        </button>
      `).join('');
      toolGrid.querySelectorAll('[data-toggle-tool]').forEach((button) => {
        button.addEventListener('click', () => {
          const tool = button.dataset.toggleTool;
          if (profile.tools.includes(tool)) {
            profile.tools = profile.tools.filter((item) => item !== tool);
          } else {
            profile.tools = [...profile.tools, tool];
          }
          renderAll();
        });
      });

      const profileSkillList = document.getElementById('profileSkillList');
      profileSkillList.innerHTML = skills.map((skill) => {
        const selected = profile.skillIds.includes(skill.id);
        return `
          <button class="profile-skill-row" type="button" data-toggle-skill="${skill.id}">
            <span class="checkbox ${selected ? 'checked' : ''}">${iconCheck}</span>
            <span class="profile-skill-main">
              <span class="profile-skill-name">${skill.name}</span>
              <span class="profile-skill-description">${skill.desc}</span>
            </span>
            <span class="profile-skill-tags">
              ${skill.tags.slice(0, 3).map((tag) => `<span class="inline-tag">#${tag}</span>`).join('')}
            </span>
          </button>
        `;
      }).join('');
      profileSkillList.querySelectorAll('[data-toggle-skill]').forEach((button) => {
        button.addEventListener('click', () => {
          const skillId = button.dataset.toggleSkill;
          if (profile.skillIds.includes(skillId)) {
            profile.skillIds = profile.skillIds.filter((id) => id !== skillId);
          } else {
            profile.skillIds = [...profile.skillIds, skillId];
          }
          renderAll();
        });
      });

      document.getElementById('previewGrid').innerHTML = `
        <div class="preview-card add"><strong>+${preview.add.length}</strong><span>skills will be added</span></div>
        <div class="preview-card remove"><strong>-${preview.remove.length}</strong><span>skills will be removed</span></div>
        <div class="preview-card keep"><strong>${preview.keep.length}</strong><span>skills will stay active</span></div>
      `;
    }

    function renderProfiles() {
      renderProfilesSidebar();
      renderProfileDetail();
    }

    function openApplyModal(profileId) {
      pendingApplyProfileId = profileId;
      const profile = getProfile(profileId);
      const preview = calculatePreview(profile);
      const modal = document.getElementById('applyModal');
      const list = document.getElementById('changeList');
      document.getElementById('applyModalTitle').textContent = `Apply ${profile.name}`;
      document.getElementById('applyModalSubtitle').textContent =
        `${profile.skillIds.length} skills will sync to ${profile.tools.join(', ') || 'no tools selected'}.`;

      const changes = [
        ...preview.add.map((id) => ({ type: 'add', name: getSkill(id).name, label: 'ADD SKILL' })),
        ...preview.remove.map((id) => ({ type: 'remove', name: getSkill(id).name, label: 'REMOVE SKILL' })),
        ...preview.keep.slice(0, 4).map((id) => ({ type: 'keep', name: getSkill(id).name, label: 'KEEP' })),
        ...preview.toolAdd.map((tool) => ({ type: 'add', name: tool, label: 'ADD TOOL' })),
        ...preview.toolRemove.map((tool) => ({ type: 'remove', name: tool, label: 'REMOVE TOOL' }))
      ];

      list.innerHTML = changes.length
        ? changes.map((change) => `<div class="change-item ${change.type}"><span>${change.name}</span><span class="kind">${change.label}</span></div>`).join('')
        : '<div class="change-item keep"><span>No changes compared with current live sync state.</span><span class="kind">UNCHANGED</span></div>';

      modal.classList.add('open');
    }

    function applyProfile(profileId) {
      const profile = getProfile(profileId);
      selectedProfileId = profileId;
      selectedProfileInEditor = profileId;
      profiles.forEach((item) => {
        item.active = item.id === profileId;
      });
      state.liveSkillIds = new Set(profile.skillIds);
      state.liveTools = new Set(profile.tools);
      closeModals();
      renderAll();
      showToast(`${profile.name} applied`);
    }

    function openTagModal(skillId) {
      editingSkillId = skillId;
      const skill = getSkill(skillId);
      document.getElementById('tagModalTitle').textContent = `Edit Tags: ${skill.name}`;
      document.getElementById('tagModalSubtitle').textContent = 'Click tags to add or remove them from this skill.';
      renderTagEditor();
      document.getElementById('tagModal').classList.add('open');
    }

    function renderTagEditor() {
      const skill = getSkill(editingSkillId);
      document.getElementById('tagEditorList').innerHTML = allTags.map((tag) => `
        <button class="select-chip ${skill.tags.includes(tag) ? 'selected' : ''}" type="button" data-editor-tag="${tag}">
          <span class="check-dot"></span>${tag}
        </button>
      `).join('');

      document.querySelectorAll('[data-editor-tag]').forEach((button) => {
        button.addEventListener('click', () => {
          const tag = button.dataset.editorTag;
          if (skill.tags.includes(tag)) {
            skill.tags = skill.tags.filter((item) => item !== tag);
          } else {
            skill.tags = [...skill.tags, tag];
          }
          renderTagEditor();
          renderTagFilter();
          renderTagsPage();
          renderSkills();
          renderProfiles();
        });
      });
    }

    function getTagUsageCount(tag) {
      return skills.filter((skill) => skill.tags.includes(tag)).length;
    }

    function openTagManagerModal() {
      renderTagManager();
      document.getElementById('tagManagerModal').classList.add('open');
      document.getElementById('newTagInput').focus();
    }

    function renderTagManager() {
      const list = document.getElementById('tagManagerList');
      list.innerHTML = allTags.map((tag, index) => `
        <div class="tag-manager-row">
          <div class="tag-manager-name">
            <span class="tag-color-dot" style="background:${getTagColor(index)}"></span>
            <span>${tag}</span>
          </div>
          <div class="tag-manager-count">${getTagUsageCount(tag)} skills</div>
          <div class="tag-manager-actions">
            <button class="btn btn-sm btn-ghost" type="button" data-rename-tag="${tag}">Rename</button>
            <button class="btn btn-sm btn-ghost" type="button" data-delete-tag="${tag}">Delete</button>
          </div>
        </div>
      `).join('');

      list.querySelectorAll('[data-rename-tag]').forEach((button) => {
        button.addEventListener('click', () => renameTag(button.dataset.renameTag));
      });

      list.querySelectorAll('[data-delete-tag]').forEach((button) => {
        button.addEventListener('click', () => deleteTag(button.dataset.deleteTag));
      });
    }

    function renderTagsPage() {
      const table = document.getElementById('tagTable');
      const normalizedSearch = tagManagerSearchTerm.toLowerCase();
      const visibleTags = allTags.filter((tag) => tag.toLowerCase().includes(normalizedSearch));
      document.getElementById('tagManagerCount').textContent = `${visibleTags.length} tags`;
      table.innerHTML = `
        <div class="tag-table-row header">
          <div>Tag name</div>
          <div>Skills</div>
          <div>Last used</div>
          <div></div>
        </div>
        ${visibleTags.map((tag, index) => `
          <div class="tag-table-row">
            <div class="tag-manager-name">
              <span class="tag-color-dot" style="background:${getTagColor(index)}"></span>
              <span>${tag}</span>
            </div>
            <div class="tag-manager-count">${getTagUsageCount(tag)} skills</div>
            <div class="tag-manager-count">${index + 2}d ago</div>
            <div class="tag-table-actions">
              <button class="btn btn-sm btn-ghost" type="button" data-filter-tag-from-page="${tag}">View</button>
              <button class="btn btn-sm btn-ghost" type="button" data-rename-tag="${tag}">Rename</button>
              <button class="btn btn-sm btn-ghost" type="button" data-delete-tag="${tag}">Delete</button>
            </div>
          </div>
        `).join('') || '<div class="empty-state"><strong>No tags</strong><span>Create a tag or change the search keyword.</span></div>'}
      `;
      document.getElementById('untaggedCallout').innerHTML = getUntaggedCount() > 0 ? `
        <div class="untagged-callout">
          <div>
            <strong>${getUntaggedCount()} skills have no tags</strong>
            <span>Untagged 是系统虚拟状态，不会出现在可重命名或删除的标签表里。</span>
          </div>
          <button class="btn btn-sm btn-secondary" type="button" id="reviewUntagged">Review</button>
        </div>
      ` : '';
      const reviewUntagged = document.getElementById('reviewUntagged');
      if (reviewUntagged) {
        reviewUntagged.addEventListener('click', () => {
          selectedTags = [UNTAGGED_FILTER];
          switchView('skills');
        });
      }

      table.querySelectorAll('[data-filter-tag-from-page]').forEach((button) => {
        button.addEventListener('click', () => {
          selectedTags = [button.dataset.filterTagFromPage];
          switchView('skills');
        });
      });
      table.querySelectorAll('[data-rename-tag]').forEach((button) => {
        button.addEventListener('click', () => renameTag(button.dataset.renameTag));
      });
      table.querySelectorAll('[data-delete-tag]').forEach((button) => {
        button.addEventListener('click', () => deleteTag(button.dataset.deleteTag));
      });
    }

    function getTagColor(index) {
      return ['#2563EB', '#7C3AED', '#059669', '#D97706', '#0891B2', '#DB2777', '#4F46E5', '#16A34A'][index % 8];
    }

    function normalizeTagName(name) {
      return name.trim().replace(/\s+/g, ' ');
    }

    function createTag() {
      const input = document.getElementById('newTagInput');
      const tagName = normalizeTagName(input.value);
      if (!tagName) return;
      if (allTags.some((tag) => tag.toLowerCase() === tagName.toLowerCase())) {
        showToast('Tag already exists');
        return;
      }
      allTags = [...allTags, tagName];
      input.value = '';
      renderAll();
      renderTagManager();
      showToast(`Tag "${tagName}" created`);
    }

    function renameTag(oldName) {
      const nextName = normalizeTagName(window.prompt('Rename tag', oldName) || '');
      if (!nextName || nextName === oldName) return;
      if (allTags.some((tag) => tag.toLowerCase() === nextName.toLowerCase())) {
        showToast('Tag already exists');
        return;
      }
      allTags = allTags.map((tag) => tag === oldName ? nextName : tag);
      skills.forEach((skill) => {
        skill.tags = skill.tags.map((tag) => tag === oldName ? nextName : tag);
      });
      selectedTags = selectedTags.map((tag) => tag === oldName ? nextName : tag);
      renderAll();
      renderTagManager();
      showToast(`Tag renamed to "${nextName}"`);
    }

    function deleteTag(tagName) {
      const inUse = getTagUsageCount(tagName);
      const confirmed = window.confirm(`Delete "${tagName}" from ${inUse} skills? This only removes the tag, not the skills.`);
      if (!confirmed) return;
      allTags = allTags.filter((tag) => tag !== tagName);
      skills.forEach((skill) => {
        skill.tags = skill.tags.filter((tag) => tag !== tagName);
      });
      selectedTags = selectedTags.filter((tag) => tag !== tagName);
      renderAll();
      renderTagManager();
      showToast(`Tag "${tagName}" deleted`);
    }

    function closeModals() {
      document.querySelectorAll('.modal-backdrop').forEach((modal) => modal.classList.remove('open'));
    }

    function showToast(text) {
      const toast = document.getElementById('toast');
      document.getElementById('toastText').textContent = text;
      toast.classList.add('show');
      window.clearTimeout(showToast.timer);
      showToast.timer = window.setTimeout(() => toast.classList.remove('show'), 2200);
    }

    function renderAll() {
      renderNavProfileMenu();
      renderTagFilter();
      renderSkills();
      renderProfileSummary();
      renderProfiles();
      renderTagsPage();
    }

    document.querySelectorAll('.nav-tab[data-nav]').forEach((tab) => {
      tab.addEventListener('click', () => switchView(tab.dataset.nav));
    });

    document.getElementById('previewProfileButton').addEventListener('click', () => openApplyModal(selectedProfileInEditor));
    document.getElementById('applyProfileButton').addEventListener('click', () => openApplyModal(selectedProfileInEditor));
    document.getElementById('confirmApply').addEventListener('click', () => applyProfile(pendingApplyProfileId));
    document.getElementById('createTagButton').addEventListener('click', createTag);
    document.getElementById('newTagInput').addEventListener('keydown', (event) => {
      if (event.key === 'Enter') createTag();
    });
    document.getElementById('newTagFromPage').addEventListener('click', openTagManagerModal);
    document.getElementById('backToSkillsFromTags').addEventListener('click', () => switchView('skills'));
    document.getElementById('tagManagerSearch').addEventListener('input', (event) => {
      tagManagerSearchTerm = event.target.value.trim();
      renderTagsPage();
    });
    document.getElementById('tagFilterButton').addEventListener('click', (event) => {
      event.stopPropagation();
      const dropdown = document.getElementById('tagFilterDropdown');
      const isOpen = dropdown.classList.toggle('open');
      document.getElementById('tagFilterButton').setAttribute('aria-expanded', String(isOpen));
      if (isOpen) {
        tagSearchTerm = '';
        renderTagFilter();
        document.getElementById('tagFilterDropdown').classList.add('open');
      }
    });

    document.getElementById('profileSwitcher').addEventListener('click', () => {
      const menu = document.getElementById('profileMenu');
      const isOpen = menu.classList.toggle('open');
      document.getElementById('profileSwitcher').setAttribute('aria-expanded', String(isOpen));
    });

    document.getElementById('skillSearch').addEventListener('input', (event) => {
      searchTerm = event.target.value.trim().toLowerCase();
      renderSkills();
    });

    document.getElementById('duplicateProfile').addEventListener('click', () => {
      const source = getProfile(selectedProfileInEditor);
      const copy = {
        id: `${source.id}-copy-${Date.now()}`,
        name: `${source.name} Copy`,
        desc: source.desc,
        skillIds: [...source.skillIds],
        tools: [...source.tools],
        active: false
      };
      profiles.push(copy);
      selectedProfileInEditor = copy.id;
      renderAll();
      showToast('Profile duplicated');
    });

    document.getElementById('newProfile').addEventListener('click', () => {
      const profile = {
        id: `custom-${Date.now()}`,
        name: 'Custom Profile',
        desc: 'A new profile for a specific project or workflow.',
        skillIds: [],
        tools: ['Cursor'],
        active: false
      };
      profiles.push(profile);
      selectedProfileInEditor = profile.id;
      renderAll();
      showToast('Profile created');
    });

    document.querySelectorAll('[data-close-modal]').forEach((button) => {
      button.addEventListener('click', closeModals);
    });

    document.querySelectorAll('.modal-backdrop').forEach((backdrop) => {
      backdrop.addEventListener('click', (event) => {
        if (event.target === backdrop) closeModals();
      });
    });

    document.addEventListener('keydown', (event) => {
      if (event.key === 'Escape') {
        closeModals();
        document.getElementById('profileMenu').classList.remove('open');
        closeTagDropdown();
      }
    });

    document.addEventListener('click', (event) => {
      if (!document.getElementById('tagFilterButton').contains(event.target)) {
        closeTagDropdown();
      }
    });

    renderAll();
  </script>
</body>
</html>


================================================
FILE: eslint.config.js
================================================
import js from '@eslint/js'
import globals from 'globals'
import reactHooks from 'eslint-plugin-react-hooks'
import reactRefresh from 'eslint-plugin-react-refresh'
import tseslint from 'typescript-eslint'
import { defineConfig, globalIgnores } from 'eslint/config'

export default defineConfig([
  globalIgnores(['dist', 'src-tauri/target']),
  {
    files: ['**/*.{ts,tsx}'],
    extends: [
      js.configs.recommended,
      tseslint.configs.recommended,
      reactHooks.configs.flat.recommended,
      reactRefresh.configs.vite,
    ],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
    },
  },
])


================================================
FILE: featured-skills.json
================================================
{
  "updated_at": "2026-05-13T01:47:46.473Z",
  "total": 300,
  "categories": [
    "ai-assistant",
    "development"
  ],
  "skills": [
    {
      "slug": "algorithmic-art",
      "name": "algorithmic-art",
      "summary": "Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/algorithmic-art",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "brand-guidelines",
      "name": "brand-guidelines",
      "summary": "Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/brand-guidelines",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "canvas-design",
      "name": "canvas-design",
      "summary": "Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/canvas-design",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "claude-api",
      "name": "claude-api",
      "summary": "Build, debug, and optimize Claude API / Anthropic SDK apps. Apps built with this skill should include prompt caching. Also handles migrating existing Claude API code between Claude model versions (4.5 → 4.6, 4.6 → 4.7, retired-model replacements). TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`; user asks for the Claude API, Anthropic SDK, or Managed Agents; user adds/modifies/tunes a Claude feature (caching, thinking, compaction, tool use, batch, files, citations, memory) or model (Opus/Sonnet/Haiku) in a file; questions about prompt caching / cache hit rate in an Anthropic SDK project. SKIP: file imports `openai`/other-provider SDK, filename like `*-openai.py`/`*-generic.py`, provider-neutral code, general programming/ML.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/claude-api",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "doc-coauthoring",
      "name": "doc-coauthoring",
      "summary": "Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "docx",
      "name": "docx",
      "summary": "Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/docx",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "frontend-design",
      "name": "frontend-design",
      "summary": "Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/frontend-design",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "internal-comms",
      "name": "internal-comms",
      "summary": "A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/internal-comms",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "mcp-builder",
      "name": "mcp-builder",
      "summary": "Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "pdf",
      "name": "pdf",
      "summary": "Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/pdf",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "pptx",
      "name": "pptx",
      "summary": "Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \\\"deck,\\\" \\\"slides,\\\" \\\"presentation,\\\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/pptx",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "skill-creator",
      "name": "skill-creator",
      "summary": "Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/skill-creator",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "slack-gif-creator",
      "name": "slack-gif-creator",
      "summary": "Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like \"make me a GIF of X doing Y for Slack.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "template",
      "name": "template-skill",
      "summary": "Replace with description of the skill and when Claude should use it.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/template",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "theme-factory",
      "name": "theme-factory",
      "summary": "Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/theme-factory",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "web-artifacts-builder",
      "name": "web-artifacts-builder",
      "summary": "Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/web-artifacts-builder",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "webapp-testing",
      "name": "webapp-testing",
      "summary": "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.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/webapp-testing",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "xlsx",
      "name": "xlsx",
      "summary": "Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \\\"the xlsx in my downloads\\\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.",
      "downloads": 0,
      "stars": 133029,
      "category": "ai-assistant",
      "tags": [
        "agent-skills"
      ],
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/xlsx",
      "updated_at": "2026-05-13T01:45:43Z"
    },
    {
      "slug": "00-andruia-consultant",
      "name": "00-andruia-consultant",
      "summary": "Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/00-andruia-consultant",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "007",
      "name": "007",
      "summary": "Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/007",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "10-andruia-skill-smith",
      "name": "10-andruia-skill-smith",
      "summary": "Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/10-andruia-skill-smith",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "20-andruia-niche-intelligence",
      "name": "20-andruia-niche-intelligence",
      "summary": "Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/20-andruia-niche-intelligence",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "3d-web-experience",
      "name": "3d-web-experience",
      "summary": "Expert in building 3D experiences for the web - Three.js, React",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/3d-web-experience",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ab-test-setup",
      "name": "ab-test-setup",
      "summary": "Structured guide for setting up A/B tests with mandatory gates for hypothesis, metrics, and execution readiness.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ab-test-setup",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "acceptance-orchestrator",
      "name": "acceptance-orchestrator",
      "summary": "Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/acceptance-orchestrator",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "accessibility-compliance-accessibility-audit",
      "name": "accessibility-compliance-accessibility-audit",
      "summary": "You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/accessibility-compliance-accessibility-audit",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "active-directory-attacks",
      "name": "active-directory-attacks",
      "summary": "Provide comprehensive techniques for attacking Microsoft Active Directory environments. Covers reconnaissance, credential harvesting, Kerberos attacks, lateral movement, privilege escalation, and domain dominance for red team operations and penetration testing.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/active-directory-attacks",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "activecampaign-automation",
      "name": "activecampaign-automation",
      "summary": "Automate ActiveCampaign tasks via Rube MCP (Composio): manage contacts, tags, list subscriptions, automation enrollment, and tasks. Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/activecampaign-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ad-creative",
      "name": "ad-creative",
      "summary": "Create, iterate, and scale paid ad creative for Google Ads, Meta, LinkedIn, TikTok, and similar platforms. Use when generating headlines, descriptions, primary text, or large sets of ad variations for testing and performance optimization.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ad-creative",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "address-github-comments",
      "name": "address-github-comments",
      "summary": "Use when you need to address review or issue comments on an open GitHub Pull Request using the gh CLI.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/address-github-comments",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "adhx",
      "name": "adhx",
      "summary": "Fetch any X/Twitter post as clean LLM-friendly JSON. Converts x.com, twitter.com, or adhx.com links into structured data with full article content, author info, and engagement metrics. No scraping or browser required.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/adhx",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "advanced-evaluation",
      "name": "advanced-evaluation",
      "summary": "This skill should be used when the user asks to \"implement LLM-as-judge\", \"compare model outputs\", \"create evaluation rubrics\", \"mitigate evaluation bias\", or mentions direct scoring, pairwise comparison, position bias, evaluation pipelines, or automated quality assessment.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/advanced-evaluation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "advogado-criminal",
      "name": "advogado-criminal",
      "summary": "Advogado criminalista especializado em Maria da Penha, violencia domestica, feminicidio, direito penal brasileiro, medidas protetivas, inquerito policial e acao penal.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/advogado-criminal",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "advogado-especialista",
      "name": "advogado-especialista",
      "summary": "Advogado especialista em todas as areas do Direito brasileiro: familia, criminal, trabalhista, tributario, consumidor, imobiliario, empresarial, civil e constitucional.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/advogado-especialista",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aegisops-ai",
      "name": "aegisops-ai",
      "summary": "Autonomous DevSecOps & FinOps Guardrails. Orchestrates Gemini 3 Flash to audit Linux Kernel patches, Terraform cost drifts, and K8s compliance.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aegisops-ai",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-evaluation",
      "name": "agent-evaluation",
      "summary": "Testing and benchmarking LLM agents including behavioral testing,",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-evaluation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-framework-azure-ai-py",
      "name": "agent-framework-azure-ai-py",
      "summary": "Build persistent agents on Azure AI Foundry using the Microsoft Agent Framework Python SDK.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-framework-azure-ai-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-manager-skill",
      "name": "agent-manager-skill",
      "summary": "Manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-manager-skill",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-memory-mcp",
      "name": "agent-memory-mcp",
      "summary": "A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-memory-mcp",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-memory-systems",
      "name": "agent-memory-systems",
      "summary": "Memory is the cornerstone of intelligent agents. Without it, every",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-memory-systems",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-orchestration-improve-agent",
      "name": "agent-orchestration-improve-agent",
      "summary": "Systematic improvement of existing agents through performance analysis, prompt engineering, and continuous iteration.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-orchestration-improve-agent",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-orchestration-multi-agent-optimize",
      "name": "agent-orchestration-multi-agent-optimize",
      "summary": "Optimize multi-agent systems with coordinated profiling, workload distribution, and cost-aware orchestration. Use when improving agent performance, throughput, or reliability.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-orchestration-multi-agent-optimize",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-orchestrator",
      "name": "agent-orchestrator",
      "summary": "Meta-skill que orquestra todos os agentes do ecossistema. Scan automatico de skills, match por capacidades, coordenacao de workflows multi-skill e registry management.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-orchestrator",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agent-tool-builder",
      "name": "agent-tool-builder",
      "summary": "Tools are how AI agents interact with the world. A well-designed",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agent-tool-builder",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agentflow",
      "name": "agentflow",
      "summary": "Orchestrate autonomous AI development pipelines through your Kanban board (Asana, GitHub Projects, Linear). Manages multi-worker Claude Code dispatch, deterministic quality gates, adversarial review, per-task cost tracking, and crash-proof pipeline execution.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agentflow",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agentfolio",
      "name": "agentfolio",
      "summary": "Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agentfolio",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agentic-actions-auditor",
      "name": "agentic-actions-auditor",
      "summary": ">",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agentic-actions-auditor",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agentmail",
      "name": "agentmail",
      "summary": "Email infrastructure for AI agents. Create accounts, send/receive emails, manage webhooks, and check karma balance via the AgentMail API.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agentmail",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agentphone",
      "name": "agentphone",
      "summary": "Build AI phone agents with AgentPhone API. Use when the user wants to make phone calls, send/receive SMS, manage phone numbers, create voice agents, set up webhooks, or check usage — anything related to telephony, phone numbers, or voice AI.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agentphone",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agents-md",
      "name": "agents-md",
      "summary": "This skill should be used when the user asks to \"create AGENTS.md\", \"update AGENTS.md\", \"maintain agent docs\", \"set up CLAUDE.md\", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agents-md",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agents-v2-py",
      "name": "agents-v2-py",
      "summary": "Build container-based Foundry Agents with Azure AI Projects SDK (ImageBasedHostedAgentDefinition). Use when creating hosted agents with custom container images in Azure AI Foundry.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agents-v2-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "agenttrace-session-audit",
      "name": "agenttrace-session-audit",
      "summary": "Audit local AI coding-agent sessions with agenttrace for cost, tool failures, latency, anomalies, health, diffs, and CI gates.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agenttrace-session-audit",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-agent-development",
      "name": "ai-agent-development",
      "summary": "AI agent development workflow for building autonomous agents, multi-agent systems, and agent orchestration with CrewAI, LangGraph, and custom agents.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-agent-development",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-agents-architect",
      "name": "ai-agents-architect",
      "summary": "Expert in designing and building autonomous AI agents. Masters tool",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-agents-architect",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-analyzer",
      "name": "ai-analyzer",
      "summary": "AI驱动的综合健康分析系统，整合多维度健康数据、识别异常模式、预测健康风险、提供个性化建议。支持智能问答和AI健康报告生成。",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-analyzer",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-dev-jobs-mcp",
      "name": "ai-dev-jobs-mcp",
      "summary": "Search 8,400+ AI and ML jobs across 489 companies, inspect listings and employers, match roles, and view salary and market stats via AI Dev Jobs MCP",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-dev-jobs-mcp",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-engineer",
      "name": "ai-engineer",
      "summary": "Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-engineer",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-engineering-toolkit",
      "name": "ai-engineering-toolkit",
      "summary": "6 production-ready AI engineering workflows: prompt evaluation (8-dimension scoring), context budget planning, RAG pipeline design, agent security audit (65-point checklist), eval harness building, and product sense coaching.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-engineering-toolkit",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-md",
      "name": "ai-md",
      "summary": "Convert human-written CLAUDE.md into AI-native structured-label format. Battle-tested across 4 models. Same rules, fewer tokens, higher compliance.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-md",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-ml",
      "name": "ai-ml",
      "summary": "AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-ml",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-native-cli",
      "name": "ai-native-cli",
      "summary": "Design spec with 98 rules for building CLI tools that AI agents can safely use. Covers structured JSON output, error handling, input contracts, safety guardrails, exit codes, and agent self-description.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-native-cli",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-product",
      "name": "ai-product",
      "summary": "Every product will be AI-powered. The question is whether you'll",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-product",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-seo",
      "name": "ai-seo",
      "summary": "Optimize content for AI search and LLM citations across AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and similar systems. Use when improving AI visibility, answer engine optimization, or citation readiness.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-seo",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-studio-image",
      "name": "ai-studio-image",
      "summary": "Geracao de imagens humanizadas via Google AI Studio (Gemini). Fotos realistas estilo influencer ou educacional com iluminacao natural e imperfeicoes sutis.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-studio-image",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ai-wrapper-product",
      "name": "ai-wrapper-product",
      "summary": "Expert in building products that wrap AI APIs (OpenAI, Anthropic,",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-wrapper-product",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "airflow-dag-patterns",
      "name": "airflow-dag-patterns",
      "summary": "Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/airflow-dag-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "airtable-automation",
      "name": "airtable-automation",
      "summary": "Automate Airtable tasks via Rube MCP (Composio): records, bases, tables, fields, views. Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/airtable-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "akf-trust-metadata",
      "name": "akf-trust-metadata",
      "summary": "The AI native file format. EXIF for AI — stamps every file with trust scores, source provenance, and compliance metadata. Embeds into 20+ formats (DOCX, PDF, images, code). EU AI Act, SOX, HIPAA auditing.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/akf-trust-metadata",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "algolia-search",
      "name": "algolia-search",
      "summary": "Expert patterns for Algolia search implementation, indexing",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/algolia-search",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "alpha-vantage",
      "name": "alpha-vantage",
      "summary": "Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/alpha-vantage",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "amazon-alexa",
      "name": "amazon-alexa",
      "summary": "Integracao completa com Amazon Alexa para criar skills de voz inteligentes, transformar Alexa em assistente com Claude como cerebro (projeto Auri) e integrar com AWS ecosystem (Lambda, DynamoDB, Polly, Transcribe, Lex, Smart Home).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/amazon-alexa",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "amplitude-automation",
      "name": "amplitude-automation",
      "summary": "Automate Amplitude tasks via Rube MCP (Composio): events, user activity, cohorts, user identification. Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/amplitude-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "analytics-product",
      "name": "analytics-product",
      "summary": "Analytics de produto — PostHog, Mixpanel, eventos, funnels, cohorts, retencao, north star metric, OKRs e dashboards de produto.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/analytics-product",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "analytics-tracking",
      "name": "analytics-tracking",
      "summary": "Design, audit, and improve analytics tracking systems that produce reliable, decision-ready data.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/analytics-tracking",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "analyze-project",
      "name": "analyze-project",
      "summary": "Forensic root cause analyzer for Antigravity sessions. Classifies scope deltas, rework patterns, root causes, hotspots, and auto-improves prompts/health.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/analyze-project",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "andrej-karpathy",
      "name": "andrej-karpathy",
      "summary": "Agente que simula Andrej Karpathy — ex-Director of AI da Tesla, co-fundador da OpenAI, fundador da Eureka Labs, e o maior educador de deep learning do mundo.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/andrej-karpathy",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "android_ui_verification",
      "name": "android_ui_verification",
      "summary": "Automated end-to-end UI testing and verification on an Android Emulator using ADB.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/android_ui_verification",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "android-jetpack-compose-expert",
      "name": "android-jetpack-compose-expert",
      "summary": "Expert guidance for building modern Android UIs with Jetpack Compose, covering state management, navigation, performance, and Material Design 3.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/android-jetpack-compose-expert",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "angular",
      "name": "angular",
      "summary": "Modern Angular (v20+) expert with deep knowledge of Signals, Standalone Components, Zoneless applications, SSR/Hydration, and reactive patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/angular",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "angular-best-practices",
      "name": "angular-best-practices",
      "summary": "Angular performance optimization and best practices guide. Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/angular-best-practices",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "angular-migration",
      "name": "angular-migration",
      "summary": "Master AngularJS to Angular migration, including hybrid apps, component conversion, dependency injection changes, and routing migration.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/angular-migration",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "angular-state-management",
      "name": "angular-state-management",
      "summary": "Master modern Angular state management with Signals, NgRx, and RxJS. Use when setting up global state, managing component stores, choosing between state solutions, or migrating from legacy patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/angular-state-management",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "angular-ui-patterns",
      "name": "angular-ui-patterns",
      "summary": "Modern Angular UI patterns for loading states, error handling, and data display. Use when building UI components, handling async data, or managing component states.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/angular-ui-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "animejs-animation",
      "name": "animejs-animation",
      "summary": "Advanced JavaScript animation library skill for creating complex, high-performance web animations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/animejs-animation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "anti-reversing-techniques",
      "name": "anti-reversing-techniques",
      "summary": "AUTHORIZED USE ONLY: This skill contains dual-use security techniques. Before proceeding with any bypass or analysis: > 1.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/anti-reversing-techniques",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "antigravity-design-expert",
      "name": "antigravity-design-expert",
      "summary": "Core UI/UX engineering skill for building highly interactive, spatial, weightless, and glassmorphism-based web interfaces using GSAP and 3D CSS.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/antigravity-design-expert",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "antigravity-skill-orchestrator",
      "name": "antigravity-skill-orchestrator",
      "summary": "A meta-skill that understands task requirements, dynamically selects appropriate skills, tracks successful skill combinations using agent-memory-mcp, and prevents skill overuse for simple tasks.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/antigravity-skill-orchestrator",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "antigravity-workflows",
      "name": "antigravity-workflows",
      "summary": "Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/antigravity-workflows",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aomi-transact",
      "name": "aomi-transact",
      "summary": "Build natural-language crypto/DeFi agents and EVM MCP plugins (Claude Code, Cursor, Codex, Gemini). Aomi turns prompts into wallet-signed txs on Ethereum, Base, Arbitrum, Optimism, Polygon, Linea — non-custodial, fork-simulated. 40+ apps: Uniswap, Aave, Lido, Morpho, GMX, Hyperliquid, Polymarket.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aomi-transact",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-design-principles",
      "name": "api-design-principles",
      "summary": "Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-design-principles",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-documentation",
      "name": "api-documentation",
      "summary": "API documentation workflow for generating OpenAPI specs, creating developer guides, and maintaining comprehensive API documentation.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-documentation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-documentation-generator",
      "name": "api-documentation-generator",
      "summary": "Generate comprehensive, developer-friendly API documentation from code, including endpoints, parameters, examples, and best practices",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-documentation-generator",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-documenter",
      "name": "api-documenter",
      "summary": "Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-documenter",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-endpoint-builder",
      "name": "api-endpoint-builder",
      "summary": "Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation. Follows best practices for security and scalability.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-endpoint-builder",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-fuzzing-bug-bounty",
      "name": "api-fuzzing-bug-bounty",
      "summary": "Provide comprehensive techniques for testing REST, SOAP, and GraphQL APIs during bug bounty hunting and penetration testing engagements. Covers vulnerability discovery, authentication bypass, IDOR exploitation, and API-specific attack vectors.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-fuzzing-bug-bounty",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-patterns",
      "name": "api-patterns",
      "summary": "API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-security-best-practices",
      "name": "api-security-best-practices",
      "summary": "Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common API vulnerabilities",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-security-best-practices",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-security-testing",
      "name": "api-security-testing",
      "summary": "API security testing workflow for REST and GraphQL APIs covering authentication, authorization, rate limiting, input validation, and security best practices.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-security-testing",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "api-testing-observability-api-mock",
      "name": "api-testing-observability-api-mock",
      "summary": "You are an API mocking expert specializing in realistic mock services for development, testing, and demos. Design mocks that simulate real API behavior and enable parallel development.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-testing-observability-api-mock",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-actor-development",
      "name": "apify-actor-development",
      "summary": "Important: Before you begin, fill in the generatedBy property in the meta section of .actor/actor.json. Replace it with the tool and model you're currently using, such as \\\"Claude Code with Claude Sonnet 4.5\\\". This helps Apify monitor and improve AGENTS.md for specific AI tools and models.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-actor-development",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-actorization",
      "name": "apify-actorization",
      "summary": "Actorization converts existing software into reusable serverless applications compatible with the Apify platform. Actors are programs packaged as Docker images that accept well-defined JSON input, perform an action, and optionally produce structured JSON output.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-actorization",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-audience-analysis",
      "name": "apify-audience-analysis",
      "summary": "Understand audience demographics, preferences, behavior patterns, and engagement quality across Facebook, Instagram, YouTube, and TikTok.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-audience-analysis",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-brand-reputation-monitoring",
      "name": "apify-brand-reputation-monitoring",
      "summary": "Scrape reviews, ratings, and brand mentions from multiple platforms using Apify Actors.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-brand-reputation-monitoring",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-competitor-intelligence",
      "name": "apify-competitor-intelligence",
      "summary": "Analyze competitor strategies, content, pricing, ads, and market positioning across Google Maps, Booking.com, Facebook, Instagram, YouTube, and TikTok.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-competitor-intelligence",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-content-analytics",
      "name": "apify-content-analytics",
      "summary": "Track engagement metrics, measure campaign ROI, and analyze content performance across Instagram, Facebook, YouTube, and TikTok.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-content-analytics",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-ecommerce",
      "name": "apify-ecommerce",
      "summary": "Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-ecommerce",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-influencer-discovery",
      "name": "apify-influencer-discovery",
      "summary": "Find and evaluate influencers for brand partnerships, verify authenticity, and track collaboration performance across Instagram, Facebook, YouTube, and TikTok.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-influencer-discovery",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-lead-generation",
      "name": "apify-lead-generation",
      "summary": "Scrape leads from multiple platforms using Apify Actors.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-lead-generation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-market-research",
      "name": "apify-market-research",
      "summary": "Analyze market conditions, geographic opportunities, pricing, consumer behavior, and product validation across Google Maps, Facebook, Instagram, Booking.com, and TripAdvisor.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-market-research",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-trend-analysis",
      "name": "apify-trend-analysis",
      "summary": "Discover and track emerging trends across Google Trends, Instagram, Facebook, YouTube, and TikTok to inform content strategy.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-trend-analysis",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "apify-ultimate-scraper",
      "name": "apify-ultimate-scraper",
      "summary": "AI-driven data extraction from 55+ Actors across all major platforms. This skill automatically selects the best Actor for your task.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-ultimate-scraper",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "app-builder",
      "name": "app-builder",
      "summary": "Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/app-builder",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "app-store-changelog",
      "name": "app-store-changelog",
      "summary": "Generate user-facing App Store release notes from git history since the last tag.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/app-store-changelog",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "app-store-optimization",
      "name": "app-store-optimization",
      "summary": "Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/app-store-optimization",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "appdeploy",
      "name": "appdeploy",
      "summary": "Deploy web apps with backend APIs, database, and file storage. Use when the user asks to deploy or publish a website or web app and wants a public URL. Uses HTTP API via curl.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/appdeploy",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "application-performance-performance-optimization",
      "name": "application-performance-performance-optimization",
      "summary": "Optimize end-to-end application performance with profiling, observability, and backend/frontend tuning. Use when coordinating performance optimization across the stack.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/application-performance-performance-optimization",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "architect-review",
      "name": "architect-review",
      "summary": "Master software architect specializing in modern architecture",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architect-review",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "architecture",
      "name": "architecture",
      "summary": "Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "architecture-decision-records",
      "name": "architecture-decision-records",
      "summary": "Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-records",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "architecture-patterns",
      "name": "architecture-patterns",
      "summary": "Master proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to build maintainable, testable, and scalable systems.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "arm-cortex-expert",
      "name": "arm-cortex-expert",
      "summary": "Senior embedded software engineer specializing in firmware and driver development for ARM Cortex-M microcontrollers (Teensy, STM32, nRF52, SAMD).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/arm-cortex-expert",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "asana-automation",
      "name": "asana-automation",
      "summary": "Automate Asana tasks via Rube MCP (Composio): tasks, projects, sections, teams, workspaces. Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/asana-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "ask-questions-if-underspecified",
      "name": "ask-questions-if-underspecified",
      "summary": "Clarify requirements before implementing. Use when serious doubts arise.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ask-questions-if-underspecified",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "astro",
      "name": "astro",
      "summary": "Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/astro",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "astropy",
      "name": "astropy",
      "summary": "Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/astropy",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "async-python-patterns",
      "name": "async-python-patterns",
      "summary": "Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high-performance, non-blocking systems.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/async-python-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "attack-tree-construction",
      "name": "attack-tree-construction",
      "summary": "Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/attack-tree-construction",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "audio-transcriber",
      "name": "audio-transcriber",
      "summary": "Transform audio recordings into professional Markdown documentation with intelligent summaries using LLM integration",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/audio-transcriber",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "audit-context-building",
      "name": "audit-context-building",
      "summary": "Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/audit-context-building",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "audit-skills",
      "name": "audit-skills",
      "summary": "Expert security auditor for AI Skills and Bundles. Performs non-intrusive static analysis to identify malicious patterns, data leaks, system stability risks, and obfuscated payloads across Windows, macOS, Linux/Unix, and Mobile (Android/iOS).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/audit-skills",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "auri-core",
      "name": "auri-core",
      "summary": "Auri: assistente de voz inteligente (Alexa + Claude claude-opus-4-20250805). Visao do produto, persona Vitoria Neural, stack AWS, modelo Free/Pro/Business/Enterprise, roadmap 4 fases, GTM, north star WAC e analise competitiva.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/auri-core",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "auth-implementation-patterns",
      "name": "auth-implementation-patterns",
      "summary": "Build secure, scalable authentication and authorization systems using industry-standard patterns and modern best practices.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/auth-implementation-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "autonomous-agent-patterns",
      "name": "autonomous-agent-patterns",
      "summary": "Design patterns for building autonomous coding agents, inspired by [Cline](https://github.com/cline/cline) and [OpenAI Codex](https://github.com/openai/codex).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/autonomous-agent-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "autonomous-agents",
      "name": "autonomous-agents",
      "summary": "Autonomous agents are AI systems that can independently decompose",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/autonomous-agents",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "avalonia-layout-zafiro",
      "name": "avalonia-layout-zafiro",
      "summary": "Guidelines for modern Avalonia UI layout using Zafiro.Avalonia, emphasizing shared styles, generic components, and avoiding XAML redundancy.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/avalonia-layout-zafiro",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "avalonia-viewmodels-zafiro",
      "name": "avalonia-viewmodels-zafiro",
      "summary": "Optimal ViewModel and Wizard creation patterns for Avalonia using Zafiro and ReactiveUI.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/avalonia-viewmodels-zafiro",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "avalonia-zafiro-development",
      "name": "avalonia-zafiro-development",
      "summary": "Mandatory skills, conventions, and behavioral rules for Avalonia UI development using the Zafiro toolkit.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/avalonia-zafiro-development",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "avoid-ai-writing",
      "name": "avoid-ai-writing",
      "summary": "Audit and rewrite content to remove 21 categories of AI writing patterns with a 43-entry replacement table",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/avoid-ai-writing",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "awareness-stage-mapper",
      "name": "awareness-stage-mapper",
      "summary": "One sentence - what this skill does and when to invoke it",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/awareness-stage-mapper",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aws-cost-cleanup",
      "name": "aws-cost-cleanup",
      "summary": "Automated cleanup of unused AWS resources to reduce costs",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-cost-cleanup",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aws-cost-optimizer",
      "name": "aws-cost-optimizer",
      "summary": "Comprehensive AWS cost analysis and optimization recommendations using AWS CLI and Cost Explorer",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-cost-optimizer",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aws-penetration-testing",
      "name": "aws-penetration-testing",
      "summary": "Provide comprehensive techniques for penetration testing AWS cloud environments. Covers IAM enumeration, privilege escalation, SSRF to metadata endpoint, S3 bucket exploitation, Lambda code extraction, and persistence techniques for red team operations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-penetration-testing",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aws-serverless",
      "name": "aws-serverless",
      "summary": "Specialized skill for building production-ready serverless",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-serverless",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "aws-skills",
      "name": "aws-skills",
      "summary": "AWS development with infrastructure automation and cloud architecture patterns",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-skills",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "awt-e2e-testing",
      "name": "awt-e2e-testing",
      "summary": "AI-powered E2E web testing — eyes and hands for AI coding tools. Declarative YAML scenarios, Playwright execution, visual matching (OpenCV + OCR), platform auto-detection (Flutter/React/Vue), learning DB. Install: npx skills add ksgisang/awt-skill --skill awt -g",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/awt-e2e-testing",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "axiom",
      "name": "axiom",
      "summary": "First-principles assumption auditor. Classifies each hidden assumption (fact / convention / belief / interest-driven), ranks by fragility × impact, and rebuilds conclusions from verified premises. Bilingual: auto-detects Chinese or English.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/axiom",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azd-deployment",
      "name": "azd-deployment",
      "summary": "Deploy containerized frontend + backend applications to Azure Container Apps with remote builds, managed identity, and idempotent infrastructure.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azd-deployment",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-agents-persistent-dotnet",
      "name": "azure-ai-agents-persistent-dotnet",
      "summary": "Azure AI Agents Persistent SDK for .NET. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-agents-persistent-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-agents-persistent-java",
      "name": "azure-ai-agents-persistent-java",
      "summary": "Azure AI Agents Persistent SDK for Java. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-agents-persistent-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-anomalydetector-java",
      "name": "azure-ai-anomalydetector-java",
      "summary": "Build anomaly detection applications with Azure AI Anomaly Detector SDK for Java. Use when implementing univariate/multivariate anomaly detection, time-series analysis, or AI-powered monitoring.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-anomalydetector-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-contentsafety-java",
      "name": "azure-ai-contentsafety-java",
      "summary": "Build content moderation applications using the Azure AI Content Safety SDK for Java.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-contentsafety-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-contentsafety-py",
      "name": "azure-ai-contentsafety-py",
      "summary": "Azure AI Content Safety SDK for Python. Use for detecting harmful content in text and images with multi-severity classification.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-contentsafety-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-contentsafety-ts",
      "name": "azure-ai-contentsafety-ts",
      "summary": "Analyze text and images for harmful content with customizable blocklists.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-contentsafety-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-contentunderstanding-py",
      "name": "azure-ai-contentunderstanding-py",
      "summary": "Azure AI Content Understanding SDK for Python. Use for multimodal content extraction from documents, images, audio, and video.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-contentunderstanding-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-document-intelligence-dotnet",
      "name": "azure-ai-document-intelligence-dotnet",
      "summary": "Azure AI Document Intelligence SDK for .NET. Extract text, tables, and structured data from documents using prebuilt and custom models.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-document-intelligence-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-document-intelligence-ts",
      "name": "azure-ai-document-intelligence-ts",
      "summary": "Extract text, tables, and structured data from documents using prebuilt and custom models.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-document-intelligence-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-formrecognizer-java",
      "name": "azure-ai-formrecognizer-java",
      "summary": "Build document analysis applications using the Azure AI Document Intelligence SDK for Java.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-formrecognizer-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-ml-py",
      "name": "azure-ai-ml-py",
      "summary": "Azure Machine Learning SDK v2 for Python. Use for ML workspaces, jobs, models, datasets, compute, and pipelines.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-ml-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-openai-dotnet",
      "name": "azure-ai-openai-dotnet",
      "summary": "Azure OpenAI SDK for .NET. Client library for Azure OpenAI and OpenAI services. Use for chat completions, embeddings, image generation, audio transcription, and assistants.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-openai-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-projects-dotnet",
      "name": "azure-ai-projects-dotnet",
      "summary": "Azure AI Projects SDK for .NET. High-level client for Azure AI Foundry projects including agents, connections, datasets, deployments, evaluations, and indexes.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-projects-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-projects-java",
      "name": "azure-ai-projects-java",
      "summary": "Azure AI Projects SDK for Java. High-level SDK for Azure AI Foundry project management including connections, datasets, indexes, and evaluations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-projects-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-projects-py",
      "name": "azure-ai-projects-py",
      "summary": "Build AI applications on Microsoft Foundry using the azure-ai-projects SDK.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-projects-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-projects-ts",
      "name": "azure-ai-projects-ts",
      "summary": "High-level SDK for Azure AI Foundry projects with agents, connections, deployments, and evaluations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-projects-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-textanalytics-py",
      "name": "azure-ai-textanalytics-py",
      "summary": "Azure AI Text Analytics SDK for sentiment analysis, entity recognition, key phrases, language detection, PII, and healthcare NLP. Use for natural language processing on text.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-textanalytics-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-transcription-py",
      "name": "azure-ai-transcription-py",
      "summary": "Azure AI Transcription SDK for Python. Use for real-time and batch speech-to-text transcription with timestamps and diarization.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-transcription-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-translation-document-py",
      "name": "azure-ai-translation-document-py",
      "summary": "Azure AI Document Translation SDK for batch translation of documents with format preservation. Use for translating Word, PDF, Excel, PowerPoint, and other document formats at scale.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-translation-document-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-translation-text-py",
      "name": "azure-ai-translation-text-py",
      "summary": "Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-translation-text-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-translation-ts",
      "name": "azure-ai-translation-ts",
      "summary": "Text and document translation with REST-style clients.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-translation-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-vision-imageanalysis-java",
      "name": "azure-ai-vision-imageanalysis-java",
      "summary": "Build image analysis applications with Azure AI Vision SDK for Java. Use when implementing image captioning, OCR text extraction, object detection, tagging, or smart cropping.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-vision-imageanalysis-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-vision-imageanalysis-py",
      "name": "azure-ai-vision-imageanalysis-py",
      "summary": "Azure AI Vision Image Analysis SDK for captions, tags, objects, OCR, people detection, and smart cropping. Use for computer vision and image understanding tasks.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-vision-imageanalysis-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-voicelive-dotnet",
      "name": "azure-ai-voicelive-dotnet",
      "summary": "Azure AI Voice Live SDK for .NET. Build real-time voice AI applications with bidirectional WebSocket communication.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-voicelive-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-voicelive-java",
      "name": "azure-ai-voicelive-java",
      "summary": "Azure AI VoiceLive SDK for Java. Real-time bidirectional voice conversations with AI assistants using WebSocket.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-voicelive-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-voicelive-py",
      "name": "azure-ai-voicelive-py",
      "summary": "Build real-time voice AI applications with bidirectional WebSocket communication.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-voicelive-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-ai-voicelive-ts",
      "name": "azure-ai-voicelive-ts",
      "summary": "Azure AI Voice Live SDK for JavaScript/TypeScript. Build real-time voice AI applications with bidirectional WebSocket communication.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-voicelive-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-appconfiguration-java",
      "name": "azure-appconfiguration-java",
      "summary": "Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-appconfiguration-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-appconfiguration-py",
      "name": "azure-appconfiguration-py",
      "summary": "Azure App Configuration SDK for Python. Use for centralized configuration management, feature flags, and dynamic settings.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-appconfiguration-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-appconfiguration-ts",
      "name": "azure-appconfiguration-ts",
      "summary": "Centralized configuration management with feature flags and dynamic refresh.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-appconfiguration-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-communication-callautomation-java",
      "name": "azure-communication-callautomation-java",
      "summary": "Build server-side call automation workflows including IVR systems, call routing, recording, and AI-powered interactions.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-callautomation-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-communication-callingserver-java",
      "name": "azure-communication-callingserver-java",
      "summary": "⚠️ DEPRECATED: This SDK has been renamed to Call Automation. For new projects, use azure-communication-callautomation instead. This skill is for maintaining legacy code only.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-callingserver-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-communication-chat-java",
      "name": "azure-communication-chat-java",
      "summary": "Build real-time chat applications with thread management, messaging, participants, and read receipts.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-chat-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-communication-common-java",
      "name": "azure-communication-common-java",
      "summary": "Azure Communication Services common utilities for Java. Use when working with CommunicationTokenCredential, user identifiers, token refresh, or shared authentication across ACS services.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-common-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-communication-sms-java",
      "name": "azure-communication-sms-java",
      "summary": "Send SMS messages with Azure Communication Services SMS Java SDK. Use when implementing SMS notifications, alerts, OTP delivery, bulk messaging, or delivery reports.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-sms-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-compute-batch-java",
      "name": "azure-compute-batch-java",
      "summary": "Azure Batch SDK for Java. Run large-scale parallel and HPC batch jobs with pools, jobs, tasks, and compute nodes.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-compute-batch-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-containerregistry-py",
      "name": "azure-containerregistry-py",
      "summary": "Azure Container Registry SDK for Python. Use for managing container images, artifacts, and repositories.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-containerregistry-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-cosmos-db-py",
      "name": "azure-cosmos-db-py",
      "summary": "Build production-grade Azure Cosmos DB NoSQL services following clean code, security best practices, and TDD principles.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-db-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-cosmos-java",
      "name": "azure-cosmos-java",
      "summary": "Azure Cosmos DB SDK for Java. NoSQL database operations with global distribution, multi-model support, and reactive patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-cosmos-py",
      "name": "azure-cosmos-py",
      "summary": "Azure Cosmos DB SDK for Python (NoSQL API). Use for document CRUD, queries, containers, and globally distributed data.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-cosmos-rust",
      "name": "azure-cosmos-rust",
      "summary": "Azure Cosmos DB SDK for Rust (NoSQL API). Use for document CRUD, queries, containers, and globally distributed data.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-cosmos-ts",
      "name": "azure-cosmos-ts",
      "summary": "Azure Cosmos DB JavaScript/TypeScript SDK (@azure/cosmos) for data plane operations. Use for CRUD operations on documents, queries, bulk operations, and container management.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-data-tables-java",
      "name": "azure-data-tables-java",
      "summary": "Build table storage applications using the Azure Tables SDK for Java. Works with both Azure Table Storage and Cosmos DB Table API.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-data-tables-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-data-tables-py",
      "name": "azure-data-tables-py",
      "summary": "Azure Tables SDK for Python (Storage and Cosmos DB). Use for NoSQL key-value storage, entity CRUD, and batch operations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-data-tables-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventgrid-dotnet",
      "name": "azure-eventgrid-dotnet",
      "summary": "Azure Event Grid SDK for .NET. Client library for publishing and consuming events with Azure Event Grid. Use for event-driven architectures, pub/sub messaging, CloudEvents, and EventGridEvents.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventgrid-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventgrid-java",
      "name": "azure-eventgrid-java",
      "summary": "Build event-driven applications with Azure Event Grid SDK for Java. Use when publishing events, implementing pub/sub patterns, or integrating with Azure services via events.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventgrid-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventgrid-py",
      "name": "azure-eventgrid-py",
      "summary": "Azure Event Grid SDK for Python. Use for publishing events, handling CloudEvents, and event-driven architectures.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventgrid-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventhub-dotnet",
      "name": "azure-eventhub-dotnet",
      "summary": "Azure Event Hubs SDK for .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventhub-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventhub-java",
      "name": "azure-eventhub-java",
      "summary": "Build real-time streaming applications with Azure Event Hubs SDK for Java. Use when implementing event streaming, high-throughput data ingestion, or building event-driven architectures.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventhub-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventhub-py",
      "name": "azure-eventhub-py",
      "summary": "Azure Event Hubs SDK for Python streaming. Use for high-throughput event ingestion, producers, consumers, and checkpointing.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventhub-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventhub-rust",
      "name": "azure-eventhub-rust",
      "summary": "Azure Event Hubs SDK for Rust. Use for sending and receiving events, streaming data ingestion.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventhub-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-eventhub-ts",
      "name": "azure-eventhub-ts",
      "summary": "High-throughput event streaming and real-time data ingestion.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-eventhub-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-functions",
      "name": "azure-functions",
      "summary": "Expert patterns for Azure Functions development including isolated",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-functions",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-identity-dotnet",
      "name": "azure-identity-dotnet",
      "summary": "Azure Identity SDK for .NET. Authentication library for Azure SDK clients using Microsoft Entra ID. Use for DefaultAzureCredential, managed identity, service principals, and developer credentials.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-identity-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-identity-java",
      "name": "azure-identity-java",
      "summary": "Authenticate Java applications with Azure services using Microsoft Entra ID (Azure AD).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-identity-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-identity-py",
      "name": "azure-identity-py",
      "summary": "Azure Identity SDK for Python authentication. Use for DefaultAzureCredential, managed identity, service principals, and token caching.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-identity-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-identity-rust",
      "name": "azure-identity-rust",
      "summary": "Azure Identity SDK for Rust authentication. Use for DeveloperToolsCredential, ManagedIdentityCredential, ClientSecretCredential, and token-based authentication.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-identity-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-identity-ts",
      "name": "azure-identity-ts",
      "summary": "Authenticate to Azure services with various credential types.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-identity-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-certificates-rust",
      "name": "azure-keyvault-certificates-rust",
      "summary": "Azure Key Vault Certificates SDK for Rust. Use for creating, importing, and managing certificates.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-certificates-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-keys-rust",
      "name": "azure-keyvault-keys-rust",
      "summary": "Azure Key Vault Keys SDK for Rust. Use for creating, managing, and using cryptographic keys. Triggers: \"keyvault keys rust\", \"KeyClient rust\", \"create key rust\", \"encrypt rust\", \"sign rust\".",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-keys-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-keys-ts",
      "name": "azure-keyvault-keys-ts",
      "summary": "Manage cryptographic keys using Azure Key Vault Keys SDK for JavaScript (@azure/keyvault-keys). Use when creating, encrypting/decrypting, signing, or rotating keys.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-keys-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-py",
      "name": "azure-keyvault-py",
      "summary": "Azure Key Vault SDK for Python. Use for secrets, keys, and certificates management with secure storage.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-secrets-rust",
      "name": "azure-keyvault-secrets-rust",
      "summary": "Azure Key Vault Secrets SDK for Rust. Use for storing and retrieving secrets, passwords, and API keys. Triggers: \"keyvault secrets rust\", \"SecretClient rust\", \"get secret rust\", \"set secret rust\".",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-secrets-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-keyvault-secrets-ts",
      "name": "azure-keyvault-secrets-ts",
      "summary": "Manage secrets using Azure Key Vault Secrets SDK for JavaScript (@azure/keyvault-secrets). Use when storing and retrieving application secrets or configuration values.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-keyvault-secrets-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-maps-search-dotnet",
      "name": "azure-maps-search-dotnet",
      "summary": "Azure Maps SDK for .NET. Location-based services including geocoding, routing, rendering, geolocation, and weather. Use for address search, directions, map tiles, IP geolocation, and weather data.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-maps-search-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-messaging-webpubsub-java",
      "name": "azure-messaging-webpubsub-java",
      "summary": "Build real-time web applications with Azure Web PubSub SDK for Java. Use when implementing WebSocket-based messaging, live updates, chat applications, or server-to-client push notifications.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-messaging-webpubsub-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-messaging-webpubsubservice-py",
      "name": "azure-messaging-webpubsubservice-py",
      "summary": "Azure Web PubSub Service SDK for Python. Use for real-time messaging, WebSocket connections, and pub/sub patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-messaging-webpubsubservice-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-apicenter-dotnet",
      "name": "azure-mgmt-apicenter-dotnet",
      "summary": "Azure API Center SDK for .NET. Centralized API inventory management with governance, versioning, and discovery.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-apicenter-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-apicenter-py",
      "name": "azure-mgmt-apicenter-py",
      "summary": "Azure API Center Management SDK for Python. Use for managing API inventory, metadata, and governance across your organization.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-apicenter-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-apimanagement-dotnet",
      "name": "azure-mgmt-apimanagement-dotnet",
      "summary": "Azure Resource Manager SDK for API Management in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-apimanagement-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-apimanagement-py",
      "name": "azure-mgmt-apimanagement-py",
      "summary": "Azure API Management SDK for Python. Use for managing APIM services, APIs, products, subscriptions, and policies.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-apimanagement-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-applicationinsights-dotnet",
      "name": "azure-mgmt-applicationinsights-dotnet",
      "summary": "Azure Application Insights SDK for .NET. Application performance monitoring and observability resource management.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-applicationinsights-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-arizeaiobservabilityeval-dotnet",
      "name": "azure-mgmt-arizeaiobservabilityeval-dotnet",
      "summary": "Azure Resource Manager SDK for Arize AI Observability and Evaluation (.NET).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-arizeaiobservabilityeval-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-botservice-dotnet",
      "name": "azure-mgmt-botservice-dotnet",
      "summary": "Azure Resource Manager SDK for Bot Service in .NET. Management plane operations for creating and managing Azure Bot resources, channels (Teams, DirectLine, Slack), and connection settings.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-botservice-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-botservice-py",
      "name": "azure-mgmt-botservice-py",
      "summary": "Azure Bot Service Management SDK for Python. Use for creating, managing, and configuring Azure Bot Service resources.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-botservice-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-fabric-dotnet",
      "name": "azure-mgmt-fabric-dotnet",
      "summary": "Azure Resource Manager SDK for Fabric in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-fabric-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-fabric-py",
      "name": "azure-mgmt-fabric-py",
      "summary": "Azure Fabric Management SDK for Python. Use for managing Microsoft Fabric capacities and resources.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-fabric-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-mongodbatlas-dotnet",
      "name": "azure-mgmt-mongodbatlas-dotnet",
      "summary": "Manage MongoDB Atlas Organizations as Azure ARM resources with unified billing through Azure Marketplace.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-mongodbatlas-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-mgmt-weightsandbiases-dotnet",
      "name": "azure-mgmt-weightsandbiases-dotnet",
      "summary": "Azure Weights & Biases SDK for .NET. ML experiment tracking and model management via Azure Marketplace. Use for creating W&B instances, managing SSO, marketplace integration, and ML observability.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-weightsandbiases-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-microsoft-playwright-testing-ts",
      "name": "azure-microsoft-playwright-testing-ts",
      "summary": "Run Playwright tests at scale with cloud-hosted browsers and integrated Azure portal reporting.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-microsoft-playwright-testing-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-ingestion-java",
      "name": "azure-monitor-ingestion-java",
      "summary": "Azure Monitor Ingestion SDK for Java. Send custom logs to Azure Monitor via Data Collection Rules (DCR) and Data Collection Endpoints (DCE).",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-ingestion-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-ingestion-py",
      "name": "azure-monitor-ingestion-py",
      "summary": "Azure Monitor Ingestion SDK for Python. Use for sending custom logs to Log Analytics workspace via Logs Ingestion API.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-ingestion-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-opentelemetry-exporter-java",
      "name": "azure-monitor-opentelemetry-exporter-java",
      "summary": "Azure Monitor OpenTelemetry Exporter for Java. Export OpenTelemetry traces, metrics, and logs to Azure Monitor/Application Insights.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-opentelemetry-exporter-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-opentelemetry-exporter-py",
      "name": "azure-monitor-opentelemetry-exporter-py",
      "summary": "Azure Monitor OpenTelemetry Exporter for Python. Use for low-level OpenTelemetry export to Application Insights.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-opentelemetry-exporter-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-opentelemetry-py",
      "name": "azure-monitor-opentelemetry-py",
      "summary": "Azure Monitor OpenTelemetry Distro for Python. Use for one-line Application Insights setup with auto-instrumentation.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-opentelemetry-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-opentelemetry-ts",
      "name": "azure-monitor-opentelemetry-ts",
      "summary": "Auto-instrument Node.js applications with distributed tracing, metrics, and logs.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-opentelemetry-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-query-java",
      "name": "azure-monitor-query-java",
      "summary": "Azure Monitor Query SDK for Java. Execute Kusto queries against Log Analytics workspaces and query metrics from Azure resources.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-query-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-monitor-query-py",
      "name": "azure-monitor-query-py",
      "summary": "Azure Monitor Query SDK for Python. Use for querying Log Analytics workspaces and Azure Monitor metrics.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-query-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-postgres-ts",
      "name": "azure-postgres-ts",
      "summary": "Connect to Azure Database for PostgreSQL Flexible Server from Node.js/TypeScript using the pg (node-postgres) package.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-postgres-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-cosmosdb-dotnet",
      "name": "azure-resource-manager-cosmosdb-dotnet",
      "summary": "Azure Resource Manager SDK for Cosmos DB in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-cosmosdb-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-durabletask-dotnet",
      "name": "azure-resource-manager-durabletask-dotnet",
      "summary": "Azure Resource Manager SDK for Durable Task Scheduler in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-durabletask-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-mysql-dotnet",
      "name": "azure-resource-manager-mysql-dotnet",
      "summary": "Azure MySQL Flexible Server SDK for .NET. Database management for MySQL Flexible Server deployments.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-mysql-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-playwright-dotnet",
      "name": "azure-resource-manager-playwright-dotnet",
      "summary": "Azure Resource Manager SDK for Microsoft Playwright Testing in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-playwright-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-postgresql-dotnet",
      "name": "azure-resource-manager-postgresql-dotnet",
      "summary": "Azure PostgreSQL Flexible Server SDK for .NET. Database management for PostgreSQL Flexible Server deployments.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-postgresql-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-redis-dotnet",
      "name": "azure-resource-manager-redis-dotnet",
      "summary": "Azure Resource Manager SDK for Redis in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-redis-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-resource-manager-sql-dotnet",
      "name": "azure-resource-manager-sql-dotnet",
      "summary": "Azure Resource Manager SDK for Azure SQL in .NET.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-resource-manager-sql-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-search-documents-dotnet",
      "name": "azure-search-documents-dotnet",
      "summary": "Azure AI Search SDK for .NET (Azure.Search.Documents). Use for building search applications with full-text, vector, semantic, and hybrid search.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-search-documents-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-search-documents-py",
      "name": "azure-search-documents-py",
      "summary": "Azure AI Search SDK for Python. Use for vector search, hybrid search, semantic ranking, indexing, and skillsets.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-search-documents-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-search-documents-ts",
      "name": "azure-search-documents-ts",
      "summary": "Build search applications with vector, hybrid, and semantic search capabilities.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-search-documents-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-security-keyvault-keys-dotnet",
      "name": "azure-security-keyvault-keys-dotnet",
      "summary": "Azure Key Vault Keys SDK for .NET. Client library for managing cryptographic keys in Azure Key Vault and Managed HSM. Use for key creation, rotation, encryption, decryption, signing, and verification.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-security-keyvault-keys-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-security-keyvault-keys-java",
      "name": "azure-security-keyvault-keys-java",
      "summary": "Azure Key Vault Keys Java SDK for cryptographic key management. Use when creating, managing, or using RSA/EC keys, performing encrypt/decrypt/sign/verify operations, or working with HSM-backed keys.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-security-keyvault-keys-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-security-keyvault-secrets-java",
      "name": "azure-security-keyvault-secrets-java",
      "summary": "Azure Key Vault Secrets Java SDK for secret management. Use when storing, retrieving, or managing passwords, API keys, connection strings, or other sensitive configuration data.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-security-keyvault-secrets-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-servicebus-dotnet",
      "name": "azure-servicebus-dotnet",
      "summary": "Azure Service Bus SDK for .NET. Enterprise messaging with queues, topics, subscriptions, and sessions.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-servicebus-dotnet",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-servicebus-py",
      "name": "azure-servicebus-py",
      "summary": "Azure Service Bus SDK for Python messaging. Use for queues, topics, subscriptions, and enterprise messaging patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-servicebus-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-servicebus-ts",
      "name": "azure-servicebus-ts",
      "summary": "Enterprise messaging with queues, topics, and subscriptions.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-servicebus-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-speech-to-text-rest-py",
      "name": "azure-speech-to-text-rest-py",
      "summary": "Azure Speech to Text REST API for short audio (Python). Use for simple speech recognition of audio files up to 60 seconds without the Speech SDK.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-speech-to-text-rest-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-blob-java",
      "name": "azure-storage-blob-java",
      "summary": "Build blob storage applications using the Azure Storage Blob SDK for Java.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-blob-java",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-blob-py",
      "name": "azure-storage-blob-py",
      "summary": "Azure Blob Storage SDK for Python. Use for uploading, downloading, listing blobs, managing containers, and blob lifecycle.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-blob-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-blob-rust",
      "name": "azure-storage-blob-rust",
      "summary": "Azure Blob Storage SDK for Rust. Use for uploading, downloading, and managing blobs and containers.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-blob-rust",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-blob-ts",
      "name": "azure-storage-blob-ts",
      "summary": "Azure Blob Storage JavaScript/TypeScript SDK (@azure/storage-blob) for blob operations. Use for uploading, downloading, listing, and managing blobs and containers.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-blob-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-file-datalake-py",
      "name": "azure-storage-file-datalake-py",
      "summary": "Azure Data Lake Storage Gen2 SDK for Python. Use for hierarchical file systems, big data analytics, and file/directory operations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-datalake-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-file-share-py",
      "name": "azure-storage-file-share-py",
      "summary": "Azure Storage File Share SDK for Python. Use for SMB file shares, directories, and file operations in the cloud.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-share-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-file-share-ts",
      "name": "azure-storage-file-share-ts",
      "summary": "Azure File Share JavaScript/TypeScript SDK (@azure/storage-file-share) for SMB file share operations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-share-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-queue-py",
      "name": "azure-storage-queue-py",
      "summary": "Azure Queue Storage SDK for Python. Use for reliable message queuing, task distribution, and asynchronous processing.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-queue-py",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-storage-queue-ts",
      "name": "azure-storage-queue-ts",
      "summary": "Azure Queue Storage JavaScript/TypeScript SDK (@azure/storage-queue) for message queue operations. Use for sending, receiving, peeking, and deleting messages in queues.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-queue-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "azure-web-pubsub-ts",
      "name": "azure-web-pubsub-ts",
      "summary": "Real-time messaging with WebSocket connections and pub/sub patterns.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-web-pubsub-ts",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "backend-architect",
      "name": "backend-architect",
      "summary": "Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-architect",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "backend-dev-guidelines",
      "name": "backend-dev-guidelines",
      "summary": "You are a senior backend engineer operating production-grade services under strict architectural and reliability constraints. Use when routes, controllers, services, repositories, express middleware, or prisma database access.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-dev-guidelines",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "backend-development-feature-development",
      "name": "backend-development-feature-development",
      "summary": "Orchestrate end-to-end backend feature development from requirements to deployment. Use when coordinating multi-phase feature delivery across teams and services.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-development-feature-development",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "backend-security-coder",
      "name": "backend-security-coder",
      "summary": "Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use PROACTIVELY for backend security implementations or security code reviews.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-security-coder",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "backtesting-frameworks",
      "name": "backtesting-frameworks",
      "summary": "Build robust, production-grade backtesting systems that avoid common pitfalls and produce reliable strategy performance estimates.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backtesting-frameworks",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bamboohr-automation",
      "name": "bamboohr-automation",
      "summary": "Automate BambooHR tasks via Rube MCP (Composio): employees, time-off, benefits, dependents, employee updates. Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bamboohr-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "basecamp-automation",
      "name": "basecamp-automation",
      "summary": "Automate Basecamp project management, to-dos, messages, people, and to-do list organization via Rube MCP (Composio). Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/basecamp-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "baseline-ui",
      "name": "baseline-ui",
      "summary": "Validates animation durations, enforces typography scale, checks component accessibility, and prevents layout anti-patterns in Tailwind CSS projects. Use when building UI components, reviewing CSS utilities, styling React views, or enforcing design consistency.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/baseline-ui",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bash-defensive-patterns",
      "name": "bash-defensive-patterns",
      "summary": "Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bash-defensive-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bash-linux",
      "name": "bash-linux",
      "summary": "Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bash-linux",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bash-pro",
      "name": "bash-pro",
      "summary": "Master of defensive Bash scripting for production automation, CI/CD",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bash-pro",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bash-scripting",
      "name": "bash-scripting",
      "summary": "Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bash-scripting",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bats-testing-patterns",
      "name": "bats-testing-patterns",
      "summary": "Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bats-testing-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bazel-build-optimization",
      "name": "bazel-build-optimization",
      "summary": "Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bazel-build-optimization",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bdi-mental-states",
      "name": "bdi-mental-states",
      "summary": "This skill should be used when the user asks to \"model agent mental states\", \"implement BDI architecture\", \"create belief-desire-intention models\", \"transform RDF to beliefs\", \"build cognitive agent\", or mentions BDI ontology, mental state modeling, rational agency, or neuro-symbolic AI integration.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bdi-mental-states",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bdistill-behavioral-xray",
      "name": "bdistill-behavioral-xray",
      "summary": "X-ray any AI model's behavioral patterns — refusal boundaries, hallucination tendencies, reasoning style, formatting defaults. No API key needed.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bdistill-behavioral-xray",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bdistill-knowledge-extraction",
      "name": "bdistill-knowledge-extraction",
      "summary": "Extract structured domain knowledge from AI models in-session or from local open-source models via Ollama. No API key needed.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bdistill-knowledge-extraction",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "beautiful-prose",
      "name": "beautiful-prose",
      "summary": "A hard-edged writing style contract for timeless, forceful English prose without modern AI tics. Use when users ask for prose or rewrites that must be clean, exact, concrete, and free of AI cadence, filler, or therapeutic tone.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/beautiful-prose",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "behavioral-modes",
      "name": "behavioral-modes",
      "summary": "AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/behavioral-modes",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bevy-ecs-expert",
      "name": "bevy-ecs-expert",
      "summary": "Master Bevy's Entity Component System (ECS) in Rust, covering Systems, Queries, Resources, and parallel scheduling.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bevy-ecs-expert",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bill-gates",
      "name": "bill-gates",
      "summary": "Agente que simula Bill Gates — cofundador da Microsoft, arquiteto da industria de software comercial, estrategista tecnologico global, investidor sistemico e filantropo baseado em dados.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bill-gates",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "billing-automation",
      "name": "billing-automation",
      "summary": "Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/billing-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "binary-analysis-patterns",
      "name": "binary-analysis-patterns",
      "summary": "Comprehensive patterns and techniques for analyzing compiled binaries, understanding assembly code, and reconstructing program logic.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/binary-analysis-patterns",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "biopython",
      "name": "biopython",
      "summary": "Biopython is a comprehensive set of freely available Python tools for biological computation. It provides functionality for sequence manipulation, file I/O, database access, structural bioinformatics, phylogenetics, and many other bioinformatics tasks.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/biopython",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "bitbucket-automation",
      "name": "bitbucket-automation",
      "summary": "Automate Bitbucket repositories, pull requests, branches, issues, and workspace management via Rube MCP (Composio). Always search tools first for current schemas.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/bitbucket-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "blockchain-developer",
      "name": "blockchain-developer",
      "summary": "Build production-ready Web3 applications, smart contracts, and decentralized systems. Implements DeFi protocols, NFT platforms, DAOs, and enterprise blockchain integrations.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blockchain-developer",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "blockrun",
      "name": "blockrun",
      "summary": "BlockRun works with Claude Code and Google Antigravity.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blockrun",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "blog-writing-guide",
      "name": "blog-writing-guide",
      "summary": "This skill enforces Sentry's blog writing standards across every post — whether you're helping an engineer write their first blog post or a marketer draft a product announcement.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blog-writing-guide",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "blueprint",
      "name": "blueprint",
      "summary": "Turn a one-line objective into a step-by-step construction plan any coding agent can execute cold. Each step has a self-contained context brief — a fresh agent in a new session can pick up any step without reading prior steps.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blueprint",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "box-automation",
      "name": "box-automation",
      "summary": "Automate Box operations including file upload/download, content search, folder management, collaboration, metadata queries, and sign requests through Composio's Box toolkit.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/box-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brainstorming",
      "name": "brainstorming",
      "summary": "Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brainstorming",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brand-guidelines-anthropic",
      "name": "brand-guidelines-anthropic",
      "summary": "To access Anthropic's official brand identity and style resources, use this skill.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brand-guidelines-anthropic",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brand-guidelines-community",
      "name": "brand-guidelines-community",
      "summary": "To access Anthropic's official brand identity and style resources, use this skill.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brand-guidelines-community",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brand-perception-psychologist",
      "name": "brand-perception-psychologist",
      "summary": "One sentence - what this skill does and when to invoke it",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brand-perception-psychologist",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brevo-automation",
      "name": "brevo-automation",
      "summary": "Automate Brevo (formerly Sendinblue) email marketing operations through Composio's Brevo toolkit via Rube MCP.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brevo-automation",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "broken-authentication",
      "name": "broken-authentication",
      "summary": "Identify and exploit authentication and session management vulnerabilities in web applications. Broken authentication consistently ranks in the OWASP Top 10 and can lead to account takeover, identity theft, and unauthorized access to sensitive systems.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/broken-authentication",
      "updated_at": "2026-05-13T01:43:57Z"
    },
    {
      "slug": "brooks-lint",
      "name": "brooks-lint",
      "summary": "AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.",
      "downloads": 0,
      "stars": 37331,
      "category": "development",
      "tags": [
        "agent-skills",
        "agentic-skills",
        "ai-agent-skills",
        "ai-agents",
        "ai-coding"
      ],
      "source_url": "https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brooks-lint",
      "updated_at": "2026-05-13T01:43:57Z"
    }
  ]
}


================================================
FILE: index.html
================================================
<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vite + React + TS</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
</html>


================================================
FILE: package.json
================================================
{
  "name": "skills-hub",
  "private": true,
  "version": "0.6.0",
  "type": "module",
  "scripts": {
    "dev": "vite --port 5173 --strictPort",
    "build": "tsc -b && vite build",
    "lint": "eslint .",
    "rust:fmt": "cd src-tauri && cargo fmt --all",
    "rust:fmt:check": "cd src-tauri && cargo fmt --all -- --check",
    "rust:clippy": "cd src-tauri && cargo clippy --all-targets --all-features -- -D warnings",
    "rust:test": "cd src-tauri && cargo test",
    "check": "npm run lint && npm run build && npm run rust:fmt:check && npm run rust:clippy && npm run rust:test",
    "preview": "vite preview",
    "version:set": "node scripts/version.mjs set",
    "version:sync": "node scripts/version.mjs sync",
    "version:check": "node scripts/version.mjs check",
    "tauri": "tauri",
    "tauri:dev": "tauri dev",
    "tauri:icon:desktop": "node scripts/tauri-icon-desktop.mjs",
    "tauri:build": "npm run version:check && tauri build",
    "tauri:build:mac:dmg": "npm run tauri:build -- --bundles dmg",
    "tauri:build:mac:universal:dmg": "npm run tauri:build -- --target universal-apple-darwin --bundles dmg",
    "tauri:build:win:exe": "npm run tauri:build -- --bundles nsis",
    "tauri:build:win:msi": "npm run tauri:build -- --bundles msi",
    "tauri:build:win:all": "npm run tauri:build -- --bundles msi,nsis",
    "tauri:build:linux:deb": "npm run tauri:build -- --bundles deb",
    "tauri:build:linux:appimage": "npm run tauri:build -- --bundles appimage",
    "tauri:build:linux:all": "npm run tauri:build -- --bundles deb,appimage"
  },
  "dependencies": {
    "@tailwindcss/vite": "^4.1.18",
    "@tauri-apps/api": "^2.9.1",
    "@tauri-apps/plugin-dialog": "^2.5.3",
    "@tauri-apps/plugin-opener": "^2.5.3",
    "@tauri-apps/plugin-updater": "^2.5.3",
    "clsx": "^2.1.1",
    "i18next": "^25.7.4",
    "i18next-browser-languagedetector": "^8.2.0",
    "lucide-react": "^0.562.0",
    "react": "^19.2.3",
    "react-dom": "^19.2.3",
    "react-i18next": "^16.5.3",
    "react-markdown": "^10.1.0",
    "react-router-dom": "^7.12.0",
    "react-syntax-highlighter": "^16.1.1",
    "remark-frontmatter": "^5.0.0",
    "remark-gfm": "^4.0.1",
    "sonner": "^2.0.7",
    "tailwind-merge": "^3.4.0",
    "tailwindcss": "^4.1.18"
  },
  "devDependencies": {
    "@eslint/js": "^9.39.2",
    "@tauri-apps/cli": "^2.9.6",
    "@types/node": "^24.10.7",
    "@types/react": "^19.2.8",
    "@types/react-dom": "^19.2.3",
    "@types/react-syntax-highlighter": "^15.5.13",
    "@vitejs/plugin-react": "^5.1.2",
    "eslint": "^9.39.2",
    "eslint-plugin-react-hooks": "^7.0.1",
    "eslint-plugin-react-refresh": "^0.4.25",
    "globals": "^16.5.0",
    "typescript": "~5.9.3",
    "typescript-eslint": "^8.53.0",
    "vite": "^7.3.1"
  }
}


================================================
FILE: scripts/coverage-rust.sh
================================================
#!/usr/bin/env bash
set -euo pipefail

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT_DIR/src-tauri"

cargo llvm-cov --workspace --html --output-dir "$ROOT_DIR/coverage/llvm-cov"


================================================
FILE: scripts/extract-changelog.mjs
================================================
import fs from 'node:fs'

function normalizeVersion(input) {
  const v = String(input || '').trim()
  if (!v) return null
  return v.startsWith('v') ? v.slice(1) : v
}

function extractSection(changelogText, version) {
  const lines = changelogText.split(/\r?\n/)
  const headerRe = new RegExp(`^##\\s+\\[${escapeRegExp(version)}\\](\\s*-\\s*.*)?$`)
  const altHeaderRe = new RegExp(`^##\\s+${escapeRegExp(version)}(\\s*-\\s*.*)?$`)
  const headerVRe = new RegExp(`^##\\s+\\[v${escapeRegExp(version)}\\](\\s*-\\s*.*)?$`)
  const altHeaderVRe = new RegExp(`^##\\s+v${escapeRegExp(version)}(\\s*-\\s*.*)?$`)

  let start = -1
  for (let i = 0; i < lines.length; i += 1) {
    const line = lines[i].trimEnd()
    if (headerRe.test(line) || altHeaderRe.test(line) || headerVRe.test(line) || altHeaderVRe.test(line)) {
      start = i + 1
      break
    }
  }
  if (start === -1) return null

  let end = lines.length
  for (let i = start; i < lines.length; i += 1) {
    if (/^##\s+/.test(lines[i])) {
      end = i
      break
    }
  }

  const body = lines.slice(start, end).join('\n').trim()
  return body || null
}

function listVersions(changelogText) {
  const lines = changelogText.split(/\r?\n/)
  const versions = []
  for (const rawLine of lines) {
    const line = rawLine.trimEnd()
    const m =
      line.match(/^##\s+\[(?<v>v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\](?:\s*-.*)?$/) ||
      line.match(/^##\s+(?<v>v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(?:\s*-.*)?$/)
    if (m?.groups?.v) versions.push(m.groups.v)
  }
  return [...new Set(versions)]
}

function escapeRegExp(str) {
  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
}

const [tagOrVersion, changelogPathArg] = process.argv.slice(2)
const version = normalizeVersion(tagOrVersion)
if (!version) {
  console.error('Usage: node scripts/extract-changelog.mjs <tag-or-version> [CHANGELOG.md]')
  process.exit(2)
}

const changelogPath = changelogPathArg || 'CHANGELOG.md'
if (!fs.existsSync(changelogPath)) {
  console.error(`CHANGELOG not found: ${changelogPath}`)
  process.exit(2)
}

const changelogText = fs.readFileSync(changelogPath, 'utf8')
const section = extractSection(changelogText, version)
if (!section) {
  console.error(`Version section not found in ${changelogPath}: ${version}`)
  const available = listVersions(changelogText)
  if (available.length) {
    console.error(`Available versions found: ${available.join(', ')}`)
  } else {
    console.error('No version headers detected. Expected headers like: "## [0.1.1] - 2026-01-24"')
  }
  process.exit(3)
}

process.stdout.write(section + '\n')


================================================
FILE: scripts/fetch-featured-skills.mjs
================================================
#!/usr/bin/env node

/**
 * Aggregates AI Agent Skills from a curated list of high-quality GitHub repositories.
 *
 * Fetches metadata and directory trees for each curated repo, detects individual skills
 * within each repo, and outputs featured-skills.json with one entry per skill.
 *
 * API budget: ~14 requests total (7 Repos API + 7 Trees API).
 *
 * Requires: GITHUB_TOKEN environment variable.
 */

import { existsSync, readFileSync, writeFileSync } from 'node:fs'
import { resolve } from 'node:path'

// Load .env file
const envPath = resolve(import.meta.dirname, '..', '.env')
if (existsSync(envPath)) {
  for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
    const trimmed = line.trim()
    if (!trimmed || trimmed.startsWith('#')) continue
    const idx = trimmed.indexOf('=')
    if (idx === -1) continue
    const key = trimmed.slice(0, idx).trim()
    const value = trimmed.slice(idx + 1).trim()
    if (!process.env[key]) process.env[key] = value
  }
}

const OUTPUT_FILE = 'featured-skills.json'

// Curated high-quality skill repositories (ordered by stars desc)
const CURATED_REPOS = [
  'anthropics/skills',
  'sickn33/antigravity-awesome-skills',
  'K-Dense-AI/claude-scientific-skills',
  'travisvn/awesome-claude-skills',
  'VoltAgent/awesome-agent-skills',
  'anthropics/knowledge-work-plugins',
  'alirezarezvani/claude-skills',
]

const MAX_SKILLS = 300
const CONCURRENCY = 10
const MAX_RATE_LIMIT_WAIT_SECS = 60

// Skill scan bases matching installer.rs SKILL_SCAN_BASES
const SKILL_SCAN_BASES = [
  'skills',
  'skills/.curated',
  'skills/.experimental',
  'skills/.system',
  '.claude/skills',
]

// Directories to skip when scanning root-level subdirs
const ROOT_SKIP_DIRS = new Set([
  'skills', '.claude', '.git', '.github', '.vscode', 'node_modules',
  '.idea', '.DS_Store', 'dist', 'build', 'out', 'target',
  'docs', 'test', 'tests', '__tests__', 'examples', 'src', 'lib',
])

// Category classification rules
const CATEGORY_RULES = [
  { keywords: ['browser', 'automation', 'playwright', 'puppeteer'], category: 'browser-automation' },
  { keywords: ['security', 'audit', 'vulnerability', 'pentest'], category: 'security' },
  { keywords: ['devops', 'deploy', 'infra', 'docker', 'kubernetes'], category: 'devops' },
  { keywords: ['marketing', 'seo', 'ads', 'advertising'], category: 'marketing' },
  { keywords: ['database', 'sql', 'postgres', 'mongo'], category: 'database' },
  { keywords: ['git', 'github', 'pr', 'code-review'], category: 'development' },
  { keywords: ['ai', 'llm', 'agent', 'model'], category: 'ai-assistant' },
]

const GITHUB_TOKEN = process.env.GITHUB_TOKEN || ''

// ─── HTTP helpers ───

async function fetchJson(url, retries = 3) {
  const headers = {
    Accept: 'application/vnd.github+json',
    'User-Agent': 'skills-hub-aggregator',
  }
  if (GITHUB_TOKEN) {
    headers.Authorization = `Bearer ${GITHUB_TOKEN}`
  }

  for (let attempt = 0; attempt <= retries; attempt++) {
    const res = await fetch(url, { headers })

    if (res.status === 403 || res.status === 429) {
      const resetHeader = res.headers.get('x-ratelimit-reset')
      let waitSecs = resetHeader
        ? Math.max(Number(resetHeader) - Math.floor(Date.now() / 1000), 1)
        : Math.pow(2, attempt + 1)

      if (waitSecs > MAX_RATE_LIMIT_WAIT_SECS) {
        console.warn(`Rate limited, reset in ${waitSecs}s (exceeds max ${MAX_RATE_LIMIT_WAIT_SECS}s) — skipping`)
        return null
      }
      console.warn(`Rate limited (${res.status}), waiting ${waitSecs}s (attempt ${attempt + 1}/${retries + 1})...`)
      await sleep(waitSecs * 1000)
      continue
    }

    if (!res.ok) {
      if (attempt < retries) {
        await sleep(Math.pow(2, attempt) * 1000)
        continue
      }
      return null
    }

    return res.json()
  }
  return null
}

function sleep(ms) {
  return new Promise((r) => setTimeout(r, ms))
}

// Run async tasks with bounded concurrency
async function pMap(items, fn, concurrency) {
  const results = new Array(items.length)
  let idx = 0

  async function worker() {
    while (idx < items.length) {
      const i = idx++
      results[i] = await fn(items[i], i)
    }
  }

  const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker())
  await Promise.all(workers)
  return results
}

// ─── Step 1: Fetch curated repo metadata ───

async function fetchRepoMetadata(fullName) {
  const url = `https://api.github.com/repos/${fullName}`
  const data = await fetchJson(url)
  if (!data || !data.full_name) {
    console.warn(`  Skipping ${fullName}: unable to fetch metadata`)
    return null
  }
  return data
}

async function fetchAllRepoMetadata() {
  console.log(`Fetching metadata for ${CURATED_REPOS.length} curated repos...`)
  const results = await pMap(
    CURATED_REPOS,
    async (fullName) => {
      console.log(`  Fetching: ${fullName}`)
      return fetchRepoMetadata(fullName)
    },
    CONCURRENCY,
  )
  const repos = results.filter(Boolean)
  console.log(`Successfully fetched ${repos.length}/${CURATED_REPOS.length} repos`)
  return repos
}

// ─── Step 2: Detect skills in each repo ───

function detectSkillsFromTree(treeItems) {
  const filePaths = new Set()
  const dirPaths = new Set()
  for (const item of treeItems) {
    if (item.type === 'blob') filePaths.add(item.path)
    else if (item.type === 'tree') dirPaths.add(item.path)
  }

  const skills = [] // { dirPath }
  const foundDirs = new Set()

  // Scan SKILL_SCAN_BASES
  for (const base of SKILL_SCAN_BASES) {
    for (const dir of dirPaths) {
      if (!dir.startsWith(base + '/')) continue
      const rest = dir.slice(base.length + 1)
      if (rest.includes('/')) continue // not a direct child

      const hasSkillMd = filePaths.has(dir + '/SKILL.md')
      const isClaudeSkill = base === '.claude/skills'

      if (hasSkillMd || isClaudeSkill) {
        if (!foundDirs.has(dir)) {
          foundDirs.add(dir)
          skills.push({ dirPath: dir })
        }
      }
    }
  }

  // Scan root-level subdirectories (must have SKILL.md or .claude-plugin/plugin.json)
  for (const dir of dirPaths) {
    if (dir.includes('/')) continue
    if (ROOT_SKIP_DIRS.has(dir) || dir.startsWith('.')) continue
    if (foundDirs.has(dir)) continue

    if (filePaths.has(dir + '/SKILL.md') || filePaths.has(dir + '/.claude-plugin/plugin.json')) {
      foundDirs.add(dir)
      skills.push({ dirPath: dir })
    }
  }

  // Single-skill repo: root has SKILL.md and no sub-skills found
  if (skills.length === 0 && filePaths.has('SKILL.md')) {
    skills.push({ dirPath: null })
  }

  return skills
}

async function getRepoTree(owner, repo, branch) {
  const url = `https://api.github.com/repos/${owner}/${repo}/git/trees/${encodeURIComponent(branch)}?recursive=1`
  const data = await fetchJson(url, 2)
  if (!data || !data.tree) return null
  if (data.truncated) {
    console.warn(`  Warning: tree for ${owner}/${repo} was truncated, some skills may be missed`)
  }
  return data.tree
}

// ─── Step 3: Classify ───

function classify(topics, description) {
  const text = [...(topics || []), description || ''].join(' ').toLowerCase()
  for (const rule of CATEGORY_RULES) {
    if (rule.keywords.some((kw) => text.includes(kw))) {
      return rule.category
    }
  }
  return 'general'
}

// ─── SKILL.md helpers ───

function parseSkillMdFrontmatter(content) {
  const lines = content.split('\n')
  if (lines[0].trim() !== '---') return null
  let name = null
  let description = null
  for (let i = 1; i < lines.length; i++) {
    const l = lines[i].trim()
    if (l === '---') break
    if (l.startsWith('name:')) {
      name = l.slice(5).trim().replace(/^["']|["']$/g, '')
    } else if (l.startsWith('description:')) {
      description = l.slice(12).trim().replace(/^["']|["']$/g, '')
    }
  }
  return { name, description }
}

async function fetchSkillMdContent(owner, repo, branch, dirPath) {
  const filePath = dirPath ? `${dirPath}/SKILL.md` : 'SKILL.md'
  const url = `https://api.github.com/repos/${owner}/${repo}/contents/${encodeURIComponent(filePath)}?ref=${encodeURIComponent(branch)}`
  const data = await fetchJson(url, 1)
  if (!data || !data.content) return null
  const content = Buffer.from(data.content, 'base64').toString('utf-8')
  return parseSkillMdFrontmatter(content)
}

// ─── Name helpers ───

function kebabToTitle(name) {
  return name
    .split(/[-_]/)
    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
    .join(' ')
}

function slugFromDirPath(dirPath, repoName) {
  if (!dirPath) return repoName
  const parts = dirPath.split('/')
  return parts[parts.length - 1]
}

// ─── Main ───

async function main() {
  if (!GITHUB_TOKEN) {
    console.error('Error: GITHUB_TOKEN environment variable is required.')
    console.error('Set it via: export GITHUB_TOKEN=ghp_xxx')
    process.exit(1)
  }

  // Step 1: Fetch curated repo metadata
  const repos = await fetchAllRepoMetadata()

  // Step 2: Detect skills in each repo via Trees API
  console.log('Scanning repo trees for skills...')
  const skillEntries = [] // { repo, dirPath }
  let treeFailures = 0

  await pMap(
    repos,
    async (repo) => {
      const [owner, repoName] = repo.full_name.split('/')
      const tree = await getRepoTree(owner, repoName, repo.default_branch)
      if (!tree) {
        treeFailures++
        return
      }

      const detected = detectSkillsFromTree(tree)
      if (detected.length === 0) {
        // No detectable skill structure — treat whole repo as single skill
        skillEntries.push({ repo, dirPath: null })
        return
      }

      for (const s of detected) {
        skillEntries.push({ repo, dirPath: s.dirPath })
      }
    },
    CONCURRENCY,
  )

  console.log(`Detected ${skillEntries.length} skills across ${repos.length} repos (${treeFailures} tree fetch failures)`)

  // Fallback: if no skills detected, keep existing local file
  if (skillEntries.length === 0) {
    if (existsSync(OUTPUT_FILE)) {
      console.warn('No skills fetched from GitHub — keeping existing local featured-skills.json')
    } else {
      console.error('No skills fetched and no local fallback exists.')
      process.exit(1)
    }
    return
  }

  // Step 3: Sort by stars desc, deduplicate, take top MAX_SKILLS
  skillEntries.sort((a, b) => b.repo.stargazers_count - a.repo.stargazers_count)

  const seenSlugs = new Set()
  const dedupedEntries = skillEntries.filter((entry) => {
    const slug = slugFromDirPath(entry.dirPath, entry.repo.full_name.split('/')[1])
    if (seenSlugs.has(slug)) return false
    seenSlugs.add(slug)
    return true
  })
  console.log(`After dedup: ${dedupedEntries.length} unique skills (removed ${skillEntries.length - dedupedEntries.length} duplicates)`)

  const topEntries = dedupedEntries.slice(0, MAX_SKILLS)

  // Step 4: Fetch SKILL.md for top skills to get real names
  console.log(`Fetching SKILL.md for ${topEntries.length} skills...`)
  const skillMdMap = new Map() // index -> { name, description }
  await pMap(
    topEntries,
    async (entry, i) => {
      const [owner, repoName] = entry.repo.full_name.split('/')
      const md = await fetchSkillMdContent(owner, repoName, entry.repo.default_branch, entry.dirPath)
      if (md) skillMdMap.set(i, md)
    },
    CONCURRENCY,
  )
  console.log(`Fetched SKILL.md for ${skillMdMap.size}/${topEntries.length} skills`)

  // Filter out entries without SKILL.md
  const validEntries = topEntries.filter((_, i) => skillMdMap.has(i))
  console.log(`${validEntries.length} skills have SKILL.md (filtered out ${topEntries.length - validEntries.length})`)

  // Rebuild index mapping after filtering
  const validMdList = validEntries.map((entry, _i) => {
    const origIndex = topEntries.indexOf(entry)
    return { entry, md: skillMdMap.get(origIndex) }
  })

  // Step 5: Build output
  const categorySet = new Set()
  const topSkills = validMdList.map(({ entry, md }) => {
    const { repo, dirPath } = entry
    const repoName = repo.full_name.split('/')[1]
    const slug = slugFromDirPath(dirPath, repoName)
    const name = md.name || slug
    const summary = (md && md.description) || repo.description || ''
    const category = classify(repo.topics, repo.description)
    categorySet.add(category)

    let sourceUrl
    if (dirPath) {
      sourceUrl = `${repo.html_url}/tree/${repo.default_branch}/${dirPath}`
    } else {
      sourceUrl = repo.html_url
    }

    return {
      slug,
      name,
      summary,
      downloads: 0,
      stars: repo.stargazers_count,
      category,
      tags: (repo.topics || []).slice(0, 5),
      source_url: sourceUrl,
      updated_at: repo.updated_at,
    }
  })

  // Re-sort after name update (stars desc, then name asc)
  topSkills.sort((a, b) => b.stars - a.stars || a.name.localeCompare(b.name))

  const categories = Array.from(categorySet).sort()

  const output = {
    updated_at: new Date().toISOString(),
    total: topSkills.length,
    categories,
    skills: topSkills,
  }

  writeFileSync(OUTPUT_FILE, JSON.stringify(output, null, 2) + '\n')
  console.log(`Wrote ${topSkills.length} skills (of ${skillEntries.length} detected) to ${OUTPUT_FILE}`)
}

main().catch((err) => {
  console.error('Fatal error:', err)
  process.exit(1)
})


================================================
FILE: scripts/tauri-icon-desktop.mjs
================================================
import { spawnSync } from 'node:child_process'
import fs from 'node:fs'
import os from 'node:os'
import path from 'node:path'

const projectRoot = path.resolve(import.meta.dirname, '..')
const outDir = path.join(projectRoot, 'src-tauri', 'icons')

const cliArgs = process.argv.slice(2)
const sourceArg = cliArgs[0]

const defaultSourceCandidates = [
  path.join(outDir, 'icon-source.png'),
  path.join(projectRoot, 'public', 'logo.png'),
]

const source =
  sourceArg ??
  defaultSourceCandidates.find((candidate) => fs.existsSync(candidate))

if (!source) {
  console.error(
    '未找到图标源文件，请传入路径，例如：node scripts/tauri-icon-desktop.mjs public/logo.png',
  )
  process.exit(1)
}

if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true })

const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skills-hub-tauri-icons-'))
try {
  const res = spawnSync(
    'npx',
    ['--yes', 'tauri', 'icon', source, '-o', tempDir],
    { stdio: 'inherit', cwd: projectRoot },
  )
  if (res.status !== 0) process.exit(res.status ?? 1)

  const keepFiles = new Set([
    '32x32.png',
    '64x64.png',
    '128x128.png',
    '128x128@2x.png',
    'icon.png',
    'icon.icns',
    'icon.ico',
  ])

  for (const filename of keepFiles) {
    const src = path.join(tempDir, filename)
    const dst = path.join(outDir, filename)
    if (!fs.existsSync(src)) {
      console.error(`缺少生成文件：${src}`)
      process.exit(1)
    }
    fs.copyFileSync(src, dst)
  }

  for (const entry of fs.readdirSync(outDir, { withFileTypes: true })) {
    if (entry.isDirectory()) {
      fs.rmSync(path.join(outDir, entry.name), { recursive: true, force: true })
      continue
    }
    if (entry.name === 'icon-source.png') continue
    if (!keepFiles.has(entry.name)) fs.rmSync(path.join(outDir, entry.name))
  }
} finally {
  fs.rmSync(tempDir, { recursive: true, force: true })
}



================================================
FILE: scripts/version.mjs
================================================
#!/usr/bin/env node
import fs from "node:fs";
import path from "node:path";
import process from "node:process";

const ROOT = process.cwd();

function read(filePath) {
  return fs.readFileSync(path.join(ROOT, filePath), "utf8");
}

function write(filePath, contents) {
  fs.writeFileSync(path.join(ROOT, filePath), contents, "utf8");
}

function replaceJsonStringProp(filePath, propName, newValue) {
  const original = read(filePath);
  const re = new RegExp(`("${propName}"\\s*:\\s*")([^"]*)(")`);
  const m = original.match(re);
  if (!m) throw new Error(`Cannot find "${propName}" in ${filePath}`);
  const updated = original.replace(re, `$1${newValue}$3`);
  JSON.parse(updated);
  if (updated !== original) write(filePath, updated);
  return { from: m[2], to: newValue, changed: updated !== original };
}

function replaceCargoPackageVersion(filePath, newValue) {
  const original = read(filePath);
  const pkgHeader = original.match(/^\[package\]\s*$/m);
  if (!pkgHeader) throw new Error(`Cannot find [package] section in ${filePath}`);
  const pkgStart = pkgHeader.index ?? 0;
  const afterPkg = original.slice(pkgStart + pkgHeader[0].length);
  const nextSection = afterPkg.match(/^\[[^\]]+\]\s*$/m);
  const pkgEnd = nextSection?.index != null ? pkgStart + pkgHeader[0].length + nextSection.index : original.length;

  const before = original.slice(0, pkgStart);
  const pkgSection = original.slice(pkgStart, pkgEnd);
  const after = original.slice(pkgEnd);

  const re = /^version\s*=\s*"([^"]*)"\s*$/m;
  const m = pkgSection.match(re);
  if (!m) throw new Error(`Cannot find package version in ${filePath}`);
  const updatedSection = pkgSection.replace(re, `version = "${newValue}"`);

  const updated = `${before}${updatedSection}${after}`;
  if (updated !== original) write(filePath, updated);
  return { from: m[1], to: newValue, changed: updated !== original };
}

function getPackageJsonVersion() {
  const pkg = JSON.parse(read("package.json"));
  if (!pkg.version || typeof pkg.version !== "string") {
    throw new Error("package.json missing valid version");
  }
  return pkg.version;
}

function setPackageJsonVersion(newVersion) {
  return replaceJsonStringProp("package.json", "version", newVersion);
}

function syncFromPackageJson() {
  const version = getPackageJsonVersion();
  const results = [];
  results.push({ file: "package.json", ...(replaceJsonStringProp("package.json", "version", version)) });
  results.push({ file: "src-tauri/tauri.conf.json", ...(replaceJsonStringProp("src-tauri/tauri.conf.json", "version", version)) });
  results.push({ file: "src-tauri/Cargo.toml", ...(replaceCargoPackageVersion("src-tauri/Cargo.toml", version)) });
  return { version, results };
}

function checkInSync() {
  const version = getPackageJsonVersion();
  const mismatches = [];

  const tauriConfVersion = JSON.parse(read("src-tauri/tauri.conf.json")).version;
  if (tauriConfVersion !== version) {
    mismatches.push(`src-tauri/tauri.conf.json version=${tauriConfVersion} (expected ${version})`);
  }

  const cargoToml = read("src-tauri/Cargo.toml");
  const pkgHeader = cargoToml.match(/^\[package\]\s*$/m);
  if (!pkgHeader) throw new Error("src-tauri/Cargo.toml missing [package] section");
  const pkgStart = pkgHeader.index ?? 0;
  const afterPkg = cargoToml.slice(pkgStart + pkgHeader[0].length);
  const nextSection = afterPkg.match(/^\[[^\]]+\]\s*$/m);
  const pkgEnd = nextSection?.index != null ? pkgStart + pkgHeader[0].length + nextSection.index : cargoToml.length;
  const pkgSection = cargoToml.slice(pkgStart, pkgEnd);
  const m = pkgSection.match(/^version\s*=\s*"([^"]*)"\s*$/m);
  if (!m) throw new Error("src-tauri/Cargo.toml missing package version");
  const cargoVersion = m[1];
  if (cargoVersion !== version) {
    mismatches.push(`src-tauri/Cargo.toml version=${cargoVersion} (expected ${version})`);
  }

  return { version, mismatches };
}

function usage() {
  console.log("Usage:");
  console.log("  node scripts/version.mjs set <x.y.z>");
  console.log("  node scripts/version.mjs sync");
  console.log("  node scripts/version.mjs check");
}

async function main() {
  const [cmd, arg] = process.argv.slice(2);
  if (!cmd) {
    usage();
    process.exit(1);
  }

  if (cmd === "set") {
    if (!arg) {
      usage();
      process.exit(1);
    }
    setPackageJsonVersion(arg);
    syncFromPackageJson();
    console.log(`Version set to ${arg}`);
    return;
  }

  if (cmd === "sync") {
    const { version, results } = syncFromPackageJson();
    const changedFiles = results.filter((r) => r.changed).map((r) => r.file);
    console.log(`Synced version ${version}${changedFiles.length ? ` (updated: ${changedFiles.join(", ")})` : ""}`);
    return;
  }

  if (cmd === "check") {
    const { version, mismatches } = checkInSync();
    if (mismatches.length) {
      console.error(`Version mismatch (package.json=${version}):`);
      for (const line of mismatches) console.error(`- ${line}`);
      process.exit(1);
    }
    console.log(`Version OK (${version})`);
    return;
  }

  usage();
  process.exit(1);
}

main().catch((err) => {
  console.error(err?.stack || String(err));
  process.exit(1);
});



================================================
FILE: src/App.css
================================================
.skills-app {
  height: 100%;
  background: var(--bg-app);
  border: none;
  border-radius: 0;
  box-shadow: none;
  display: flex;
  flex-direction: column;
  overflow: hidden;
}

.skills-header {
  height: 56px;
  padding: 0 24px;
  display: flex;
  align-items: center;
  justify-content: space-between;
  border-bottom: 1px solid var(--border-subtle);
  background: var(--bg-header);
  backdrop-filter: blur(12px);
}

.header-left {
  display: flex;
  align-items: center;
  gap: 24px;
  height: 100%;
}

.brand-area {
  display: flex;
  align-items: center;
  gap: 10px;
}

/* Navigation Tabs */
.nav-tabs {
  display: flex;
  align-items: center;
  gap: 4px;
  height: 100%;
}

.nav-tab {
  height: 100%;
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 0 14px;
  font-size: 13px;
  font-weight: 500;
  color: var(--text-tertiary);
  cursor: pointer;
  border: none;
  background: none;
  position: relative;
  transition: color 0.2s;
  font-family: inherit;
}

.nav-tab:hover {
  color: var(--text-secondary);
}

.nav-tab.active {
  color: var(--accent-primary);
  font-weight: 600;
}

.nav-tab.active::after {
  content: '';
  position: absolute;
  bottom: 0;
  left: 8px;
  right: 8px;
  height: 2px;
  background: var(--accent-primary);
  border-radius: 2px 2px 0 0;
}

.logo-icon {
  width: 36px;
  height: 36px;
  display: block;
  object-fit: contain;
  border-radius: 8px;
}

.brand-text-wrap {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.brand-text {
  font-weight: 700;
  font-size: 20px;
  letter-spacing: -0.03em;
  background: linear-gradient(to right, #2563eb, #9333ea, #ea580c);
  background-clip: text;
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
}

.brand-subtitle {
  font-size: 12px;
  color: var(--text-secondary);
}

.header-actions {
  display: flex;
  align-items: center;
  gap: 12px;
}

.skills-main {
  flex: 1;
  overflow: hidden;
  background: var(--bg-app);
  display: flex;
  flex-direction: column;
  min-height: 0;
}

.dashboard-stack {
  flex: 1;
  display: flex;
  flex-direction: column;
  min-height: 0;
}

.filter-bar {
  padding: 20px 32px 0 32px;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 16px;
}

.filter-title {
  font-size: 14px;
  font-weight: 500;
  color: var(--text-secondary);
  font-family: var(--font-mono);
  flex-shrink: 0;
  white-space: nowrap;
}

.filter-actions {
  display: flex;
  align-items: center;
  gap: 12px;
  min-width: 0;
}

.filter-actions .btn {
  flex-shrink: 0;
  white-space: nowrap;
}

.tag-filter-wrap {
  position: relative;
  flex-shrink: 0;
}

.tag-filter-btn {
  min-width: 108px;
  justify-content: center;
  white-space: nowrap;
}

.tag-filter-btn.active {
  border-color: rgba(37, 99, 235, 0.45);
  color: var(--accent-primary);
  background: var(--accent-soft-bg);
}

.tag-filter-menu {
  position: absolute;
  top: calc(100% + 8px);
  right: 0;
  width: 320px;
  max-height: min(480px, calc(100vh - 140px));
  display: flex;
  flex-direction: column;
  background: var(--bg-app);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-lg);
  z-index: 30;
  overflow: hidden;
}

.tag-filter-head {
  height: 44px;
  padding: 0 14px;
  display: flex;
  align-items: center;
  justify-content: space-between;
  font-size: 13px;
  font-weight: 700;
  color: var(--text-primary);
}

.tag-filter-head span:last-child {
  color: var(--text-tertiary);
  font-weight: 600;
}

.tag-filter-search {
  height: 36px;
  margin: 0 12px 10px;
  padding: 0 10px;
  display: flex;
  align-items: center;
  gap: 8px;
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  background: var(--bg-panel);
  color: var(--text-tertiary);
}

.tag-filter-search input {
  flex: 1;
  min-width: 0;
  border: none;
  outline: none;
  background: transparent;
  color: var(--text-primary);
  font-family: var(--font-ui);
  font-size: 13px;
}

.tag-filter-options {
  padding: 0 8px 8px;
  overflow-y: auto;
}

.tag-filter-option {
  width: 100%;
  height: 36px;
  display: grid;
  grid-template-columns: 24px 1fr auto;
  align-items: center;
  gap: 8px;
  border: none;
  background: transparent;
  border-radius: var(--radius-md);
  color: var(--text-secondary);
  cursor: pointer;
  font-size: 13px;
  font-weight: 600;
  text-align: left;
  padding: 0 8px;
}

.tag-filter-option:hover,
.tag-filter-option.selected {
  background: var(--bg-element);
  color: var(--text-primary);
}

.tag-check {
  width: 18px;
  height: 18px;
  border: 1px solid var(--border-subtle);
  border-radius: 5px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  color: var(--accent-primary-fg);
  background: var(--bg-panel);
}

.tag-filter-option.selected .tag-check {
  background: var(--accent-primary);
  border-color: var(--accent-primary);
}

.tag-count {
  color: var(--text-tertiary);
  font-weight: 600;
}

.tag-filter-footer {
  height: 48px;
  border-top: 1px solid var(--border-subtle);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 12px;
  background: var(--bg-panel);
}

.tag-filter-footer button {
  border: none;
  background: transparent;
  color: var(--text-secondary);
  cursor: pointer;
  font-weight: 600;
  font-size: 13px;
}

.tag-filter-footer button:hover {
  color: var(--accent-primary);
}

.tag-filter-footer button:disabled {
  color: var(--text-tertiary);
  cursor: not-allowed;
}

.sort-btn {
  height: 36px;
  padding: 0 12px;
  font-weight: 400;
  position: relative;
  white-space: nowrap;
}

.sort-btn select {
  position: absolute;
  inset: 0;
  opacity: 0;
  cursor: pointer;
}

.search-container {
  position: relative;
  flex: 0 1 220px;
}

.search-input {
  background: var(--bg-panel);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  height: 36px;
  padding: 0 12px 0 36px;
  color: var(--text-primary);
  width: 100%;
  min-width: 180px;
  font-size: 13px;
  transition: all 0.2s;
  font-family: var(--font-ui);
}

.search-input:focus {
  outline: none;
  border-color: var(--accent-primary);
  background: var(--bg-app);
  box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
}

.search-icon-abs {
  position: absolute;
  left: 12px;
  top: 50%;
  transform: translateY(-50%);
  width: 16px;
  height: 16px;
  color: var(--text-tertiary);
  pointer-events: none;
}

.status-row {
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 8px 32px 0;
}

.error {
  color: var(--status-error);
  font-size: 13px;
  white-space: pre-wrap;
}

.status {
  color: var(--status-info);
  font-size: 13px;
}


.skills-list {
  padding: 16px 32px 32px;
  display: flex;
  flex-direction: column;
  gap: 12px;
  overflow-y: auto;
  flex: 1;
  min-height: 0;
}

.discovered-banner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  background: var(--warning-soft-bg);
  border: 1px dashed var(--warning-soft-border);
  border-radius: var(--radius-lg);
  padding: 12px 20px;
}

.banner-left {
  display: flex;
  align-items: center;
  gap: 12px;
}

.banner-icon {
  width: 32px;
  height: 32px;
  background: rgba(245, 158, 11, 0.1);
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--status-warning);
}

.banner-title {
  font-weight: 600;
  color: var(--text-primary);
  font-size: 14px;
}

.banner-subtitle {
  font-size: 12px;
  color: var(--text-secondary);
}

.skill-card {
  background: var(--bg-app);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  padding: 16px 20px;
  display: grid;
  grid-template-columns: 48px 1fr auto;
  gap: 20px;
  align-items: center;
  transition: all 0.2s;
  position: relative;
}

.skill-card:hover {
  border-color: var(--border-strong);
  background: var(--bg-panel);
  transform: translateY(-1px);
  box-shadow: var(--shadow-sm);
  z-index: 1;
}

.skill-icon {
  width: 48px;
  height: 48px;
  background: var(--bg-element);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--text-secondary);
  font-size: 20px;
  transition: all 0.2s;
}

.skill-card:hover .skill-icon {
  color: var(--text-primary);
  border-color: var(--border-strong);
  background: var(--bg-panel);
}

.skill-main {
  display: flex;
  flex-direction: column;
  gap: 4px;
  justify-content: center;
}

.skill-header-row {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-wrap: wrap;
}

.skill-name {
  font-weight: 600;
  color: var(--text-primary);
  font-size: 15px;
  letter-spacing: -0.01em;
}

.skill-tags-inline {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  flex-wrap: wrap;
}

.skill-tag-pill {
  height: 22px;
  display: inline-flex;
  align-items: center;
  gap: 4px;
  border: 1px solid var(--border-subtle);
  border-radius: 999px;
  background: var(--bg-element);
  color: var(--text-secondary);
  padding: 0 8px;
  font-size: 11px;
  font-weight: 600;
  cursor: pointer;
}

.skill-tag-pill:hover {
  color: var(--accent-primary);
  border-color: rgba(37, 99, 235, 0.35);
  background: var(--accent-soft-bg);
}

.skill-tag-pill.muted {
  color: var(--text-tertiary);
}

.skill-desc {
  font-size: 13px;
  color: var(--text-secondary);
  line-height: 1.5;
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
  margin-top: 2px;
}

.skill-meta-row {
  display: flex;
  align-items: center;
  gap: 12px;
  margin-top: 4px;
}

.skill-source {
  font-family: var(--font-ui);
  font-size: 12px;
  color: var(--text-tertiary);
  display: flex;
  align-items: center;
  gap: 6px;
}

.skill-source.time {
  white-space: nowrap;
}

.scope-badge {
  height: 22px;
  display: inline-flex;
  align-items: center;
  border: 1px solid var(--border-subtle);
  border-radius: 6px;
  padding: 0 8px;
  background: var(--bg-element);
  color: var(--text-secondary);
  font-size: 12px;
  cursor: pointer;
}

.scope-badge.project {
  border-color: #2563eb;
  color: #2563eb;
  background: rgba(37, 99, 235, 0.08);
}

.scope-badge.global {
  border-color: var(--status-success);
  color: var(--status-success);
  background: rgba(34, 197, 94, 0.08);
}

.repo-pill {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  max-width: 320px;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  color: var(--text-secondary);
  font-weight: 500;
  padding: 2px 8px;
  border-radius: 999px;
  border: 1px solid var(--border-subtle);
  background: var(--bg-element);
  transition: all 0.2s;
}

.repo-pill.copyable {
  cursor: pointer;
}

.repo-pill.copyable:hover {
  color: var(--text-primary);
  border-color: var(--border-strong);
  background: #eef2ff;
}

.repo-pill:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

.repo-pill .copy-icon {
  display: inline-flex;
  align-items: center;
  opacity: 0;
  transform: translateX(-2px);
  transition: all 0.2s;
  color: var(--text-tertiary);
}

.repo-pill.copyable:hover .copy-icon {
  opacity: 1;
  transform: translateX(0);
  color: var(--text-secondary);
}

.dot {
  color: var(--text-tertiary);
}

.tool-matrix {
  display: flex;
  align-items: center;
  gap: 6px;
  flex-wrap: wrap;
  margin-top: 10px;
}

.tool-matrix.collapsed {
  flex-wrap: nowrap;
  overflow: hidden;
}

.tool-pill {
  height: 22px;
  padding: 0 8px;
  border-radius: 4px;
  font-size: 11px;
  font-weight: 500;
  display: inline-flex;
  align-items: center;
  gap: 6px;
  cursor: pointer;
  transition: all 0.2s;
  border: 1px solid var(--border-subtle);
  font-family: var(--font-ui);
  background: var(--bg-panel);
  color: var(--text-secondary);
}

.tool-pill.active {
  background: var(--bg-panel);
  color: var(--status-success);
  border-color: var(--status-success);
}

.tool-pill.active.project {
  color: #2563eb;
  border-color: #2563eb;
}

.tool-pill.active:hover {
  border-color: var(--status-success);
  transform: translateY(-1px);
}

.tool-pill.active.project:hover {
  border-color: #2563eb;
}

.tool-pill.inactive {
  background: var(--bg-element);
  color: var(--text-tertiary);
  border-color: transparent;
}

.tool-pill.inactive:hover {
  color: var(--text-secondary);
  background: var(--bg-element-hover);
}

.tool-pill.disabled {
  opacity: 0.5;
  cursor: not-allowed;
  border: 1px dashed var(--border-strong);
  background: transparent;
  color: var(--text-tertiary);
}

.tool-pill.more-badge {
  background: var(--bg-element);
  color: var(--text-tertiary);
  border: 1px solid var(--border-subtle);
  font-size: 11px;
  cursor: pointer;
  flex-shrink: 0;
}

.tool-pill.more-badge:hover {
  background: var(--bg-element-hover);
  color: var(--text-secondary);
}

.tool-pill-toggle {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 4px 8px;
  border-radius: 6px;
  border: 1px solid var(--border-subtle);
  background: var(--bg-element);
  font-size: 12px;
  color: var(--text-secondary);
  cursor: pointer;
  transition: all 0.2s;
}

.tool-pill-toggle input {
  display: none;
}

.tool-pill-toggle.active {
  background: var(--success-soft-bg);
  border-color: var(--success-soft-border);
  color: var(--status-success);
}

.tool-pill-toggle.disabled {
  opacity: 0.5;
  cursor: not-allowed;
}

.add-tags-list {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
  max-height: 148px;
  overflow: auto;
  padding: 2px 0 2px;
}

.add-tag-pill {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 5px 10px;
  border-radius: 999px;
  border: 1px solid var(--border-subtle);
  background: var(--bg-element);
  color: var(--text-secondary);
  font-size: 12px;
  font-weight: 600;
  cursor: pointer;
  transition: all 0.2s;
}

.add-tag-pill:hover {
  color: var(--accent-primary);
  border-color: rgba(37, 99, 235, 0.35);
  background: var(--accent-soft-bg);
}

.add-tag-pill.selected {
  border-color: var(--accent-primary);
  background: var(--accent-soft-bg);
  color: var(--accent-primary);
}

.add-tag-check {
  width: 14px;
  height: 14px;
  border-radius: 4px;
  border: 1px solid var(--border-subtle);
  display: inline-flex;
  align-items: center;
  justify-content: center;
  color: var(--accent-primary-fg);
  background: var(--bg-app);
}

.add-tag-pill.selected .add-tag-check {
  background: var(--accent-primary);
  border-color: var(--accent-primary);
}

.status-badge {
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background: var(--status-success);
  box-shadow: 0 0 0 2px var(--success-soft-border);
}

.skill-actions-col {
  display: flex;
  flex-direction: row;
  align-items: center;
  gap: 8px;
  align-self: center;
}

.card-btn {
  height: 32px;
  width: 32px;
  padding: 0;
  border-radius: var(--radius-md);
  background: transparent;
  color: var(--text-tertiary);
  border: 1px solid transparent;
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: all 0.2s;
}

.card-btn:hover {
  color: var(--text-primary);
  background: var(--bg-element);
  border-color: var(--border-subtle);
  transform: translateY(-1px);
  box-shadow: var(--shadow-sm);
}

.card-btn.primary-action {
  color: var(--accent-primary);
  background: var(--accent-soft-bg);
  border-color: var(--accent-soft-border);
}

.card-btn.tag-action.has-tags {
  color: var(--accent-primary);
  background: var(--accent-soft-bg);
  border-color: var(--accent-soft-border);
}

.card-btn.primary-action:hover {
  background: var(--accent-primary);
  color: var(--accent-primary-fg);
  border-color: var(--accent-primary);
}

.card-btn.danger-action:hover {
  color: var(--status-error);
  background: var(--danger-soft-bg);
  border-color: var(--danger-soft-border);
}

.empty {
  padding: 16px;
  border-radius: var(--radius-lg);
  border: 1px dashed var(--border-subtle);
  color: var(--text-secondary);
  background: var(--bg-app);
  margin: 0;
}

.btn {
  height: 36px;
  padding: 0 16px;
  border-radius: var(--radius-md);
  font-size: 13px;
  font-weight: 600;
  cursor: pointer;
  display: inline-flex;
  align-items: center;
  gap: 6px;
  border: 1px solid transparent;
  transition: all 0.2s;
  position: relative;
  overflow: hidden;
  background: transparent;
}

.btn-primary {
  background: var(--accent-primary);
  color: var(--accent-primary-fg);
  box-shadow: 0 4px 6px -1px rgba(37, 99, 235, 0.2);
}

.btn-primary:hover {
  background: var(--accent-primary-hover);
  transform: translateY(-1px);
  box-shadow: 0 6px 8px -1px rgba(37, 99, 235, 0.3);
}

.btn-secondary {
  background: transparent;
  border-color: var(--border-subtle);
  color: var(--text-primary);
}

.btn-secondary:hover {
  border-color: var(--border-strong);
  background: var(--bg-element);
}

.btn-warning {
  background: var(--status-warning);
  border-color: var(--status-warning);
  color: var(--accent-primary-fg);
  height: 32px;
}

.btn-warning:hover {
  opacity: 0.9;
}

.btn-danger {
  background: var(--danger-soft-bg);
  color: var(--status-error);
  border-color: var(--danger-soft-border);
}

.btn-danger:hover {
  background: var(--danger-soft-border);
  border-color: var(--status-error);
}

.btn:disabled,
.icon-btn:disabled,
.lang-btn:disabled,
.card-btn:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

.icon-btn {
  width: 36px;
  height: 36px;
  display: flex;
  align-items: center;
  justify-content: center;
  border-radius: var(--radius-md);
  color: var(--text-secondary);
  cursor: pointer;
  transition: all 0.2s;
  border: 1px solid var(--border-subtle);
  background: var(--bg-app);
}

.icon-btn:hover {
  background: var(--bg-element);
  color: var(--text-primary);
  transform: translateY(-1px);
}

.lang-btn {
  font-size: 12px;
  font-weight: 600;
  color: var(--text-secondary);
  cursor: pointer;
  padding: 6px 10px;
  border-radius: var(--radius-sm);
  background: transparent;
  border: 1px solid var(--border-subtle);
  font-family: var(--font-mono);
  display: flex;
  align-items: center;
  gap: 6px;
}

.lang-btn:hover {
  color: var(--text-primary);
  background: var(--bg-element);
  border-color: var(--text-tertiary);
}

.modal-backdrop {
  position: fixed;
  inset: 0;
  background: rgba(17, 24, 39, 0.45);
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 24px;
  z-index: 999;
}

.loading-backdrop {
  z-index: 2000;
}

.modal {
  width: min(520px, 100%);
  background: var(--bg-app);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
}

.modal-lg {
  width: min(720px, 100%);
}

.modal-xl {
  width: min(880px, 100%);
}

.modal-header {
  padding: 16px 20px;
  border-bottom: 1px solid var(--border-subtle);
  display: flex;
  justify-content: space-between;
  align-items: center;
}

.modal-title {
  font-size: 16px;
  font-weight: 600;
  color: var(--text-primary);
}

.modal-close {
  color: var(--text-tertiary);
  cursor: pointer;
  background: transparent;
  border: none;
  font-size: 18px;
  line-height: 1;
}

.modal-close:hover {
  color: var(--text-primary);
}

.modal-body {
  padding: 20px;
  color: var(--text-secondary);
  font-size: 13px;
  line-height: 1.5;
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.modal-actions {
  margin-top: 16px;
  display: flex;
  justify-content: flex-end;
  gap: 10px;
}

.modal-footer {
  padding: 16px 20px;
  border-top: 1px solid var(--border-subtle);
  display: flex;
  justify-content: flex-end;
  gap: 12px;
  background: var(--bg-panel);
}

.modal-footer.space-between {
  justify-content: space-between;
}

.modal-delete .delete-body {
  gap: 12px;
}

.tag-delete-modal {
  width: min(440px, 100%);
}

.tag-delete-body {
  white-space: pre-line;
}

.scope-modal {
  width: min(620px, 100%);
}

.scope-modal-body {
  gap: 10px;
}

.scope-help {
  color: var(--text-secondary);
  font-size: 13px;
  line-height: 1.5;
  margin-bottom: 2px;
}

.scope-choice {
  display: flex;
  align-items: flex-start;
  gap: 10px;
  padding: 10px 12px;
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  cursor: pointer;
}

.scope-choice.active {
  border-color: var(--border-strong);
  background: var(--bg-panel);
}

.scope-choice input {
  margin-top: 3px;
}

.scope-choice span {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.scope-choice small {
  color: var(--text-tertiary);
}

.scope-inline-warning {
  padding: 10px 12px;
  border: 1px solid rgba(245, 158, 11, 0.35);
  border-radius: 8px;
  background: rgba(245, 158, 11, 0.08);
  color: #92400e;
  font-size: 13px;
  line-height: 1.5;
}

.project-sync-panel {
  display: flex;
  flex-direction: column;
  gap: 10px;
  padding-top: 6px;
}

.project-sync-heading {
  color: var(--text-secondary);
  font-size: 12px;
  font-weight: 600;
}

.project-path-list,
.recent-project-list {
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.project-path-row,
.recent-project-row {
  min-height: 34px;
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 6px 8px;
  border: 1px solid var(--border-subtle);
  border-radius: 6px;
  background: var(--bg-panel);
  color: var(--text-secondary);
}

.project-path-row .mono,
.recent-project-row .mono {
  min-width: 0;
  flex: 1;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.recent-project-row {
  cursor: pointer;
  justify-content: space-between;
}

.recent-project-row:hover {
  border-color: var(--border-strong);
}

.project-empty {
  color: var(--text-tertiary);
  font-size: 13px;
}

.delete-title {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--status-error);
  font-weight: 600;
  font-size: 16px;
}

.delete-desc {
  font-size: 14px;
  color: var(--text-secondary);
}

.delete-warning {
  border: 1px solid rgba(220, 38, 38, 0.15);
  background: rgba(220, 38, 38, 0.05);
  border-radius: var(--radius-md);
  padding: 12px 14px;
}

.delete-warning ul {
  list-style: none;
  padding: 0;
  margin: 0;
  display: grid;
  gap: 6px;
  font-size: 12px;
  color: var(--text-secondary);
}

.delete-warning li::before {
  content: '•';
  color: var(--status-error);
  margin-right: 8px;
}

.btn-danger-solid {
  background: var(--status-error);
  color: var(--accent-primary-fg);
  box-shadow: 0 4px 6px -1px rgba(220, 38, 38, 0.2);
}

.btn-danger-solid:hover {
  opacity: 0.9;
  transform: translateY(-1px);
}

.processing-row {
  display: flex;
  gap: 12px;
  align-items: flex-start;
}

.processing-main {
  flex: 1;
  min-width: 0;
}

.spinner {
  width: 18px;
  height: 18px;
  border-radius: 999px;
  border: 2px solid var(--border-subtle);
  border-top-color: var(--accent-primary);
  animation: spin 0.9s linear infinite;
  margin-top: 2px;
}

.loading-modal {
  width: min(520px, 100%);
}

.loading-content {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  padding: 32px 20px;
  text-align: center;
  gap: 10px;
}

.loading-cancel-btn {
  margin-top: 8px;
}

.loader-spinner {
  width: 24px;
  height: 24px;
  border: 2px solid var(--border-subtle);
  border-top-color: var(--accent-primary);
  border-radius: 50%;
  animation: spin 0.8s linear infinite;
}

.loading-text {
  font-size: 16px;
  font-weight: 600;
  color: var(--text-primary);
}

.loading-subtext {
  font-size: 13px;
  color: var(--text-tertiary);
  font-family: var(--font-mono);
}

.loading-subtext-delayed {
  opacity: 0;
  animation: loadingSubtextFadeIn 0.18s ease 1.5s forwards;
}

.loading-backdrop .loading-subtext-delayed {
  will-change: opacity, transform;
}

@keyframes loadingSubtextFadeIn {
  from {
    opacity: 0;
    transform: translateY(2px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.loading-stage {
  font-size: 14px;
  color: var(--text-secondary);
  font-weight: 500;
}

.progress-bar {
  height: 6px;
  background: var(--bg-element);
  border-radius: 999px;
  width: 220px;
  overflow: hidden;
  margin-top: 8px;
}

.progress-fill {
  height: 100%;
  background: var(--accent-primary);
  width: 60%;
  border-radius: 999px;
  animation: shimmer 1.5s infinite linear;
  background: linear-gradient(
    90deg,
    var(--accent-primary) 0%,
    #60a5fa 50%,
    var(--accent-primary) 100%
  );
  background-size: 200% 100%;
}

@keyframes shimmer {
  0% {
    background-position: 100% 0;
  }
  100% {
    background-position: -100% 0;
  }
}

@keyframes spin {
  to {
    transform: rotate(360deg);
  }
}

.tabs {
  display: flex;
  gap: 24px;
  border-bottom: 1px solid var(--border-subtle);
  margin-bottom: 12px;
}

.tab-item {
  padding-bottom: 10px;
  font-size: 14px;
  color: var(--text-secondary);
  cursor: pointer;
  border-bottom: 2px solid transparent;
  background: transparent;
  border: none;
}

.tab-item:hover {
  color: var(--text-primary);
}

.tab-item.active {
  color: var(--accent-primary);
  border-color: var(--accent-primary);
  font-weight: 500;
}

.tab-item.disabled {
  color: var(--text-tertiary);
  cursor: not-allowed;
}

.form-group {
  margin-bottom: 12px;
}

.label {
  display: block;
  font-size: 13px;
  font-weight: 500;
  color: var(--text-secondary);
  margin-bottom: 8px;
}

.input {
  width: 100%;
  background: var(--bg-app);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  padding: 10px 14px;
  color: var(--text-primary);
  font-family: var(--font-mono);
  font-size: 13px;
  transition: all 0.2s;
}

.input:focus {
  border-color: var(--accent-primary);
  outline: none;
  box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.1);
}

.input-row {
  display: flex;
  gap: 8px;
  align-items: center;
}

.input-action {
  height: 40px;
  padding: 0 14px;
  white-space: nowrap;
}

.helper-text {
  font-size: 12px;
  color: var(--text-tertiary);
  margin-top: 6px;
}

.alert {
  border: 1px solid var(--danger-soft-border);
  background: var(--danger-soft-bg-strong);
  border-radius: var(--radius-lg);
  padding: 12px;
  margin: 0 32px;
}

.alert-title {
  font-weight: 700;
  color: var(--status-error);
}

.alert-body {
  margin-top: 8px;
  display: flex;
  flex-direction: column;
  gap: 10px;
}

.alert-item-title {
  font-weight: 600;
  color: var(--status-error);
  font-size: 13px;
}

.alert-item-message {
  white-space: pre-wrap;
  color: var(--status-error);
  font-size: 12px;
  line-height: 1.5;
}

.import-summary {
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.import-metrics {
  display: flex;
  gap: 12px;
  font-size: 12px;
  color: var(--text-secondary);
}

.groups {
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.discovered-list {
  gap: 14px;
}

.discovered-list .group-card {
  background: var(--bg-panel);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  padding: 18px 20px;
  box-shadow: var(--shadow-sm);
  transition: all 0.2s;
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.discovered-list .group-card:hover {
  border-color: var(--border-strong);
  box-shadow: var(--shadow-lg);
  transform: translateY(-1px);
}

.discovered-list .group-title {
  display: flex;
  align-items: center;
  justify-content: space-between;
  font-weight: 600;
  color: var(--text-primary);
  gap: 12px;
}

.discovered-list .group-select {
  gap: 12px;
  font-size: 15px;
}

.discovered-list .group-select input {
  width: 18px;
  height: 18px;
  accent-color: var(--accent-primary);
}

.discovered-list .group-variants {
  margin-top: 0;
  gap: 8px;
  padding-top: 10px;
  border-top: 1px solid var(--border-subtle);
}

.discovered-list .variant-row {
  grid-template-columns: 20px minmax(0, 1fr) auto;
  align-items: center;
  font-size: 12px;
  color: var(--text-secondary);
  column-gap: 12px;
  row-gap: 6px;
}

.discovered-list .variant-spacer {
  width: 16px;
  height: 16px;
}

.discovered-list .variant-info {
  display: flex;
  flex-direction: column;
  gap: 6px;
  min-width: 0;
}

.discovered-list .found-pill {
  font-size: 11px;
  color: var(--status-warning);
  background: var(--warning-soft-bg);
  border: 1px solid var(--warning-soft-border);
  padding: 2px 8px;
  border-radius: 999px;
  display: inline-flex;
  align-items: center;
  gap: 6px;
  width: fit-content;
}

.discovered-list .path {
  font-family: var(--font-mono);
  color: var(--text-tertiary);
  font-size: 12px;
  word-break: break-all;
}

.modal-discovered .variant-row .meta {
  color: var(--text-tertiary);
  font-size: 12px;
  justify-self: end;
}

.discovered-list .badge {
  background: var(--warning-soft-bg);
  color: var(--status-warning);
  border: 1px solid var(--warning-soft-border);
  font-size: 11px;
}

.modal-discovered .modal-body {
  gap: 20px;
  padding: 24px 28px 20px;
}

.modal-discovered {
  max-height: calc(100vh - 48px);
  display: flex;
  flex-direction: column;
}

.modal-discovered .modal-body {
  overflow: auto;
  flex: 1;
  min-height: 0;
}

.modal-discovered .modal-footer {
  margin-top: 0;
  justify-content: flex-end;
  padding: 20px 24px;
  background: var(--bg-app);
  gap: 16px;
}

.modal-discovered .modal-footer .btn {
  height: 40px;
  padding: 0 20px;
}

.modal-discovered .import-summary {
  color: var(--text-secondary);
  font-size: 14px;
  line-height: 1.6;
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.modal-discovered .import-metrics {
  font-size: 12px;
  color: var(--text-tertiary);
  display: flex;
  gap: 16px;
}

.modal-discovered .sync-row {
  margin: 0;
  padding: 8px 12px;
  border-radius: var(--radius-md);
  background: var(--bg-panel);
  border: 1px solid var(--border-subtle);
  justify-content: space-between;
}

.group-card {
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  padding: 12px;
  background: var(--bg-element);
}

.group-title {
  display: flex;
  justify-content: space-between;
  align-items: center;
  font-weight: 600;
}

.group-select {
  display: flex;
  align-items: center;
  gap: 10px;
}

.badge {
  background: var(--bg-element);
  color: var(--text-primary);
  border-radius: 999px;
  padding: 2px 10px;
  font-size: 12px;
}

.badge.danger {
  background: var(--danger-soft-bg);
  color: var(--status-error);
}

.group-variants {
  display: flex;
  flex-direction: column;
  gap: 8px;
  margin-top: 10px;
}

.variant-row {
  display: grid;
  grid-template-columns: 20px 120px 1fr auto;
  gap: 12px;
  font-size: 13px;
  color: var(--text-secondary);
}

.sync-row {
  display: flex;
  align-items: center;
  gap: 16px;
  margin: 8px 0;
  color: var(--text-primary);
}

.pick-list {
  margin-top: 12px;
  display: flex;
  flex-direction: column;
  gap: 10px;
  max-height: 360px;
  overflow: auto;
  padding-right: 4px;
}

.pick-search {
  position: relative;
  margin-top: 12px;
}

.import-search {
  flex: none;
  width: 100%;
  margin-top: 4px;
}

.modal-discovered .import-search + .sync-row {
  margin-top: 0;
}

.pick-item {
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  padding: 14px;
  display: flex;
  gap: 12px;
  background: var(--bg-panel);
}

.pick-item.disabled {
  opacity: 0.6;
}

.pick-item.disabled .pick-item-title {
  color: var(--text-secondary);
}

.pick-toolbar {
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin-top: 8px;
  color: var(--text-secondary);
  font-size: 13px;
}

.pick-item-checkbox {
  display: inline-flex;
  align-items: flex-start;
  padding-top: 2px;
}

.pick-item-checkbox input {
  width: 18px;
  height: 18px;
  accent-color: var(--accent-primary);
}

.pick-item-main {
  display: flex;
  flex-direction: column;
  gap: 4px;
  min-width: 0;
}

.pick-item-title {
  font-weight: 700;
  color: var(--text-primary);
  font-size: 14px;
}

.pick-item-desc {
  color: var(--text-secondary);
  font-size: 12px;
  line-height: 1.4;
}

.pick-item-path {
  font-family: var(--font-mono);
  color: var(--text-secondary);
  font-size: 12px;
  word-break: break-all;
}

.pick-item-reason {
  color: var(--danger);
  font-size: 12px;
}

.tags-page {
  flex: 1;
  min-height: 0;
  display: flex;
  flex-direction: column;
  overflow: hidden;
}

.tags-page-subtitle {
  margin-top: 4px;
  color: var(--text-secondary);
  font-size: 13px;
}

.tags-review-row,
.tags-toolbar {
  margin: 16px 32px 0;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
}

.tags-review-row {
  padding: 12px 16px;
  border: 1px dashed var(--border-subtle);
  border-radius: var(--radius-lg);
  background: var(--bg-panel);
}

.tags-review-left {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--text-secondary);
  font-weight: 600;
  font-size: 13px;
}

.tags-toolbar {
  align-items: stretch;
}

.tags-search {
  flex: 1;
}

.tags-new-row {
  display: flex;
  align-items: center;
  gap: 8px;
}

.tags-new-row .search-input {
  width: 220px;
}

.tags-table {
  margin: 16px 32px 32px;
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  overflow: auto;
  background: var(--bg-app);
}

.tags-table-row {
  min-height: 48px;
  display: grid;
  grid-template-columns: minmax(180px, 1fr) 100px 140px 220px;
  align-items: center;
  gap: 12px;
  padding: 0 16px;
  border-bottom: 1px solid var(--border-subtle);
  color: var(--text-secondary);
  font-size: 13px;
}

.tags-table-row:last-child {
  border-bottom: none;
}

.tags-table-head {
  min-height: 40px;
  background: var(--bg-panel);
  color: var(--text-tertiary);
  font-size: 12px;
  font-weight: 700;
}

.tags-table-name {
  color: var(--text-primary);
  font-weight: 700;
}

.tags-table-actions {
  display: flex;
  align-items: center;
  gap: 12px;
}

.tags-table-actions button {
  border: none;
  background: transparent;
  color: var(--text-secondary);
  cursor: pointer;
  font-weight: 600;
  font-size: 13px;
}

.tags-table-actions button:hover {
  color: var(--accent-primary);
}

.edit-tags-modal {
  width: min(420px, 100%);
}

.modal-subtitle {
  margin-top: 4px;
  color: var(--text-secondary);
  font-size: 12px;
}

.edit-tags-search {
  margin-top: 16px;
}

.edit-tags-list {
  max-height: 280px;
  overflow-y: auto;
  padding: 0 12px;
}

.edit-tags-modal .modal-actions {
  padding: 0 20px 18px;
}

.inline-checkbox {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  color: var(--text-secondary);
  font-size: 13px;
}

.settings-row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
}

.settings-label {
  font-size: 13px;
  color: var(--text-secondary);
  font-weight: 500;
}

.mono {
  font-family: var(--font-mono);
  font-size: 12px;
  word-break: break-all;
}

.settings-page {
  display: flex;
  flex-direction: column;
  height: 100%;
  overflow-y: auto;
  align-items: center;
}

.settings-page > .detail-header {
  width: 100%;
  max-width: 560px;
  margin: 0 auto;
  border-bottom: none;
  padding: 24px 0 0;
}

.settings-page-body {
  padding: 16px 0 32px;
  display: flex;
  flex-direction: column;
  gap: 20px;
  width: 100%;
  max-width: 560px;
  color: var(--text-primary);
}

.settings-field {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.settings-select-wrap {
  position: relative;
}

.settings-select {
  width: 100%;
  height: 40px;
  padding: 0 36px 0 14px;
  border-radius: var(--radius-md);
  border: 1px solid var(--border-subtle);
  background: var(--bg-app);
  color: var(--text-primary);
  font-size: 13px;
  font-family: var(--font-ui);
  appearance: none;
  cursor: pointer;
  transition: all 0.2s;
}

.settings-select:focus {
  outline: none;
  border-color: var(--accent-primary);
  box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.12);
}

.settings-select-caret {
  position: absolute;
  right: 12px;
  top: 50%;
  transform: translateY(-50%);
  width: 14px;
  height: 14px;
  color: var(--text-tertiary);
  pointer-events: none;
}

.settings-theme-options {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 8px;
}

.settings-theme-btn {
  height: 40px;
  border-radius: var(--radius-md);
  border: 1px solid var(--border-subtle);
  background: var(--bg-app);
  color: var(--text-secondary);
  font-size: 13px;
  font-weight: 600;
  cursor: pointer;
  transition: all 0.2s;
}

.settings-theme-btn:hover {
  border-color: var(--border-strong);
  color: var(--text-primary);
  background: var(--bg-element);
}

.settings-theme-btn.active {
  background: var(--accent-primary);
  color: var(--accent-primary-fg);
  border-color: var(--accent-primary);
  box-shadow: var(--shadow-sm);
}

.settings-theme-btn:focus-visible {
  outline: 2px solid var(--accent-primary);
  outline-offset: 2px;
}

.settings-input-row {
  display: flex;
  gap: 8px;
  align-items: center;
}

.settings-input {
  flex: 1;
  height: 40px;
  padding: 0 14px;
  border-radius: var(--radius-md);
  border: 1px solid var(--border-subtle);
  background: var(--bg-app);
  color: var(--text-primary);
  font-size: 13px;
}

.settings-input:focus {
  outline: none;
  border-color: var(--accent-primary);
  box-shadow: 0 0 0 2px rgba(37, 99, 235, 0.12);
}

.settings-browse {
  height: 40px;
  padding: 0 14px;
}

.settings-helper {
  font-size: 12px;
  color: var(--text-tertiary);
}

.settings-section-title {
  font-size: 13px;
  font-weight: 600;
  color: var(--text-primary);
  margin-top: 4px;
}

.settings-list {
  display: flex;
  flex-direction: column;
}

.settings-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
  padding: 16px 0;
  border-bottom: 1px solid var(--border-subtle);
}

.settings-item:last-child {
  border-bottom: none;
}

.settings-item-info {
  display: flex;
  flex-direction: column;
  gap: 4px;
  min-width: 0;
}

.settings-item-title {
  font-size: 14px;
  font-weight: 600;
  color: var(--text-primary);
}

.settings-item-desc {
  font-size: 12px;
  color: var(--text-tertiary);
  line-height: 1.4;
}

.settings-toggle {
  width: 44px;
  height: 24px;
  background: var(--bg-element);
  border-radius: 999px;
  border: 1px solid var(--border-subtle);
  position: relative;
  cursor: pointer;
  transition: all 0.2s;
  padding: 0;
}

.settings-toggle:disabled {
  cursor: not-allowed;
  opacity: 0.7;
}

.settings-toggle.checked {
  background: var(--status-success);
  border-color: var(--status-success);
}

.settings-toggle-knob {
  width: 18px;
  height: 18px;
  background: var(--bg-panel);
  border-radius: 50%;
  position: absolute;
  top: 2px;
  left: 2px;
  transition: transform 0.2s ease;
  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.2);
}

.settings-toggle.checked .settings-toggle-knob {
  transform: translateX(20px);
}

.settings-version {
  margin-top: 4px;
  padding-top: 16px;
  border-top: 1px solid var(--border-subtle);
  text-align: center;
  font-size: 12px;
  color: var(--text-tertiary);
}

.settings-update-section {
  border-top: 1px solid var(--border-subtle);
  padding-top: 16px;
  margin-top: 4px;
}

.settings-version-row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
}

.settings-version-text {
  font-size: 13px;
  color: var(--text-secondary);
}

.settings-update-status {
  font-size: 13px;
  color: var(--text-tertiary);
}

.settings-update-ok {
  color: var(--success, #22c55e);
  font-size: 13px;
}

.settings-update-available {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  margin-top: 8px;
  padding: 8px 10px;
  border-radius: 6px;
  background: var(--bg-hover);
  font-size: 13px;
}

.settings-update-error {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  margin-top: 8px;
  font-size: 13px;
  color: var(--danger, #ef4444);
}

.btn-sm {
  padding: 4px 10px;
  font-size: 12px;
  white-space: nowrap;
}

.btn-full {
  width: 100%;
}

/* Update modal */
.update-modal {
  width: 380px;
  padding: 24px;
  text-align: center;
  position: relative;
}

.update-modal-close {
  position: absolute;
  top: 10px;
  right: 10px;
}

.update-modal-body {
  margin-bottom: 20px;
}

.update-modal-title {
  font-size: 16px;
  font-weight: 600;
  color: var(--text-primary);
  margin-bottom: 8px;
}

.update-modal-text {
  font-size: 14px;
  color: var(--text-secondary);
  line-height: 1.5;
}

.update-modal-notes {
  margin-top: 12px;
  padding: 10px 12px;
  border-radius: 6px;
  background: var(--bg-hover);
  font-size: 13px;
  color: var(--text-secondary);
  text-align: left;
  line-height: 1.6;
  max-height: 200px;
  overflow-y: auto;
  word-break: break-word;
}

.update-modal-notes h3 {
  font-size: 13px;
  font-weight: 600;
  color: var(--text-primary);
  margin: 8px 0 4px;
}

.update-modal-notes h3:first-child {
  margin-top: 0;
}

.update-modal-notes ul {
  margin: 4px 0;
  padding-left: 18px;
}

.update-modal-notes li {
  margin: 2px 0;
}

.update-modal-notes a {
  color: var(--accent);
  text-decoration: none;
}

.update-modal-notes p {
  margin: 4px 0;
}

.update-modal-actions {
  display: flex;
  gap: 8px;
  justify-content: center;
}

/* Explore tab */
.explore-content {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.explore-filter {
  margin-top: 4px;
}

.explore-list {
  max-height: 400px;
  overflow-y: auto;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.explore-skill-item {
  padding: 10px 12px;
  border-radius: 8px;
  cursor: pointer;
  transition: background 0.15s;
}

.explore-skill-item:hover {
  background: var(--bg-hover);
}

.explore-skill-header {
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 8px;
}

.explore-skill-name {
  font-weight: 600;
  font-size: 14px;
  color: var(--text-primary);
}

.explore-skill-stats {
  font-size: 12px;
  color: var(--text-tertiary);
  white-space: nowrap;
  flex-shrink: 0;
}

.explore-skill-summary {
  margin-top: 2px;
  font-size: 13px;
  color: var(--text-secondary);
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.explore-source {
  font-size: 12px;
  color: var(--text-tertiary);
  text-align: right;
}


.explore-section-title {
  font-size: 12px;
  font-weight: 600;
  color: var(--text-tertiary);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  padding: 8px 0 4px;
  border-top: 1px solid var(--border-subtle);
  margin-top: 4px;
}

.explore-skill-source {
  margin-top: 2px;
  font-size: 12px;
  color: var(--text-tertiary);
}

.explore-loading,
.explore-empty {
  padding: 32px 0;
  text-align: center;
  color: var(--text-tertiary);
  font-size: 14px;
}

/* ===== Explore Page (full page) ===== */
.explore-page {
  flex: 1;
  display: flex;
  flex-direction: column;
  overflow: hidden;
}

.explore-hero {
  padding: 24px 32px 16px 32px;
  flex-shrink: 0;
}

.explore-search-row {
  display: flex;
  align-items: center;
  gap: 12px;
}

.explore-search-wrap {
  flex: 1;
  position: relative;
}

.explore-search-icon {
  position: absolute;
  left: 14px;
  top: 50%;
  transform: translateY(-50%);
  color: var(--text-tertiary);
  pointer-events: none;
}

.explore-search-input {
  width: 100%;
  height: 40px;
  background: var(--bg-panel);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg, 12px);
  padding: 0 16px 0 40px;
  font-size: 14px;
  color: var(--text-primary);
  transition: all 0.2s;
  font-family: inherit;
}

.explore-search-input:focus {
  outline: none;
  border-color: var(--accent-primary);
  box-shadow: 0 0 0 3px var(--accent-soft-bg);
}

.explore-search-input::placeholder {
  color: var(--text-tertiary);
}

.explore-manual-btn {
  height: 40px;
  padding: 0 16px;
  flex-shrink: 0;
}

.explore-source-label {
  font-size: 11px;
  color: var(--text-tertiary);
  margin-top: 8px;
  padding-left: 4px;
}

.explore-scroll {
  flex: 1;
  overflow-y: auto;
  padding: 0 32px 32px 32px;
}

.explore-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 10px;
  margin-bottom: 24px;
}

.explore-card {
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg, 12px);
  padding: 16px;
  display: flex;
  flex-direction: column;
  gap: 10px;
  transition: all 0.2s;
  cursor: pointer;
  background: var(--bg-app);
}

.explore-card:hover {
  border-color: var(--border-strong);
  box-shadow: var(--shadow-sm);
}

.explore-card-top {
  display: flex;
  align-items: flex-start;
  justify-content: space-between;
  gap: 12px;
}

.explore-card-info {
  flex: 1;
  min-width: 0;
}

.explore-card-name {
  font-weight: 600;
  font-size: 14px;
  color: var(--text-primary);
  margin-bottom: 2px;
}

.explore-card-author {
  font-size: 12px;
  color: var(--text-tertiary);
}

.explore-card-desc {
  font-size: 13px;
  color: var(--text-secondary);
  line-height: 1.5;
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

.explore-card-bottom {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
}

.explore-card-stats {
  display: flex;
  align-items: center;
  gap: 12px;
}

.explore-stat {
  display: flex;
  align-items: center;
  gap: 4px;
  font-size: 11px;
  color: var(--text-tertiary);
}

.explore-btn-install {
  background: var(--accent-primary);
  color: white;
  height: 30px;
  padding: 0 14px;
  font-size: 12px;
  font-weight: 600;
  border-radius: var(--radius-md, 8px);
  border: none;
  cursor: pointer;
  transition: all 0.2s;
  font-family: inherit;
  flex-shrink: 0;
}

.explore-btn-install:hover {
  filter: brightness(0.9);
}

.explore-btn-install:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

.explore-btn-installed {
  background: var(--status-success-bg, #ecfdf5);
  color: var(--status-success);
  height: 30px;
  padding: 0 14px;
  font-size: 12px;
  font-weight: 600;
  border-radius: var(--radius-md, 8px);
  border: 1px solid var(--status-success-border, #a7f3d0);
  cursor: default;
  font-family: inherit;
  display: flex;
  align-items: center;
  flex-shrink: 0;
}

/* ===== Skill Detail View ===== */
.detail-view {
  flex: 1;
  display: flex;
  flex-direction: column;
  overflow: hidden;
  min-height: 0;
}

.detail-header {
  padding: 16px 32px;
  border-bottom: 1px solid var(--border-subtle);
  flex-shrink: 0;
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.detail-back-btn {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: 13px;
  font-weight: 500;
  color: var(--text-secondary);
  cursor: pointer;
  background: none;
  border: none;
  padding: 4px 8px;
  border-radius: var(--radius-sm);
  transition: all 0.2s;
  font-family: inherit;
  align-self: flex-start;
}

.detail-back-btn:hover {
  color: var(--accent-primary);
  background: var(--accent-soft-bg);
}

.detail-skill-name {
  font-size: 20px;
  font-weight: 700;
  color: var(--text-primary);
  letter-spacing: -0.02em;
}

.detail-desc {
  font-size: 13px;
  color: var(--text-secondary);
  line-height: 1.5;
}

.detail-meta {
  display: flex;
  align-items: center;
  gap: 14px;
  font-size: 12px;
  color: var(--text-tertiary);
  margin-top: 2px;
}

.detail-meta-item {
  display: flex;
  align-items: center;
  gap: 5px;
}

.detail-meta-dot {
  color: var(--border-strong);
}

.detail-body {
  flex: 1;
  display: flex;
  overflow: hidden;
  min-height: 0;
}

/* ── File tree sidebar ── */
.detail-file-list {
  width: 260px;
  border-right: 1px solid var(--border-subtle);
  overflow-y: auto;
  flex-shrink: 0;
  background: var(--bg-panel);
  padding: 4px 0;
}

.file-list-title {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-tertiary);
  padding: 10px 16px 6px;
}

.file-tree {
  display: flex;
  flex-direction: column;
}

.tree-item {
  display: flex;
  align-items: center;
  gap: 4px;
  padding: 4px 12px;
  font-size: 13px;
  color: var(--text-secondary);
  cursor: pointer;
  border: none;
  background: none;
  width: 100%;
  text-align: left;
  font-family: inherit;
  transition: background 0.12s;
  min-height: 28px;
}

.tree-item:hover {
  background: var(--bg-element);
}

.tree-item.tree-file.active {
  background: var(--accent-soft-bg);
  color: var(--accent-primary);
  font-weight: 500;
}

.tree-chevron {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 14px;
  flex-shrink: 0;
  color: var(--text-tertiary);
}

.tree-icon {
  flex-shrink: 0;
}

.tree-icon-folder {
  color: var(--accent-primary);
  opacity: 0.7;
}

.tree-icon-file {
  color: var(--text-tertiary);
}

.tree-item.active .tree-icon-file {
  color: var(--accent-primary);
}

.tree-name {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  flex: 1;
  min-width: 0;
}

.tree-size {
  font-size: 11px;
  color: var(--text-tertiary);
  flex-shrink: 0;
  font-family: var(--font-mono);
  margin-left: auto;
  padding-left: 8px;
}

/* ── File content area ── */
.detail-file-content {
  flex: 1;
  overflow: auto;
  min-width: 0;
  background: var(--bg-app);
}

.file-content-header {
  padding: 10px 20px;
  border-bottom: 1px solid var(--border-subtle);
  display: flex;
  align-items: center;
  justify-content: space-between;
  position: sticky;
  top: 0;
  background: var(--bg-panel);
  z-index: 5;
}

.file-content-path {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--text-secondary);
  display: flex;
  align-items: center;
  gap: 6px;
}

.file-content-size {
  font-size: 11px;
  color: var(--text-tertiary);
  font-family: var(--font-mono);
}

.file-content-body {
  padding: 0;
}

/* Syntax highlighter overrides */
.file-content-body pre {
  margin: 0 !important;
  border-radius: 0 !important;
}

.file-content-body code {
  font-family: var(--font-mono) !important;
}

/* ── Markdown body ── */
.markdown-body {
  padding: 24px 32px;
  font-size: 14px;
  line-height: 1.7;
  color: var(--text-primary);
  width: 100%;
  max-width: 860px;
  margin: 0 auto;
  box-sizing: border-box;
}

.markdown-body h1,
.markdown-body h2,
.markdown-body h3,
.markdown-body h4,
.markdown-body h5,
.markdown-body h6 {
  color: var(--text-primary);
  margin-top: 24px;
  margin-bottom: 12px;
  font-weight: 600;
  line-height: 1.3;
}

.markdown-body h1 { font-size: 24px; padding-bottom: 8px; border-bottom: 1px solid var(--border-subtle); }
.markdown-body h2 { font-size: 20px; padding-bottom: 6px; border-bottom: 1px solid var(--border-subtle); }
.markdown-body h3 { font-size: 16px; }
.markdown-body h4 { font-size: 14px; }

.markdown-body p {
  margin: 0 0 12px;
}

.markdown-body ul,
.markdown-body ol {
  padding-left: 24px;
  margin: 0 0 12px;
}

.markdown-body li {
  margin-bottom: 4px;
}

.markdown-body li > ul,
.markdown-body li > ol {
  margin-top: 4px;
  margin-bottom: 0;
}

.markdown-body blockquote {
  margin: 0 0 12px;
  padding: 4px 16px;
  border-left: 3px solid var(--accent-primary);
  color: var(--text-secondary);
  background: var(--bg-element);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
}

.markdown-body pre {
  margin: 0 0 12px !important;
  border-radius: var(--radius-md) !important;
  border: 1px solid var(--border-subtle);
  overflow-x: auto;
}

.markdown-body .md-inline-code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  padding: 2px 6px;
  background: var(--bg-element);
  border-radius: var(--radius-sm);
  color: var(--text-primary);
  border: 1px solid var(--border-subtle);
}

.markdown-body a {
  color: var(--accent-primary);
  text-decoration: none;
}

.markdown-body a:hover {
  text-decoration: underline;
}

.markdown-body hr {
  border: none;
  border-top: 1px solid var(--border-subtle);
  margin: 20px 0;
}

.frontmatter-meta {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
  gap: 10px;
  margin: 0 0 20px;
  padding: 12px;
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  background: var(--bg-panel);
}

.frontmatter-meta-item {
  min-width: 0;
}

.frontmatter-meta-item[data-key="description"] {
  grid-column: 1 / -1;
}

.frontmatter-meta dt {
  margin: 0 0 4px;
  font-size: 11px;
  font-weight: 600;
  line-height: 1.3;
  color: var(--text-tertiary);
  text-transform: uppercase;
  overflow-wrap: normal;
}

.frontmatter-meta dd {
  margin: 0;
  font-size: 13px;
  line-height: 1.55;
  color: var(--text-primary);
  overflow-wrap: anywhere;
  white-space: pre-wrap;
}

.markdown-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 12px;
  font-size: 13px;
}

.markdown-body th,
.markdown-body td {
  padding: 8px 12px;
  border: 1px solid var(--border-subtle);
  text-align: left;
  vertical-align: top;
  overflow-wrap: anywhere;
}

.markdown-body td {
  white-space: pre-wrap;
}

.markdown-body th {
  background: var(--bg-element);
  font-weight: 600;
  color: var(--text-primary);
}

.markdown-body tr:nth-child(even) {
  background: var(--bg-panel);
}

.markdown-body img {
  max-width: 100%;
  border-radius: var(--radius-md);
}

/* ── Loading / spinner ── */
.detail-loading {
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 32px 16px;
  color: var(--text-tertiary);
  font-size: 13px;
  gap: 8px;
}

.detail-spinner {
  width: 16px;
  height: 16px;
  border: 2px solid var(--border-subtle);
  border-top-color: var(--accent-primary);
  border-radius: 50%;
  animation: spin 0.8s linear infinite;
}

/* ── Clickable skill name in card ── */
.skill-name.clickable {
  cursor: pointer;
  transition: color 0.15s;
  background: none;
  border: none;
  padding: 0;
  font: inherit;
  font-weight: 600;
  font-size: 15px;
  letter-spacing: -0.01em;
  color: var(--text-primary);
  text-align: left;
}

.skill-name.clickable:hover {
  color: var(--accent-primary);
}


================================================
FILE: src/App.tsx
================================================
import { useCallback, useEffect, useMemo, useRef, useState, type MutableRefObject } from 'react'
import type { Update } from '@tauri-apps/plugin-updater'
import './App.css'
import { useTranslation } from 'react-i18next'
import { Toaster, toast } from 'sonner'
import Markdown from 'react-markdown'
import remarkGfm from 'remark-gfm'
import ExplorePage from './components/skills/ExplorePage'
import FilterBar from './components/skills/FilterBar'
import SkillDetailView from './components/skills/SkillDetailView'
import Header from './components/skills/Header'
import LoadingOverlay from './components/skills/LoadingOverlay'
import SkillsList from './components/skills/SkillsList'
import TagsPage from './components/skills/TagsPage'
import AddSkillModal from './components/skills/modals/AddSkillModal'
import DeleteModal from './components/skills/modals/DeleteModal'
import EditSkillTagsModal from './components/skills/modals/EditSkillTagsModal'
import GitPickModal from './components/skills/modals/GitPickModal'
import LocalPickModal from './components/skills/modals/LocalPickModal'
import ImportModal from './components/skills/modals/ImportModal'
import NewToolsModal from './components/skills/modals/NewToolsModal'
import ScopeSyncModal from './components/skills/modals/ScopeSyncModal'
import SharedDirModal from './components/skills/modals/SharedDirModal'
import SettingsPage from './components/skills/SettingsPage'
import type {
  FeaturedSkillDto,
  GitSkillCandidate,
  InstallResultDto,
  LocalSkillCandidate,
  ManagedSkill,
  OnboardingPlan,
  OnlineSkillDto,
  TagWithCountDto,
  ToolOption,
  ToolStatusDto,
  UpdateResultDto,
} from './components/skills/types'

type SkillScopeState = Record<
  string,
  {
    scope: 'global' | 'project'
    projects: string[]
  }
>

function App() {
  const { t, i18n } = useTranslation()
  const language = i18n.resolvedLanguage ?? i18n.language ?? 'en'
  const languageStorageKey = 'skills-language'
  const themeStorageKey = 'skills-theme'
  const skillScopeStorageKey = 'skills-project-scope-state-v1'
  const toggleLanguage = useCallback(() => {
    void i18n.changeLanguage(language === 'en' ? 'zh' : 'en')
  }, [i18n, language])
  const [themePreference, setThemePreference] = useState<'system' | 'light' | 'dark'>(
    'system',
  )
  const [systemTheme, setSystemTheme] = useState<'light' | 'dark'>('light')
  const [plan, setPlan] = useState<OnboardingPlan | null>(null)
  const [loading, setLoading] = useState(false)
  const [error, setError] = useState<string | null>(null)
  const [selected, setSelected] = useState<Record<string, boolean>>({})
  const [variantChoice, setVariantChoice] = useState<Record<string, string>>({})
  const [syncTargets, setSyncTargets] = useState<Record<string, boolean>>({})
  const [actionMessage, setActionMessage] = useState<string | null>(null)
  const [successToastMessage, setSuccessToastMessage] = useState<string | null>(
    null,
  )
  const [managedSkills, setManagedSkills] = useState<ManagedSkill[]>([])
  const [localPath, setLocalPath] = useState('')
  const [localName, setLocalName] = useState('')
  const [gitUrl, setGitUrl] = useState('')
  const [gitName, setGitName] = useState('')
  const [pendingDeleteId, setPendingDeleteId] = useState<string | null>(null)
  const [gitCandidates, setGitCandidates] = useState<GitSkillCandidate[]>([])
  const [gitCandidatesRepoUrl, setGitCandidatesRepoUrl] = useState<string>('')
  const [showGitPickModal, setShowGitPickModal] = useState(false)
  const [gitCandidateSelected, setGitCandidateSelected] = useState<
    Record<string, boolean>
  >({})
  const [localCandidates, setLocalCandidates] = useState<LocalSkillCandidate[]>([])
  const [localCandidatesBasePath, setLocalCandidatesBasePath] = useState('')
  const [showLocalPickModal, setShowLocalPickModal] = useState(false)
  const [localCandidateSelected, setLocalCandidateSelected] = useState<
    Record<string, boolean>
  >({})
  const [loadingStartAt, setLoadingStartAt] = useState<number | null>(null)
  const [toolStatus, setToolStatus] = useState<ToolStatusDto | null>(null)
  const [showNewToolsModal, setShowNewToolsModal] = useState(false)
  const [showAddModal, setShowAddModal] = useState(false)
  const [showImportModal, setShowImportModal] = useState(false)
  const [pendingSharedToggle, setPendingSharedToggle] = useState<{
    skill: ManagedSkill
    toolId: string
    affectedToolIds?: string[]
  } | null>(null)
  const [updateAvailableVersion, setUpdateAvailableVersion] = useState<string | null>(null)
  const [updateBody, setUpdateBody] = useState<string | null>(null)
  const [updateInstalling, setUpdateInstalling] = useState(false)
  const [updateDone, setUpdateDone] = useState(false)
  const updateObjRef = useRef<Update | null>(null) as MutableRefObject<Update | null>
  const [searchQuery, setSearchQuery] = useState('')
  const [sortBy, setSortBy] = useState<'updated' | 'name'>('updated')
  const [scopeFilter, setScopeFilter] = useState<'all' | 'global' | 'project'>('all')
  const [activeView, setActiveView] = useState<'myskills' | 'explore' | 'detail' | 'settings' | 'tags'>('myskills')
  const [detailSkill, setDetailSkill] = useState<ManagedSkill | null>(null)
  const [tags, setTags] = useState<TagWithCountDto[]>([])
  const [selectedTagIds, setSelectedTagIds] = useState<number[]>([])
  const [includeUntagged, setIncludeUntagged] = useState(false)
  const [tagEditorSkill, setTagEditorSkill] = useState<ManagedSkill | null>(null)
  const [pendingDeleteTag, setPendingDeleteTag] = useState<TagWithCountDto | null>(null)
  const [addModalTab, setAddModalTab] = useState<'local' | 'git'>('git')
  const [addModalTagIds, setAddModalTagIds] = useState<number[]>([])
  const [featuredSkills, setFeaturedSkills] = useState<FeaturedSkillDto[]>([])
  const [featuredLoading, setFeaturedLoading] = useState(false)
  const [exploreFilter, setExploreFilter] = useState('')
  const [searchResults, setSearchResults] = useState<OnlineSkillDto[]>([])
  const [searchLoading, setSearchLoading] = useState(false)
  const searchTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null)
  const [autoSelectSkillName, setAutoSelectSkillName] = useState<string | null>(null)
  const [scopeModalSkill, setScopeModalSkill] = useState<ManagedSkill | null>(null)
  const [recentProjects, setRecentProjects] = useState<string[]>([])
  const [skillScopeState, setSkillScopeState] = useState<SkillScopeState>({})

  const isTauri =
    typeof window !== 'undefined' &&
    Boolean(
      (window as { __TAURI__?: unknown }).__TAURI__ ||
        (window as { __TAURI_INTERNALS__?: unknown }).__TAURI_INTERNALS__,
    )

  const invokeTauri = useCallback(
    async <T,>(command: string, args?: Record<string, unknown>) => {
      if (!isTauri) {
        throw new Error('Tauri API is not available')
      }
      const { invoke } = await import('@tauri-apps/api/core')
      return invoke<T>(command, args)
    },
    [isTauri],
  )
  const formatErrorMessage = useCallback(
    (raw: string) => {
      if (raw.includes('CANCELLED|')) {
        return '' // Silently ignore cancelled operations
      }
      if (raw.includes('skill already exists in central repo')) {
        // Extract skill name from path like: skill already exists in central repo: "/path/to/react-best-practices"
        const pathMatch = raw.match(/central repo:\s*"?([^"]+)"?/)
        if (pathMatch) {
          const skillName = pathMatch[1].split('/').pop() ?? ''
          if (skillName) {
            return t('errors.skillExistsInHubNamed', { name: skillName })
          }
        }
        return t('errors.skillExistsInHub')
      }
      if (raw.startsWith('TARGET_EXISTS|')) {
        return t('errors.targetExists')
      }
      if (raw.startsWith('TOOL_NOT_INSTALLED|')) {
        return t('errors.toolNotInstalled')
      }
      if (raw.startsWith('TOOL_NOT_WRITABLE|')) {
        const parts = raw.split('|')
        return t('errors.toolNotWritable', { tool: parts[1] ?? '', path: parts[2] ?? '' })
      }
      if (raw.startsWith('PROJECT_SCOPE_UNSUPPORTED|')) {
        const tool = raw.split('|')[1] ?? ''
        return t('projectSync.unsupportedTool', { tool })
      }
      if (raw.includes('未在该仓库中发现可导入的 Skills')) {
        return t('errors.noSkillsFoundInRepo')
      }
      return raw
    },
    [t],
  )
  const showActionErrors = useCallback(
    (errors: { title: string; message: string }[]) => {
      if (errors.length === 0) return
      const head = errors[0]
      const more =
        errors.length > 1
          ? t('errors.moreCount', { count: errors.length - 1 })
          : ''
      toast.error(
        `${formatErrorMessage(`${head.title}\n${head.message}`)}${more}`,
        { duration: 3200 },
      )
    },
    [formatErrorMessage, t],
  )
  const isSkillNameTaken = useCallback(
    (name: string) =>
      managedSkills.some((skill) => skill.name.toLowerCase() === name.toLowerCase()),
    [managedSkills],
  )

  const formatRelative = (ms: number | null | undefined) => {
    if (!ms) return t('relative.empty')
    const diff = Date.now() - ms
    if (diff < 0) return t('relative.empty')
    const minutes = Math.floor(diff / 60000)
    if (minutes < 1) return t('relative.justNow')
    if (minutes < 60) {
      return t('relative.minutesAgo', { minutes })
    }
    const hours = Math.floor(minutes / 60)
    if (hours < 24) {
      return t('relative.hoursAgo', { hours })
    }
    const days = Math.floor(hours / 24)
    return t('relative.daysAgo', { days })
  }

  const getSkillSourceLabel = (skill: ManagedSkill) => {
    const key = skill.source_type.toLowerCase()
    if (key.includes('git') && skill.source_ref) {
      return skill.source_ref
    }
    return skill.central_path
  }

  const getGithubInfo = (url: string | null | undefined) => {
    if (!url) return null
    const normalized = url.replace(/^git\+/, '')
    try {
      const parsed = new URL(normalized)
      if (!parsed.hostname.includes('github.com')) return null
      const parts = parsed.pathname.split('/').filter(Boolean)
      const owner = parts[0]
      const repo = parts[1]?.replace(/\.git$/, '')
      if (!owner || !repo) return null
      return {
        label: `${owner}/${repo}`,
        href: `https://github.com/${owner}/${repo}`,
      }
    } catch {
      const match = normalized.match(/github\.com\/([^/]+)\/([^/#?]+)/i)
      if (!match) return null
      const owner = match[1]
      const repo = match[2].replace(/\.git$/, '')
      return {
        label: `${owner}/${repo}`,
        href: `https://github.com/${owner}/${repo}`,
      }
    }
  }

  const loadPlan = useCallback(async () => {
    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    try {
      const result = await invokeTauri<OnboardingPlan>('get_onboarding_plan')
      setPlan(result)
      const defaultSelected: Record<string, boolean> = {}
      const defaultChoice: Record<string, string> = {}
      result.groups.forEach((group) => {
        defaultSelected[group.name] = true
        const first = group.variants[0]
        if (first) {
          defaultChoice[group.name] = first.path
        }
      })
      setSelected(defaultSelected)
      setVariantChoice(defaultChoice)
      return result
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
      return null
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }, [invokeTauri])

  const loadManagedSkills = useCallback(async () => {
    try {
      const result = await invokeTauri<ManagedSkill[]>('get_managed_skills')
      setManagedSkills(result)
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    }
  }, [invokeTauri])

  const loadTags = useCallback(async () => {
    try {
      const result = await invokeTauri<TagWithCountDto[]>('get_tags')
      setTags(result)
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    }
  }, [invokeTauri])

  useEffect(() => {
    if (isTauri) {
      loadManagedSkills()
      loadTags()
    }
  }, [isTauri, loadManagedSkills, loadTags])

  useEffect(() => {
    if (typeof window === 'undefined') return
    try {
      const raw = window.localStorage.getItem(skillScopeStorageKey)
      if (raw) {
        setSkillScopeState(JSON.parse(raw) as SkillScopeState)
      }
    } catch {
      setSkillScopeState({})
    }
  }, [skillScopeStorageKey])

  useEffect(() => {
    if (typeof window === 'undefined') return
    try {
      window.localStorage.setItem(
        skillScopeStorageKey,
        JSON.stringify(skillScopeState),
      )
    } catch {
      // ignore storage failures
    }
  }, [skillScopeState, skillScopeStorageKey])

  useEffect(() => {
    if (!isTauri) return
    invokeTauri<string[]>('get_recent_projects')
      .then((projects) => setRecentProjects(projects))
      .catch(() => {})
  }, [invokeTauri, isTauri])

  useEffect(() => {
    if (typeof window === 'undefined') return
    const stored = window.localStorage.getItem(themeStorageKey)
    if (stored === 'light' || stored === 'dark' || stored === 'system') {
      setThemePreference(stored)
    }
  }, [themeStorageKey])

  useEffect(() => {
    if (typeof window === 'undefined') return
    if (language !== 'en' && language !== 'zh') return
    try {
      window.localStorage.setItem(languageStorageKey, language)
    } catch {
      // ignore storage failures
    }
  }, [language, languageStorageKey])

  useEffect(() => {
    if (typeof window === 'undefined') return
    const media = window.matchMedia('(prefers-color-scheme: dark)')
    const update = () => {
      setSystemTheme(media.matches ? 'dark' : 'light')
    }
    update()
    if (media.addEventListener) {
      media.addEventListener('change', update)
    } else {
      media.addListener(update)
    }
    return () => {
      if (media.removeEventListener) {
        media.removeEventListener('change', update)
      } else {
        media.removeListener(update)
      }
    }
  }, [])

  useEffect(() => {
    if (typeof document === 'undefined') return
    const resolvedTheme =
      themePreference === 'system' ? systemTheme : themePreference
    document.documentElement.dataset.theme = resolvedTheme
    document.documentElement.style.colorScheme = resolvedTheme
    try {
      window.localStorage.setItem(themeStorageKey, themePreference)
    } catch {
      // ignore storage failures
    }
  }, [systemTheme, themePreference, themeStorageKey])

  useEffect(() => {
    if (!isTauri) return
    invokeTauri<string>('get_central_repo_path')
      .then((path) => setStoragePath(path))
      .catch((err) => {
        setError(err instanceof Error ? err.message : String(err))
      })
  }, [isTauri, invokeTauri])

  useEffect(() => {
    if (!isTauri) return
    invokeTauri<number>('get_git_cache_cleanup_days')
      .then((days) => setGitCacheCleanupDays(days))
      .catch((err) => {
        setError(err instanceof Error ? err.message : String(err))
      })
  }, [isTauri, invokeTauri])

  useEffect(() => {
    if (!isTauri) return
    invokeTauri<number>('get_git_cache_ttl_secs')
      .then((secs) => setGitCacheTtlSecs(secs))
      .catch((err) => {
        setError(err instanceof Error ? err.message : String(err))
      })
  }, [isTauri, invokeTauri])

  useEffect(() => {
    if (!isTauri) return
    invokeTauri<string>('get_github_token')
      .then((token) => setGithubToken(token))
      .catch(() => {})
  }, [isTauri, invokeTauri])

  useEffect(() => {
    if (isTauri) {
      void loadPlan()
    }
  }, [isTauri, loadPlan])

  useEffect(() => {
    if (!isTauri) return
    const ignoredVersion = localStorage.getItem('skills-ignored-update-version')
    import('@tauri-apps/plugin-updater')
      .then(({ check }) => check())
      .then(async (update) => {
        if (update && update.version !== ignoredVersion) {
          updateObjRef.current = update
          setUpdateAvailableVersion(update.version)
          // Fetch full release notes from GitHub API
          try {
            const res = await fetch(
              `https://api.github.com/repos/qufei1993/skills-hub/releases/tags/v${update.version}`,
            )
            if (res.ok) {
              const data = await res.json()
              setUpdateBody(data.body ?? update.body ?? null)
            } else {
              setUpdateBody(update.body ?? null)
            }
          } catch {
            setUpdateBody(update.body ?? null)
          }
        }
      })
      .catch(() => {})
  }, [isTauri])

  const handleDismissUpdate = useCallback(() => {
    setUpdateAvailableVersion(null)
    setUpdateBody(null)
  }, [])

  const handleDismissUpdateForever = useCallback(() => {
    if (updateAvailableVersion) {
      localStorage.setItem('skills-ignored-update-version', updateAvailableVersion)
    }
    setUpdateAvailableVersion(null)
    setUpdateBody(null)
  }, [updateAvailableVersion])

  const handleUpdateNow = useCallback(async () => {
    const update = updateObjRef.current
    if (!update) return
    setUpdateInstalling(true)
    try {
      await update.downloadAndInstall()
      setUpdateInstalling(false)
      setUpdateDone(true)
    } catch (err) {
      setUpdateInstalling(false)
      toast.error(err instanceof Error ? err.message : String(err), { duration: 3200 })
    }
  }, [])

  useEffect(() => {
    if (!successToastMessage) return
    toast.success(successToastMessage, { duration: 1800 })
    setSuccessToastMessage(null)
  }, [successToastMessage])

  useEffect(() => {
    if (!error) return
    const msg = formatErrorMessage(error)
    if (msg) toast.error(msg, { duration: 2600 })
    setError(null)
    setActionMessage(null)
  }, [error, formatErrorMessage])

  const toolInfos = useMemo(() => toolStatus?.tools ?? [], [toolStatus])

  const tools: ToolOption[] = useMemo(() => {
    return toolInfos.map((info) => ({
      id: info.key,
      // Prefer i18n label if present; fallback to backend label.
      label: t(`tools.${info.key}`, { defaultValue: info.label }),
      supports_project_scope: info.supports_project_scope,
    }))
  }, [t, toolInfos])

  const toolLabelById = useMemo(() => {
    const out: Record<string, string> = {}
    for (const tool of tools) out[tool.id] = tool.label
    return out
  }, [tools])

  const sharedToolIdsByToolId = useMemo(() => {
    // toolId -> all toolIds that share the same skills_dir.
    const byDir: Record<string, string[]> = {}
    for (const info of toolInfos) {
      const dir = info.skills_dir
      if (!byDir[dir]) byDir[dir] = []
      byDir[dir].push(info.key)
    }
    const out: Record<string, string[]> = {}
    for (const dir of Object.keys(byDir)) {
      const ids = byDir[dir]
      if (ids.length <= 1) continue
      for (const id of ids) out[id] = ids
    }
    return out
  }, [toolInfos])

  const uniqueToolIdsBySkillsDir = useCallback(
    (toolIds: string[]) => {
      // Preserve UI order (tools array order), de-dupe by skills_dir.
      const wanted = new Set(toolIds)
      const seen = new Set<string>()
      const out: string[] = []
      for (const tool of toolInfos) {
        if (!wanted.has(tool.key)) continue
        if (seen.has(tool.skills_dir)) continue
        seen.add(tool.skills_dir)
        out.push(tool.key)
      }
      return out
    },
    [toolInfos],
  )

  const installedToolIds = useMemo(
    () => toolStatus?.installed ?? [],
    [toolStatus],
  )
  const isInstalled = useCallback(
    (id: string) => installedToolIds.includes(id),
    [installedToolIds],
  )
  const installedTools = useMemo(
    () => tools.filter((tool) => installedToolIds.includes(tool.id)),
    [tools, installedToolIds],
  )
  const toolSupportsProjectScope = useCallback(
    (toolId: string) =>
      tools.find((tool) => tool.id === toolId)?.supports_project_scope ?? true,
    [tools],
  )
  const installedProjectToolIds = useMemo(
    () => installedToolIds.filter((toolId) => toolSupportsProjectScope(toolId)),
    [installedToolIds, toolSupportsProjectScope],
  )

  const getSkillProjects = useCallback(
    (skill: ManagedSkill) => {
      const projects = new Set<string>()
      for (const target of skill.targets) {
        if ((target.scope ?? 'global') === 'project' && target.project_path) {
          projects.add(target.project_path)
        }
      }
      return Array.from(projects)
    },
    [],
  )

  const getSkillScope = useCallback(
    (skill: ManagedSkill): 'global' | 'project' => {
      const hasGlobalTarget = skill.targets.some(
        (target) => (target.scope ?? 'global') === 'global',
      )
      const hasProjectTarget = skill.targets.some(
        (target) => (target.scope ?? 'global') === 'project',
      )
      if (hasGlobalTarget && !hasProjectTarget) return 'global'
      if (hasProjectTarget && !hasGlobalTarget) return 'project'
      const stored = skillScopeState[skill.id]?.scope
      if (stored === 'global' || stored === 'project') return stored
      return hasProjectTarget ? 'project' : 'global'
    },
    [skillScopeState],
  )

  const visibleSkills = useMemo(() => {
    const query = searchQuery.trim().toLowerCase()
    const selectedTagSet = new Set(selectedTagIds)
    const hasTagFilter = selectedTagIds.length > 0 || includeUntagged
    const filtered = managedSkills.filter((skill) => {
      if (scopeFilter !== 'all' && getSkillScope(skill) !== scopeFilter) return false
      if (hasTagFilter) {
        const matchesSelectedTag = skill.tags.some((tag) => selectedTagSet.has(tag.id))
        const matchesUntagged = includeUntagged && skill.tags.length === 0
        if (!matchesSelectedTag && !matchesUntagged) return false
      }
      if (!query) return true
      return (
        skill.name.toLowerCase().includes(query) ||
        skill.central_path.toLowerCase().includes(query) ||
        skill.source_type.toLowerCase().includes(query) ||
        skill.tags.some((tag) => tag.name.toLowerCase().includes(query))
      )
    })
    const sorted = [...filtered].sort((a, b) => {
      if (sortBy === 'name') {
        return a.name.localeCompare(b.name)
      }
      return (b.updated_at ?? 0) - (a.updated_at ?? 0)
    })
    return sorted
  }, [
    getSkillScope,
    includeUntagged,
    managedSkills,
    scopeFilter,
    searchQuery,
    selectedTagIds,
    sortBy,
  ])
  const untaggedCount = useMemo(
    () => managedSkills.filter((skill) => skill.tags.length === 0).length,
    [managedSkills],
  )

  const [storagePath, setStoragePath] = useState<string>(t('notAvailable'))
  const [gitCacheCleanupDays, setGitCacheCleanupDays] = useState<number>(30)
  const [gitCacheTtlSecs, setGitCacheTtlSecs] = useState<number>(60)
  const [githubToken, setGithubToken] = useState<string>('')
  const handlePickStoragePath = useCallback(async () => {
    try {
      if (!isTauri) {
        throw new Error(t('errors.notTauri'))
      }
      const { open } = await import('@tauri-apps/plugin-dialog')
      const selected = await open({
        directory: true,
        multiple: false,
        title: t('selectStoragePath'),
      })
      if (!selected || Array.isArray(selected)) return
      const newPath = await invokeTauri<string>('set_central_repo_path', {
        path: selected,
      })
      setStoragePath(newPath)
      await loadManagedSkills()
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    }
  }, [invokeTauri, isTauri, loadManagedSkills, t])
  const handleGitCacheCleanupDaysChange = useCallback(
    async (nextDays: number) => {
      const normalized = Math.max(0, Math.min(nextDays, 3650))
      setGitCacheCleanupDays(normalized)
      if (!isTauri) return
      try {
        const updated = await invokeTauri<number>('set_git_cache_cleanup_days', {
          days: normalized,
        })
        setGitCacheCleanupDays(updated)
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      }
    },
    [invokeTauri, isTauri],
  )
  const handleGitCacheTtlSecsChange = useCallback(
    async (nextSecs: number) => {
      const normalized = Math.max(0, Math.min(nextSecs, 3600))
      setGitCacheTtlSecs(normalized)
      if (!isTauri) return
      try {
        const updated = await invokeTauri<number>('set_git_cache_ttl_secs', {
          secs: normalized,
        })
        setGitCacheTtlSecs(updated)
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      }
    },
    [invokeTauri, isTauri],
  )
  const handleGithubTokenChange = useCallback(
    async (nextToken: string) => {
      setGithubToken(nextToken)
      if (!isTauri) return
      try {
        await invokeTauri('set_github_token', { token: nextToken })
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      }
    },
    [invokeTauri, isTauri],
  )
  const handleClearGitCacheNow = useCallback(async () => {
    if (!isTauri) {
      setError(t('errors.notTauri'))
      return
    }
    try {
      const removed = await invokeTauri<number>('clear_git_cache_now')
      setSuccessToastMessage(t('status.gitCacheCleared', { count: removed }))
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    }
  }, [invokeTauri, isTauri, t])
  const handlePickLocalPath = useCallback(async () => {
    try {
      if (!isTauri) {
        throw new Error(t('errors.notTauri'))
      }
      const { open } = await import('@tauri-apps/plugin-dialog')
      const selected = await open({
        directory: true,
        multiple: false,
        title: t('selectLocalFolder'),
      })
      if (!selected || Array.isArray(selected)) return
      setLocalPath(selected)
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    }
  }, [isTauri, t])
  const pendingDeleteSkill = useMemo(
    () => managedSkills.find((skill) => skill.id === pendingDeleteId) ?? null,
    [managedSkills, pendingDeleteId],
  )
  const newlyInstalledToolsText = useMemo(() => {
    if (!toolStatus || toolStatus.newly_installed.length === 0) return ''
    return toolStatus.newly_installed
      .map((id) => tools.find((t) => t.id === id)?.label ?? id)
      .join('、')
  }, [toolStatus, tools])

  const handleOpenSettings = useCallback(() => {
    setActiveView('settings')
  }, [])

  const loadFeaturedSkills = useCallback(async () => {
    if (featuredSkills.length > 0) return
    setFeaturedLoading(true)
    try {
      const result = await invokeTauri<FeaturedSkillDto[]>('get_featured_skills')
      setFeaturedSkills(result)
    } catch {
      // silent — explore tab will show empty state
    } finally {
      setFeaturedLoading(false)
    }
  }, [featuredSkills.length, invokeTauri])

  const handleViewChange = useCallback(
    (view: 'myskills' | 'explore' | 'tags') => {
      setActiveView(view)
      if (view === 'explore') {
        loadFeaturedSkills()
      }
      if (view === 'myskills') {
        setDetailSkill(null)
      }
    },
    [loadFeaturedSkills],
  )

  const handleOpenDetail = useCallback((skill: ManagedSkill) => {
    setDetailSkill(skill)
    setActiveView('detail')
  }, [])

  const handleBackToList = useCallback(() => {
    setDetailSkill(null)
    setActiveView('myskills')
  }, [])

  const handleExploreFilterChange = useCallback(
    (value: string) => {
      setExploreFilter(value)
      if (searchTimerRef.current) {
        clearTimeout(searchTimerRef.current)
        searchTimerRef.current = null
      }
      if (value.trim().length < 2) {
        setSearchResults([])
        setSearchLoading(false)
        return
      }
      setSearchLoading(true)
      searchTimerRef.current = setTimeout(async () => {
        try {
          const results = await invokeTauri<OnlineSkillDto[]>(
            'search_skills_online',
            { query: value.trim(), limit: 20 },
          )
          setSearchResults(results)
        } catch {
          toast.error(t('searchError'))
          setSearchResults([])
        } finally {
          setSearchLoading(false)
        }
      }, 500)
    },
    [invokeTauri, t],
  )


  const handleOpenAdd = useCallback(() => {
    setShowAddModal(true)
    setAddModalTagIds([])
  }, [])

  const applySelectedAddModalTags = useCallback(
    async (skillId: string, skillName: string) => {
      if (addModalTagIds.length === 0) return
      try {
        await invokeTauri('set_skill_tags', {
          skillId,
          tagIds: addModalTagIds,
        })
      } catch {
        toast.error(t('tagsApplyFailed', { name: skillName }))
      }
    },
    [addModalTagIds, invokeTauri, t],
  )

  const handleCancelLoading = useCallback(() => {
    void invokeTauri('cancel_current_operation').catch(() => {})
    setLoading(false)
    setLoadingStartAt(null)
    setActionMessage(null)
  }, [invokeTauri])

  const handleCloseAdd = useCallback(() => {
    if (!loading) {
      setShowAddModal(false)
      setAddModalTagIds([])
    }
  }, [loading])

  const handleCloseImport = useCallback(() => {
    if (!loading) setShowImportModal(false)
  }, [loading])

  const handleCloseSettings = useCallback(() => {
    setActiveView('myskills')
  }, [])

  const handleThemeChange = useCallback(
    (nextTheme: 'system' | 'light' | 'dark') => {
      setThemePreference(nextTheme)
    },
    [],
  )

  const handleCloseNewTools = useCallback(() => {
    if (!loading) setShowNewToolsModal(false)
  }, [loading])

  const handleCloseDelete = useCallback(() => {
    if (!loading) setPendingDeleteId(null)
  }, [loading])

  const handleCloseGitPick = useCallback(() => {
    if (!loading) setShowGitPickModal(false)
  }, [loading])

  const handleCancelGitPick = useCallback(() => {
    if (loading) return
    setShowGitPickModal(false)
    setGitCandidates([])
    setGitCandidateSelected({})
    setGitCandidatesRepoUrl('')
  }, [loading])

  const handleCloseLocalPick = useCallback(() => {
    if (!loading) setShowLocalPickModal(false)
  }, [loading])

  const handleCancelLocalPick = useCallback(() => {
    if (loading) return
    setShowLocalPickModal(false)
    setLocalCandidates([])
    setLocalCandidateSelected({})
    setLocalCandidatesBasePath('')
  }, [loading])

  const handleSortChange = useCallback((value: 'updated' | 'name') => {
    setSortBy(value)
  }, [])

  const handleSearchChange = useCallback((value: string) => {
    setSearchQuery(value)
  }, [])

  const handleScopeFilterChange = useCallback(
    (value: 'all' | 'global' | 'project') => {
      setScopeFilter(value)
    },
    [],
  )

  const handleToggleAddModalTag = useCallback((tagId: number) => {
    setAddModalTagIds((current) =>
      current.includes(tagId)
        ? current.filter((id) => id !== tagId)
        : [...current, tagId],
    )
  }, [])

  const handleToggleTagFilter = useCallback((tagId: number) => {
    setSelectedTagIds((current) =>
      current.includes(tagId)
        ? current.filter((id) => id !== tagId)
        : [...current, tagId],
    )
  }, [])

  const handleToggleUntaggedFilter = useCallback(() => {
    setIncludeUntagged((current) => !current)
  }, [])

  const handleClearTagFilters = useCallback(() => {
    setSelectedTagIds([])
    setIncludeUntagged(false)
  }, [])

  const handleOpenTagsPage = useCallback(() => {
    setActiveView('tags')
  }, [])

  const handleReviewUntagged = useCallback(() => {
    setSelectedTagIds([])
    setIncludeUntagged(true)
    setActiveView('myskills')
  }, [])

  const handleViewTag = useCallback((tagId: number) => {
    setSelectedTagIds([tagId])
    setIncludeUntagged(false)
    setActiveView('myskills')
  }, [])

  const handleCreateTag = useCallback(
    async (name: string) => {
      try {
        await invokeTauri('create_tag', { name })
        await loadTags()
        setSuccessToastMessage(t('tagCreated'))
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      }
    },
    [invokeTauri, loadTags, t],
  )

  const handleRenameTag = useCallback(
    async (tagId: number, name: string) => {
      try {
        const renamed = await invokeTauri<{ id: number; name: string }>('rename_tag', {
          tagId,
          name,
        })
        setSelectedTagIds((current) =>
          current.includes(tagId) ? current.map((id) => (id === tagId ? renamed.id : id)) : current,
        )
        await loadManagedSkills()
        await loadTags()
        setSuccessToastMessage(t('tagRenamed'))
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      }
    },
    [invokeTauri, loadManagedSkills, loadTags, t],
  )

  const handleDeleteTag = useCallback((tag: TagWithCountDto) => {
    setPendingDeleteTag(tag)
  }, [])

  const handleCloseDeleteTag = useCallback(() => {
    if (!loading) setPendingDeleteTag(null)
  }, [loading])

  const handleConfirmDeleteTag = useCallback(async () => {
    if (!pendingDeleteTag) return
    try {
      setLoading(true)
      setLoadingStartAt(Date.now())
      setActionMessage(t('actions.deletingTag', { name: pendingDeleteTag.name }))
      await invokeTauri('delete_tag', { tagId: pendingDeleteTag.id })
      setSelectedTagIds((current) => current.filter((id) => id !== pendingDeleteTag.id))
      await loadManagedSkills()
      await loadTags()
      setPendingDeleteTag(null)
      setSuccessToastMessage(t('tagDeleted'))
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
      setActionMessage(null)
    }
  }, [invokeTauri, loadManagedSkills, loadTags, pendingDeleteTag, t])

  const handleOpenEditTags = useCallback((skill: ManagedSkill) => {
    setTagEditorSkill(skill)
  }, [])

  const handleCloseEditTags = useCallback(() => {
    if (!loading) setTagEditorSkill(null)
  }, [loading])

  const handleSaveSkillTags = useCallback(
    async (skill: ManagedSkill, tagIds: number[]) => {
      try {
        setLoading(true)
        setLoadingStartAt(Date.now())
        setActionMessage(t('actions.updatingTags', { name: skill.name }))
        await invokeTauri('set_skill_tags', { skillId: skill.id, tagIds })
        await loadManagedSkills()
        await loadTags()
        setTagEditorSkill(null)
        setSuccessToastMessage(t('tagsUpdated'))
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
      } finally {
        setLoading(false)
        setLoadingStartAt(null)
        setActionMessage(null)
      }
    },
    [invokeTauri, loadManagedSkills, loadTags, t],
  )

  const handleSyncTargetChange = useCallback(
    (toolId: string, checked: boolean) => {
      const shared = sharedToolIdsByToolId[toolId] ?? [toolId]
      if (shared.length > 1) {
        const others = shared.filter((id) => id !== toolId)
        const otherLabels = others.map((id) => toolLabelById[id] ?? id).join(', ')
        const ok = window.confirm(
          t('sharedDirConfirm', {
            tool: toolLabelById[toolId] ?? toolId,
            others: otherLabels,
          }),
        )
        if (!ok) return
      }
      setSyncTargets((prev) => {
        const next = { ...prev }
        for (const id of shared) next[id] = checked
        return next
      })
    },
    [sharedToolIdsByToolId, t, toolLabelById],
  )

  const handleDeletePrompt = useCallback((skillId: string) => {
    setPendingDeleteId(skillId)
  }, [])

  const handleToggleGitCandidate = useCallback(
    (subpath: string, checked: boolean) => {
      setGitCandidateSelected((prev) => ({
        ...prev,
        [subpath]: checked,
      }))
    },
    [],
  )

  const handleToggleLocalCandidate = useCallback(
    (subpath: string, checked: boolean) => {
      setLocalCandidateSelected((prev) => ({
        ...prev,
        [subpath]: checked,
      }))
    },
    [],
  )

  const handleToggleGroup = useCallback((groupName: string, checked: boolean) => {
    setSelected((prev) => ({
      ...prev,
      [groupName]: checked,
    }))
  }, [])

  const handleSelectVariant = useCallback((groupName: string, path: string) => {
    setVariantChoice((prev) => ({
      ...prev,
      [groupName]: path,
    }))
  }, [])

  const handleReviewImport = useCallback(async () => {
    if (plan) {
      setShowImportModal(true)
      return
    }
    const result = await loadPlan()
    if (result) {
      setShowImportModal(true)
    }
  }, [loadPlan, plan])

  useEffect(() => {
    const load = async () => {
      if (!isTauri) return
      try {
        const status = await invokeTauri<ToolStatusDto>('get_tool_status')
        setToolStatus(status)

        // Default-select installed tools for sync targets if user hasn't toggled yet.
        setSyncTargets((prev) => {
          if (Object.keys(prev).length > 0) return prev
          const next: Record<string, boolean> = {}
          for (const t of status.tools) {
            next[t.key] = status.installed.includes(t.key)
          }
          return next
        })

        if (status.newly_installed.length > 0) {
          setShowNewToolsModal(true)
        }
      } catch (err) {
        // Non-fatal; app can still work without detection.
        console.warn(err)
      }
    }
    void load()
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [isTauri])

  const handleImport = async () => {
    if (!plan) return
    if (!plan.groups.some((group) => selected[group.name])) {
      setError(t('errors.selectAtLeastOneSkill'))
      return
    }
    setLoading(true)
    setLoadingStartAt(Date.now())
    setActionMessage(null)
    setError(null)
    try {
      const collectedErrors: { title: string; message: string }[] = []
      let successCount = 0
      for (const group of plan.groups) {
        if (!selected[group.name]) continue
        const chosenPath = variantChoice[group.name] ?? group.variants[0]?.path
        if (!chosenPath) continue
        const chosenVariant = group.variants.find((v) => v.path === chosenPath)
        const chosenVariantTool = chosenVariant?.tool ?? null
        const chosenFingerprint = chosenVariant?.fingerprint ?? null

        let installResult: {
          skill_id: string
          central_path: string
        }

        try {
          setActionMessage(t('actions.importExisting', { name: group.name }))
          installResult = await invokeTauri<{
            skill_id: string
            central_path: string
          }>('import_existing_skill', {
            sourcePath: chosenPath,
            name: group.name,
          })
          successCount += 1
        } catch (err) {
          collectedErrors.push({
            title: t('errors.importFailedTitle', { name: group.name }),
            message: err instanceof Error ? err.message : String(err),
          })
          continue
        }

        const selectedInstalledIds = tools
          .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
          .map((t) => t.id)
        const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
          .map((id) => tools.find((t) => t.id === id))
          .filter(Boolean) as ToolOption[]
        for (const tool of targets) {
          setActionMessage(
            t('actions.syncing', { name: group.name, tool: tool.label }),
          )
          try {
            const sharedToolIds = sharedToolIdsByToolId[tool.id] ?? [tool.id]
            const hasSameContentVariant = Boolean(
              chosenFingerprint &&
                group.variants.some(
                  (variant) =>
                    sharedToolIds.includes(variant.tool) &&
                    variant.fingerprint === chosenFingerprint,
                ),
            )
            const overwrite = Boolean(
              (chosenVariantTool &&
                (chosenVariantTool === tool.id || sharedToolIds.includes(chosenVariantTool))) ||
                hasSameContentVariant,
            )
            await invokeTauri('sync_skill_to_tool', {
              sourcePath: installResult.central_path,
              skillId: installResult.skill_id,
              tool: tool.id,
              name: group.name,
              // 自动接管：来源目录或内容一致的已发现目录可安全替换为 Hub 管理的同步目标。
              overwrite,
              overwriteIfSameContent: true,
            })
          } catch (err) {
            const raw = err instanceof Error ? err.message : String(err)
            if (raw.startsWith('TARGET_EXISTS|')) {
              const targetPath = raw.split('|')[1] ?? ''
              collectedErrors.push({
                title: t('errors.syncFailedTitle', {
                  name: group.name,
                  tool: tool.label,
                }),
                message: t('errors.syncTargetExistsMessage', {
                  path: targetPath,
                }),
              })
            } else {
              collectedErrors.push({
                title: t('errors.syncFailedTitle', {
                  name: group.name,
                  tool: tool.label,
                }),
                message: raw,
              })
            }
          }
        }
      }

      setActionMessage(t('status.importCompleted'))
      setActionMessage(null)
      await loadManagedSkills()
      await loadPlan()
      if (collectedErrors.length > 0) {
        showActionErrors(collectedErrors)
      } else if (successCount > 0) {
        setSuccessToastMessage(t('status.importCompleted'))
      }
      setShowImportModal(false)
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const handleCreateLocal = async () => {
    if (!localPath.trim()) {
      setError(t('errors.requireLocalPath'))
      return
    }
    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    setActionMessage(t('actions.creatingLocalSkill'))
    try {
      const basePath = localPath.trim()
      const candidates = await invokeTauri<LocalSkillCandidate[]>(
        'list_local_skills_cmd',
        { basePath },
      )
      if (candidates.length === 0) {
        throw new Error(t('errors.noSkillsFoundLocal'))
      }
      if (candidates.length === 1 && candidates[0].valid) {
        const desiredName = localName.trim() || candidates[0].name
        if (isSkillNameTaken(desiredName)) {
          setError(t('errors.skillAlreadyExists', { name: desiredName }))
          return
        }
        const created = await invokeTauri<InstallResultDto>(
          'install_local_selection',
          {
            basePath,
            subpath: candidates[0].subpath,
            name: localName.trim() || undefined,
          },
        )
        await applySelectedAddModalTags(created.skill_id, created.name)
        {
          const selectedInstalledIds = tools
            .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
            .map((t) => t.id)
          const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
            .map((id) => tools.find((t) => t.id === id))
            .filter(Boolean) as ToolOption[]
          if (targets.length === 0) {
            setError(t('errors.noSyncTargets'))
          } else {
            const collectedErrors: { title: string; message: string }[] = []
            for (let i = 0; i < targets.length; i++) {
              const tool = targets[i]
              setActionMessage(
                t('actions.syncStep', {
                  index: i + 1,
                  total: targets.length,
                  name: created.name,
                  tool: tool.label,
                }),
              )
              try {
                await invokeTauri('sync_skill_to_tool', {
                  sourcePath: created.central_path,
                  skillId: created.skill_id,
                  tool: tool.id,
                  name: created.name,
                  overwriteIfSameContent: true,
                })
              } catch (err) {
                const raw = err instanceof Error ? err.message : String(err)
                collectedErrors.push({
                  title: t('errors.syncFailedTitle', {
                    name: created.name,
                    tool: tool.label,
                  }),
                  message: raw,
                })
              }
            }
            if (collectedErrors.length > 0) showActionErrors(collectedErrors)
          }
        }
        setLocalPath('')
        setLocalName('')
        setActionMessage(t('status.localSkillCreated'))
        setSuccessToastMessage(t('status.localSkillCreated'))
        setActionMessage(null)
        setShowAddModal(false)
        await loadManagedSkills()
        await loadTags()
      } else {
        setLocalCandidatesBasePath(basePath)
        setLocalCandidates(candidates)
        setLocalCandidateSelected(
          Object.fromEntries(candidates.map((c) => [c.subpath, c.valid])),
        )
        setShowLocalPickModal(true)
        setActionMessage(null)
        setLoading(false)
        setLoadingStartAt(null)
        return
      }
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const handleCreateGit = async () => {
    if (!gitUrl.trim()) {
      setError(t('errors.requireGitUrl'))
      return
    }
    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    setActionMessage(t('actions.creatingGitSkill'))
    try {
      const url = gitUrl.trim()
      const isFolderUrl = url.includes('/tree/') || url.includes('/blob/')

      if (isFolderUrl) {
        const candidates = await invokeTauri<GitSkillCandidate[]>(
          'list_git_skills_cmd',
          { repoUrl: url },
        )
        if (candidates.length === 0) {
          throw new Error(t('errors.noSkillsFoundWithHint'))
        }
        if (candidates.length > 1) {
          setGitCandidatesRepoUrl(url)
          setGitCandidates(candidates)
          setGitCandidateSelected(
            Object.fromEntries(candidates.map((c) => [c.subpath, true])),
          )
          setShowGitPickModal(true)
          setActionMessage(null)
          setLoading(false)
          setLoadingStartAt(null)
          return
        }
        if (isSkillNameTaken(candidates[0].name)) {
          setError(t('errors.skillAlreadyExists', { name: candidates[0].name }))
          return
        }
        const created = await invokeTauri<InstallResultDto>(
          'install_git_selection',
          {
            repoUrl: url,
            subpath: candidates[0].subpath,
            name: gitName.trim() || undefined,
          },
        )
        await applySelectedAddModalTags(created.skill_id, created.name)
        {
          const selectedInstalledIds = tools
            .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
            .map((t) => t.id)
          const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
            .map((id) => tools.find((t) => t.id === id))
            .filter(Boolean) as ToolOption[]
          if (targets.length === 0) {
            setError(t('errors.noSyncTargets'))
          } else {
            const collectedErrors: { title: string; message: string }[] = []
            for (let i = 0; i < targets.length; i++) {
              const tool = targets[i]
              setActionMessage(
                t('actions.syncStep', {
                  index: i + 1,
                  total: targets.length,
                  name: created.name,
                  tool: tool.label,
                }),
              )
              try {
                await invokeTauri('sync_skill_to_tool', {
                  sourcePath: created.central_path,
                  skillId: created.skill_id,
                  tool: tool.id,
                  name: created.name,
                  overwriteIfSameContent: true,
                })
              } catch (err) {
                const raw = err instanceof Error ? err.message : String(err)
              collectedErrors.push({
                title: t('errors.syncFailedTitle', {
                  name: created.name,
                  tool: tool.label,
                }),
                message: raw,
              })
              }
            }
            if (collectedErrors.length > 0) showActionErrors(collectedErrors)
          }
        }
      } else {
        const candidates = await invokeTauri<GitSkillCandidate[]>(
          'list_git_skills_cmd',
          { repoUrl: url },
        )
        if (candidates.length === 0) {
          throw new Error(t('errors.noSkillsFoundWithHint'))
        }
        if (candidates.length === 1) {
          if (isSkillNameTaken(candidates[0].name)) {
            setError(t('errors.skillAlreadyExists', { name: candidates[0].name }))
            return
          }
          const created = await invokeTauri<InstallResultDto>(
            'install_git_selection',
            {
            repoUrl: url,
            subpath: candidates[0].subpath,
            name: gitName.trim() || undefined,
            },
          )
          await applySelectedAddModalTags(created.skill_id, created.name)
          {
            const selectedInstalledIds = tools
              .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
              .map((t) => t.id)
            const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
              .map((id) => tools.find((t) => t.id === id))
              .filter(Boolean) as ToolOption[]
            if (targets.length === 0) {
              setError(t('errors.noSyncTargets'))
            } else {
              const collectedErrors: { title: string; message: string }[] = []
              for (let i = 0; i < targets.length; i++) {
                const tool = targets[i]
                setActionMessage(
                  t('actions.syncStep', {
                    index: i + 1,
                    total: targets.length,
                    name: created.name,
                    tool: tool.label,
                  }),
                )
                try {
                  await invokeTauri('sync_skill_to_tool', {
                    sourcePath: created.central_path,
                    skillId: created.skill_id,
                    tool: tool.id,
                    name: created.name,
                    overwriteIfSameContent: true,
                  })
                } catch (err) {
                  const raw = err instanceof Error ? err.message : String(err)
                  collectedErrors.push({
                    title: t('errors.syncFailedTitle', {
                      name: created.name,
                      tool: tool.label,
                    }),
                    message: raw,
                  })
                }
              }
              if (collectedErrors.length > 0) showActionErrors(collectedErrors)
            }
          }
        } else if (autoSelectSkillName) {
          // Auto-select the matching skill from online search results.
          // skills.sh name may differ from SKILL.md name (e.g. "json-render-react" vs "react"),
          // so try exact match first, then containment match.
          const target = autoSelectSkillName.toLowerCase()
          const containMatches = candidates.filter((c) => {
            const n = c.name.toLowerCase()
            return target.includes(n) || n.includes(target)
          })
          const match =
            candidates.find((c) => c.name.toLowerCase() === target) ??
            (containMatches.length === 1 ? containMatches[0] : undefined)
          setAutoSelectSkillName(null)
          if (match) {
            if (isSkillNameTaken(match.name)) {
              setError(t('errors.skillAlreadyExists', { name: match.name }))
              return
            }
            const created = await invokeTauri<InstallResultDto>(
              'install_git_selection',
              {
                repoUrl: url,
                subpath: match.subpath,
                name: gitName.trim() || undefined,
              },
            )
            await applySelectedAddModalTags(created.skill_id, created.name)
            {
              const selectedInstalledIds = tools
                .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
                .map((t) => t.id)
              const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
                .map((id) => tools.find((t) => t.id === id))
                .filter(Boolean) as ToolOption[]
              if (targets.length === 0) {
                setError(t('errors.noSyncTargets'))
              } else {
                const collectedErrors: { title: string; message: string }[] = []
                for (let i = 0; i < targets.length; i++) {
                  const tool = targets[i]
                  setActionMessage(
                    t('actions.syncStep', {
                      index: i + 1,
                      total: targets.length,
                      name: created.name,
                      tool: tool.label,
                    }),
                  )
                  try {
                    await invokeTauri('sync_skill_to_tool', {
                      sourcePath: created.central_path,
                      skillId: created.skill_id,
                      tool: tool.id,
                      name: created.name,
                      overwriteIfSameContent: true,
                    })
                  } catch (err) {
                    const raw = err instanceof Error ? err.message : String(err)
                    collectedErrors.push({
                      title: t('errors.syncFailedTitle', {
                        name: created.name,
                        tool: tool.label,
                      }),
                      message: raw,
                    })
                  }
                }
                if (collectedErrors.length > 0) showActionErrors(collectedErrors)
              }
            }
          } else {
            // No match found, fall back to picker
            setGitCandidatesRepoUrl(url)
            setGitCandidates(candidates)
            setGitCandidateSelected(
              Object.fromEntries(candidates.map((c) => [c.subpath, true])),
            )
            setShowGitPickModal(true)
            setActionMessage(null)
            setLoading(false)
            setLoadingStartAt(null)
            return
          }
        } else {
          setGitCandidatesRepoUrl(url)
          setGitCandidates(candidates)
          setGitCandidateSelected(
            Object.fromEntries(candidates.map((c) => [c.subpath, true])),
          )
          setShowGitPickModal(true)
          setActionMessage(null)
          setLoading(false)
          setLoadingStartAt(null)
          return
        }
      }
      setGitUrl('')
      setGitName('')
      setActionMessage(t('status.gitSkillCreated'))
      setSuccessToastMessage(t('status.gitSkillCreated'))
      setActionMessage(null)
      setShowAddModal(false)
      await loadManagedSkills()
      await loadTags()
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const [exploreInstallTrigger, setExploreInstallTrigger] = useState(0)
  const exploreInstallUrlRef = useRef<string | null>(null)

  const handleExploreInstall = useCallback(
    (sourceUrl: string, skillName?: string) => {
      setGitUrl(sourceUrl)
      if (skillName) setAutoSelectSkillName(skillName)
      if (toolStatus) {
        const targets: Record<string, boolean> = {}
        for (const id of toolStatus.installed) {
          targets[id] = true
        }
        setSyncTargets(targets)
      }
      exploreInstallUrlRef.current = sourceUrl
      setExploreInstallTrigger((n) => n + 1)
    },
    [toolStatus],
  )

  useEffect(() => {
    if (exploreInstallTrigger > 0 && exploreInstallUrlRef.current && !loading) {
      exploreInstallUrlRef.current = null
      void handleCreateGit()
    }
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [exploreInstallTrigger])

  const handleInstallSelectedLocalCandidates = async () => {
    const selected = localCandidates.filter(
      (c) => c.valid && localCandidateSelected[c.subpath],
    )
    if (selected.length === 0) {
      setError(t('errors.selectAtLeastOneSkill'))
      return
    }
    if (selected.length > 1 && localName.trim()) {
      setError(t('errors.multiSelectNoCustomName'))
      return
    }
    if (selected.length > 1) {
      const seen = new Set<string>()
      const dup = selected.find((c) => {
        if (seen.has(c.name)) return true
        seen.add(c.name)
        return false
      })
      if (dup) {
        setError(t('errors.duplicateSelectedSkills', { name: dup.name }))
        return
      }
    }
    const desiredName =
      selected.length === 1 && localName.trim()
        ? localName.trim()
        : selected[0].name
    if (selected.length === 1 && isSkillNameTaken(desiredName)) {
      setError(t('errors.skillAlreadyExists', { name: desiredName }))
      return
    }
    const duplicated = selected.find((c) => isSkillNameTaken(c.name))
    if (selected.length > 1 && duplicated) {
      setError(t('errors.skillAlreadyExists', { name: duplicated.name }))
      return
    }

    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    try {
      const collectedErrors: { title: string; message: string }[] = []
      for (let i = 0; i < selected.length; i++) {
        const candidate = selected[i]
        setActionMessage(
          t('actions.importStep', {
            index: i + 1,
            total: selected.length,
            name: candidate.name,
          }),
        )
        try {
          const created = await invokeTauri<InstallResultDto>(
            'install_local_selection',
            {
              basePath: localCandidatesBasePath,
              subpath: candidate.subpath,
              name: localName.trim() || undefined,
            },
          )
          await applySelectedAddModalTags(created.skill_id, created.name)
          {
            const selectedInstalledIds = tools
              .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
              .map((t) => t.id)
            const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
              .map((id) => tools.find((t) => t.id === id))
              .filter(Boolean) as ToolOption[]
            if (targets.length === 0) {
              collectedErrors.push({
                title: t('errors.unsyncedTitle', { name: created.name }),
                message: t('errors.noSyncTargets'),
              })
            } else {
              for (let ti = 0; ti < targets.length; ti++) {
                const tool = targets[ti]
                setActionMessage(
                  t('actions.syncStep', {
                    index: ti + 1,
                    total: targets.length,
                    name: created.name,
                    tool: tool.label,
                  }),
                )
                try {
                  await invokeTauri('sync_skill_to_tool', {
                    sourcePath: created.central_path,
                    skillId: created.skill_id,
                    tool: tool.id,
                    name: created.name,
                    overwriteIfSameContent: true,
                  })
                } catch (err) {
                  const raw = err instanceof Error ? err.message : String(err)
                  collectedErrors.push({
                    title: t('errors.syncFailedTitle', {
                      name: created.name,
                      tool: tool.label,
                    }),
                    message: raw,
                  })
                }
              }
            }
          }
        } catch (err) {
          const raw = err instanceof Error ? err.message : String(err)
          collectedErrors.push({
            title: t('errors.importFailedTitle', { name: candidate.name }),
            message: raw,
          })
        }
      }

      setShowLocalPickModal(false)
      setLocalCandidates([])
      setLocalCandidateSelected({})
      setLocalCandidatesBasePath('')
      setLocalPath('')
      setLocalName('')
      setActionMessage(t('status.selectedSkillsInstalled'))
      setSuccessToastMessage(t('status.selectedSkillsInstalled'))
      setActionMessage(null)
      setShowAddModal(false)
      await loadManagedSkills()
      await loadTags()
      if (collectedErrors.length > 0) showActionErrors(collectedErrors)
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const handleInstallSelectedCandidates = async () => {
    const selected = gitCandidates.filter((c) => gitCandidateSelected[c.subpath])
    if (selected.length === 0) {
      setError(t('errors.selectAtLeastOneSkill'))
      return
    }
    const duplicated = selected.find((c) => isSkillNameTaken(c.name))
    if (duplicated) {
      setError(t('errors.skillAlreadyExists', { name: duplicated.name }))
      return
    }
    if (selected.length > 1 && gitName.trim()) {
      setError(t('errors.multiSelectNoCustomName'))
      return
    }

    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    try {
      const collectedErrors: { title: string; message: string }[] = []
      for (let i = 0; i < selected.length; i++) {
        const candidate = selected[i]
        setActionMessage(
          t('actions.importStep', {
            index: i + 1,
            total: selected.length,
            name: candidate.name,
          }),
        )
        try {
          const created = await invokeTauri<InstallResultDto>(
            'install_git_selection',
            {
            repoUrl: gitCandidatesRepoUrl,
            subpath: candidate.subpath,
            name: gitName.trim() || undefined,
            },
          )
          await applySelectedAddModalTags(created.skill_id, created.name)
          {
            const selectedInstalledIds = tools
              .filter((tool) => syncTargets[tool.id] && isInstalled(tool.id))
              .map((t) => t.id)
            const targets = uniqueToolIdsBySkillsDir(selectedInstalledIds)
              .map((id) => tools.find((t) => t.id === id))
              .filter(Boolean) as ToolOption[]
            if (targets.length === 0) {
              collectedErrors.push({
                title: t('errors.unsyncedTitle', { name: created.name }),
                message: t('errors.noSyncTargets'),
              })
            } else {
              for (let ti = 0; ti < targets.length; ti++) {
                const tool = targets[ti]
                setActionMessage(
                  t('actions.syncStep', {
                    index: ti + 1,
                    total: targets.length,
                    name: created.name,
                    tool: tool.label,
                  }),
                )
                try {
                  await invokeTauri('sync_skill_to_tool', {
                    sourcePath: created.central_path,
                    skillId: created.skill_id,
                    tool: tool.id,
                    name: created.name,
                    overwriteIfSameContent: true,
                  })
                } catch (err) {
                  const raw = err instanceof Error ? err.message : String(err)
                  collectedErrors.push({
                    title: t('errors.syncFailedTitle', {
                      name: created.name,
                      tool: tool.label,
                    }),
                    message: raw,
                  })
                }
              }
            }
          }
        } catch (err) {
          const raw = err instanceof Error ? err.message : String(err)
          collectedErrors.push({
            title: t('errors.importFailedTitle', { name: candidate.name }),
            message: raw,
          })
        }
      }

      setShowGitPickModal(false)
      setGitCandidates([])
      setGitCandidateSelected({})
      setGitCandidatesRepoUrl('')
      setGitUrl('')
      setGitName('')
      setActionMessage(t('status.selectedSkillsInstalled'))
      setSuccessToastMessage(t('status.selectedSkillsInstalled'))
      setActionMessage(null)
      setShowGitPickModal(false)
      setGitCandidates([])
      setGitCandidateSelected({})
      setGitCandidatesRepoUrl('')
      setShowAddModal(false)
      await loadManagedSkills()
      await loadTags()
      if (collectedErrors.length > 0) showActionErrors(collectedErrors)
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const handleDeleteManaged = async (skill: ManagedSkill) => {
    setLoading(true)
    setLoadingStartAt(Date.now())
    setActionMessage(t('actions.removing', { name: skill.name }))
    setError(null)
    try {
      await invokeTauri('delete_managed_skill', { skillId: skill.id })
      setActionMessage(t('status.skillRemoved'))
      setSuccessToastMessage(t('status.skillRemoved'))
      setActionMessage(null)
      setSkillScopeState((prev) => {
        const next = { ...prev }
        delete next[skill.id]
        return next
      })
      await loadManagedSkills()
      await loadTags()
      setPendingDeleteId(null)
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
  }

  const handleSyncAllManagedToTools = useCallback(
    async (toolIds: string[]) => {
      if (managedSkills.length === 0) return
      const installedIds = uniqueToolIdsBySkillsDir(
        toolIds.filter((id) => isInstalled(id)),
      )
      if (installedIds.length === 0) return

      setLoading(true)
      setLoadingStartAt(Date.now())
      setError(null)
      try {
        const collectedErrors: { title: string; message: string }[] = []
        for (let si = 0; si < managedSkills.length; si++) {
          const skill = managedSkills[si]
          const skillScope = getSkillScope(skill)
          const projects = getSkillProjects(skill)
          for (let ti = 0; ti < installedIds.length; ti++) {
            const toolId = installedIds[ti]
            const toolLabel = tools.find((t) => t.id === toolId)?.label ?? toolId
            if (skillScope === 'project') {
              if (!toolSupportsProjectScope(toolId)) continue
              if (projects.length === 0) continue
            }
            setActionMessage(
              t('actions.syncStep', {
                index: si + 1,
                total: managedSkills.length,
                name: skill.name,
                tool: toolLabel,
              }),
            )
            try {
              if (skillScope === 'project') {
                for (const projectPath of projects) {
                  await invokeTauri('sync_skill_to_tool', {
                    sourcePath: skill.central_path,
                    skillId: skill.id,
                    tool: toolId,
                    name: skill.name,
                    overwriteIfSameContent: true,
                    scope: 'project',
                    projectPath,
                  })
                }
              } else {
                await invokeTauri('sync_skill_to_tool', {
                  sourcePath: skill.central_path,
                  skillId: skill.id,
                  tool: toolId,
                  name: skill.name,
                  overwriteIfSameContent: true,
                  scope: 'global',
                })
              }
            } catch (err) {
              const raw = err instanceof Error ? err.message : String(err)
              if (raw.startsWith('TOOL_NOT_INSTALLED|') || raw.startsWith('TOOL_NOT_WRITABLE|')) {
                continue
              }
              collectedErrors.push({
                title: t('errors.syncFailedTitle', {
                  name: skill.name,
                  tool: toolLabel,
                }),
                message: raw,
              })
            }
          }
        }
        setActionMessage(t('status.syncCompleted'))
        setSuccessToastMessage(t('status.syncCompleted'))
        setActionMessage(null)
        await loadManagedSkills()
        if (collectedErrors.length > 0) showActionErrors(collectedErrors)
      } finally {
        setLoading(false)
        setLoadingStartAt(null)
      }
    },
    [
      invokeTauri,
      getSkillProjects,
      getSkillScope,
      isInstalled,
      loadManagedSkills,
      managedSkills,
      showActionErrors,
      t,
      tools,
      toolSupportsProjectScope,
      uniqueToolIdsBySkillsDir,
    ],
  )

  const handleSyncAllNewTools = useCallback(() => {
    if (!toolStatus) return
    setSyncTargets((prev) => {
      const next = { ...prev }
      for (const id of toolStatus.newly_installed) {
        const shared = sharedToolIdsByToolId[id] ?? [id]
        for (const sid of shared) next[sid] = true
      }
      return next
    })
    setShowNewToolsModal(false)
    void handleSyncAllManagedToTools(toolStatus.newly_installed)
  }, [handleSyncAllManagedToTools, sharedToolIdsByToolId, toolStatus])

  const handleOpenScope = useCallback((skill: ManagedSkill) => {
    setScopeModalSkill(skill)
  }, [])

  const handleCloseScope = useCallback(() => {
    if (!loading) setScopeModalSkill(null)
  }, [loading])

  const setSkillScopeAndProjects = useCallback(
    (skillId: string, scope: 'global' | 'project', projects: string[]) => {
      const uniqueProjects = Array.from(new Set(projects.filter(Boolean)))
      setSkillScopeState((prev) => ({
        ...prev,
        [skillId]: {
          scope,
          projects: uniqueProjects,
        },
      }))
    },
    [],
  )

  const handleScopeChange = useCallback(
    async (nextScope: 'global' | 'project', nextProjects: string[]) => {
      const skill = scopeModalSkill
      if (!skill || loading) return
      const projects = Array.from(new Set(nextProjects.filter(Boolean)))
      const hasStaleTargets = skill.targets.some(
        (target) =>
          (target.scope ?? 'global') !== nextScope ||
          (nextScope === 'project' &&
            (target.scope ?? 'global') === 'project' &&
            (!target.project_path || !projects.includes(target.project_path))),
      )
      const activeTargets = skill.targets.filter(
        (target) =>
          (target.scope ?? 'global') !== nextScope ||
          (nextScope === 'project' &&
            (target.scope ?? 'global') === 'project' &&
            (!target.project_path || !projects.includes(target.project_path))),
      )
      const existingProjects = getSkillProjects(skill)
      const projectsChanged =
        projects.length !== existingProjects.length ||
        projects.some((project) => !existingProjects.includes(project))
      if (getSkillScope(skill) === nextScope && !hasStaleTargets && !projectsChanged) {
        return
      }

      setLoading(true)
      setLoadingStartAt(Date.now())
      setError(null)
      try {
        const seen = new Set<string>()
        for (const target of activeTargets) {
          const targetScope = target.scope ?? 'global'
          const key = `${target.tool}|${targetScope}|${target.project_path ?? ''}`
          if (seen.has(key)) continue
          seen.add(key)
          await invokeTauri('unsync_skill_from_tool', {
            skillId: skill.id,
            tool: target.tool,
            scope: targetScope,
            projectPath: target.project_path ?? undefined,
          })
        }
        if (nextScope === 'project' && projects.length > 0) {
          for (const toolId of installedProjectToolIds) {
            for (const projectPath of projects) {
              await invokeTauri('sync_skill_to_tool', {
                sourcePath: skill.central_path,
                skillId: skill.id,
                tool: toolId,
                name: skill.name,
                overwriteIfSameContent: true,
                scope: 'project',
                projectPath,
              })
            }
          }
        } else if (nextScope === 'global') {
          for (const toolId of installedToolIds) {
            try {
                await invokeTauri('sync_skill_to_tool', {
                  sourcePath: skill.central_path,
                  skillId: skill.id,
                  tool: toolId,
                  name: skill.name,
                  overwriteIfSameContent: true,
                  scope: 'global',
                })
            } catch (err) {
              const raw = err instanceof Error ? err.message : String(err)
              if (raw.startsWith('TOOL_NOT_INSTALLED|')) continue
              throw err
            }
          }
        }
        await loadManagedSkills()
        if (nextScope === 'project') {
          for (const projectPath of projects) {
            const saved = await invokeTauri<string[]>('save_recent_project', {
              projectPath,
            })
            setRecentProjects(saved)
          }
        }
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err))
        return
      } finally {
        setLoading(false)
        setLoadingStartAt(null)
      }

      setSkillScopeAndProjects(
        skill.id,
        nextScope,
        nextScope === 'project' ? projects : [],
      )
      setScopeModalSkill(null)
    },
    [
      getSkillProjects,
      getSkillScope,
      installedToolIds,
      installedProjectToolIds,
      invokeTauri,
      loadManagedSkills,
      loading,
      scopeModalSkill,
      setSkillScopeAndProjects,
    ],
  )

  const handlePickProject = useCallback(async () => {
    if (!scopeModalSkill) return undefined
    try {
      if (!isTauri) throw new Error(t('errors.notTauri'))
      const { open } = await import('@tauri-apps/plugin-dialog')
      const selected = await open({
        directory: true,
        multiple: false,
        title: t('projectSync.selectProjectTitle'),
      })
      if (!selected || Array.isArray(selected)) return undefined
      return selected
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err))
      return undefined
    }
  }, [isTauri, scopeModalSkill, t])

  const runToggleToolForSkill = useCallback(
    async (skill: ManagedSkill, toolId: string) => {
      if (loading) return
      const toolLabel = tools.find((t) => t.id === toolId)?.label ?? toolId
      const skillScope = getSkillScope(skill)
      const projects = getSkillProjects(skill)
      if (skillScope === 'project') {
        if (!toolSupportsProjectScope(toolId)) {
          setError(t('projectSync.unsupportedTool', { tool: toolLabel }))
          return
        }
        if (projects.length === 0) {
          setError(t('projectSync.noProjectsForSync'))
          setScopeModalSkill(skill)
          return
        }
      }
      const matchingTargets = skill.targets.filter(
        (target) => target.tool === toolId && (target.scope ?? 'global') === skillScope,
      )
      const synced = matchingTargets.length > 0

      setLoading(true)
      setLoadingStartAt(Date.now())
      setError(null)
      try {
        if (synced) {
          setActionMessage(
            t('actions.unsyncing', { name: skill.name, tool: toolLabel }),
          )
          if (skillScope === 'project') {
            const targetProjects = Array.from(
              new Set(
                matchingTargets
                  .map((target) => target.project_path)
                  .filter((path): path is string => Boolean(path)),
              ),
            )
            for (const projectPath of targetProjects) {
              await invokeTauri('unsync_skill_from_tool', {
                skillId: skill.id,
                tool: toolId,
                scope: 'project',
                projectPath,
              })
            }
          } else {
            await invokeTauri('unsync_skill_from_tool', {
              skillId: skill.id,
              tool: toolId,
              scope: 'global',
            })
          }
        } else {
          setActionMessage(
            t('actions.syncing', { name: skill.name, tool: toolLabel }),
          )
          if (skillScope === 'project') {
            for (const projectPath of projects) {
              await invokeTauri('sync_skill_to_tool', {
                sourcePath: skill.central_path,
                skillId: skill.id,
                tool: toolId,
                name: skill.name,
                overwriteIfSameContent: true,
                scope: 'project',
                projectPath,
              })
            }
          } else {
            await invokeTauri('sync_skill_to_tool', {
              sourcePath: skill.central_path,
              skillId: skill.id,
              tool: toolId,
              name: skill.name,
              overwriteIfSameContent: true,
              scope: 'global',
            })
          }
        }
        const statusText = synced
          ? t('status.syncDisabled')
          : t('status.syncEnabled')
        setActionMessage(statusText)
        setSuccessToastMessage(statusText)
        setActionMessage(null)
        await loadManagedSkills()
      } catch (err) {
        const raw = err instanceof Error ? err.message : String(err)
        if (raw.startsWith('TARGET_EXISTS|')) {
          const targetPath = raw.split('|')[1] ?? ''
          setError(t('errors.targetExistsDetail', { path: targetPath }))
        } else if (raw.startsWith('TOOL_NOT_INSTALLED|')) {
          setError(t('errors.toolNotInstalled'))
        } else if (raw.startsWith('TOOL_NOT_WRITABLE|')) {
          const parts = raw.split('|')
          setError(t('errors.toolNotWritable', { tool: parts[1] ?? '', path: parts[2] ?? '' }))
        } else {
          setError(raw)
        }
      } finally {
        setLoading(false)
        setLoadingStartAt(null)
      }
    },
    [
      getSkillProjects,
      getSkillScope,
      invokeTauri,
      loadManagedSkills,
      loading,
      t,
      tools,
      toolSupportsProjectScope,
    ],
  )

  const handleToggleToolForSkill = useCallback(
    (skill: ManagedSkill, toolId: string) => {
      if (loading) return
      const skillScope = getSkillScope(skill)
      const currentTarget = skill.targets.find(
        (target) => target.tool === toolId && (target.scope ?? 'global') === skillScope,
      )
      const shared = currentTarget
        ? skill.targets
            .filter(
              (target) =>
                (target.scope ?? 'global') === skillScope &&
                target.target_path === currentTarget.target_path,
            )
            .map((target) => target.tool)
        : sharedToolIdsByToolId[toolId] ?? null
      if (shared && shared.length > 1) {
        setPendingSharedToggle({ skill, toolId, affectedToolIds: shared })
        return
      }
      void runToggleToolForSkill(skill, toolId)
    },
    [getSkillScope, loading, runToggleToolForSkill, sharedToolIdsByToolId],
  )

  const handleUpdateManaged = useCallback(
    async (skill: ManagedSkill) => {
    setLoading(true)
    setLoadingStartAt(Date.now())
    setError(null)
    try {
      setActionMessage(t('actions.updating', { name: skill.name }))
      await invokeTauri<UpdateResultDto>('update_managed_skill', { skillId: skill.id })
      const updatedText = t('status.updated', { name: skill.name })
      setActionMessage(updatedText)
      setSuccessToastMessage(updatedText)
      setActionMessage(null)
      await loadManagedSkills()
    } catch (err) {
      const raw = err instanceof Error ? err.message : String(err)
      setError(raw)
    } finally {
      setLoading(false)
      setLoadingStartAt(null)
    }
    },
    [invokeTauri, loadManagedSkills, t],
  )

  const handleUpdateSkill = useCallback(
    (skill: ManagedSkill) => {
      void handleUpdateManaged(skill)
    },
    [handleUpdateManaged],
  )

  const handleSharedCancel = useCallback(() => {
    if (loading) return
    setPendingSharedToggle(null)
  }, [loading])

  const handleSharedConfirm = useCallback(() => {
    if (!pendingSharedToggle) return
    const payload = pendingSharedToggle
    setPendingSharedToggle(null)
    void runToggleToolForSkill(payload.skill, payload.toolId)
  }, [pendingSharedToggle, runToggleToolForSkill])

  const pendingSharedLabels = useMemo(() => {
    if (!pendingSharedToggle) return null
    const toolId = pendingSharedToggle.toolId
    const shared = pendingSharedToggle.affectedToolIds ?? sharedToolIdsByToolId[toolId] ?? []
    const others = shared.filter((id) => id !== toolId)
    return {
      toolLabel: toolLabelById[toolId] ?? toolId,
      otherLabels: others.map((id) => toolLabelById[id] ?? id).join(', '),
    }
  }, [pendingSharedToggle, sharedToolIdsByToolId, toolLabelById])

  const currentScopeModalSkill = useMemo(() => {
    if (!scopeModalSkill) return null
    return managedSkills.find((skill) => skill.id === scopeModalSkill.id) ?? scopeModalSkill
  }, [managedSkills, scopeModalSkill])

  return (
    <div className="skills-app">
      <Toaster
        position="top-right"
        richColors
        toastOptions={{ duration: 1800 }}
      />
      <LoadingOverlay
        loading={loading}
        actionMessage={actionMessage}
        loadingStartAt={loadingStartAt}
        onCancel={handleCancelLoading}
        t={t}
      />

      <Header
        language={language}
        loading={loading}
        activeView={activeView}
        onToggleLanguage={toggleLanguage}
        onOpenSettings={handleOpenSettings}
        onViewChange={handleViewChange}
        t={t}
      />

      <main className="skills-main">
        {activeView === 'detail' && detailSkill ? (
          <SkillDetailView
            skill={detailSkill}
            onBack={handleBackToList}
            invokeTauri={invokeTauri}
            formatRelative={formatRelative}
            t={t}
          />
        ) : activeView === 'myskills' ? (
          <div className="dashboard-stack">
            <FilterBar
              sortBy={sortBy}
              searchQuery={searchQuery}
              scopeFilter={scopeFilter}
              tags={tags}
              selectedTagIds={selectedTagIds}
              includeUntagged={includeUntagged}
              untaggedCount={untaggedCount}
              totalCount={visibleSkills.length}
              onSortChange={handleSortChange}
              onSearchChange={handleSearchChange}
              onScopeFilterChange={handleScopeFilterChange}
              onToggleTag={handleToggleTagFilter}
              onToggleUntagged={handleToggleUntaggedFilter}
              onClearTags={handleClearTagFilters}
              onManageTags={handleOpenTagsPage}
              t={t}
            />
            <SkillsList
              plan={plan}
              visibleSkills={visibleSkills}
              installedTools={installedTools}
              loading={loading}
              getGithubInfo={getGithubInfo}
              getSkillSourceLabel={getSkillSourceLabel}
              formatRelative={formatRelative}
              onReviewImport={handleReviewImport}
              onUpdateSkill={handleUpdateSkill}
              onDeleteSkill={handleDeletePrompt}
              onToggleTool={handleToggleToolForSkill}
              onOpenScope={handleOpenScope}
              onOpenDetail={handleOpenDetail}
              onEditTags={handleOpenEditTags}
              getSkillScope={getSkillScope}
              getSkillProjects={getSkillProjects}
              t={t}
            />
          </div>
        ) : activeView === 'tags' ? (
          <TagsPage
            tags={tags}
            untaggedCount={untaggedCount}
            loading={loading}
            formatRelative={formatRelative}
            onBack={handleBackToList}
            onReviewUntagged={handleReviewUntagged}
            onViewTag={handleViewTag}
            onCreateTag={handleCreateTag}
            onRenameTag={handleRenameTag}
            onDeleteTag={handleDeleteTag}
            t={t}
          />
        ) : activeView === 'settings' ? (
          <SettingsPage
            isTauri={isTauri}
            language={language}
            storagePath={storagePath}
            gitCacheCleanupDays={gitCacheCleanupDays}
            gitCacheTtlSecs={gitCacheTtlSecs}
            themePreference={themePreference}
            onPickStoragePath={handlePickStoragePath}
            onToggleLanguage={toggleLanguage}
            onThemeChange={handleThemeChange}
            onGitCacheCleanupDaysChange={handleGitCacheCleanupDaysChange}
            onGitCacheTtlSecsChange={handleGitCacheTtlSecsChange}
            onClearGitCacheNow={handleClearGitCacheNow}
            githubToken={githubToken}
            onGithubTokenChange={handleGithubTokenChange}
            onBack={handleCloseSettings}
            t={t}
          />
        ) : (
          <ExplorePage
            featuredSkills={featuredSkills}
            featuredLoading={featuredLoading}
            exploreFilter={exploreFilter}
            searchResults={searchResults}
            searchLoading={searchLoading}
            managedSkills={managedSkills}
            loading={loading}
            onExploreFilterChange={handleExploreFilterChange}
            onInstallSkill={handleExploreInstall}
            onOpenManualAdd={handleOpenAdd}
            t={t}
          />
        )}
      </main>

      <AddSkillModal
        open={showAddModal}
        loading={loading}
        canClose={!loading}
        addModalTab={addModalTab}
        localPath={localPath}
        localName={localName}
        gitUrl={gitUrl}
        gitName={gitName}
        tags={tags}
        selectedTagIds={addModalTagIds}
        syncTargets={syncTargets}
        installedTools={installedTools}
        toolStatus={toolStatus}
        onRequestClose={handleCloseAdd}
        onTabChange={setAddModalTab}
        onLocalPathChange={setLocalPath}
        onPickLocalPath={handlePickLocalPath}
        onLocalNameChange={setLocalName}
        onGitUrlChange={setGitUrl}
        onGitNameChange={setGitName}
        onToggleTag={handleToggleAddModalTag}
        onSyncTargetChange={handleSyncTargetChange}
        onSubmit={addModalTab === 'local' ? handleCreateLocal : handleCreateGit}
        t={t}
      />

      <EditSkillTagsModal
        key={
          tagEditorSkill
            ? `${tagEditorSkill.id}-${tagEditorSkill.tags.map((tag) => tag.id).join('-')}`
            : 'edit-tags'
        }
        open={Boolean(tagEditorSkill)}
        loading={loading}
        skill={
          tagEditorSkill
            ? managedSkills.find((skill) => skill.id === tagEditorSkill.id) ?? tagEditorSkill
            : null
        }
        tags={tags}
        onRequestClose={handleCloseEditTags}
        onSave={handleSaveSkillTags}
        t={t}
      />

      {showImportModal && plan ? (
        <ImportModal
          open={showImportModal}
          loading={loading}
          plan={plan}
          selected={selected}
          variantChoice={variantChoice}
          onRequestClose={handleCloseImport}
          onToggleGroup={handleToggleGroup}
          onSelectVariant={handleSelectVariant}
          onImport={handleImport}
          t={t}
        />
      ) : null}

      <SharedDirModal
        open={Boolean(pendingSharedToggle)}
        loading={loading}
        toolLabel={pendingSharedLabels?.toolLabel ?? ''}
        otherLabels={pendingSharedLabels?.otherLabels ?? ''}
        onRequestClose={handleSharedCancel}
        onConfirm={handleSharedConfirm}
        t={t}
      />

      <ScopeSyncModal
        key={
          currentScopeModalSkill
            ? `${currentScopeModalSkill.id}-${getSkillScope(currentScopeModalSkill)}`
            : 'scope-modal'
        }
        open={Boolean(currentScopeModalSkill)}
        loading={loading}
        skill={currentScopeModalSkill}
        scope={
          currentScopeModalSkill ? getSkillScope(currentScopeModalSkill) : 'global'
        }
        projects={
          currentScopeModalSkill ? getSkillProjects(currentScopeModalSkill) : []
        }
        recentProjects={recentProjects}
        onRequestClose={handleCloseScope}
        onScopeChange={handleScopeChange}
        onPickProject={handlePickProject}
        t={t}
      />

      <NewToolsModal
        open={Boolean(showNewToolsModal && newlyInstalledToolsText)}
        loading={loading}
        toolsLabelText={newlyInstalledToolsText}
        onLater={handleCloseNewTools}
        onSyncAll={handleSyncAllNewTools}
        t={t}
      />

      <DeleteModal
        open={Boolean(pendingDeleteId)}
        loading={loading}
        skillName={pendingDeleteSkill?.name ?? null}
        onRequestClose={handleCloseDelete}
        onConfirm={() => {
          if (pendingDeleteSkill) void handleDeleteManaged(pendingDeleteSkill)
        }}
        t={t}
      />

      {pendingDeleteTag ? (
        <div className="modal-backdrop" onClick={loading ? undefined : handleCloseDeleteTag}>
          <div
            className="modal modal-delete tag-delete-modal"
            onClick={(event) => event.stopPropagation()}
          >
            <div className="modal-header">
              <div className="modal-title">{t('deleteTagTitle')}</div>
              <button
                className="modal-close"
                type="button"
                onClick={handleCloseDeleteTag}
                disabled={loading}
              >
                ×
              </button>
            </div>
            <div className="modal-body tag-delete-body">
              {t('deleteTagConfirm', {
                name: pendingDeleteTag.name,
                count: pendingDeleteTag.skill_count,
              })}
            </div>
            <div className="modal-footer">
              <button
                className="btn btn-secondary"
                type="button"
                onClick={handleCloseDeleteTag}
                disabled={loading}
              >
                {t('cancel')}
              </button>
              <button
                className="btn btn-danger"
                type="button"
                onClick={() => void handleConfirmDeleteTag()}
                disabled={loading}
              >
                {t('deleteAction')}
              </button>
            </div>
          </div>
        </div>
      ) : null}

      {showLocalPickModal ? (
        <LocalPickModal
          open={showLocalPickModal}
          loading={loading}
          localCandidates={localCandidates}
          localCandidateSelected={localCandidateSelected}
          onRequestClose={handleCloseLocalPick}
          onCancel={handleCancelLocalPick}
          onToggleCandidate={handleToggleLocalCandidate}
          onInstall={handleInstallSelectedLocalCandidates}
          t={t}
        />
      ) : null}

      {showGitPickModal ? (
        <GitPickModal
          open={showGitPickModal}
          loading={loading}
          gitCandidates={gitCandidates}
          gitCandidateSelected={gitCandidateSelected}
          onRequestClose={handleCloseGitPick}
          onCancel={handleCancelGitPick}
          onToggleCandidate={handleToggleGitCandidate}
          onInstall={handleInstallSelectedCandidates}
          t={t}
        />
      ) : null}

      {updateAvailableVersion && (
        <div className="modal-backdrop" onClick={updateInstalling ? undefined : handleDismissUpdate}>
          <div
            className="modal update-modal"
            role="dialog"
            aria-modal="true"
            onClick={(e) => e.stopPropagation()}
          >
            {!updateInstalling && !updateDone && (
              <button
                className="modal-close update-modal-close"
                type="button"
                onClick={handleDismissUpdate}
                aria-label={t('close')}
              >
                ✕
              </button>
            )}
            <div className="update-modal-body">
              <div className="update-modal-title">
                {updateDone ? t('updateInstalledRestart') : t('updateAvailable')}
              </div>
              {!updateDone && (
                <div className="update-modal-text">
                  {t('updateBannerText', { version: updateAvailableVersion })}
                </div>
              )}
              {!updateDone && updateBody && (
                <div className="update-modal-notes">
                  <Markdown remarkPlugins={[remarkGfm]}>{updateBody}</Markdown>
                </div>
              )}
            </div>
            <div className="update-modal-actions">
              {updateDone ? (
                <button
                  className="btn btn-primary"
                  type="button"
                  onClick={handleDismissUpdate}
                >
                  {t('done')}
                </button>
              ) : (
                <>
                  <button
                    className="btn btn-primary"
                    type="button"
                    disabled={updateInstalling}
                    onClick={handleUpdateNow}
                  >
                    {updateInstalling ? t('installingUpdate') : t('updateNow')}
                  </button>
                  {!updateInstalling && (
                    <button
                      className="btn btn-secondary"
                      type="button"
                      onClick={handleDismissUpdateForever}
                    >
                      {t('updateBannerDismiss')}
                    </button>
                  )}
                </>
              )}
            </div>
          </div>
        </div>
      )}
      </div>
  )
}

export default App


================================================
FILE: src/components/Layout.tsx
================================================
import React from 'react';
import { Link, Outlet, useLocation } from 'react-router-dom';
import { Home, Settings, Box } from 'lucide-react';
import { clsx } from 'clsx';
import { useTranslation } from 'react-i18next';

const NavItem = ({ to, icon: Icon, label }: { to: string; icon: React.ElementType; label: string }) => {
  const location = useLocation();
  const isActive = location.pathname === to;
  
  return (
    <Link
      to={to}
      className={clsx(
        "flex items-center gap-3 px-3 py-2 rounded-md transition-colors",
        isActive 
          ? "bg-blue-600 text-white" 
          : "text-gray-400 hover:bg-gray-800 hover:text-white"
      )}
    >
      <Icon size={20} />
      <span>{label}</span>
    </Link>
  );
};

export const Layout = () => {
  const { t } = useTranslation();

  return (
    <div className="flex h-screen bg-gray-900 text-white">
      {/* Sidebar */}
      <aside className="w-64 border-r border-gray-800 flex flex-col p-4">
        <div className="flex items-center gap-2 mb-8 px-2">
          <div className="w-8 h-8 bg-blue-600 rounded-lg flex items-center justify-center">
            <Box className="text-white" size={20} />
          </div>
          <span className="font-bold text-xl">{t('appName')}</span>
        </div>
        
        <nav className="flex-1 space-y-1">
          <NavItem to="/" icon={Home} label={t('layout.navDashboard')} />
          <NavItem to="/skills" icon={Box} label={t('layout.navSkills')} />
          <NavItem to="/settings" icon={Settings} label={t('layout.navSettings')} />
        </nav>

        <div className="text-xs text-gray-600 px-2">
          {t('layout.versionLabel')}
        </div>
      </aside>

      {/* Main Content */}
      <main className="flex-1 overflow-auto bg-gray-950 p-6">
        <Outlet />
      </main>
    </div>
  );
};


================================================
FILE: src/components/skills/ExplorePage.tsx
================================================
import { memo, useMemo } from 'react'
import { Plus, Search, Star } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { FeaturedSkillDto, ManagedSkill, OnlineSkillDto } from './types'

type ExplorePageProps = {
  featuredSkills: FeaturedSkillDto[]
  featuredLoading: boolean
  exploreFilter: string
  searchResults: OnlineSkillDto[]
  searchLoading: boolean
  managedSkills: ManagedSkill[]
  loading: boolean
  onExploreFilterChange: (value: string) => void
  onInstallSkill: (sourceUrl: string, skillName?: string) => void
  onOpenManualAdd: () => void
  t: TFunction
}

function formatCount(n: number): string {
  if (n >= 1000000) return `${(n / 1000000).toFixed(1)}M`
  if (n >= 1000) return `${(n / 1000).toFixed(1)}K`
  return String(n)
}

const ExplorePage = ({
  featuredSkills,
  featuredLoading,
  exploreFilter,
  searchResults,
  searchLoading,
  managedSkills,
  loading,
  onExploreFilterChange,
  onInstallSkill,
  onOpenManualAdd,
  t,
}: ExplorePageProps) => {
  const filteredSkills = useMemo(() => {
    if (!exploreFilter.trim()) return featuredSkills
    const lower = exploreFilter.toLowerCase()
    return featuredSkills.filter(
      (s) =>
        s.name.toLowerCase().includes(lower) ||
        s.summary.toLowerCase().includes(lower),
    )
  }, [featuredSkills, exploreFilter])

  const deduplicatedResults = useMemo(() => {
    const featuredNames = new Set(filteredSkills.map((s) => s.name.toLowerCase()))
    return searchResults.filter((s) => !featuredNames.has(s.name.toLowerCase()))
  }, [searchResults, filteredSkills])

  const isSearchActive = exploreFilter.trim().length >= 2

  // Check if a skill is already installed by matching name + source (case-insensitive)
  const installedSkillKeys = useMemo(() => {
    const keys = new Set<string>()
    for (const skill of managedSkills) {
      const source = (skill.source_ref ?? '')
        .replace('https://github.com/', '')
        .replace(/\.git$/, '')
        .split('/tree/')[0]
        .toLowerCase()
      keys.add(`${skill.name.toLowerCase()}|${source}`)
    }
    return keys
  }, [managedSkills])

  const isInstalled = (skillName: string, source: string) => {
    const normalizedSource = source
      .replace('https://github.com/', '')
      .replace(/\.git$/, '')
      .split('/tree/')[0]
      .toLowerCase()
    return installedSkillKeys.has(`${skillName.toLowerCase()}|${normalizedSource}`)
  }

  return (
    <div className="explore-page">
      <div className="explore-hero">
        <div className="explore-search-row">
          <div className="explore-search-wrap">
            <Search size={16} className="explore-search-icon" />
            <input
              className="explore-search-input"
              placeholder={t('exploreFilterPlaceholder')}
              value={exploreFilter}
              onChange={(e) => onExploreFilterChange(e.target.value)}
            />
          </div>
          <button
            className="btn btn-secondary explore-manual-btn"
            type="button"
            onClick={onOpenManualAdd}
            disabled={loading}
          >
            <Plus size={15} />
            {t('manualAdd')}
          </button>
        </div>
        <div className="explore-source-label">
          {t('exploreSourceHint')}
        </div>
      </div>

      <div className="explore-scroll">
        {/* Featured section */}
        {featuredLoading ? (
          <div className="explore-loading">{t('exploreLoading')}</div>
        ) : (
          <>
            {isSearchActive && filteredSkills.length > 0 && (
              <div className="explore-section-title">{t('exploreFeaturedTitle')}</div>
            )}
            {filteredSkills.length > 0 ? (
              <div className="explore-grid">
                {filteredSkills.map((skill) => {
                  const installed = isInstalled(skill.name, skill.source_url)
                  return (
                    <div key={skill.slug} className="explore-card">
                      <div className="explore-card-top">
                        <div className="explore-card-info">
                          <div className="explore-card-name">{skill.name}</div>
                          <div className="explore-card-author">
                            {skill.source_url
                              .replace('https://github.com/', '')
                              .split('/tree/')[0]}
                          </div>
                        </div>
                        {installed ? (
                          <span className="explore-btn-installed">
                            {t('status.installed')}
                          </span>
                        ) : (
                          <button
                            className="explore-btn-install"
                            type="button"
                            disabled={loading}
                            onClick={() => onInstallSkill(skill.source_url)}
                          >
                            {t('install')}
                          </button>
                        )}
                      </div>
                      <div className="explore-card-desc">{skill.summary}</div>
                      <div className="explore-card-bottom">
                        <div className="explore-card-stats">
                          <span className="explore-stat">
                            <Star size={12} />
                            {formatCount(skill.stars)}
                          </span>
                        </div>
                      </div>
                    </div>
                  )
                })}
              </div>
            ) : !isSearchActive ? (
              <div className="explore-empty">{t('exploreEmpty')}</div>
            ) : null}

            {/* Online search results */}
            {isSearchActive && (
              <>
                <div className="explore-section-title">{t('exploreOnlineTitle')}</div>
                {searchLoading ? (
                  <div className="explore-loading">{t('searchLoading')}</div>
                ) : deduplicatedResults.length > 0 ? (
                  <div className="explore-grid">
                    {deduplicatedResults.map((skill) => {
                      const installed = isInstalled(skill.name, skill.source_url)
                      return (
                        <div key={skill.source} className="explore-card">
                          <div className="explore-card-top">
                            <div className="explore-card-info">
                              <div className="explore-card-name">{skill.name}</div>
                              <div className="explore-card-author">{skill.source}</div>
                            </div>
                            {installed ? (
                              <span className="explore-btn-installed">
                                {t('status.installed')}
                              </span>
                            ) : (
                              <button
                                className="explore-btn-install"
                                type="button"
                                disabled={loading}
                                onClick={() => onInstallSkill(skill.source_url, skill.name)}
                              >
                                {t('install')}
                              </button>
                            )}
                          </div>
                          <div className="explore-card-bottom">
                            <div className="explore-card-stats">
                              <span className="explore-stat">
                                {formatCount(skill.installs)} installs
                              </span>
                            </div>
                          </div>
                        </div>
                      )
                    })}
                  </div>
                ) : (
                  <div className="explore-empty">{t('searchEmpty')}</div>
                )}
              </>
            )}
          </>
        )}
      </div>
    </div>
  )
}

export default memo(ExplorePage)


================================================
FILE: src/components/skills/FilterBar.tsx
================================================
import { memo, useEffect, useMemo, useRef, useState } from 'react'
import { ArrowUpDown, Check, ChevronDown, Search, Tags } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { TagWithCountDto } from './types'

type FilterBarProps = {
  sortBy: 'updated' | 'name'
  searchQuery: string
  scopeFilter: 'all' | 'global' | 'project'
  tags: TagWithCountDto[]
  selectedTagIds: number[]
  includeUntagged: boolean
  untaggedCount: number
  totalCount: number
  onSortChange: (value: 'updated' | 'name') => void
  onSearchChange: (value: string) => void
  onScopeFilterChange: (value: 'all' | 'global' | 'project') => void
  onToggleTag: (tagId: number) => void
  onToggleUntagged: () => void
  onClearTags: () => void
  onManageTags: () => void
  t: TFunction
}

const FilterBar = ({
  sortBy,
  searchQuery,
  scopeFilter,
  tags,
  selectedTagIds,
  includeUntagged,
  untaggedCount,
  totalCount,
  onSortChange,
  onSearchChange,
  onScopeFilterChange,
  onToggleTag,
  onToggleUntagged,
  onClearTags,
  onManageTags,
  t,
}: FilterBarProps) => {
  const [tagMenuOpen, setTagMenuOpen] = useState(false)
  const [tagQuery, setTagQuery] = useState('')
  const tagMenuRef = useRef<HTMLDivElement | null>(null)
  const scopeOptions: { value: 'all' | 'global' | 'project'; label: string }[] = [
    { value: 'all', label: t('scope.all') },
    { value: 'global', label: t('scope.global') },
    { value: 'project', label: t('scope.project') },
  ]
  const selectedTagSet = useMemo(() => new Set(selectedTagIds), [selectedTagIds])
  const selectedCount = selectedTagIds.length + (includeUntagged ? 1 : 0)
  const filteredTags = useMemo(() => {
    const query = tagQuery.trim().toLowerCase()
    if (!query) return tags
    return tags.filter((tag) => tag.name.toLowerCase().includes(query))
  }, [tagQuery, tags])

  useEffect(() => {
    if (!tagMenuOpen) return
    const handlePointerDown = (event: MouseEvent) => {
      if (!tagMenuRef.current?.contains(event.target as Node)) {
        setTagMenuOpen(false)
      }
    }
    document.addEventListener('mousedown', handlePointerDown)
    return () => document.removeEventListener('mousedown', handlePointerDown)
  }, [tagMenuOpen])

  return (
    <div className="filter-bar">
      <div className="filter-title">
        {t('allSkills')}（{totalCount}）
      </div>
      <div className="filter-actions">
        <button className="btn btn-secondary sort-btn" type="button">
          {scopeOptions.find((option) => option.value === scopeFilter)?.label ?? t('scope.all')}
          <ChevronDown size={12} />
          <select
            aria-label={t('scope.filterLabel')}
            value={scopeFilter}
            onChange={(event) =>
              onScopeFilterChange(event.target.value as 'all' | 'global' | 'project')
            }
          >
            {scopeOptions.map((option) => (
              <option key={option.value} value={option.value}>
                {option.label}
              </option>
            ))}
          </select>
        </button>
        <button className="btn btn-secondary sort-btn" type="button">
          {sortBy === 'updated' ? t('sortUpdated') : t('sortName')}
          <ArrowUpDown size={12} />
          <select
            aria-label={t('filterSort')}
            value={sortBy}
            onChange={(event) => onSortChange(event.target.value as 'updated' | 'name')}
          >
            <option value="updated">{t('sortUpdated')}</option>
            <option value="name">{t('sortName')}</option>
          </select>
        </button>
        <div className="tag-filter-wrap" ref={tagMenuRef}>
          <button
            className={`btn btn-secondary tag-filter-btn${selectedCount > 0 ? ' active' : ''}`}
            type="button"
            onClick={() => setTagMenuOpen((open) => !open)}
          >
            <Tags size={14} />
            {selectedCount > 0
              ? t('tagsSelected', { count: selectedCount })
              : t('tags')}
            <ChevronDown size={12} />
          </button>
          {tagMenuOpen ? (
            <div className="tag-filter-menu">
              <div className="tag-filter-head">
                <span>{t('tags')}</span>
                <span>{t('matchAny')}</span>
              </div>
              <div className="tag-filter-search">
                <Search size={15} />
                <input
                  value={tagQuery}
                  onChange={(event) => setTagQuery(event.target.value)}
                  placeholder={t('searchTags')}
                />
              </div>
              <div className="tag-filter-options">
                <button
                  className={`tag-filter-option${includeUntagged ? ' selected' : ''}`}
                  type="button"
                  onClick={onToggleUntagged}
                >
                  <span className="tag-check">{includeUntagged ? <Check size={14} /> : null}</span>
                  <span>{t('untagged')}</span>
                  <span className="tag-count">{untaggedCount}</span>
                </button>
                {filteredTags.map((tag) => {
                  const selected = selectedTagSet.has(tag.id)
                  return (
                    <button
                      key={tag.id}
                      className={`tag-filter-option${selected ? ' selected' : ''}`}
                      type="button"
                      onClick={() => onToggleTag(tag.id)}
                    >
                      <span className="tag-check">{selected ? <Check size={14} /> : null}</span>
                      <span>{tag.name}</span>
                      <span className="tag-count">{tag.skill_count}</span>
                    </button>
                  )
                })}
              </div>
              <div className="tag-filter-footer">
                <button type="button" onClick={onClearTags} disabled={selectedCount === 0}>
                  {t('clearAll')}
                </button>
                <button type="button" onClick={onManageTags}>
                  {t('manageTags')}
                </button>
              </div>
            </div>
          ) : null}
        </div>
        <div className="search-container">
          <Search size={16} className="search-icon-abs" />
          <input
            className="search-input"
            value={searchQuery}
            onChange={(event) => onSearchChange(event.target.value)}
            placeholder={t('searchPlaceholder')}
          />
        </div>
      </div>
    </div>
  )
}

export default memo(FilterBar)


================================================
FILE: src/components/skills/Header.tsx
================================================
import { memo } from 'react'
import { Layers, Search, Settings, Tag } from 'lucide-react'
import type { TFunction } from 'i18next'

type HeaderProps = {
  language: string
  loading: boolean
  activeView: 'myskills' | 'explore' | 'detail' | 'settings' | 'tags'
  onToggleLanguage: () => void
  onOpenSettings: () => void
  onViewChange: (view: 'myskills' | 'explore' | 'tags') => void
  t: TFunction
}

const Header = ({
  language,
  activeView,
  onToggleLanguage,
  onOpenSettings,
  onViewChange,
  t,
}: HeaderProps) => {
  return (
    <header className="skills-header">
      <div className="header-left">
        <div className="brand-area">
          <img className="logo-icon" src="/logo.png" alt="" />
          <div className="brand-text-wrap">
            <div className="brand-text">{t('appName')}</div>
          </div>
        </div>
        <nav className="nav-tabs">
          <button
            className={`nav-tab${activeView === 'myskills' || activeView === 'detail' ? ' active' : ''}`}
            type="button"
            onClick={() => onViewChange('myskills')}
          >
            <Layers size={16} />
            {t('navMySkills')}
          </button>
          <button
            className={`nav-tab${activeView === 'explore' ? ' active' : ''}`}
            type="button"
            onClick={() => onViewChange('explore')}
          >
            <Search size={16} />
            {t('navExplore')}
          </button>
          <button
            className={`nav-tab${activeView === 'tags' ? ' active' : ''}`}
            type="button"
            onClick={() => onViewChange('tags')}
          >
            <Tag size={16} />
            {t('navTags')}
          </button>
        </nav>
      </div>
      <div className="header-actions">
        <button className="lang-btn" type="button" onClick={onToggleLanguage}>
          {language === 'en' ? t('languageShort.en') : t('languageShort.zh')}
        </button>
        <button className={`icon-btn${activeView === 'settings' ? ' active' : ''}`} type="button" onClick={onOpenSettings}>
          <Settings size={18} />
        </button>
      </div>
    </header>
  )
}

export default memo(Header)


================================================
FILE: src/components/skills/LoadingOverlay.tsx
================================================
import { memo } from 'react'
import type { TFunction } from 'i18next'

type LoadingOverlayProps = {
  loading: boolean
  actionMessage: string | null
  loadingStartAt: number | null
  onCancel?: () => void
  t: TFunction
}

const LoadingOverlay = ({
  loading,
  actionMessage,
  loadingStartAt,
  onCancel,
  t,
}: LoadingOverlayProps) => {
  if (!loading) return null

  return (
    <div className="modal-backdrop loading-backdrop">
      <div className="modal loading-modal" role="dialog" aria-modal="true">
        <div className="loading-content">
          <div className="loader-spinner" />
          <div className="loading-text">{t('processingTitle')}</div>
          <div className="loading-stage">
            {actionMessage ?? t('processingTipShort')}
          </div>
          {loadingStartAt ? (
            <div className="loading-subtext loading-subtext-delayed">
              {t('processingTipLong')}
            </div>
          ) : null}
          <div className="progress-bar">
            <div className="progress-fill" />
          </div>
          {onCancel ? (
            <button
              className="btn btn-secondary loading-cancel-btn"
              type="button"
              onClick={onCancel}
            >
              {t('cancel')}
            </button>
          ) : null}
        </div>
      </div>
    </div>
  )
}

export default memo(LoadingOverlay)


================================================
FILE: src/components/skills/SettingsPage.tsx
================================================
import { memo, useCallback, useEffect, useMemo, useRef, useState } from 'react'
import { ArrowLeft } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { Update } from '@tauri-apps/plugin-updater'

type UpdateStatus = 'idle' | 'checking' | 'up-to-date' | 'available' | 'downloading' | 'done' | 'error'

type SettingsPageProps = {
  isTauri: boolean
  language: string
  storagePath: string
  gitCacheCleanupDays: number
  gitCacheTtlSecs: number
  themePreference: 'system' | 'light' | 'dark'
  githubToken: string
  onPickStoragePath: () => void
  onToggleLanguage: () => void
  onThemeChange: (nextTheme: 'system' | 'light' | 'dark') => void
  onGitCacheCleanupDaysChange: (nextDays: number) => void
  onGitCacheTtlSecsChange: (nextSecs: number) => void
  onClearGitCacheNow: () => void
  onGithubTokenChange: (token: string) => void
  onBack: () => void
  t: TFunction
}

const SettingsPage = ({
  isTauri,
  language,
  storagePath,
  gitCacheCleanupDays,
  gitCacheTtlSecs,
  themePreference,
  onPickStoragePath,
  onToggleLanguage,
  onThemeChange,
  onGitCacheCleanupDaysChange,
  onGitCacheTtlSecsChange,
  onClearGitCacheNow,
  githubToken,
  onGithubTokenChange,
  onBack,
  t,
}: SettingsPageProps) => {
  const [localToken, setLocalToken] = useState(githubToken)
  useEffect(() => {
    setLocalToken(githubToken)
  }, [githubToken])

  const [updateStatus, setUpdateStatus] = useState<UpdateStatus>('idle')
  const [updateVersion, setUpdateVersion] = useState<string | null>(null)
  const [updateError, setUpdateError] = useState<string | null>(null)
  const updateRef = useRef<Update | null>(null)

  const handleCheckUpdate = useCallback(async () => {
    if (!isTauri) return
    setUpdateStatus('checking')
    setUpdateError(null)
    try {
      const { check } = await import('@tauri-apps/plugin-updater')
      const update = await check()
      if (update) {
        updateRef.current = update
        setUpdateVersion(update.version)
        setUpdateStatus('available')
      } else {
        setUpdateStatus('up-to-date')
      }
    } catch (err) {
      setUpdateError(err instanceof Error ? err.message : String(err))
      setUpdateStatus('error')
    }
  }, [isTauri])

  const handleInstallUpdate = useCallback(async () => {
    const update = updateRef.current
    if (!update) return
    setUpdateStatus('downloading')
    setUpdateError(null)
    try {
      await update.downloadAndInstall()
      setUpdateStatus('done')
    } catch (err) {
      setUpdateError(err instanceof Error ? err.message : String(err))
      setUpdateStatus('error')
    }
  }, [])

  const [appVersion, setAppVersion] = useState<string | null>(null)
  const versionText = useMemo(() => {
    if (!isTauri) return t('notAvailable')
    if (!appVersion) return t('unknown')
    return `v${appVersion}`
  }, [appVersion, isTauri, t])

  const loadAppVersion = useCallback(async () => {
    if (!isTauri) {
      setAppVersion(null)
      return
    }
    try {
      const { getVersion } = await import('@tauri-apps/api/app')
      const v = await getVersion()
      setAppVersion(v)
    } catch {
      setAppVersion(null)
    }
  }, [isTauri])

  useEffect(() => {
    void loadAppVersion()
    return () => { updateRef.current = null }
  }, [loadAppVersion])

  return (
    <div className="settings-page">
      <div className="detail-header">
        <button className="detail-back-btn" type="button" onClick={onBack}>
          <ArrowLeft size={16} />
          {t('detail.back')}
        </button>
        <div className="detail-skill-name">{t('settings')}</div>
      </div>
      <div className="settings-page-body">
        <div className="settings-field">
          <label className="settings-label" htmlFor="settings-language">
            {t('interfaceLanguage')}
          </label>
          <div className="settings-select-wrap">
            <select
              id="settings-language"
              className="settings-select"
              value={language}
              onChange={(event) => {
                if (event.target.value !== language) {
                  onToggleLanguage()
                }
              }}
            >
              <option value="en">{t('languageOptions.en')}</option>
              <option value="zh">{t('languageOptions.zh')}</option>
            </select>
            <svg
              className="settings-select-caret"
              viewBox="0 0 24 24"
              fill="none"
              stroke="currentColor"
              strokeWidth="2"
              aria-hidden="true"
            >
              <path d="M6 9l6 6 6-6" />
            </svg>
          </div>
        </div>

        <div className="settings-field">
          <label className="settings-label" id="settings-theme-label">
            {t('themeMode')}
          </label>
          <div className="settings-theme-options" role="group" aria-labelledby="settings-theme-label">
            <button
              type="button"
              className={`settings-theme-btn ${
                themePreference === 'system' ? 'active' : ''
              }`}
              aria-pressed={themePreference === 'system'}
              onClick={() => onThemeChange('system')}
            >
              {t('themeOptions.system')}
            </button>
            <button
              type="button"
              className={`settings-theme-btn ${
                themePreference === 'light' ? 'active' : ''
              }`}
              aria-pressed={themePreference === 'light'}
              onClick={() => onThemeChange('light')}
            >
              {t('themeOptions.light')}
            </button>
            <button
              type="button"
              className={`settings-theme-btn ${
                themePreference === 'dark' ? 'active' : ''
              }`}
              aria-pressed={themePreference === 'dark'}
              onClick={() => onThemeChange('dark')}
            >
              {t('themeOptions.dark')}
            </button>
          </div>
        </div>

        <div className="settings-field">
          <label className="settings-label" htmlFor="settings-storage">
            {t('skillsStoragePath')}
          </label>
          <div className="settings-input-row">
            <input
              id="settings-storage"
              className="settings-input mono"
              value={storagePath}
              readOnly
            />
            <button
              className="btn btn-secondary settings-browse"
              type="button"
              onClick={onPickStoragePath}
            >
              {t('browse')}
            </button>
          </div>
          <div className="settings-helper">{t('skillsStorageHint')}</div>
        </div>

        <div className="settings-field">
          <label className="settings-label" htmlFor="settings-git-cache-days">
            {t('gitCacheCleanupDays')}
          </label>
          <div className="settings-input-row">
            <input
              id="settings-git-cache-days"
              className="settings-input"
              type="number"
              min={0}
              max={3650}
              step={1}
              value={gitCacheCleanupDays}
              onChange={(event) => {
                const next = Number(event.target.value)
                if (!Number.isNaN(next)) {
                  onGitCacheCleanupDaysChange(next)
                }
              }}
            />
            <button
              className="btn btn-secondary settings-browse"
              type="button"
              onClick={onClearGitCacheNow}
            >
              {t('cleanNow')}
            </button>
          </div>
          <div className="settings-helper">{t('gitCacheCleanupHint')}</div>
        </div>

        <div className="settings-field">
          <label className="settings-label" htmlFor="settings-git-cache-ttl">
            {t('gitCacheTtlSecs')}
          </label>
          <div className="settings-input-row">
            <input
              id="settings-git-cache-ttl"
              className="settings-input"
              type="number"
              min={0}
              max={3600}
              step={1}
              value={gitCacheTtlSecs}
              onChange={(event) => {
                const next = Number(event.target.value)
                if (!Number.isNaN(next)) {
                  onGitCacheTtlSecsChange(next)
                }
              }}
            />
          </div>
          <div className="settings-helper">{t('gitCacheTtlHint')}</div>
        </div>

        <div className="settings-field">
          <label className="settings-label" htmlFor="settings-github-token">
            {t('githubToken')}
          </label>
          <div className="settings-input-row">
            <input
              id="settings-github-token"
              className="settings-input mono"
              type="password"
              placeholder={t('githubTokenPlaceholder')}
              value={localToken}
              onChange={(e) => setLocalToken(e.target.value)}
              onBlur={() => {
                if (localToken !== githubToken) {
                  onGithubTokenChange(localToken)
                }
              }}
            />
          </div>
          <div className="settings-helper">{t('githubTokenHint')}</div>
        </div>

        <div className="settings-field settings-update-section">
          <label className="settings-label">{t('appUpdates')}</label>
          <div className="settings-version-row">
            <span className="settings-version-text">
              {t('appName')} {versionText}
            </span>
            {isTauri && updateStatus === 'idle' && (
              <button
                className="btn btn-secondary btn-sm"
                type="button"
                onClick={handleCheckUpdate}
              >
                {t('checkForUpdates')}
              </button>
            )}
            {updateStatus === 'checking' && (
              <span className="settings-update-status">{t('checkingUpdates')}</span>
            )}
            {updateStatus === 'up-to-date' && (
              <span className="settings-update-status settings-update-ok">{t('updateNotAvailable')}</span>
            )}
          </div>
          {updateStatus === 'available' && (
            <div className="settings-update-available">
              <span>{t('updateAvailableWithVersion', { version: updateVersion })}</span>
              <button
                className="btn btn-primary btn-sm"
                type="button"
                onClick={handleInstallUpdate}
              >
                {t('downloadAndInstall')}
              </button>
            </div>
          )}
          {updateStatus === 'downloading' && (
            <div className="settings-update-status">{t('installingUpdate')}</div>
          )}
          {updateStatus === 'done' && (
            <div className="settings-update-ok">{t('updateInstalledRestart')}</div>
          )}
          {updateStatus === 'error' && (
            <div className="settings-update-error">
              <span>{updateError}</span>
              <button
                className="btn btn-secondary btn-sm"
                type="button"
                onClick={handleCheckUpdate}
              >
                {t('checkForUpdates')}
              </button>
            </div>
          )}
          <div className="settings-helper">{t('updateHint')}</div>
        </div>

      </div>
    </div>
  )
}

export default memo(SettingsPage)


================================================
FILE: src/components/skills/SkillCard.tsx
================================================
import { memo, useState } from 'react'
import { Box, Copy, Folder, Github, RefreshCw, Tag, Trash2 } from 'lucide-react'
import { toast } from 'sonner'
import type { TFunction } from 'i18next'
import type { ManagedSkill, ToolOption } from './types'

type GithubInfo = {
  label: string
  href: string
}

type SkillCardProps = {
  skill: ManagedSkill
  installedTools: ToolOption[]
  loading: boolean
  getGithubInfo: (url: string | null | undefined) => GithubInfo | null
  getSkillSourceLabel: (skill: ManagedSkill) => string
  formatRelative: (ms: number | null | undefined) => string
  onUpdate: (skill: ManagedSkill) => void
  onDelete: (skillId: string) => void
  onToggleTool: (skill: ManagedSkill, toolId: string) => void
  onOpenScope: (skill: ManagedSkill) => void
  onOpenDetail: (skill: ManagedSkill) => void
  onEditTags: (skill: ManagedSkill) => void
  getSkillScope: (skill: ManagedSkill) => 'global' | 'project'
  getSkillProjects: (skill: ManagedSkill) => string[]
  t: TFunction
}

const MAX_VISIBLE_BADGES = 5

const SkillCard = ({
  skill,
  installedTools,
  loading,
  getGithubInfo,
  getSkillSourceLabel,
  formatRelative,
  onUpdate,
  onDelete,
  onToggleTool,
  onOpenScope,
  onOpenDetail,
  onEditTags,
  getSkillScope,
  getSkillProjects,
  t,
}: SkillCardProps) => {
  const typeKey = skill.source_type.toLowerCase()
  const iconNode = typeKey.includes('git') ? (
    <Github size={20} />
  ) : typeKey.includes('local') ? (
    <Folder size={20} />
  ) : (
    <Box size={20} />
  )
  const github = getGithubInfo(skill.source_ref)
  const copyValue = (github?.href ?? skill.source_ref ?? '').trim()
  const skillScope = getSkillScope(skill)
  const projectCount = getSkillProjects(skill).length

  const handleCopy = async () => {
    if (!copyValue) return
    try {
      await navigator.clipboard.writeText(copyValue)
      toast.success(t('copied'))
    } catch {
      toast.error(t('copyFailed'))
    }
  }

  // Split tools into synced and remaining for badge display
  const syncedTools: { tool: ToolOption; target: (typeof skill.targets)[0] }[] = []
  const unsyncedTools: ToolOption[] = []
  for (const tool of installedTools) {
    const target = skill.targets.find(
      (tgt) => tgt.tool === tool.id && (tgt.scope ?? 'global') === skillScope,
    )
    if (target) {
      syncedTools.push({ tool, target })
    } else {
      unsyncedTools.push(tool)
    }
  }

  const [expanded, setExpanded] = useState(false)
  const needsCollapse = syncedTools.length > MAX_VISIBLE_BADGES
  const visibleSynced = expanded ? syncedTools : syncedTools.slice(0, MAX_VISIBLE_BADGES)
  const remainingCount = syncedTools.length - MAX_VISIBLE_BADGES
  const showUnsyncedTools = expanded || !needsCollapse

  return (
    <div className="skill-card">
      <div className="skill-icon">{iconNode}</div>
      <div className="skill-main">
        <div className="skill-header-row">
          <button
            type="button"
            className="skill-name clickable"
            onClick={() => onOpenDetail(skill)}
          >
            {skill.name}
          </button>
          {skill.tags.length > 0 ? (
            <div className="skill-tags-inline">
              {skill.tags.slice(0, 3).map((tag) => (
                <button
                  key={tag.id}
                  className="skill-tag-pill"
                  type="button"
                  onClick={() => onEditTags(skill)}
                >
                  #{tag.name}
                </button>
              ))}
              {skill.tags.length > 3 ? (
                <button
                  className="skill-tag-pill muted"
                  type="button"
                  onClick={() => onEditTags(skill)}
                >
                  +{skill.tags.length - 3}
                </button>
              ) : null}
            </div>
          ) : null}
        </div>
        {skill.description ? (
          <div className="skill-desc">{skill.description}</div>
        ) : null}
        <div className="skill-meta-row">
          {github ? (
            <div className="skill-source">
              <button
                className="repo-pill copyable"
                type="button"
                title={t('copy')}
                aria-label={t('copy')}
                onClick={() => void handleCopy()}
                disabled={!copyValue}
              >
                {github.label}
                <span className="copy-icon" aria-hidden="true">
                  <Copy size={12} />
                </span>
              </button>
            </div>
          ) : (
            <div className="skill-source">
              <button
                className="repo-pill copyable"
                type="button"
                title={t('copy')}
                aria-label={t('copy')}
                onClick={() => void handleCopy()}
                disabled={!copyValue}
              >
                <span className="mono">{getSkillSourceLabel(skill)}</span>
                <span className="copy-icon" aria-hidden="true">
                  <Copy size={12} />
                </span>
              </button>
            </div>
          )}
          <div className="skill-source time">
            <span className="dot">•</span>
            {formatRelative(skill.updated_at)}
          </div>
          <button
            className={`scope-badge ${skillScope}`}
            type="button"
            onClick={() => onOpenScope(skill)}
          >
            {skillScope === 'project'
              ? t('scope.projectCount', { count: projectCount })
              : t('scope.globalBadge')}
          </button>
        </div>
        <div className={`tool-matrix${!expanded && needsCollapse ? ' collapsed' : ''}`}>
          {visibleSynced.map(({ tool, target }) => (
            <button
              key={`${skill.id}-${tool.id}`}
              type="button"
              className="tool-pill active"
              title={`${tool.label} (${target.mode ?? t('unknown')})`}
              onClick={() => void onToggleTool(skill, tool.id)}
            >
              <span className="status-badge" />
              {tool.label}
            </button>
          ))}
          {needsCollapse && !expanded ? (
            <button
              type="button"
              className="tool-pill more-badge"
              onClick={() => setExpanded(true)}
            >
              {t('moreTools', { count: remainingCount })}
            </button>
          ) : null}
          {showUnsyncedTools &&
            unsyncedTools.map((tool) => {
              const disabled = false
              return (
                <button
                  key={`${skill.id}-${tool.id}`}
                  type="button"
                  className={`tool-pill ${disabled ? 'disabled' : 'inactive'}`}
                  title={tool.label}
                  onClick={() => {
                    if (!disabled) void onToggleTool(skill, tool.id)
                  }}
                  disabled={disabled}
                >
                  {tool.label}
                </button>
              )
            })}
        </div>
      </div>
      <div className="skill-actions-col">
        <button
          className={`card-btn tag-action${skill.tags.length > 0 ? ' has-tags' : ''}`}
          type="button"
          onClick={() => onEditTags(skill)}
          disabled={loading}
          aria-label={t('editTags')}
          title={t('editTags')}
        >
          <Tag size={16} />
        </button>
        <button
          className="card-btn primary-action"
          type="button"
          onClick={() => onUpdate(skill)}
          disabled={loading}
          aria-label={t('update')}
        >
          <RefreshCw size={16} />
        </button>
        <button
          className="card-btn danger-action"
          type="button"
          onClick={() => onDelete(skill.id)}
          disabled={loading}
          aria-label={t('remove')}
        >
          <Trash2 size={16} />
        </button>
      </div>
    </div>
  )
}

export default memo(SkillCard)


================================================
FILE: src/components/skills/SkillDetailView.tsx
================================================
import { memo, useCallback, useEffect, useMemo, useState } from 'react'
import {
  ArrowLeft,
  ChevronDown,
  ChevronRight,
  Clock,
  File,
  Folder,
  FolderOpen,
  GitBranch,
} from 'lucide-react'
import { Prism as SyntaxHighlighter } from 'react-syntax-highlighter'
import {
  oneLight,
  oneDark,
} from 'react-syntax-highlighter/dist/esm/styles/prism'
import Markdown from 'react-markdown'
import remarkFrontmatter from 'remark-frontmatter'
import remarkGfm from 'remark-gfm'
import { toast } from 'sonner'
import type { TFunction } from 'i18next'
import type { ManagedSkill, SkillFileEntry } from './types'

// ─── Types ───────────────────────────────────────────
type SkillDetailViewProps = {
  skill: ManagedSkill
  onBack: () => void
  invokeTauri: <T>(command: string, args?: Record<string, unknown>) => Promise<T>
  formatRelative: (ms: number | null | undefined) => string
  t: TFunction
}

type TreeNode = {
  name: string
  path: string // full relative path for files, folder prefix for dirs
  isDir: boolean
  size: number
  children: TreeNode[]
}

// ─── Helpers ─────────────────────────────────────────
function formatSize(bytes: number): string {
  if (bytes < 1024) return `${bytes} B`
  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`
}

const EXT_LANG: Record<string, string> = {
  ts: 'typescript',
  tsx: 'tsx',
  js: 'javascript',
  jsx: 'jsx',
  py: 'python',
  rs: 'rust',
  go: 'go',
  rb: 'ruby',
  java: 'java',
  kt: 'kotlin',
  swift: 'swift',
  c: 'c',
  cpp: 'cpp',
  h: 'c',
  hpp: 'cpp',
  cs: 'csharp',
  css: 'css',
  scss: 'scss',
  less: 'less',
  html: 'html',
  xml: 'xml',
  json: 'json',
  yaml: 'yaml',
  yml: 'yaml',
  toml: 'toml',
  sh: 'bash',
  bash: 'bash',
  zsh: 'bash',
  sql: 'sql',
  graphql: 'graphql',
  dockerfile: 'docker',
  lua: 'lua',
  r: 'r',
  dart: 'dart',
  php: 'php',
  pl: 'perl',
  ex: 'elixir',
  exs: 'elixir',
  erl: 'erlang',
  hs: 'haskell',
  vim: 'vim',
  ini: 'ini',
  cfg: 'ini',
  diff: 'diff',
  patch: 'diff',
}

function getLang(filename: string): string {
  const lower = filename.toLowerCase()
  if (lower === 'dockerfile' || lower.startsWith('dockerfile.')) return 'docker'
  if (lower === 'makefile' || lower === 'gnumakefile') return 'makefile'
  const ext = lower.split('.').pop() ?? ''
  return EXT_LANG[ext] ?? ''
}

function isMarkdown(filename: string): boolean {
  return /\.(md|mdx|markdown)$/i.test(filename)
}

/** Build a tree from flat file paths */
function buildTree(files: SkillFileEntry[]): TreeNode[] {
  const root: TreeNode[] = []

  for (const f of files) {
    const parts = f.path.split('/')
    let current = root
    for (let i = 0; i < parts.length; i++) {
      const name = parts[i]
      const isLast = i === parts.length - 1
      if (isLast) {
        current.push({
          name,
          path: f.path,
          isDir: false,
          size: f.size,
          children: [],
        })
      } else {
        let dir = current.find((n) => n.isDir && n.name === name)
        if (!dir) {
          dir = {
            name,
            path: parts.slice(0, i + 1).join('/'),
            isDir: true,
            size: 0,
            children: [],
          }
          current.push(dir)
        }
        current = dir.children
      }
    }
  }

  // Sort: dirs first (alphabetical), then files (SKILL.md first, then alphabetical)
  const sortNodes = (nodes: TreeNode[]) => {
    nodes.sort((a, b) => {
      if (a.isDir !== b.isDir) return a.isDir ? -1 : 1
      if (!a.isDir && !b.isDir) {
        const aSkill = a.name.toLowerCase() === 'skill.md'
        const bSkill = b.name.toLowerCase() === 'skill.md'
        if (aSkill !== bSkill) return aSkill ? -1 : 1
      }
      return a.name.localeCompare(b.name)
    })
    for (const n of nodes) {
      if (n.isDir) sortNodes(n.children)
    }
  }
  sortNodes(root)
  return root
}

// ─── FileTreeNode component ─────────────────────────
type FileTreeNodeProps = {
  node: TreeNode
  depth: number
  activeFile: string | null
  expanded: Set<string>
  onToggleDir: (path: string) => void
  onSelectFile: (path: string) => void
}

const FileTreeNode = memo(
  ({
    node,
    depth,
    activeFile,
    expanded,
    onToggleDir,
    onSelectFile,
  }: FileTreeNodeProps) => {
    if (node.isDir) {
      const isOpen = expanded.has(node.path)
      return (
        <>
          <button
            type="button"
            className="tree-item tree-dir"
            style={{ paddingLeft: 12 + depth * 16 }}
            onClick={() => onToggleDir(node.path)}
          >
            <span className="tree-chevron">
              {isOpen ? <ChevronDown size={14} /> : <ChevronRight size={14} />}
            </span>
            {isOpen ? (
              <FolderOpen size={14} className="tree-icon tree-icon-folder" />
            ) : (
              <Folder size={14} className="tree-icon tree-icon-folder" />
            )}
            <span className="tree-name">{node.name}</span>
          </button>
          {isOpen
            ? node.children.map((child) => (
                <FileTreeNode
                  key={child.path}
                  node={child}
                  depth={depth + 1}
                  activeFile={activeFile}
                  expanded={expanded}
                  onToggleDir={onToggleDir}
                  onSelectFile={onSelectFile}
                />
              ))
            : null}
        </>
      )
    }

    return (
      <button
        type="button"
        className={`tree-item tree-file${activeFile === node.path ? ' active' : ''}`}
        style={{ paddingLeft: 12 + depth * 16 + 18 }}
        onClick={() => onSelectFile(node.path)}
      >
        <File size={14} className="tree-icon tree-icon-file" />
        <span className="tree-name">{node.name}</span>
        <span className="tree-size">{formatSize(node.size)}</span>
      </button>
    )
  },
)
FileTreeNode.displayName = 'FileTreeNode'

// ─── FileContent renderer ────────────────────────────
type FileContentRendererProps = {
  filename: string
  content: string
  isDark: boolean
}

function parseFrontmatter(raw: string): {
  meta: Record<string, string> | null
  body: string
} {
  if (!raw.startsWith('---')) return { meta: null, body: raw }
  const end = raw.indexOf('\n---', 3)
  if (end === -1) return { meta: null, body: raw }
  const block = raw.slice(4, end)
  const entries: Record<string, string> = {}
  const lines = block.split('\n')
  for (let i = 0; i < lines.length; i++) {
    const line = lines[i]
    const idx = line.indexOf(':')
    if (idx === -1) continue
    const key = line.slice(0, idx).trim()
    let val = line.slice(idx + 1).trim()
    const blockStyle = val.match(/^([>|])[-+]?$/)?.[1]
    if (blockStyle) {
      const blockLines: string[] = []
      while (i + 1 < lines.length) {
        const next = lines[i + 1]
        if (next.trim() !== '' && !/^\s/.test(next)) break
        blockLines.push(next.replace(/^\s{2}/, ''))
        i++
      }
      val =
        blockStyle === '|'
          ? blockLines.join('\n').trim()
          : blockLines.map((v) => v.trim()).filter(Boolean).join(' ')
    }
    // strip surrounding quotes
    if (
      val.length >= 2 &&
      ((val[0] === '"' && val[val.length - 1] === '"') ||
        (val[0] === "'" && val[val.length - 1] === "'"))
    ) {
      val = val.slice(1, -1)
    }
    if (key) entries[key] = val
  }
  const keys = Object.keys(entries)
  if (keys.length === 0) return { meta: null, body: raw }
  const body = raw.slice(end + 4).replace(/^\n+/, '')
  return { meta: entries, body }
}

const FileContentRenderer = memo(
  ({ filename, content, isDark }: FileContentRendererProps) => {
    if (isMarkdown(filename)) {
      const { meta, body } = parseFrontmatter(content)
      return (
        <div className="markdown-body">
          {meta && (
            <dl className="frontmatter-meta">
              {Object.entries(meta).map(([key, value]) => (
                <div
                  className="frontmatter-meta-item"
                  data-key={key}
                  key={key}
                >
                  <dt>{key}</dt>
                  <dd>{value}</dd>
                </div>
              ))}
            </dl>
          )}
          <Markdown
            remarkPlugins={[remarkFrontmatter, remarkGfm]}
            components={{
              code: ({ className, children, ...rest }) => {
                const match = /language-(\w+)/.exec(className ?? '')
                const inline = !match
                if (inline) {
                  return (
                    <code className="md-inline-code" {...rest}>
                      {children}
                    </code>
                  )
                }
                return (
                  <SyntaxHighlighter
                    style={isDark ? oneDark : oneLight}
                    language={match[1]}
                    PreTag="div"
                    customStyle={{
                      margin: 0,
                      borderRadius: 6,
                      fontSize: 13,
                    }}
                  >
                    {String(children).replace(/\n$/, '')}
                  </SyntaxHighlighter>
                )
              },
            }}
          >
            {body}
          </Markdown>
        </div>
      )
    }

    const lang = getLang(filename)
    if (lang) {
      return (
        <SyntaxHighlighter
          style={isDark ? oneDark : oneLight}
          language={lang}
          showLineNumbers
          lineNumberStyle={{
            minWidth: '3em',
            paddingRight: '1em',
            color: isDark ? '#636d83' : '#9ca3af',
            userSelect: 'none',
          }}
          customStyle={{
            margin: 0,
            padding: '16px 0',
            background: 'transparent',
            fontSize: 13,
            lineHeight: 1.7,
          }}
        >
          {content}
        </SyntaxHighlighter>
      )
    }

    // Plain text with line numbers
    return (
      <SyntaxHighlighter
        style={isDark ? oneDark : oneLight}
        language="text"
        showLineNumbers
        lineNumberStyle={{
          minWidth: '3em',
          paddingRight: '1em',
          color: isDark ? '#636d83' : '#9ca3af',
          userSelect: 'none',
        }}
        customStyle={{
          margin: 0,
          padding: '16px 0',
          background: 'transparent',
          fontSize: 13,
          lineHeight: 1.7,
        }}
      >
        {content}
      </SyntaxHighlighter>
    )
  },
)
FileContentRenderer.displayName = 'FileContentRenderer'

// ─── Main component ──────────────────────────────────
const SkillDetailView = ({
  skill,
  onBack,
  invokeTauri,
  formatRelative,
  t,
}: SkillDetailViewProps) => {
  const [files, setFiles] = useState<SkillFileEntry[]>([])
  const [activeFile, setActiveFile] = useState<string | null>(null)
  const [fileContent, setFileContent] = useState('')
  const [loadingFiles, setLoadingFiles] = useState(true)
  const [loadingContent, setLoadingContent] = useState(false)
  const [expanded, setExpanded] = useState<Set<string>>(new Set())

  const isDark =
    document.documentElement.getAttribute('data-theme') === 'dark'

  const tree = useMemo(() => buildTree(files), [files])

  useEffect(() => {
    let cancelled = false
    const load = async () => {
      setLoadingFiles(true)
      try {
        const result = await invokeTauri<SkillFileEntry[]>('list_skill_files', {
          centralPath: skill.central_path,
        })
        if (cancelled) return
        setFiles(result)
        // Start with all folders collapsed
        setExpanded(new Set())
        if (result.length > 0) {
          setActiveFile(result[0].path)
        }
      } catch {
        if (!cancelled) {
          toast.error(t('detail.readError'))
        }
      } finally {
        if (!cancelled) setLoadingFiles(false)
      }
    }
    void load()
    return () => {
      cancelled = true
    }
  }, [invokeTauri, skill.central_path, t])

  useEffect(() => {
    if (!activeFile) return
    let cancelled = false
    const load = async () => {
      setLoadingContent(true)
      try {
        const content = await invokeTauri<string>('read_skill_file', {
          centralPath: skill.central_path,
          filePath: activeFile,
        })
        if (!cancelled) setFileContent(content)
      } catch (err) {
        if (!cancelled) {
          const msg = err instanceof Error ? err.message : String(err)
          setFileContent(msg)
        }
      } finally {
        if (!cancelled) setLoadingContent(false)
      }
    }
    void load()
    return () => {
      cancelled = true
    }
  }, [activeFile, invokeTauri, skill.central_path])

  const handleSelectFile = useCallback((path: string) => {
    setActiveFile(path)
  }, [])

  const handleToggleDir = useCallback((path: string) => {
    setExpanded((prev) => {
      const next = new Set(prev)
      if (next.has(path)) {
        next.delete(path)
      } else {
        next.add(path)
      }
      return next
    })
  }, [])

  const sourceLabel =
    skill.source_type.toLowerCase().includes('git')
      ? skill.source_ref?.replace(/^https?:\/\/(www\.)?github\.com\//, '') ?? ''
      : skill.source_ref ?? ''

  const SourceIcon = skill.source_type.toLowerCase().includes('git')
    ? GitBranch
    : Folder

  return (
    <div className="detail-view">
      <div className="detail-header">
        <button className="detail-back-btn" type="button" onClick={onBack}>
          <ArrowLeft size={16} />
          {t('detail.back')}
        </button>
        <div className="detail-skill-name">{skill.name}</div>
        {skill.description ? (
          <div className="detail-desc">{skill.description}</div>
        ) : null}
        <div className="detail-meta">
          {sourceLabel ? (
            <span className="detail-meta-item">
              <SourceIcon size={13} />
              {sourceLabel}
            </span>
          ) : null}
          {sourceLabel ? (
            <span className="detail-meta-dot">&middot;</span>
          ) : null}
          <span className="detail-meta-item">
            <Clock size={13} />
            {formatRelative(skill.updated_at)}
          </span>
          <span className="detail-meta-dot">&middot;</span>
          <span className="detail-meta-item">
            <File size={13} />
            {t('detail.fileCount', { count: files.length })}
          </span>
        </div>
      </div>

      <div className="detail-body">
        <div className="detail-file-list">
          <div className="file-list-title">{t('detail.files')}</div>
          {loadingFiles ? (
            <div className="detail-loading">
              <div className="detail-spinner" />
              {t('detail.loadingFiles')}
            </div>
          ) : files.length === 0 ? (
            <div className="detail-loading">{t('detail.noFiles')}</div>
          ) : (
            <div className="file-tree">
              {tree.map((node) => (
                <FileTreeNode
                  key={node.path}
                  node={node}
                  depth={0}
                  activeFile={activeFile}
                  expanded={expanded}
                  onToggleDir={handleToggleDir}
                  onSelectFile={handleSelectFile}
                />
              ))}
            </div>
          )}
        </div>

        <div className="detail-file-content">
          {activeFile ? (
            <>
              <div className="file-content-header">
                <span className="file-content-path">
                  <File size={14} />
                  {activeFile}
                </span>
                <span className="file-content-size">
                  {formatSize(
                    files.find((f) => f.path === activeFile)?.size ?? 0,
                  )}
                </span>
              </div>
              {loadingContent ? (
                <div className="detail-loading" style={{ height: 200 }}>
                  <div className="detail-spinner" />
                  {t('detail.loadingContent')}
                </div>
              ) : (
                <div className="file-content-body">
                  <FileContentRenderer
                    filename={activeFile}
                    content={fileContent}
                    isDark={isDark}
                  />
                </div>
              )}
            </>
          ) : (
            <div className="detail-loading" style={{ height: 200 }}>
              {loadingFiles ? t('detail.loadingFiles') : t('detail.noFiles')}
            </div>
          )}
        </div>
      </div>
    </div>
  )
}

export default memo(SkillDetailView)


================================================
FILE: src/components/skills/SkillsList.tsx
================================================
import { memo } from 'react'
import { MessageCircle } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { ManagedSkill, OnboardingPlan, ToolOption } from './types'
import SkillCard from './SkillCard'

type GithubInfo = {
  label: string
  href: string
}

type SkillsListProps = {
  plan: OnboardingPlan | null
  visibleSkills: ManagedSkill[]
  installedTools: ToolOption[]
  loading: boolean
  getGithubInfo: (url: string | null | undefined) => GithubInfo | null
  getSkillSourceLabel: (skill: ManagedSkill) => string
  formatRelative: (ms: number | null | undefined) => string
  onReviewImport: () => void
  onUpdateSkill: (skill: ManagedSkill) => void
  onDeleteSkill: (skillId: string) => void
  onToggleTool: (skill: ManagedSkill, toolId: string) => void
  onOpenScope: (skill: ManagedSkill) => void
  onOpenDetail: (skill: ManagedSkill) => void
  onEditTags: (skill: ManagedSkill) => void
  getSkillScope: (skill: ManagedSkill) => 'global' | 'project'
  getSkillProjects: (skill: ManagedSkill) => string[]
  t: TFunction
}

const SkillsList = ({
  plan,
  visibleSkills,
  installedTools,
  loading,
  getGithubInfo,
  getSkillSourceLabel,
  formatRelative,
  onReviewImport,
  onUpdateSkill,
  onDeleteSkill,
  onToggleTool,
  onOpenScope,
  onOpenDetail,
  onEditTags,
  getSkillScope,
  getSkillProjects,
  t,
}: SkillsListProps) => {
  return (
    <div className="skills-list">
      {plan && plan.total_skills_found > 0 ? (
        <div className="discovered-banner">
          <div className="banner-left">
            <div className="banner-icon">
              <MessageCircle size={18} />
            </div>
            <div className="banner-content">
              <div className="banner-title">{t('discoveredTitle')}</div>
              <div className="banner-subtitle">
                {t('discoveredCount', { count: plan.total_skills_found })}
              </div>
            </div>
          </div>
          <button
            className="btn btn-warning"
            type="button"
            onClick={onReviewImport}
            disabled={loading}
          >
            {t('reviewImport')}
          </button>
        </div>
      ) : null}

      {visibleSkills.length === 0 ? (
        <div className="empty">{t('skillsEmpty')}</div>
      ) : (
        <>
          {visibleSkills.map((skill) => (
            <SkillCard
              key={skill.id}
              skill={skill}
              installedTools={installedTools}
              loading={loading}
              getGithubInfo={getGithubInfo}
              getSkillSourceLabel={getSkillSourceLabel}
              formatRelative={formatRelative}
              onUpdate={onUpdateSkill}
              onDelete={onDeleteSkill}
              onToggleTool={onToggleTool}
              onOpenScope={onOpenScope}
              onOpenDetail={onOpenDetail}
              onEditTags={onEditTags}
              getSkillScope={getSkillScope}
              getSkillProjects={getSkillProjects}
              t={t}
            />
          ))}
        </>
      )}
    </div>
  )
}

export default memo(SkillsList)


================================================
FILE: src/components/skills/TagsPage.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { ArrowLeft, Plus, Search, Tag } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { TagWithCountDto } from './types'

type TagsPageProps = {
  tags: TagWithCountDto[]
  untaggedCount: number
  loading: boolean
  formatRelative: (ms: number | null | undefined) => string
  onBack: () => void
  onReviewUntagged: () => void
  onViewTag: (tagId: number) => void
  onCreateTag: (name: string) => void
  onRenameTag: (tagId: number, name: string) => void
  onDeleteTag: (tag: TagWithCountDto) => void
  t: TFunction
}

const TagsPage = ({
  tags,
  untaggedCount,
  loading,
  formatRelative,
  onBack,
  onReviewUntagged,
  onViewTag,
  onCreateTag,
  onRenameTag,
  onDeleteTag,
  t,
}: TagsPageProps) => {
  const [query, setQuery] = useState('')
  const [newTagName, setNewTagName] = useState('')
  const filteredTags = useMemo(() => {
    const normalized = query.trim().toLowerCase()
    if (!normalized) return tags
    return tags.filter((tag) => tag.name.toLowerCase().includes(normalized))
  }, [query, tags])

  const submitNewTag = () => {
    const name = newTagName.trim()
    if (!name) return
    onCreateTag(name)
    setNewTagName('')
  }

  return (
    <div className="tags-page">
      <div className="detail-header">
        <button className="btn btn-secondary" type="button" onClick={onBack}>
          <ArrowLeft size={16} />
          {t('back')}
        </button>
        <div>
          <div className="detail-skill-name">{t('tags')}</div>
          <div className="tags-page-subtitle">{t('tagsHelp')}</div>
        </div>
      </div>

      <div className="tags-review-row">
        <div className="tags-review-left">
          <Tag size={16} />
          <span>{t('untaggedSkillsCount', { count: untaggedCount })}</span>
        </div>
        <button
          className="btn btn-secondary"
          type="button"
          onClick={onReviewUntagged}
          disabled={untaggedCount === 0}
        >
          {t('review')}
        </button>
      </div>

      <div className="tags-toolbar">
        <div className="search-container tags-search">
          <Search size={16} className="search-icon-abs" />
          <input
            className="search-input"
            value={query}
            onChange={(event) => setQuery(event.target.value)}
            placeholder={t('searchTags')}
          />
        </div>
        <div className="tags-new-row">
          <input
            className="search-input"
            value={newTagName}
            onChange={(event) => setNewTagName(event.target.value)}
            onKeyDown={(event) => {
              if (event.key === 'Enter') submitNewTag()
            }}
            placeholder={t('newTagPlaceholder')}
          />
          <button
            className="btn btn-primary"
            type="button"
            onClick={submitNewTag}
            disabled={loading || !newTagName.trim()}
          >
            <Plus size={14} />
            {t('newTag')}
          </button>
        </div>
      </div>

      <div className="tags-table">
        <div className="tags-table-row tags-table-head">
          <span>{t('tagName')}</span>
          <span>{t('skills')}</span>
          <span>{t('lastUsed')}</span>
          <span>{t('actionsLabel')}</span>
        </div>
        {filteredTags.length === 0 ? (
          <div className="empty">{t('tagsEmpty')}</div>
        ) : (
          filteredTags.map((tag) => (
            <div className="tags-table-row" key={tag.id}>
              <span className="tags-table-name">#{tag.name}</span>
              <span>{tag.skill_count}</span>
              <span>{formatRelative(tag.updated_at)}</span>
              <span className="tags-table-actions">
                <button type="button" onClick={() => onViewTag(tag.id)}>
                  {t('view')}
                </button>
                <button
                  type="button"
                  onClick={() => {
                    const nextName = window.prompt(t('renameTagPrompt'), tag.name)
                    if (nextName?.trim()) onRenameTag(tag.id, nextName)
                  }}
                >
                  {t('rename')}
                </button>
                <button type="button" onClick={() => onDeleteTag(tag)}>
                  {t('deleteAction')}
                </button>
              </span>
            </div>
          ))
        )}
      </div>
    </div>
  )
}

export default memo(TagsPage)


================================================
FILE: src/components/skills/modals/AddSkillModal.tsx
================================================
import { memo } from 'react'
import { Check } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { TagWithCountDto, ToolOption, ToolStatusDto } from '../types'

type AddSkillModalProps = {
  open: boolean
  loading: boolean
  canClose: boolean
  addModalTab: 'local' | 'git'
  localPath: string
  localName: string
  gitUrl: string
  gitName: string
  tags: TagWithCountDto[]
  selectedTagIds: number[]
  syncTargets: Record<string, boolean>
  installedTools: ToolOption[]
  toolStatus: ToolStatusDto | null
  onRequestClose: () => void
  onTabChange: (tab: 'local' | 'git') => void
  onLocalPathChange: (value: string) => void
  onPickLocalPath: () => void
  onLocalNameChange: (value: string) => void
  onGitUrlChange: (value: string) => void
  onGitNameChange: (value: string) => void
  onToggleTag: (tagId: number) => void
  onSyncTargetChange: (toolId: string, checked: boolean) => void
  onSubmit: () => void
  t: TFunction
}

const AddSkillModal = ({
  open,
  loading,
  canClose,
  addModalTab,
  localPath,
  localName,
  gitUrl,
  gitName,
  tags,
  selectedTagIds,
  syncTargets,
  installedTools,
  toolStatus,
  onRequestClose,
  onTabChange,
  onLocalPathChange,
  onPickLocalPath,
  onLocalNameChange,
  onGitUrlChange,
  onGitNameChange,
  onToggleTag,
  onSyncTargetChange,
  onSubmit,
  t,
}: AddSkillModalProps) => {
  if (!open) return null

  return (
    <div
      className="modal-backdrop"
      onClick={() => (canClose ? onRequestClose() : null)}
    >
      <div className="modal" onClick={(e) => e.stopPropagation()}>
        <div className="modal-header">
          <div className="modal-title">{t('addSkillTitle')}</div>
          <button
            className="modal-close"
            type="button"
            onClick={onRequestClose}
            aria-label={t('close')}
            disabled={!canClose}
          >
            ✕
          </button>
        </div>
        <div className="modal-body">
          <div className="tabs">
            <button
              className={`tab-item${addModalTab === 'local' ? ' active' : ''}`}
              type="button"
              onClick={() => onTabChange('local')}
            >
              {t('localTab')}
            </button>
            <button
              className={`tab-item${addModalTab === 'git' ? ' active' : ''}`}
              type="button"
              onClick={() => onTabChange('git')}
            >
              {t('gitTab')}
            </button>
          </div>

          {addModalTab === 'local' ? (
            <>
              <div className="form-group">
                <label className="label">{t('localFolder')}</label>
                <div className="input-row">
                  <input
                    className="input"
                    placeholder={t('localPathPlaceholder')}
                    value={localPath}
                    onChange={(event) => onLocalPathChange(event.target.value)}
                  />
                  <button
                    className="btn btn-secondary input-action"
                    type="button"
                    onClick={onPickLocalPath}
                    disabled={!canClose}
                  >
                    {t('browse')}
                  </button>
                </div>
              </div>
              <div className="form-group">
                <label className="label">{t('optionalNamePlaceholder')}</label>
                <input
                  className="input"
                  placeholder={t('optionalNamePlaceholder')}
                  value={localName}
                  onChange={(event) => onLocalNameChange(event.target.value)}
                />
              </div>
            </>
          ) : (
            <>
              <div className="form-group">
                <label className="label">{t('repositoryUrl')}</label>
                <input
                  className="input"
                  placeholder={t('gitUrlPlaceholder')}
                  value={gitUrl}
                  onChange={(event) => onGitUrlChange(event.target.value)}
                />
              </div>
              <div className="form-group">
                <label className="label">{t('optionalNamePlaceholder')}</label>
                <input
                  className="input"
                  placeholder={t('optionalNamePlaceholder')}
                  value={gitName}
                  onChange={(event) => onGitNameChange(event.target.value)}
                />
              </div>
            </>
          )}

          <div className="form-group">
            <label className="label">{t('addTags')}</label>
            {tags.length > 0 ? (
              <div className="add-tags-list">
                {tags.map((tag) => {
                  const selected = selectedTagIds.includes(tag.id)
                  return (
                    <button
                      key={tag.id}
                      className={`add-tag-pill${selected ? ' selected' : ''}`}
                      type="button"
                      onClick={() => onToggleTag(tag.id)}
                    >
                      <span className="add-tag-check">
                        {selected ? <Check size={12} /> : null}
                      </span>
                      <span>#{tag.name}</span>
                    </button>
                  )
                })}
              </div>
            ) : (
              <div className="helper-text">{t('noTagsYet')}</div>
            )}
          </div>

          <div className="form-group">
            <label className="label">{t('installToTools')}</label>
            {toolStatus ? (
              <div className="tool-matrix">
                {installedTools.map((tool) => (
                  <label
                    key={tool.id}
                    className={`tool-pill-toggle${
                      syncTargets[tool.id] ? ' active' : ''
                    }`}
                  >
                    <input
                      type="checkbox"
                      checked={Boolean(syncTargets[tool.id])}
                      onChange={(event) =>
                        onSyncTargetChange(tool.id, event.target.checked)
                      }
                    />
                    {syncTargets[tool.id] ? <span className="status-badge" /> : null}
                    {tool.label}
                  </label>
                ))}
              </div>
            ) : (
              <div className="helper-text">{t('detectingTools')}</div>
            )}
            <div className="helper-text">{t('syncAfterCreate')}</div>
          </div>
        </div>
        <div className="modal-footer">
          <button
            className="btn btn-secondary"
            onClick={onRequestClose}
            disabled={!canClose}
          >
            {t('cancel')}
          </button>
          <button
            className="btn btn-primary"
            onClick={onSubmit}
            disabled={loading}
          >
            {addModalTab === 'local' ? t('create') : t('install')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(AddSkillModal)


================================================
FILE: src/components/skills/modals/DeleteModal.tsx
================================================
import { memo } from 'react'
import { TriangleAlert } from 'lucide-react'
import type { TFunction } from 'i18next'

type DeleteModalProps = {
  open: boolean
  loading: boolean
  skillName: string | null
  onRequestClose: () => void
  onConfirm: () => void
  t: TFunction
}

const DeleteModal = ({
  open,
  loading,
  skillName,
  onRequestClose,
  onConfirm,
  t,
}: DeleteModalProps) => {
  if (!open) return null

  return (
    <div className="modal-backdrop" onClick={onRequestClose}>
      <div
        className="modal modal-delete"
        onClick={(e) => e.stopPropagation()}
        role="dialog"
        aria-modal="true"
      >
        <div className="modal-body delete-body">
          <div className="delete-title">
            <TriangleAlert size={20} />
            {t('deleteTitle')}
          </div>
          <div className="delete-desc">
            {skillName ? (
              <>
                {t('delete.confirmPrefix')}
                <strong>{skillName}</strong>
                {t('delete.confirmSuffix')}
              </>
            ) : (
              t('deleteBody')
            )}
          </div>
          <div className="delete-warning">
            <ul>
              <li>{t('delete.warningRemoveFromTools')}</li>
              <li>{t('delete.warningDeleteFromHub')}</li>
            </ul>
          </div>
        </div>
        <div className="modal-footer space-between">
          <button
            className="btn btn-secondary"
            onClick={onRequestClose}
            disabled={loading}
          >
            {t('cancel')}
          </button>
          <button
            className="btn btn-danger-solid"
            onClick={onConfirm}
            disabled={loading}
          >
            {t('delete.confirmButton')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(DeleteModal)


================================================
FILE: src/components/skills/modals/EditSkillTagsModal.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { Check, Search } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { ManagedSkill, TagWithCountDto } from '../types'

type EditSkillTagsModalProps = {
  open: boolean
  loading: boolean
  skill: ManagedSkill | null
  tags: TagWithCountDto[]
  onRequestClose: () => void
  onSave: (skill: ManagedSkill, tagIds: number[]) => void
  t: TFunction
}

const EditSkillTagsModal = ({
  open,
  loading,
  skill,
  tags,
  onRequestClose,
  onSave,
  t,
}: EditSkillTagsModalProps) => {
  const [query, setQuery] = useState('')
  const [selectedIds, setSelectedIds] = useState<number[]>(
    () => skill?.tags.map((tag) => tag.id) ?? [],
  )
  const selectedSet = useMemo(() => new Set(selectedIds), [selectedIds])
  const filteredTags = useMemo(() => {
    const normalized = query.trim().toLowerCase()
    if (!normalized) return tags
    return tags.filter((tag) => tag.name.toLowerCase().includes(normalized))
  }, [query, tags])

  if (!open || !skill) return null

  const toggleTag = (tagId: number) => {
    setSelectedIds((current) =>
      current.includes(tagId)
        ? current.filter((id) => id !== tagId)
        : [...current, tagId],
    )
  }

  return (
    <div className="modal-backdrop" onClick={loading ? undefined : onRequestClose}>
      <div className="modal edit-tags-modal" onClick={(event) => event.stopPropagation()}>
        <div className="modal-header">
          <div>
            <div className="modal-title">{t('editTagsTitle', { name: skill.name })}</div>
            <div className="modal-subtitle">{t('editTagsHelp')}</div>
          </div>
          <button className="modal-close" type="button" onClick={onRequestClose}>
            ×
          </button>
        </div>
        <div className="tag-filter-search edit-tags-search">
          <Search size={15} />
          <input
            value={query}
            onChange={(event) => setQuery(event.target.value)}
            placeholder={t('searchTags')}
          />
        </div>
        <div className="edit-tags-list">
          {filteredTags.length === 0 ? (
            <div className="empty">{t('tagsEmpty')}</div>
          ) : (
            filteredTags.map((tag) => {
              const selected = selectedSet.has(tag.id)
              return (
                <button
                  key={tag.id}
                  className={`tag-filter-option${selected ? ' selected' : ''}`}
                  type="button"
                  onClick={() => toggleTag(tag.id)}
                >
                  <span className="tag-check">{selected ? <Check size={14} /> : null}</span>
                  <span>{tag.name}</span>
                  <span className="tag-count">{tag.skill_count}</span>
                </button>
              )
            })
          )}
        </div>
        <div className="modal-actions">
          <button className="btn btn-secondary" type="button" onClick={onRequestClose}>
            {t('cancel')}
          </button>
          <button
            className="btn btn-primary"
            type="button"
            disabled={loading}
            onClick={() => onSave(skill, selectedIds)}
          >
            {t('done')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(EditSkillTagsModal)


================================================
FILE: src/components/skills/modals/GitPickModal.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { Search } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { GitSkillCandidate } from '../types'

type GitPickModalProps = {
  open: boolean
  loading: boolean
  gitCandidates: GitSkillCandidate[]
  gitCandidateSelected: Record<string, boolean>
  onRequestClose: () => void
  onCancel: () => void
  onToggleCandidate: (subpath: string, checked: boolean) => void
  onInstall: () => void
  t: TFunction
}

const GitPickModal = ({
  open,
  loading,
  gitCandidates,
  gitCandidateSelected,
  onRequestClose,
  onCancel,
  onToggleCandidate,
  onInstall,
  t,
}: GitPickModalProps) => {
  const [query, setQuery] = useState('')
  const normalizedQuery = query.trim().toLowerCase()
  const filteredCandidates = useMemo(() => {
    if (!normalizedQuery) return gitCandidates
    return gitCandidates.filter((c) =>
      [c.name, c.description ?? '', c.subpath].some((value) =>
        value.toLowerCase().includes(normalizedQuery),
      ),
    )
  }, [gitCandidates, normalizedQuery])
  const selectedCount = filteredCandidates.filter(
    (c) => gitCandidateSelected[c.subpath],
  ).length
  const allVisibleSelected =
    filteredCandidates.length > 0 &&
    filteredCandidates.every((c) => gitCandidateSelected[c.subpath])

  const toggleVisibleCandidates = (checked: boolean) => {
    filteredCandidates.forEach((c) => onToggleCandidate(c.subpath, checked))
  }

  if (!open) return null

  return (
    <div className="modal-backdrop" onClick={onRequestClose}>
      <div className="modal" onClick={(e) => e.stopPropagation()}>
        <div className="modal-header">
          <div className="modal-title">{t('gitPickTitle')}</div>
          <button
            className="modal-close"
            type="button"
            onClick={onRequestClose}
            aria-label={t('close')}
          >
            ✕
          </button>
        </div>
        <div className="modal-body">
          <p className="label">{t('gitPickBody')}</p>
          <div className="pick-search">
            <Search size={16} className="search-icon-abs" />
            <input
              className="search-input"
              value={query}
              onChange={(event) => setQuery(event.target.value)}
              placeholder={t('pickSearchPlaceholder')}
            />
          </div>
          <div className="pick-toolbar">
            <label className="inline-checkbox">
              <input
                type="checkbox"
                checked={allVisibleSelected}
                onChange={(e) => toggleVisibleCandidates(e.target.checked)}
                disabled={filteredCandidates.length === 0}
              />
              {t('selectAll')}
            </label>
            <span className="pick-toolbar-count">
              {t('selectedCount', {
                selected: selectedCount,
                total: filteredCandidates.length,
              })}
            </span>
          </div>
          <div className="pick-list">
            {filteredCandidates.length === 0 ? (
              <div className="empty">{t('pickSearchEmpty')}</div>
            ) : null}
            {filteredCandidates.map((c) => (
              <div className="pick-item" key={c.subpath}>
                <label className="pick-item-checkbox">
                  <input
                    type="checkbox"
                    checked={Boolean(gitCandidateSelected[c.subpath])}
                    onChange={(e) => onToggleCandidate(c.subpath, e.target.checked)}
                  />
                </label>
                <div className="pick-item-main">
                  <div className="pick-item-title">{c.name}</div>
                  {c.description ? (
                    <div className="pick-item-desc">{c.description}</div>
                  ) : null}
                  <div className="pick-item-path">{c.subpath}</div>
                </div>
              </div>
            ))}
          </div>
        </div>
        <div className="modal-footer">
          <button className="btn btn-secondary" onClick={onCancel} disabled={loading}>
            {t('cancel')}
          </button>
          <button className="btn btn-primary" onClick={onInstall} disabled={loading}>
            {t('installSelected')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(GitPickModal)


================================================
FILE: src/components/skills/modals/ImportModal.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { Download, Search } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { OnboardingPlan } from '../types'

type ImportModalProps = {
  open: boolean
  loading: boolean
  plan: OnboardingPlan
  selected: Record<string, boolean>
  variantChoice: Record<string, string>
  onRequestClose: () => void
  onToggleGroup: (groupName: string, checked: boolean) => void
  onSelectVariant: (groupName: string, path: string) => void
  onImport: () => void
  t: TFunction
}

const ImportModal = ({
  open,
  loading,
  plan,
  selected,
  variantChoice,
  onRequestClose,
  onToggleGroup,
  onSelectVariant,
  onImport,
  t,
}: ImportModalProps) => {
  const [query, setQuery] = useState('')
  const normalizedQuery = query.trim().toLowerCase()
  const filteredGroups = useMemo(() => {
    if (!normalizedQuery) return plan.groups
    return plan.groups.filter((group) => {
      const fields = [
        group.name,
        ...group.variants.flatMap((variant) => [variant.path, variant.tool]),
      ]
      return fields.some((value) => value.toLowerCase().includes(normalizedQuery))
    })
  }, [normalizedQuery, plan.groups])
  const selectedCount = filteredGroups.filter((group) => selected[group.name]).length
  const allVisibleSelected =
    filteredGroups.length > 0 &&
    filteredGroups.every((group) => selected[group.name])

  const toggleVisibleGroups = (checked: boolean) => {
    filteredGroups.forEach((group) => onToggleGroup(group.name, checked))
  }

  if (!open) return null

  return (
    <div className="modal-backdrop" onClick={onRequestClose}>
      <div
        className="modal modal-lg modal-discovered"
        onClick={(e) => e.stopPropagation()}
      >
        <div className="modal-header">
          <div className="modal-title">{t('importTitle')}</div>
          <button
            className="modal-close"
            type="button"
            onClick={onRequestClose}
            aria-label={t('close')}
          >
            ✕
          </button>
        </div>
        <div className="modal-body">
          <div className="import-summary">
            <div>{t('importSummary')}</div>
            <div className="import-metrics">
              <span>{t('toolsScanned', { count: plan.total_tools_scanned })}</span>
              <span>{t('skillsFound', { count: plan.total_skills_found })}</span>
            </div>
          </div>
          <div className="search-container import-search">
            <Search size={16} className="search-icon-abs" />
            <input
              className="search-input"
              value={query}
              onChange={(event) => setQuery(event.target.value)}
              placeholder={t('searchPlaceholder')}
            />
          </div>
          <div className="sync-row">
            <label className="inline-checkbox">
              <input
                type="checkbox"
                checked={allVisibleSelected}
                onChange={(event) => toggleVisibleGroups(event.target.checked)}
                disabled={filteredGroups.length === 0}
              />
              {t('selectAll')}
            </label>
            <span className="pick-toolbar-count">
              {t('selectedCount', {
                selected: selectedCount,
                total: filteredGroups.length,
              })}
            </span>
          </div>
          <div className="groups discovered-list">
            {filteredGroups.length === 0 ? (
              <div className="empty">{t('importSearchEmpty')}</div>
            ) : null}
            {filteredGroups.map((group) => (
              <div className="group-card" key={group.name}>
                <div className="group-title">
                  <label className="group-select">
                    <input
                      type="checkbox"
                      checked={Boolean(selected[group.name])}
                      onChange={(event) =>
                        onToggleGroup(group.name, event.target.checked)
                      }
                    />
                    <span>{group.name}</span>
                  </label>
                  {group.has_conflict ? (
                    <span className="badge danger">{t('conflict')}</span>
                  ) : (
                    <span className="badge">{t('consistent')}</span>
                  )}
                </div>
                <div className="group-variants">
                  {group.variants.map((variant) => (
                    <div
                      className="variant-row"
                      key={`${group.name}-${variant.tool}-${variant.path}`}
                    >
                      {group.has_conflict ? (
                        <input
                          type="radio"
                          name={`variant-${group.name}`}
                          checked={variantChoice[group.name] === variant.path}
                          onChange={() => onSelectVariant(group.name, variant.path)}
                        />
                      ) : (
                        <span className="variant-spacer" />
                      )}
                      <div className="variant-info">
                        <span className="path">{variant.path}</span>
                        <span className="found-pill">
                          {t('foundIn')} {variant.tool}
                        </span>
                      </div>
                      {variant.is_link ? (
                        <span className="meta">
                          {t('linkLabel', {
                            target: variant.link_target ?? t('unknown'),
                          })}
                        </span>
                      ) : (
                        <span className="meta">{t('directory')}</span>
                      )}
                    </div>
                  ))}
                </div>
              </div>
            ))}
          </div>
        </div>
        <div className="modal-footer">
          <button
            className="btn btn-primary"
            onClick={onImport}
            disabled={loading || selectedCount === 0}
          >
            <Download size={14} />
            {t('importAndSync')}
          </button>
          <button
            className="btn btn-secondary"
            onClick={onRequestClose}
            disabled={loading}
          >
            {t('close')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(ImportModal)


================================================
FILE: src/components/skills/modals/LocalPickModal.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { Search } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { LocalSkillCandidate } from '../types'

type LocalPickModalProps = {
  open: boolean
  loading: boolean
  localCandidates: LocalSkillCandidate[]
  localCandidateSelected: Record<string, boolean>
  onRequestClose: () => void
  onCancel: () => void
  onToggleCandidate: (subpath: string, checked: boolean) => void
  onInstall: () => void
  t: TFunction
}

const LocalPickModal = ({
  open,
  loading,
  localCandidates,
  localCandidateSelected,
  onRequestClose,
  onCancel,
  onToggleCandidate,
  onInstall,
  t,
}: LocalPickModalProps) => {
  const [query, setQuery] = useState('')
  const normalizedQuery = query.trim().toLowerCase()
  const filteredCandidates = useMemo(() => {
    if (!normalizedQuery) return localCandidates
    return localCandidates.filter((c) =>
      [c.name, c.description ?? '', c.subpath].some((value) =>
        value.toLowerCase().includes(normalizedQuery),
      ),
    )
  }, [localCandidates, normalizedQuery])
  const selectableCandidates = filteredCandidates.filter((c) => c.valid)
  const selectedCount = selectableCandidates.filter(
    (c) => localCandidateSelected[c.subpath],
  ).length
  const selectableCount = selectableCandidates.length
  const allVisibleSelected =
    selectableCount > 0 &&
    selectableCandidates.every((c) => localCandidateSelected[c.subpath])

  const toggleVisibleCandidates = (checked: boolean) => {
    selectableCandidates.forEach((c) => onToggleCandidate(c.subpath, checked))
  }

  if (!open) return null

  const mapReason = (code?: string | null) => {
    if (!code) return t('localSkillInvalid.unknown')
    if (code === 'missing_skill_md') return t('localSkillInvalid.missingSkillMd')
    if (code === 'invalid_frontmatter') return t('localSkillInvalid.invalidFrontmatter')
    if (code === 'missing_name') return t('localSkillInvalid.missingName')
    if (code === 'read_failed') return t('localSkillInvalid.readFailed')
    return t('localSkillInvalid.unknown')
  }

  return (
    <div className="modal-backdrop" onClick={onRequestClose}>
      <div className="modal" onClick={(e) => e.stopPropagation()}>
        <div className="modal-header">
          <div className="modal-title">{t('localPickTitle')}</div>
          <button
            className="modal-close"
            type="button"
            onClick={onRequestClose}
            aria-label={t('close')}
          >
            ✕
          </button>
        </div>
        <div className="modal-body">
          <p className="label">{t('localPickBody')}</p>
          <div className="pick-search">
            <Search size={16} className="search-icon-abs" />
            <input
              className="search-input"
              value={query}
              onChange={(event) => setQuery(event.target.value)}
              placeholder={t('pickSearchPlaceholder')}
            />
          </div>
          <div className="pick-toolbar">
            <label className="inline-checkbox">
              <input
                type="checkbox"
                checked={allVisibleSelected}
                onChange={(e) => toggleVisibleCandidates(e.target.checked)}
                disabled={selectableCount === 0}
              />
              {t('selectAll')}
            </label>
            <span className="pick-toolbar-count">
              {t('selectedCount', {
                selected: selectedCount,
                total: selectableCount,
              })}
            </span>
          </div>
          <div className="pick-list">
            {filteredCandidates.length === 0 ? (
              <div className="empty">{t('pickSearchEmpty')}</div>
            ) : null}
            {filteredCandidates.map((c) => (
              <div
                className={`pick-item${c.valid ? '' : ' disabled'}`}
                key={c.subpath}
              >
                <label className="pick-item-checkbox">
                  <input
                    type="checkbox"
                    checked={Boolean(localCandidateSelected[c.subpath])}
                    onChange={(e) => onToggleCandidate(c.subpath, e.target.checked)}
                    disabled={!c.valid}
                  />
                </label>
                <div className="pick-item-main">
                  <div className="pick-item-title">{c.name}</div>
                  {c.description ? (
                    <div className="pick-item-desc">{c.description}</div>
                  ) : null}
                  <div className="pick-item-path">{c.subpath}</div>
                  {!c.valid ? (
                    <div className="pick-item-reason">
                      {t('localPickInvalidReason', { reason: mapReason(c.reason) })}
                    </div>
                  ) : null}
                </div>
              </div>
            ))}
          </div>
        </div>
        <div className="modal-footer">
          <button className="btn btn-secondary" onClick={onCancel} disabled={loading}>
            {t('cancel')}
          </button>
          <button className="btn btn-primary" onClick={onInstall} disabled={loading}>
            {t('installSelected')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(LocalPickModal)


================================================
FILE: src/components/skills/modals/NewToolsModal.tsx
================================================
import { memo } from 'react'
import type { TFunction } from 'i18next'

type NewToolsModalProps = {
  open: boolean
  loading: boolean
  toolsLabelText: string
  onLater: () => void
  onSyncAll: () => void
  t: TFunction
}

const NewToolsModal = ({
  open,
  loading,
  toolsLabelText,
  onLater,
  onSyncAll,
  t,
}: NewToolsModalProps) => {
  if (!open) return null

  return (
    <div className="modal-backdrop" onClick={onLater}>
      <div className="modal" onClick={(e) => e.stopPropagation()} role="dialog" aria-modal="true">
        <div className="modal-header">
          <div className="modal-title">{t('newToolsTitle')}</div>
        </div>
        <div className="modal-body">
          {t('newToolsBody', {
            tools: toolsLabelText,
          })}
        </div>
        <div className="modal-footer">
          <button className="btn btn-secondary" onClick={onLater} disabled={loading}>
            {t('later')}
          </button>
          <button className="btn btn-primary" onClick={onSyncAll} disabled={loading}>
            {t('syncAll')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(NewToolsModal)


================================================
FILE: src/components/skills/modals/ScopeSyncModal.tsx
================================================
import { memo, useMemo, useState } from 'react'
import { Folder, X } from 'lucide-react'
import type { TFunction } from 'i18next'
import type { ManagedSkill } from '../types'

type ScopeSyncModalProps = {
  open: boolean
  loading: boolean
  skill: ManagedSkill | null
  scope: 'global' | 'project'
  projects: string[]
  recentProjects: string[]
  onRequestClose: () => void
  onScopeChange: (scope: 'global' | 'project', projects: string[]) => void
  onPickProject: () => Promise<string | undefined>
  t: TFunction
}

const ScopeSyncModal = ({
  open,
  loading,
  skill,
  scope,
  projects,
  recentProjects,
  onRequestClose,
  onScopeChange,
  onPickProject,
  t,
}: ScopeSyncModalProps) => {
  const [draftScope, setDraftScope] = useState<'global' | 'project'>(scope)
  const [draftProjects, setDraftProjects] = useState<string[]>(projects)

  const normalizedProjects = useMemo(
    () => Array.from(new Set(projects.filter(Boolean))),
    [projects],
  )
  const normalizedDraftProjects = useMemo(
    () => Array.from(new Set(draftProjects.filter(Boolean))),
    [draftProjects],
  )
  const projectListChanged =
    normalizedProjects.length !== normalizedDraftProjects.length ||
    normalizedProjects.some((item) => !normalizedDraftProjects.includes(item))
  const availableRecent = recentProjects.filter(
    (item) => !normalizedDraftProjects.includes(item),
  )
  const hasScopeChange = draftScope !== scope
  const requiresProject = draftScope === 'project' && normalizedDraftProjects.length === 0
  const addDraftProject = (projectPath: string) => {
    setDraftProjects((prev) => Array.from(new Set([...prev, projectPath].filter(Boolean))))
  }

  if (!open || !skill) return null

  return (
    <div className="modal-backdrop" onClick={loading ? undefined : onRequestClose}>
      <div
        className="modal scope-modal"
        role="dialog"
        aria-modal="true"
        onClick={(event) => event.stopPropagation()}
      >
        <div className="modal-header">
          <div className="modal-title">
            {t('projectSync.title')} · {skill.name}
          </div>
          <button
            className="modal-close"
            type="button"
            onClick={onRequestClose}
            disabled={loading}
            aria-label={t('close')}
          >
            ✕
          </button>
        </div>
        <div className="modal-body scope-modal-body">
          <div className="scope-help">{t('projectSync.help')}</div>
          <label className={`scope-choice${draftScope === 'global' ? ' active' : ''}`}>
            <input
              type="radio"
              checked={draftScope === 'global'}
              onChange={() => setDraftScope('global')}
              disabled={loading}
            />
            <span>
              <strong>{t('scope.global')}</strong>
              <small>{t('projectSync.globalDesc')}</small>
            </span>
          </label>
          <label className={`scope-choice${draftScope === 'project' ? ' active' : ''}`}>
            <input
              type="radio"
              checked={draftScope === 'project'}
              onChange={() => setDraftScope('project')}
              disabled={loading}
            />
            <span>
              <strong>{t('scope.project')}</strong>
              <small>{t('projectSync.projectDesc')}</small>
            </span>
          </label>

          {draftScope === 'project' ? (
            <div className="project-sync-panel">
              <div className="project-sync-heading">{t('projectSync.projectDirs')}</div>
              {normalizedDraftProjects.length > 0 ? (
                <div className="project-path-list">
                  {normalizedDraftProjects.map((project) => (
                    <div className="project-path-row" key={project}>
                      <Folder size={14} />
                      <span className="mono">{project}</span>
                      <button
                        type="button"
                        className="icon-btn"
                        onClick={() =>
                          setDraftProjects((prev) => prev.filter((item) => item !== project))
                        }
                        disabled={loading}
                        aria-label={t('remove')}
                      >
                        <X size={14} />
                      </button>
                    </div>
                  ))}
                </div>
              ) : (
                <div className="project-empty">{t('projectSync.noProjects')}</div>
              )}
              {requiresProject ? (
                <div className="scope-inline-warning">
                  {t('projectSync.projectRequired')}
                </div>
              ) : null}
              <button
                type="button"
                className="btn btn-secondary"
                onClick={() => {
                  void onPickProject().then((projectPath) => {
                    if (projectPath) addDraftProject(projectPath)
                  })
                }}
                disabled={loading}
              >
                {t('projectSync.addProject')}
              </button>

              {availableRecent.length > 0 ? (
                <>
                  <div className="project-sync-heading">{t('projectSync.recentProjects')}</div>
                  <div className="recent-project-list">
                    {availableRecent.map((project) => (
                      <button
                        key={project}
                        type="button"
                        className="recent-project-row"
                        onClick={() => addDraftProject(project)}
                        disabled={loading}
                      >
                        <span className="mono">{project}</span>
                        <span>{t('projectSync.addRecent')}</span>
                      </button>
                    ))}
                  </div>
                </>
              ) : null}
            </div>
          ) : null}
        </div>
        <div className="modal-footer">
          <button
            className="btn btn-secondary"
            type="button"
            onClick={onRequestClose}
            disabled={loading}
          >
            {t('cancel')}
          </button>
          <button
            className="btn btn-primary"
            type="button"
            onClick={() => onScopeChange(draftScope, normalizedDraftProjects)}
            disabled={loading || (!hasScopeChange && !projectListChanged) || requiresProject}
          >
            {t('projectSync.applyScope')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(ScopeSyncModal)


================================================
FILE: src/components/skills/modals/SharedDirModal.tsx
================================================
import { memo } from 'react'
import type { TFunction } from 'i18next'

type SharedDirModalProps = {
  open: boolean
  loading: boolean
  toolLabel: string
  otherLabels: string
  onRequestClose: () => void
  onConfirm: () => void
  t: TFunction
}

const SharedDirModal = ({
  open,
  loading,
  toolLabel,
  otherLabels,
  onRequestClose,
  onConfirm,
  t,
}: SharedDirModalProps) => {
  if (!open) return null

  return (
    <div className="modal-backdrop" onClick={onRequestClose}>
      <div
        className="modal"
        onClick={(e) => e.stopPropagation()}
        role="dialog"
        aria-modal="true"
      >
        <div className="modal-header">
          <div className="modal-title">{t('appName')}</div>
        </div>
        <div className="modal-body">
          {t('sharedDirConfirm', {
            tool: toolLabel,
            others: otherLabels,
          })}
        </div>
        <div className="modal-footer">
          <button
            className="btn btn-secondary"
            onClick={onRequestClose}
            disabled={loading}
          >
            {t('cancel')}
          </button>
          <button className="btn btn-primary" onClick={onConfirm} disabled={loading}>
            {t('confirm')}
          </button>
        </div>
      </div>
    </div>
  )
}

export default memo(SharedDirModal)


================================================
FILE: src/components/skills/types.ts
================================================
export type OnboardingVariant = {
  tool: string
  name: string
  path: string
  fingerprint?: string | null
  is_link: boolean
  link_target?: string | null
}

export type OnboardingGroup = {
  name: string
  variants: OnboardingVariant[]
  has_conflict: boolean
}

export type OnboardingPlan = {
  total_tools_scanned: number
  total_skills_found: number
  groups: OnboardingGroup[]
}

export type ToolOption = {
  id: string
  label: string
  supports_project_scope?: boolean
}

export type TagDto = {
  id: number
  name: string
}

export type TagWithCountDto = TagDto & {
  skill_count: number
  updated_at: number
}

export type ManagedSkill = {
  id: string
  name: string
  description?: string | null
  source_type: string
  source_ref?: string | null
  central_path: string
  created_at: number
  updated_at: number
  last_sync_at?: number | null
  status: string
  tags: TagDto[]
  targets: {
    tool: string
    scope: 'global' | 'project' | string
    project_path?: string | null
    mode: string
    status: string
    target_path: string
    synced_at?: number | null
  }[]
}

export type GitSkillCandidate = {
  name: string
  description?: string | null
  subpath: string
}

export type LocalSkillCandidate = {
  name: string
  description?: string | null
  subpath: string
  valid: boolean
  reason?: string | null
}

export type InstallResultDto = {
  skill_id: string
  name: string
  central_path: string
  content_hash?: string | null
}

export type ToolInfoDto = {
  key: string
  label: string
  installed: boolean
  skills_dir: string
  supports_project_scope: boolean
}

export type ToolStatusDto = {
  tools: ToolInfoDto[]
  installed: string[]
  newly_installed: string[]
}

export type UpdateResultDto = {
  skill_id: string
  name: string
  content_hash?: string | null
  source_revision?: string | null
  updated_targets: string[]
}

export type FeaturedSkillDto = {
  slug: string
  name: string
  summary: string
  downloads: number
  stars: number
  source_url: string
}

export type OnlineSkillDto = {
  name: string
  installs: number
  source: string
  source_url: string
}

export type SkillFileEntry = {
  path: string
  size: number
}


================================================
FILE: src/i18n/index.ts
================================================
import i18n from 'i18next'
import { initReactI18next } from 'react-i18next'
import { resources } from './resources'

const languageStorageKey = 'skills-language'

const getStoredLanguage = () => {
  if (typeof window === 'undefined') return null
  try {
    const stored = window.localStorage.getItem(languageStorageKey)
    if (stored === 'en' || stored === 'zh') return stored
  } catch {
    // ignore storage failures
  }
  return null
}

void i18n.use(initReactI18next).init({
  resources,
  lng: getStoredLanguage() ?? 'en',
  fallbackLng: 'en',
  interpolation: {
    escapeValue: false,
  },
})

export default i18n


================================================
FILE: src/i18n/resources.ts
================================================
export const resources = {
  en: {
    translation: {
      appName: 'Skills Hub',
      unknown: 'unknown',
      languageShort: {
        en: 'EN',
        zh: '中文',
      },
      languageOptions: {
        en: 'English',
        zh: '中文',
      },
      subtitle: 'Manage and sync your skills across tools',
      navMySkills: 'My Skills',
      navExplore: 'Explore',
      navTags: 'Tags',
      newSkill: 'New Skill',
      manualAdd: 'Manual',
      manualAddHint: 'Have a Git URL or local path? Click <b>Manual</b> to add directly',
      moreTools: '+{{count}} more',
      installSuccess: '"{{name}}" installed and synced to {{count}} tools',
      settings: 'Settings',
      language: 'Language',
      interfaceLanguage: 'Interface Language',
      themeMode: 'Appearance',
      themeOptions: {
        system: 'System',
        light: 'Light',
        dark: 'Dark',
      },
      filterSort: 'Sort',
      allSkills: 'All Skills',
      scope: {
        all: 'All',
        global: 'Global',
        project: 'Project',
        filterLabel: 'Scope filter',
        globalBadge: 'Global',
        projectCount: '{{count}} projects',
      },
      projectSync: {
        title: 'Sync Scope',
        help: 'Choose where this Skill is available.',
        globalDesc: 'Available in all projects',
        projectDesc: 'Available only in selected projects',
        projectDirs: 'Project directories',
        addProject: 'Select project directory...',
        selectProjectTitle: 'Select project directory',
        recentProjects: 'Recent',
        addRecent: 'Add',
        noProjects: 'No project directories selected.',
        projectRequired: 'Select at least one project directory to apply project scope.',
        noProjectsForSync: 'Select at least one project directory before syncing.',
        unsupportedTool: '{{tool}} does not support project scope.',
        inlineGlobalClear:
          'Applying this will remove existing global links, then sync this skill to all currently installed tools in the selected project directories.',
        inlineProjectClear:
          'Applying this will remove existing project links, then sync this skill globally to all currently installed tools.',
        applyScope: 'Apply',
        confirmBody: 'The following global links will be removed:',
        confirmBodyProject: 'The following project links will be removed:',
      },
      sortUpdated: 'Most recent',
      sortName: 'Name A–Z',
      searchPlaceholder: 'Search skills...',
      tags: 'Tags',
      tagsSelected: 'Tags: {{count}} selected',
      matchAny: 'Match any',
      searchTags: 'Search tags...',
      untagged: 'Untagged',
      noTags: 'No tags',
      editTags: 'Edit tags',
      clearAll: 'Clear all',
      manageTags: 'Manage Tags...',
      tagsHelp: 'Tags help you filter and organize skills. They do not change sync results.',
      untaggedSkillsCount: '{{count}} skills have no tags',
      review: 'Review',
      newTag: 'New Tag',
      newTagPlaceholder: 'New tag name',
      tagName: 'Tag name',
      skills: 'Skills',
      lastUsed: 'Last used',
      actionsLabel: 'Actions',
      view: 'View',
      rename: 'Rename',
      deleteAction: 'Delete',
      tagsEmpty: 'No tags found.',
      renameTagPrompt: 'Rename tag',
      deleteTagTitle: 'Delete tag?',
      deleteTagConfirm:
        'Delete "{{name}}" from {{count}} skills?\nThis only removes the tag, not the skills.',
      editTagsTitle: 'Edit Tags: {{name}}',
      editTagsHelp: 'Choose the labels used to find this skill.',
      tagCreated: 'Tag created.',
      tagRenamed: 'Tag renamed.',
      tagDeleted: 'Tag deleted.',
      tagsUpdated: 'Tags updated.',
      tagsApplyFailed: 'Failed to apply tags to "{{name}}".',
      back: 'Back',
      discoveredTitle: 'Discovered skills',
      discoveredEmpty: 'Scan your tools to find existing skills to import.',
      discoveredCount: 'Found {{count}} skills ready for review.',
      reviewImport: 'Review & Import',
      scanNow: 'Scan now',
      skillsTitle: 'Managed skills',
      skillsEmpty: 'No managed skills yet.',
      toolsLabel: 'Tools',
      activeTools: 'Active Tools',
      sourceLabel: 'Source',
      pathLabel: 'Path',
      updatedLabel: 'Updated',
      statusLabel: 'Status',
      addSkillTitle: 'Add skill',
      installToTools: 'Install to tools',
      addTags: 'Add tags',
      noTagsYet: 'No tags yet.',
      syncAfterCreate: 'Sync to selected tools after creation',
      localImportTitle: 'Import from local folder',
      gitImportTitle: 'Import from Git repository',
      localPathPlaceholder: 'Local folder path',
      gitUrlPlaceholder: 'Git URL',
      optionalNamePlaceholder: 'Optional display name',
      create: 'Create',
      detectingTools: 'Detecting installed tools...',
      importTitle: 'Review discovered skills',
      importSummary: 'Select skills to import and sync to your tools.',
      importAndSync: 'Import & Sync',
      close: 'Close',
      selectAll: 'Select all',
      selectedCount: '{{selected}} / {{total}} selected',
      pickSearchPlaceholder: 'Search by name, description, or path...',
      pickSearchEmpty: 'No matching skills found.',
      importSearchEmpty: 'No matching discovered skills found.',
      partialFailure: 'Some actions did not complete',
      conflict: 'Conflict',
      consistent: 'Match',
      directory: 'Folder',
      linkLabel: 'link → {{target}}',
      deleteTitle: 'Remove skill?',
      deleteBody:
        'This will delete the managed record and remove synced links created by this app.',
      cancel: 'Cancel',
      confirm: 'Confirm',
      confirmRemove: 'Remove',
      maintenance: 'Maintenance',
      storagePath: 'Storage path',
      skillsStoragePath: 'Skills Storage Path',
      skillsStorageHint: 'Local copies of Git skills will be stored here.',
      gitCacheCleanupDays: 'Git cache cleanup (days)',
      gitCacheCleanupHint:
        'Remove cached Git repos not fetched within the past N days. Set to 0 to disable.',
      gitCacheTtlSecs: 'Git cache freshness (seconds)',
      gitCacheTtlHint:
        'Skip git fetch when the cache was updated within this window. Set to 0 to always fetch.',
      githubToken: 'GitHub Token',
      githubTokenPlaceholder: 'ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
      githubTokenHint:
        'Optional. Set a GitHub personal access token to increase API rate limits from 60/hr to 5,000/hr.',
      appUpdates: 'App updates',
      updateHint: 'Click “Check” to look for updates.',
      checkForUpdates: 'Check',
      downloadAndInstall: 'Download & Install',
      checkingUpdates: 'Checking...',
      updateNotAvailable: "You're up to date.",
      updateAvailable: 'Update available.',
      updateAvailableWithVersion: 'Update available: v{{version}}',
      installingUpdate: 'Installing...',
      updateInstalledRestart: 'Update installed. Restart the app to finish.',
      updateNow: 'Update Now',
      restartNow: 'Restart Now',
      updateBannerText: 'New version v{{version}} is available.',
      updateBannerDismiss: "Don't remind again",
      updatesMaintenance: 'Updates & Maintenance',
      autoUpdateSkills: 'Auto-update Skills',
      autoUpdateDesc: 'Automatically pull changes for Git skills every 24h',
      storageCleanup: 'Storage Cleanup',
      storageCleanupDesc: 'Clean up temporary download files (240MB)',
      cleanNow: 'Clean Now',
      browse: 'Browse',
      done: 'Done',
      selectLocalFolder: 'Select local folder',
      selectStoragePath: 'Select storage folder',
      notAvailable: 'Not available',
      rescanTools: 'Rescan tools (soon)',
      copy: 'Copy',
      copied: 'Copied to clipboard',
      copyFailed: 'Copy failed',
      update: 'Update',
      remove: 'Remove',
      localTab: 'Local Folder',
      gitTab: 'Git Repository',
      searchTab: 'Search',
      exploreTab: 'Explore',
      exploreFilterPlaceholder: 'Filter or search skills online...',
      exploreEmpty: 'No featured skills available.',
      exploreLoading: 'Loading featured skills...',
      exploreSource: 'Data from',
      exploreSourceHint: 'Featured: top 300 from curated GitHub repos · Search: more results via skills.sh · Type 2+ characters to search',
      exploreFeaturedTitle: 'Featured',
      exploreOnlineTitle: 'Online Results',
      searchLoading: 'Searching skills.sh...',
      searchEmpty: 'No additional results found.',
      searchError: 'Online search failed.',
      repositoryUrl: 'Repository URL',
      localFolder: 'Local Folder',
      install: 'Install',
      installSelected: 'Install selected',
      processingTitle: 'Installing Skills...',
      processingTipShort: 'Cloning repository and syncing to tools',
      processingTipLong:
        'Running file/network operations. First fetch may take a while depending on network; subsequent installs use cache and are faster.',
      newToolsTitle: 'New tools detected',
      newToolsBody:
        'We detected newly installed tools: {{tools}}. Sync managed skills now?',
      later: 'Later',
      syncAll: 'Sync all managed skills',
      gitPickTitle: 'Select skills to import',
      gitPickBody:
        'Multiple skills found in this repository. Choose which ones to install.',
      localPickTitle: 'Select skills to import',
      localPickBody: 'Multiple skills found in this folder. Choose which ones to install.',
      localPickInvalidReason: 'Invalid: {{reason}}',
      localSkillInvalid: {
        missingSkillMd: 'Missing SKILL.md',
        invalidFrontmatter: 'Invalid frontmatter',
        missingName: 'Missing name in frontmatter',
        readFailed: 'Failed to read SKILL.md',
        unknown: 'Unknown issue',
      },
      toolsScanned: 'Tools scanned: {{count}}',
      skillsFound: 'Skills found: {{count}}',
      foundIn: 'Found in',
      errors: {
        notTauri: 'Current environment is not Tauri. Please run `npm run tauri dev`.',
        skillExistsInHub: 'This skill already exists in Hub. No need to install again.',
        skillExistsInHubNamed: '"{{name}}" already exists in Hub. Go to My Skills to update it.',
        targetExists: 'Target folder already exists. Please remove it and try again.',
        targetExistsDetail:
          'Target folder already exists: {{path}}. For safety it was not overwritten.',
        toolNotInstalled: 'The selected tool is not installed. Please refresh and retry.',
        toolNotWritable:
          'Cannot sync to {{tool}}: permission denied on {{path}}. Please check directory permissions or run as administrator.',
        noSkillsFoundInRepo: 'No skills found in this repository.',
        requireLocalPath: 'Please enter a local path.',
        requireGitUrl: 'Please enter a Git repository URL.',
        noSyncTargets:
          'No sync target selected. Please check targets under “Create Skills -> Sync targets”.',
        noSkillsFoundWithHint:
          'No skills found in this repository (SKILL.md not detected).',
        noSkillsFoundLocal: 'No skills found in this folder (SKILL.md not detected).',
        skillAlreadyExists: 'Skill "{{name}}" already exists. Please rename it.',
        duplicateSelectedSkills:
          'Duplicate skill name "{{name}}" selected. Please select only one.',
        selectAtLeastOneSkill: 'Please select at least one Skill.',
        multiSelectNoCustomName:
          'Custom name is not supported when installing multiple skills. Leave it empty or select one.',
        syncFailedTitle: 'Sync failed: {{name}} -> {{tool}}',
        syncTargetExistsMessage:
          'Target folder already exists: {{path}}.\nFor safety it was not overwritten.\n' +
          'You can uncheck this tool or clean the folder first, then retry.',
        importFailedTitle: 'Import failed: {{name}}',
        unsyncedTitle: 'Not synced: {{name}}',
        moreCount: ' (+{{count}} more)',
      },
      actions: {
        importExisting: 'Import {{name}} ...',
        syncing: 'Sync {{name}} -> {{tool}} ...',
        syncStep: 'Sync ({{index}}/{{total}}) {{name}} -> {{tool}} ...',
        importStep: 'Import ({{index}}/{{total}}) {{name}} ...',
        creatingLocalSkill: 'Creating local skill...',
        creatingGitSkill: 'Creating Git skill...',
        removing: 'Removing {{name}} ...',
        updating: 'Updating {{name}} ...',
        updatingTags: 'Updating tags for {{name}} ...',
        deletingTag: 'Deleting tag {{name}} ...',
        unsyncing: 'Unsync {{name}} -> {{tool}} ...',
      },
      status: {
        importCompleted: 'Import completed.',
        localSkillCreated: 'Local skill created.',
        gitSkillCreated: 'Git skill created.',
        selectedSkillsInstalled: 'Selected skills installed.',
        skillRemoved: 'Skill removed.',
        syncCompleted: 'Sync completed.',
        syncDisabled: 'Sync disabled.',
        syncEnabled: 'Sync enabled.',
        updated: '{{name}} updated.',
        gitCacheCleared: 'Git cache cleared ({{count}} removed).',
        installed: 'Installed',
      },
      relative: {
        empty: '—',
        justNow: 'just now',
        minutesAgo: '{{minutes}}m ago',
        hoursAgo: '{{hours}}h ago',
        daysAgo: '{{days}}d ago',
      },
      delete: {
        confirmPrefix: 'Are you sure you want to delete ',
        confirmSuffix: '?',
        warningRemoveFromTools: 'Remove from synced tools',
        warningDeleteFromHub: 'Delete local copy from Hub',
        confirmButton: 'Yes, Delete',
      },
      layout: {
        navDashboard: 'Dashboard',
        navSkills: 'My Skills',
        navSettings: 'Settings',
        versionLabel: 'v0.1.0',
      },
      dashboard: {
        title: 'Dashboard',
        totalSkills: 'Total Skills',
        toolsConnected: 'Tools Connected',
        pendingUpdates: 'Pending Updates',
        allGood: 'All Good',
      },
      detail: {
        back: 'Back',
        files: 'Files',
        noFiles: 'No files found',
        loadingFiles: 'Loading files...',
        loadingContent: 'Loading file content...',
        readError: 'Failed to read file',
        fileCount: '{{count}} files',
      },
      sharedDirConfirm:
        'Note: {{tool}} shares the same skills directory with {{others}}. This change will affect all of them. Continue?',
      tools: {
        opencode: 'OpenCode',
        claude_code: 'Claude Code',
        codex: 'Codex',
        cursor: 'Cursor',
        amp: 'Amp',
        kimi_cli: 'Kimi Code CLI',
        augment: 'Augment',
        openclaw: 'OpenClaw',
        cline: 'Cline',
        codebuddy: 'CodeBuddy',
        command_code: 'Command Code',
        continue: 'Continue',
        crush: 'Crush',
        junie: 'Junie',
        iflow_cli: 'iFlow CLI',
        kiro_cli: 'Kiro CLI',
        kode: 'Kode',
        mcpjam: 'MCPJam',
        mistral_vibe: 'Mistral Vibe',
        mux: 'Mux',
        openclaude: 'OpenClaude IDE',
        openhands: 'OpenHands',
        pi: 'Pi',
        qoder: 'Qoder',
        qoderwork: 'QoderWork',
        qwen_code: 'Qwen Code',
        trae: 'Trae',
        trae_cn: 'Trae CN',
        zencoder: 'Zencoder',
        neovate: 'Neovate',
        pochi: 'Pochi',
        adal: 'AdaL',
        kilo_code: 'Kilo Code',
        roo_code: 'Roo Code',
        goose: 'Goose',
        gemini_cli: 'Gemini CLI',
        antigravity: 'Antigravity',
        github_copilot: 'GitHub Copilot',
        clawdbot: 'Clawdbot',
        droid: 'Droid',
        windsurf: 'Windsurf',
        moltbot: 'MoltBot',
        hermes_agent: 'Hermes Agent',
      },
    },
  },
  zh: {
    translation: {
      appName: 'Skills Hub',
      unknown: '未知',
      languageShort: {
        en: 'EN',
        zh: '中文',
      },
      languageOptions: {
        en: 'English',
        zh: '中文',
      },
      subtitle: '统一管理并同步你的技能到各工具',
      navMySkills: '我的 Skills',
      navExplore: '探索',
      navTags: '标签',
      newSkill: '新建 Skill',
      manualAdd: '手动添加',
      manualAddHint: '有 Git URL 或本地路径？点击<b>手动添加</b>直接导入',
      moreTools: '+{{count}} 个',
      installSuccess: '"{{name}}" 已安装并同步到 {{count}} 个工具',
      settings: '设置',
      language: '语言',
      interfaceLanguage: '界面语言',
      themeMode: '外观模式',
      themeOptions: {
        system: '跟随系统',
        light: '高亮',
        dark: '暗色',
      },
      filterSort: '排序',
      allSkills: '全部 Skills',
      scope: {
        all: '全部',
        global: '全局',
        project: '项目',
        filterLabel: '范围过滤',
        globalBadge: '全局',
        projectCount: '{{count}} 个项目',
      },
      projectSync: {
        title: '同步范围',
        help: '选择这个 Skill 生效的位置。',
        globalDesc: '在所有项目中可用',
        projectDesc: '仅在选择的项目中可用',
        projectDirs: '项目目录',
        addProject: '选择项目目录...',
        selectProjectTitle: '选择项目目录',
        recentProjects: '最近使用',
        addRecent: '添加',
        noProjects: '尚未选择项目目录。',
        projectRequired: '请至少选择一个项目目录后再应用项目范围。',
        noProjectsForSync: '请先选择至少一个项目目录，再同步到工具。',
        unsupportedTool: '{{tool}} 不支持项目级同步。',
        inlineGlobalClear:
          '应用后会清理现有全局链接，并将该 Skill 同步到选中项目目录下的所有当前已安装工具。',
        inlineProjectClear:
          '应用后会清理现有项目链接，并将该 Skill 全局同步到所有当前已安装工具。',
        applyScope: '应用',
        confirmBody: '以下全局链接将被清除：',
        confirmBodyProject: '以下项目链接将被清除：',
      },
      sortUpdated: '最近更新',
      sortName: '名称 A–Z',
      searchPlaceholder: '搜索 skills...',
      tags: '标签',
      tagsSelected: '标签：已选 {{count}}',
      matchAny: '任意匹配',
      searchTags: '搜索标签...',
      untagged: '无标签',
      noTags: '无标签',
      editTags: '编辑标签',
      clearAll: '清空',
      manageTags: '管理标签...',
      tagsHelp: '标签用于筛选和整理 Skills，不会改变同步结果。',
      untaggedSkillsCount: '{{count}} 个 Skills 还没有标签',
      review: '查看',
      newTag: '新建标签',
      newTagPlaceholder: '新标签名称',
      tagName: '标签名',
      skills: 'Skills',
      lastUsed: '最近使用',
      actionsLabel: '操作',
      view: '查看',
      rename: '重命名',
      deleteAction: '删除',
      tagsEmpty: '未找到标签。',
      renameTagPrompt: '重命名标签',
      deleteTagTitle: '删除标签？',
      deleteTagConfirm: '从 {{count}} 个 Skills 中删除「{{name}}」？\n这只会移除标签，不会删除 Skills。',
      editTagsTitle: '编辑标签：{{name}}',
      editTagsHelp: '选择用于查找这个 Skill 的标签。',
      tagCreated: '标签已创建。',
      tagRenamed: '标签已重命名。',
      tagDeleted: '标签已删除。',
      tagsUpdated: '标签已更新。',
      tagsApplyFailed: '无法为「{{name}}」应用标签。',
      back: '返回',
      discoveredTitle: '发现的 Skills',
      discoveredEmpty: '扫描工具以导入已存在的 Skills。',
      discoveredCount: '发现 {{count}} 个可导入 Skills。',
      reviewImport: '查看并导入',
      scanNow: '立即扫描',
      skillsTitle: '托管中的 Skills',
      skillsEmpty: '暂无托管记录。',
      toolsLabel: '工具',
      activeTools: '活跃工具',
      sourceLabel: '来源',
      pathLabel: '路径',
      updatedLabel: '更新时间',
      statusLabel: '状态',
      addSkillTitle: '添加 Skill',
      installToTools: '安装到工具',
      addTags: '添加标签',
      noTagsYet: '暂无标签。',
      syncAfterCreate: '创建后同步到选中工具',
      localImportTitle: '本地目录导入',
      gitImportTitle: 'Git 仓库导入',
      localPathPlaceholder: '本地目录路径',
      gitUrlPlaceholder: 'Git URL',
      optionalNamePlaceholder: '可选：显示名称',
      create: '创建',
      detectingTools: '检测已安装工具中...',
      importTitle: '查看发现的 Skills',
      importSummary: '选择要导入的 Skills，并同步到工具。',
      importAndSync: '导入并同步',
      close: '关闭',
      selectAll: '全选',
      selectedCount: '已选择 {{selected}} / {{total}}',
      pickSearchPlaceholder: '按名称、描述或路径搜索...',
      pickSearchEmpty: '未找到匹配的 Skills。',
      importSearchEmpty: '未找到匹配的已发现 Skills。',
      partialFailure: '部分操作未完成',
      conflict: '冲突',
      consistent: '一致',
      directory: '目录',
      linkLabel: 'link → {{target}}',
      deleteTitle: '确认移除？',
      deleteBody: '将删除托管记录，并清理由本应用创建的同步链接。',
      cancel: '取消',
      confirm: '确认',
      confirmRemove: '确认移除',
      maintenance: '维护',
      storagePath: '存储路径',
      skillsStoragePath: 'Skills 存储路径',
      skillsStorageHint: 'Git Skills 的本地副本将存放在这里。',
      gitCacheCleanupDays: 'Git 缓存清理（天）',
      gitCacheCleanupHint: '启动时清理超过 N 天未使用的 Git 缓存，设为 0 表示不清理。',
      gitCacheTtlSecs: 'Git 缓存新鲜期（秒）',
      gitCacheTtlHint:
        '在该时间窗口内命中缓存会跳过 fetch，设为 0 表示每次都拉取。',
      githubToken: 'GitHub Token',
      githubTokenPlaceholder: 'ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
      githubTokenHint:
        '可选。设置 GitHub 个人访问令牌，可将 API 速率限制从 60 次/小时提升到 5,000 次/小时。',
      appUpdates: '应用更新',
      updateHint: '点击“检查更新”获取最新版本。',
      checkForUpdates: '检查更新',
      downloadAndInstall: '下载并安装',
      checkingUpdates: '检查中...',
      updateNotAvailable: '已是最新版本。',
      updateAvailable: '发现新版本。',
      updateAvailableWithVersion: '发现新版本：v{{version}}',
      installingUpdate: '安装中...',
      updateInstalledRestart: '更新已安装，请重启应用完成更新。',
      updateNow: '立即更新',
      restartNow: '立即重启',
      updateBannerText: '发现新版本 v{{version}}。',
      updateBannerDismiss: '不再提示',
      updatesMaintenance: '更新与维护',
      autoUpdateSkills: '自动更新 Skills',
      autoUpdateDesc: '每 24 小时自动拉取 Git Skills 更新',
      storageCleanup: '存储清理',
      storageCleanupDesc: '清理临时下载文件（240MB）',
      cleanNow: '立即清理',
      browse: '浏览',
      done: '完成',
      selectLocalFolder: '选择本地目录',
      selectStoragePath: '选择存储目录',
      notAvailable: '暂不可用',
      rescanTools: '重新检测工具（敬请期待）',
      copy: '复制',
      copied: '已复制到剪贴板',
      copyFailed: '复制失败',
      update: '更新',
      remove: '移除',
      localTab: '本地目录',
      gitTab: 'Git 仓库',
      searchTab: '搜索',
      exploreTab: '探索',
      exploreFilterPlaceholder: '筛选精选或在线搜索技能...',
      exploreEmpty: '暂无精选技能。',
      exploreLoading: '加载精选技能中...',
      exploreSource: '数据来自',
      exploreSourceHint: '精选推荐：来自精选 GitHub 仓库的 Top 300 · 在线搜索：更多结果来自 skills.sh · 输入 2 个字符开始搜索',
      exploreFeaturedTitle: '精选推荐',
      exploreOnlineTitle: '在线搜索',
      searchLoading: '正在搜索 skills.sh...',
      searchEmpty: '未找到更多结果。',
      searchError: '在线搜索失败。',
      repositoryUrl: '仓库地址',
      localFolder: '本地目录',
      install: '安装',
      installSelected: '安装选中',
      processingTitle: '正在安装技能...',
      processingTipShort: '正在克隆仓库并同步到工具',
      processingTipLong: '正在执行文件/网络操作，首次获取耗时取决于网络状况，后续安装使用缓存会更快。',
      newToolsTitle: '检测到新安装的工具',
      newToolsBody: '已检测到新工具：{{tools}}，是否立即同步托管 Skills？',
      later: '稍后',
      syncAll: '同步全部托管 Skills',
      gitPickTitle: '选择要导入的 Skill',
      gitPickBody: '仓库内发现多个 Skills，可多选后统一安装。',
      localPickTitle: '选择要导入的 Skill',
      localPickBody: '目录内发现多个 Skills，可多选后统一安装。',
      localPickInvalidReason: '不可用：{{reason}}',
      localSkillInvalid: {
        missingSkillMd: '缺少 SKILL.md',
        invalidFrontmatter: 'Frontmatter 格式不合法',
        missingName: 'Frontmatter 缺少 name',
        readFailed: '无法读取 SKILL.md',
        unknown: '未知问题',
      },
      toolsScanned: '已扫描工具数：{{count}}',
      skillsFound: '发现 Skills 数：{{count}}',
      foundIn: '发现于',
      errors: {
        notTauri: '当前环境不是 Tauri，请用 `npm run tauri dev` 启动应用。',
        skillExistsInHub: '该 Skill 已存在于 Hub，无需重复安装。',
        skillExistsInHubNamed: '「{{name}}」已存在于 Hub，可前往"我的 Skills"中更新。',
        targetExists: '目标目录已存在，请先清理后重试。',
        targetExistsDetail:
          '目标目录已存在同名 Skill：{{path}}。为安全起见未覆盖。\n你可以：先手动清理该目录后重试。',
        toolNotInstalled: '未检测到该工具已安装，请刷新后重试。',
        toolNotWritable:
          '无法同步到 {{tool}}：目录 {{path}} 权限不足。请检查目录权限或以管理员身份运行。',
        noSkillsFoundInRepo: '该仓库未发现可导入的 Skills。',
        requireLocalPath: '请输入本地路径',
        requireGitUrl: '请输入 Git 仓库地址',
        noSyncTargets: '未选择任何同步目标工具，请在“创建 Skills -> 同步目标”里勾选。',
        noSkillsFoundWithHint: '未在该仓库中发现可导入的 Skills（未找到 SKILL.md）。',
        noSkillsFoundLocal: '未在该目录中发现可导入的 Skills（未找到 SKILL.md）。',
        skillAlreadyExists: '技能「{{name}}」已存在，请更换名称后再安装。',
        duplicateSelectedSkills: '所选 Skills 含有重复名称「{{name}}」，请只选择一个。',
        selectAtLeastOneSkill: '请至少选择一个 Skill',
        multiSelectNoCustomName:
          '多选安装时不支持自定义名称，请将名称留空或仅选择一个 Skill。',
        syncFailedTitle: '同步失败：{{name}} -> {{tool}}',
        syncTargetExistsMessage:
          '目标目录已存在同名 Skill：{{path}}。为安全起见未覆盖。\n你可以：取消勾选该工具，或先手动清理该目录后重试。',
        importFailedTitle: '导入失败：{{name}}',
        unsyncedTitle: '未同步：{{name}}',
        moreCount: '（另有{{count}}个）',
      },
      actions: {
        importExisting: '导入 {{name}} ...',
        syncing: '同步 {{name}} -> {{tool}} ...',
        syncStep: '同步 ({{index}}/{{total}}) {{name}} -> {{tool}} ...',
        importStep: '导入 ({{index}}/{{total}}) {{name}} ...',
        creatingLocalSkill: '创建本地技能...',
        creatingGitSkill: '创建 Git 技能...',
        removing: '移除 {{name}} ...',
        updating: '更新 {{name}} ...',
        updatingTags: '正在更新 {{name}} 的标签...',
        deletingTag: '正在删除标签 {{name}}...',
        unsyncing: '取消生效：{{name}} -> {{tool}} ...',
      },
      status: {
        importCompleted: '导入完成。',
        localSkillCreated: '本地技能创建完成。',
        gitSkillCreated: 'Git 技能创建完成。',
        selectedSkillsInstalled: '选中技能安装完成。',
        skillRemoved: '已删除该技能。',
        syncCompleted: '同步完成。',
        syncDisabled: '已取消同步。',
        syncEnabled: '已同步到工具。',
        updated: '{{name}} 已更新。',
        gitCacheCleared: 'Git 缓存已清理（删除 {{count}} 项）。',
        installed: '已安装',
      },
      relative: {
        empty: '—',
        justNow: '刚刚',
        minutesAgo: '{{minutes}} 分钟前',
        hoursAgo: '{{hours}} 小时前',
        daysAgo: '{{days}} 天前',
      },
      delete: {
        confirmPrefix: '确定要删除 ',
        confirmSuffix: '？',
        warningRemoveFromTools: '将从已同步的工具中移除',
        warningDeleteFromHub: '删除 Hub 的本地副本',
        confirmButton: '确认删除',
      },
      layout: {
        navDashboard: '概览',
        navSkills: '我的 Skills',
        navSettings: '设置',
        versionLabel: 'v0.1.0',
      },
      dashboard: {
        title: '概览',
        totalSkills: '技能总数',
        toolsConnected: '已连接工具',
        pendingUpdates: '待更新',
        allGood: '全部正常',
      },
      detail: {
        back: '返回',
        files: '文件',
        noFiles: '未找到文件',
        loadingFiles: '加载文件中...',
        loadingContent: '加载文件内容中...',
        readError: '读取文件失败',
        fileCount: '{{count}} 个文件',
      },
      sharedDirConfirm:
        '提示：{{tool}} 与 {{others}} 共用同一个 skills 目录，本次修改会同时影响它们。是否继续？',
      tools: {
        opencode: 'OpenCode',
        claude_code: 'Claude Code',
        codex: 'Codex',
        cursor: 'Cursor',
        amp: 'Amp',
        kimi_cli: 'Kimi Code CLI',
        augment: 'Augment',
        openclaw: 'OpenClaw',
        cline: 'Cline',
        codebuddy: 'CodeBuddy',
        command_code: 'Command Code',
        continue: 'Continue',
        crush: 'Crush',
        junie: 'Junie',
        iflow_cli: 'iFlow CLI',
        kiro_cli: 'Kiro CLI',
        kode: 'Kode',
        mcpjam: 'MCPJam',
        mistral_vibe: 'Mistral Vibe',
        mux: 'Mux',
        openclaude: 'OpenClaude IDE',
        openhands: 'OpenHands',
        pi: 'Pi',
        qoder: 'Qoder',
        qoderwork: 'QoderWork',
        qwen_code: 'Qwen Code',
        trae: 'Trae',
        trae_cn: 'Trae CN',
        zencoder: 'Zencoder',
        neovate: 'Neovate',
        pochi: 'Pochi',
        adal: 'AdaL',
        kilo_code: 'Kilo Code',
        roo_code: 'Roo Code',
        goose: 'Goose',
        gemini_cli: 'Gemini CLI',
        antigravity: 'Antigravity',
        github_copilot: 'GitHub Copilot',
        clawdbot: 'Clawdbot',
        droid: 'Droid',
        windsurf: 'Windsurf',
        moltbot: 'MoltBot',
        hermes_agent: 'Hermes Agent',
      },
    },
  },
} as const


================================================
FILE: src/index.css
================================================
@import url("https://fonts.googleapis.com/css2?family=Fira+Sans:wght@300;400;500;600;700&family=Fira+Code:wght@400;500;600;700&display=swap");
@import "tailwindcss";

:root {
  --bg-app: #ffffff;
  --bg-panel: #fcfcfc;
  --bg-element: #f4f4f5;
  --bg-element-hover: #e4e4e7;
  --bg-header: rgba(255, 255, 255, 0.85);
  --border-subtle: #e4e4e7;
  --border-strong: #d4d4d8;
  --text-primary: #18181b;
  --text-secondary: #52525b;
  --text-tertiary: #a1a1aa;
  --accent-primary: #2563eb;
  --accent-primary-hover: #1d4ed8;
  --accent-primary-fg: #ffffff;
  --accent-soft-bg: #eff6ff;
  --accent-soft-border: #dbeafe;
  --success-soft-bg: #ecfdf5;
  --success-soft-border: #bbf7d0;
  --status-success: #059669;
  --status-warning: #d97706;
  --status-error: #dc2626;
  --status-info: #2563eb;
  --warning-soft-bg: #fffbeb;
  --warning-soft-border: #fcd34d;
  --danger-soft-bg: #fef2f2;
  --danger-soft-border: #fee2e2;
  --danger-soft-bg-strong: #fff1f2;
  --font-ui: "Fira Sans", system-ui, -apple-system, sans-serif;
  --font-mono: "Fira Code", ui-monospace, SFMono-Regular, Menlo, Monaco,
    Consolas, "Liberation Mono", "Courier New", monospace;
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;
  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
  --shadow-lg: 0 10px 20px -6px rgb(0 0 0 / 0.15);
}

:root[data-theme='dark'] {
  --bg-app: #0b0f1a;
  --bg-panel: #111827;
  --bg-element: #1f2937;
  --bg-element-hover: #2a3648;
  --bg-header: rgba(12, 16, 28, 0.78);
  --border-subtle: #273143;
  --border-strong: #334155;
  --text-primary: #f8fafc;
  --text-secondary: #cbd5f5;
  --text-tertiary: #94a3b8;
  --accent-primary: #38bdf8;
  --accent-primary-hover: #0ea5e9;
  --accent-primary-fg: #0b0f1a;
  --accent-soft-bg: #0b3b59;
  --accent-soft-border: #155e75;
  --success-soft-bg: #0f3b2d;
  --success-soft-border: #166534;
  --status-success: #34d399;
  --status-warning: #f59e0b;
  --status-error: #f87171;
  --status-info: #38bdf8;
  --warning-soft-bg: #2a1f0b;
  --warning-soft-border: #8a5a0f;
  --danger-soft-bg: #3b1111;
  --danger-soft-border: #7f1d1d;
  --danger-soft-bg-strong: #3b1111;
  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.35);
  --shadow-lg: 0 12px 24px -10px rgb(0 0 0 / 0.45);
  color-scheme: dark;
}

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  min-height: 100vh;
  font-family: var(--font-ui);
  background: var(--bg-app);
  color: var(--text-primary);
  -webkit-font-smoothing: antialiased;
  padding: 0;
}

#root {
  width: 100%;
  height: 100vh;
}

a {
  color: inherit;
  text-decoration: none;
}


================================================
FILE: src/main.tsx
================================================
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import './i18n'
import App from './App.tsx'

createRoot(document.getElementById('root')!).render(
  <StrictMode>
    <App />
  </StrictMode>,
)


================================================
FILE: src/pages/Dashboard.tsx
================================================
import { useTranslation } from 'react-i18next';

export const Dashboard = () => {
  const { t } = useTranslation();
  return (
    <div className="space-y-6">
      <h1 className="text-2xl font-bold">{t('dashboard.title')}</h1>
      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
        <div className="bg-gray-900 p-6 rounded-lg border border-gray-800">
          <h3 className="text-gray-400 text-sm font-medium">
            {t('dashboard.totalSkills')}
          </h3>
          <p className="text-3xl font-bold mt-2">0</p>
        </div>
        <div className="bg-gray-900 p-6 rounded-lg border border-gray-800">
          <h3 className="text-gray-400 text-sm font-medium">
            {t('dashboard.toolsConnected')}
          </h3>
          <p className="text-3xl font-bold mt-2">0</p>
        </div>
        <div className="bg-gray-900 p-6 rounded-lg border border-gray-800">
          <h3 className="text-gray-400 text-sm font-medium">
            {t('dashboard.pendingUpdates')}
          </h3>
          <p className="text-3xl font-bold mt-2 text-green-500">
            {t('dashboard.allGood')}
          </p>
        </div>
      </div>
    </div>
  );
};


================================================
FILE: src/tauri-plugin-dialog.d.ts
================================================
declare module '@tauri-apps/plugin-dialog' {
  type OpenDialogOptions = {
    directory?: boolean
    multiple?: boolean
    title?: string
  }

  export function open(options?: OpenDialogOptions): Promise<string | string[] | null>
}


================================================
FILE: src-tauri/.gitignore
================================================
# Generated by Cargo
# will have compiled files and executables
/target/
/gen/schemas


================================================
FILE: src-tauri/Cargo.toml
================================================
[package]
name = "app"
version = "0.6.0"
description = "A Tauri App"
authors = ["you"]
license = ""
repository = "git@github.com:qufei1993/skills-hub.git"
edition = "2021"
rust-version = "1.77.2"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[lib]
name = "app_lib"
crate-type = ["staticlib", "cdylib", "rlib"]

[build-dependencies]
tauri-build = { version = "2.5.3", features = [] }

[dependencies]
serde_json = "1.0"
serde = { version = "1.0", features = ["derive"] }
log = "0.4"
tauri = { version = "2.9.5", features = ["test"] }
tauri-plugin-dialog = "2"
tauri-plugin-log = "2"
tauri-plugin-opener = "2"
tauri-plugin-updater = "2"
anyhow = "1.0"
rusqlite = { version = "0.31", features = ["bundled"] }
dirs = "5.0"
walkdir = "2.5"
sha2 = "0.10"
hex = "0.4"
git2 = { version = "0.19", features = ["vendored-openssl"] }
reqwest = { version = "0.12", default-features = false, features = ["blocking", "json", "rustls-tls"] }
junction = "1.1"
uuid = { version = "1", features = ["v4"] }
urlencoding = "2.1"

[dev-dependencies]
tempfile = "3"
mockito = "1"


================================================
FILE: src-tauri/build.rs
================================================
fn main() {
    // 确保替换图标后，`tauri dev` 的构建会重新触发（否则 Cargo 可能不重跑 build.rs，Dock 仍显示旧图标）。
    println!("cargo:rerun-if-changed=icons/icon.png");
    println!("cargo:rerun-if-changed=icons/icon.icns");
    println!("cargo:rerun-if-changed=icons/icon.ico");
    println!("cargo:rerun-if-changed=tauri.conf.json");
    tauri_build::build()
}


================================================
FILE: src-tauri/capabilities/default.json
================================================
{
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "default",
  "description": "enables the default permissions",
  "windows": [
    "main"
  ],
  "permissions": [
    "core:default",
    "dialog:default",
    "dialog:allow-open",
    "updater:default"
  ]
}


================================================
FILE: src-tauri/src/commands/mod.rs
================================================
use anyhow::Context;
use serde::Serialize;
use tauri::State;

use std::sync::Arc;

use crate::core::cache_cleanup::{
    cleanup_git_cache_dirs, get_git_cache_cleanup_days as get_git_cache_cleanup_days_core,
    get_git_cache_ttl_secs as get_git_cache_ttl_secs_core,
    set_git_cache_cleanup_days as set_git_cache_cleanup_days_core,
    set_git_cache_ttl_secs as set_git_cache_ttl_secs_core,
};
use crate::core::cancel_token::CancelToken;
use crate::core::central_repo::{ensure_central_repo, resolve_central_repo_path};
use crate::core::content_hash::hash_dir;
use crate::core::featured_skills::{fetch_featured_skills, FeaturedSkill};
use crate::core::github_search::{search_github_repos, RepoSummary};
use crate::core::installer::{
    install_git_skill, install_git_skill_from_selection, install_local_skill,
    install_local_skill_from_selection, list_git_skills, list_local_skills,
    update_managed_skill_from_source, GitSkillCandidate, InstallResult, LocalSkillCandidate,
};
use crate::core::onboarding::{build_onboarding_plan, OnboardingPlan};
use crate::core::skill_store::{SkillStore, SkillTargetRecord};
use crate::core::skills_search::{
    search_skills_online as search_skills_online_core, OnlineSkillResult,
};
use crate::core::sync_engine::{
    copy_dir_recursive, sync_dir_for_tool_with_overwrite, sync_dir_hybrid, SyncMode,
};
use crate::core::tool_adapters::{
    adapter_by_key, adapters_sharing_project_skills_dir, is_tool_installed, resolve_default_path,
    resolve_project_path, supports_project_scope,
};
use uuid::Uuid;

const RECENT_PROJECTS_SETTING: &str = "recent_projects_v1";

fn format_anyhow_error(err: anyhow::Error) -> String {
    let first = err.to_string();
    // Frontend relies on these prefixes for special flows.
    if first.starts_with("MULTI_SKILLS|")
        || first.starts_with("TARGET_EXISTS|")
        || first.starts_with("TOOL_NOT_INSTALLED|")
    {
        return first;
    }

    // Include the full error chain (causes), not just the top context.
    let mut full = format!("{:#}", err);

    // Redact noisy temp paths from clone context (we care about the cause, not the dest).
    // Example: `clone https://... into "/Users/.../skills-hub-git-<uuid>"`
    if let Some(head) = full.lines().next() {
        if head.starts_with("clone ") {
            if let Some(pos) = head.find(" into ") {
                let head_redacted = format!("{} (已省略临时目录)", &head[..pos]);
                let rest: String = full.lines().skip(1).collect::<Vec<_>>().join("\n");
                full = if rest.is_empty() {
                    head_redacted
                } else {
                    format!("{}\n{}", head_redacted, rest)
                };
            }
        }
    }

    let root = err.root_cause().to_string();
    let lower = full.to_lowercase();

    // Heuristic-friendly messaging for GitHub clone failures.
    if lower.contains("github.com")
        && (lower.contains("clone ") || lower.contains("remote") || lower.contains("fetch"))
    {
        if lower.contains("securetransport") {
            return format!(
        "无法从 GitHub 拉取仓库：TLS/证书校验失败（macOS SecureTransport）。\n\n建议：\n- 检查网络/代理是否拦截 HTTPS\n- 如在公司网络，可能需要安装公司根证书或使用可信代理\n- 也可在终端确认 `git clone {}` 是否可用\n\n详细：{}",
        "https://github.com/<owner>/<repo>",
        root
      );
        }
        let hint = if lower.contains("authentication")
            || lower.contains("permission denied")
            || lower.contains("credentials")
        {
            "无法访问该仓库：可能是私有仓库/权限不足/需要鉴权。"
        } else if lower.contains("not found") {
            "仓库不存在或无权限访问（GitHub 返回 not found）。"
        } else if lower.contains("failed to resolve")
            || lower.contains("could not resolve")
            || lower.contains("dns")
        {
            "无法解析 GitHub 域名（DNS）。请检查网络/代理。"
        } else if lower.contains("timed out") || lower.contains("timeout") {
            "连接 GitHub 超时。请检查网络/代理。"
        } else if lower.contains("connection refused") || lower.contains("connection reset") {
            "连接 GitHub 失败（连接被拒绝/重置）。请检查网络/代理。"
        } else {
            "无法从 GitHub 拉取仓库。请检查网络/代理，或稍后重试。"
        };

        return format!("{}\n\n详细：{}", hint, root);
    }

    full
}

#[derive(Debug, Serialize)]
pub struct ToolInfoDto {
    pub key: String,
    pub label: String,
    pub installed: bool,
    pub skills_dir: String,
    pub supports_project_scope: bool,
}

#[derive(Debug, Serialize)]
pub struct ToolStatusDto {
    pub tools: Vec<ToolInfoDto>,
    pub installed: Vec<String>,
    pub newly_installed: Vec<String>,
}

#[tauri::command]
pub async fn get_tool_status(store: State<'_, SkillStore>) -> Result<ToolStatusDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let adapters = crate::core::tool_adapters::default_tool_adapters();
        let mut tools: Vec<ToolInfoDto> = Vec::new();
        let mut installed: Vec<String> = Vec::new();

        for adapter in &adapters {
            let ok = is_tool_installed(adapter)?;
            let key = adapter.id.as_key().to_string();
            let skills_dir = resolve_default_path(adapter)?.to_string_lossy().to_string();
            tools.push(ToolInfoDto {
                key: key.clone(),
                label: adapter.display_name.to_string(),
                installed: ok,
                skills_dir,
                supports_project_scope: supports_project_scope(adapter),
            });
            if ok {
                installed.push(key);
            }
        }

        installed.dedup();

        let prev: Vec<String> = store
            .get_setting("installed_tools_v1")?
            .and_then(|raw| serde_json::from_str::<Vec<String>>(&raw).ok())
            .unwrap_or_default();

        let prev_set: std::collections::HashSet<String> = prev.into_iter().collect();
        let newly_installed: Vec<String> = installed
            .iter()
            .filter(|k| !prev_set.contains(*k))
            .cloned()
            .collect();

        // Persist current set (best effort).
        let _ = store.set_setting(
            "installed_tools_v1",
            &serde_json::to_string(&installed).unwrap_or_else(|_| "[]".to_string()),
        );

        Ok::<_, anyhow::Error>(ToolStatusDto {
            tools,
            installed,
            newly_installed,
        })
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn get_onboarding_plan(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
) -> Result<OnboardingPlan, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || build_onboarding_plan(&app, &store))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn get_git_cache_cleanup_days(store: State<'_, SkillStore>) -> Result<i64, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        Ok::<_, anyhow::Error>(get_git_cache_cleanup_days_core(&store))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn set_git_cache_cleanup_days(
    store: State<'_, SkillStore>,
    days: i64,
) -> Result<i64, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || set_git_cache_cleanup_days_core(&store, days))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn clear_git_cache_now(app: tauri::AppHandle) -> Result<usize, String> {
    tauri::async_runtime::spawn_blocking(move || {
        cleanup_git_cache_dirs(&app, std::time::Duration::from_secs(0))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn get_git_cache_ttl_secs(store: State<'_, SkillStore>) -> Result<i64, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        Ok::<_, anyhow::Error>(get_git_cache_ttl_secs_core(&store))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn set_git_cache_ttl_secs(
    store: State<'_, SkillStore>,
    secs: i64,
) -> Result<i64, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || set_git_cache_ttl_secs_core(&store, secs))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
pub struct InstallResultDto {
    pub skill_id: String,
    pub name: String,
    pub central_path: String,
    pub content_hash: Option<String>,
}

fn expand_home_path(input: &str) -> Result<std::path::PathBuf, anyhow::Error> {
    let trimmed = input.trim();
    if trimmed.is_empty() {
        anyhow::bail!("storage path is empty");
    }
    if trimmed == "~" {
        let home = dirs::home_dir().context("failed to resolve home directory")?;
        return Ok(home);
    }
    if let Some(stripped) = trimmed.strip_prefix("~/") {
        let home = dirs::home_dir().context("failed to resolve home directory")?;
        return Ok(home.join(stripped));
    }
    Ok(std::path::PathBuf::from(trimmed))
}

fn normalize_scope(scope: Option<&str>) -> Result<&'static str, anyhow::Error> {
    match scope.unwrap_or("global") {
        "global" => Ok("global"),
        "project" => Ok("project"),
        other => anyhow::bail!("invalid scope: {}", other),
    }
}

#[tauri::command]
pub async fn get_recent_projects(store: State<'_, SkillStore>) -> Result<Vec<String>, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || get_recent_projects_impl(&store))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn save_recent_project(
    store: State<'_, SkillStore>,
    projectPath: String,
) -> Result<Vec<String>, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || save_recent_project_impl(&store, &projectPath))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

fn get_recent_projects_impl(store: &SkillStore) -> Result<Vec<String>, anyhow::Error> {
    let projects = store
        .get_setting(RECENT_PROJECTS_SETTING)?
        .and_then(|raw| serde_json::from_str::<Vec<String>>(&raw).ok())
        .unwrap_or_default();
    Ok(projects)
}

fn save_recent_project_impl(
    store: &SkillStore,
    project_path: &str,
) -> Result<Vec<String>, anyhow::Error> {
    let path = expand_home_path(project_path)?;
    if !path.is_dir() {
        anyhow::bail!("projectPath must be an existing directory: {:?}", path);
    }
    let normalized = path.to_string_lossy().to_string();
    let mut projects = get_recent_projects_impl(store)?;
    projects.retain(|item| item != &normalized);
    projects.insert(0, normalized);
    projects.truncate(8);
    store.set_setting(
        RECENT_PROJECTS_SETTING,
        &serde_json::to_string(&projects).unwrap_or_else(|_| "[]".to_string()),
    )?;
    Ok(projects)
}

#[tauri::command]
pub async fn get_central_repo_path(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
) -> Result<String, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let path = resolve_central_repo_path(&app, &store)?;
        ensure_central_repo(&path)?;
        Ok::<_, anyhow::Error>(path.to_string_lossy().to_string())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn set_central_repo_path(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    path: String,
) -> Result<String, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let new_base = expand_home_path(&path)?;
        if !new_base.is_absolute() {
            anyhow::bail!("storage path must be absolute");
        }
        ensure_central_repo(&new_base)?;

        let current_base = resolve_central_repo_path(&app, &store)?;
        let skills = store.list_skills()?;
        if current_base == new_base {
            store.set_setting("central_repo_path", new_base.to_string_lossy().as_ref())?;
            return Ok::<_, anyhow::Error>(new_base.to_string_lossy().to_string());
        }

        if !skills.is_empty() {
            for skill in skills {
                let old_path = std::path::PathBuf::from(&skill.central_path);
                if !old_path.exists() {
                    anyhow::bail!("central path not found: {:?}", old_path);
                }
                let file_name = old_path
                    .file_name()
                    .ok_or_else(|| anyhow::anyhow!("invalid central path: {:?}", old_path))?;
                let new_path = new_base.join(file_name);
                if new_path.exists() {
                    anyhow::bail!("target path already exists: {:?}", new_path);
                }

                if let Err(err) = std::fs::rename(&old_path, &new_path) {
                    copy_dir_recursive(&old_path, &new_path)
                        .with_context(|| format!("copy {:?} -> {:?}", old_path, new_path))?;
                    std::fs::remove_dir_all(&old_path)
                        .with_context(|| format!("cleanup {:?}", old_path))?;
                    // Surface rename error in logs for troubleshooting.
                    eprintln!("rename failed, fallback used: {}", err);
                }

                let mut updated = skill.clone();
                updated.central_path = new_path.to_string_lossy().to_string();
                updated.updated_at = now_ms();
                store.upsert_skill(&updated)?;
            }
        }

        store.set_setting("central_repo_path", new_base.to_string_lossy().as_ref())?;
        Ok::<_, anyhow::Error>(new_base.to_string_lossy().to_string())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn install_local(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    sourcePath: String,
    name: Option<String>,
) -> Result<InstallResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let result = install_local_skill(&app, &store, sourcePath.as_ref(), name)?;
        Ok::<_, anyhow::Error>(to_install_dto(result))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn list_local_skills_cmd(basePath: String) -> Result<Vec<LocalSkillCandidate>, String> {
    tauri::async_runtime::spawn_blocking(move || {
        let path = std::path::PathBuf::from(basePath);
        list_local_skills(&path)
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn install_local_selection(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    basePath: String,
    subpath: String,
    name: Option<String>,
) -> Result<InstallResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let base = std::path::PathBuf::from(basePath);
        let result =
            install_local_skill_from_selection(&app, &store, base.as_ref(), &subpath, name)?;
        Ok::<_, anyhow::Error>(to_install_dto(result))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn install_git(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    cancel: State<'_, Arc<CancelToken>>,
    repoUrl: String,
    name: Option<String>,
) -> Result<InstallResultDto, String> {
    let store = store.inner().clone();
    cancel.reset();
    let cancel_token = Arc::clone(cancel.inner());
    tauri::async_runtime::spawn_blocking(move || {
        let result = install_git_skill(&app, &store, &repoUrl, name, Some(&cancel_token))?;
        Ok::<_, anyhow::Error>(to_install_dto(result))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn list_git_skills_cmd(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    repoUrl: String,
) -> Result<Vec<GitSkillCandidate>, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || list_git_skills(&app, &store, &repoUrl))
        .await
        .map_err(|err| err.to_string())?
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn install_git_selection(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    repoUrl: String,
    subpath: String,
    name: Option<String>,
) -> Result<InstallResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let result = install_git_skill_from_selection(&app, &store, &repoUrl, &subpath, name)?;
        Ok::<_, anyhow::Error>(to_install_dto(result))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
pub struct SyncResultDto {
    pub mode_used: String,
    pub target_path: String,
}

#[tauri::command]
pub async fn sync_skill_dir(
    source_path: String,
    target_path: String,
) -> Result<SyncResultDto, String> {
    tauri::async_runtime::spawn_blocking(move || {
        let result = sync_dir_hybrid(source_path.as_ref(), target_path.as_ref())?;
        Ok::<_, anyhow::Error>(SyncResultDto {
            mode_used: match result.mode_used {
                SyncMode::Auto => "auto",
                SyncMode::Symlink => "symlink",
                SyncMode::Junction => "junction",
                SyncMode::Copy => "copy",
            }
            .to_string(),
            target_path: result.target_path.to_string_lossy().to_string(),
        })
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
#[allow(clippy::too_many_arguments)]
pub async fn sync_skill_to_tool(
    store: State<'_, SkillStore>,
    sourcePath: String,
    skillId: String,
    tool: String,
    name: String,
    overwrite: Option<bool>,
    overwriteIfSameContent: Option<bool>,
    scope: Option<String>,
    projectPath: Option<String>,
) -> Result<SyncResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let adapter = adapter_by_key(&tool).ok_or_else(|| anyhow::anyhow!("unknown tool"))?;
        let scope = normalize_scope(scope.as_deref())?;
        if scope == "project" && !supports_project_scope(&adapter) {
            anyhow::bail!("PROJECT_SCOPE_UNSUPPORTED|{}", adapter.id.as_key());
        }
        let project_root = if scope == "project" {
            let raw = projectPath
                .as_deref()
                .ok_or_else(|| anyhow::anyhow!("projectPath is required for project scope"))?;
            let path = expand_home_path(raw)?;
            if !path.is_dir() {
                anyhow::bail!("projectPath must be an existing directory: {:?}", path);
            }
            Some(path)
        } else {
            None
        };

        if scope == "global" && !is_tool_installed(&adapter)? {
            anyhow::bail!("TOOL_NOT_INSTALLED|{}", adapter.id.as_key());
        }
        let tool_root = if let Some(project_root) = &project_root {
            resolve_project_path(&adapter, project_root)?
        } else {
            resolve_default_path(&adapter)?
        };
        // Pre-check: ensure the skills directory is writable (fixes #20 — Windows OS error 5).
        if let Err(err) = std::fs::create_dir_all(&tool_root) {
            if err.kind() == std::io::ErrorKind::PermissionDenied {
                anyhow::bail!(
                    "TOOL_NOT_WRITABLE|{}|{}",
                    adapter.display_name,
                    tool_root.to_string_lossy()
                );
            }
            anyhow::bail!("failed to create skills dir {:?}: {}", tool_root, err);
        }
        let target = tool_root.join(&name);
        let project_path_for_record = project_root
            .as_ref()
            .map(|path| path.to_string_lossy().to_string());
        if let Some(existing) =
            store.get_skill_target(&skillId, &tool, scope, project_path_for_record.as_deref())?
        {
            if existing.target_path == target.to_string_lossy() && target.exists() {
                return Ok::<_, anyhow::Error>(SyncResultDto {
                    mode_used: existing.mode,
                    target_path: existing.target_path,
                });
            }
        }
        let overwrite = overwrite.unwrap_or(false)
            || (overwriteIfSameContent.unwrap_or(false)
                && target_has_same_content(sourcePath.as_ref(), &target));
        let result =
            sync_dir_for_tool_with_overwrite(&tool, sourcePath.as_ref(), &target, overwrite)
                .map_err(|err| {
                    let msg = err.to_string();
                    if msg.contains("target already exists") {
                        anyhow::anyhow!("TARGET_EXISTS|{}", target.to_string_lossy())
                    } else if msg.contains("os error 5")
                        || msg.contains("Access is denied")
                        || msg.contains("Permission denied")
                    {
                        anyhow::anyhow!(
                            "TOOL_NOT_WRITABLE|{}|{}",
                            adapter.display_name,
                            tool_root.to_string_lossy()
                        )
                    } else {
                        anyhow::anyhow!(msg)
                    }
                })?;

        // Some tools share the same skills directory; keep DB records consistent across them.
        let group = if scope == "project" {
            adapters_sharing_project_skills_dir(&adapter)
        } else {
            crate::core::tool_adapters::adapters_sharing_skills_dir(&adapter)
        };
        for a in group {
            if !is_tool_installed(&a)? {
                continue;
            }
            let record = SkillTargetRecord {
                id: Uuid::new_v4().to_string(),
                skill_id: skillId.clone(),
                tool: a.id.as_key().to_string(),
                scope: scope.to_string(),
                project_path: project_path_for_record.clone(),
                target_path: result.target_path.to_string_lossy().to_string(),
                mode: match result.mode_used {
                    SyncMode::Auto => "auto",
                    SyncMode::Symlink => "symlink",
                    SyncMode::Junction => "junction",
                    SyncMode::Copy => "copy",
                }
                .to_string(),
                status: "ok".to_string(),
                last_error: None,
                synced_at: Some(now_ms()),
            };
            store.upsert_skill_target(&record)?;
        }

        Ok::<_, anyhow::Error>(SyncResultDto {
            mode_used: match result.mode_used {
                SyncMode::Auto => "auto",
                SyncMode::Symlink => "symlink",
                SyncMode::Junction => "junction",
                SyncMode::Copy => "copy",
            }
            .to_string(),
            target_path: result.target_path.to_string_lossy().to_string(),
        })
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

fn target_has_same_content(source: &std::path::Path, target: &std::path::Path) -> bool {
    if !source.is_dir() || !target.is_dir() {
        return false;
    }
    match (hash_dir(source), hash_dir(target)) {
        (Ok(source_hash), Ok(target_hash)) => source_hash == target_hash,
        _ => false,
    }
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn unsync_skill_from_tool(
    store: State<'_, SkillStore>,
    skillId: String,
    tool: String,
    scope: Option<String>,
    projectPath: Option<String>,
) -> Result<(), String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let scope = normalize_scope(scope.as_deref())?;
        let project_path = if scope == "project" {
            let raw = projectPath
                .as_deref()
                .ok_or_else(|| anyhow::anyhow!("projectPath is required for project scope"))?;
            Some(expand_home_path(raw)?.to_string_lossy().to_string())
        } else {
            None
        };

        // Some tools share the same skills directory; unsync should update all of them.
        let group_tool_keys: Vec<String> = if let Some(adapter) = adapter_by_key(&tool) {
            let group = if scope == "project" {
                adapters_sharing_project_skills_dir(&adapter)
            } else {
                crate::core::tool_adapters::adapters_sharing_skills_dir(&adapter)
            };
            // If none of the group tools are installed, do nothing (treat as already not effective).
            if scope == "global" {
                let mut any_installed = false;
                for a in &group {
                    if is_tool_installed(a)? {
                        any_installed = true;
                        break;
                    }
                }
                if !any_installed {
                    return Ok::<_, anyhow::Error>(());
                }
            }
            group
                .into_iter()
                .map(|a| a.id.as_key().to_string())
                .collect()
        } else {
            vec![tool.clone()]
        };

        // Remove filesystem target once (shared dir => shared target path).
        let mut removed = false;
        for k in &group_tool_keys {
            if let Some(target) =
                store.get_skill_target(&skillId, k, scope, project_path.as_deref())?
            {
                if !removed {
                    remove_path_any(&target.target_path).map_err(anyhow::Error::msg)?;
                    removed = true;
                }
                store.delete_skill_target(&skillId, k, scope, project_path.as_deref())?;
            }
        }

        Ok::<_, anyhow::Error>(())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
pub struct UpdateResultDto {
    pub skill_id: String,
    pub name: String,
    pub content_hash: Option<String>,
    pub source_revision: Option<String>,
    pub updated_targets: Vec<String>,
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn update_managed_skill(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    skillId: String,
) -> Result<UpdateResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let res = update_managed_skill_from_source(&app, &store, &skillId)?;
        Ok::<_, anyhow::Error>(UpdateResultDto {
            skill_id: res.skill_id,
            name: res.name,
            content_hash: res.content_hash,
            source_revision: res.source_revision,
            updated_targets: res.updated_targets,
        })
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn search_github(
    store: State<'_, SkillStore>,
    query: String,
    limit: Option<u32>,
) -> Result<Vec<RepoSummary>, String> {
    let store = store.inner().clone();
    let limit = limit.unwrap_or(10) as usize;
    tauri::async_runtime::spawn_blocking(move || {
        let token = store.get_setting("github_token")?.unwrap_or_default();
        let token_opt = if token.is_empty() {
            None
        } else {
            Some(token.as_str())
        };
        search_github_repos(&query, limit, token_opt)
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn get_github_token(store: State<'_, SkillStore>) -> Result<String, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        Ok::<_, anyhow::Error>(store.get_setting("github_token")?.unwrap_or_default())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn set_github_token(store: State<'_, SkillStore>, token: String) -> Result<(), String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let trimmed = token.trim();
        if trimmed.is_empty() {
            store.set_setting("github_token", "")?;
        } else {
            store.set_setting("github_token", trimmed)?;
        }
        Ok::<_, anyhow::Error>(())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn import_existing_skill(
    app: tauri::AppHandle,
    store: State<'_, SkillStore>,
    sourcePath: String,
    name: Option<String>,
) -> Result<InstallResultDto, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let source = std::path::Path::new(&sourcePath);
        // Validate SKILL.md exists before importing (fixes #8: prevents importing
        // directories that were "discovered" but lack a valid SKILL.md).
        if !source.join("SKILL.md").exists() {
            anyhow::bail!("SKILL_INVALID|missing_skill_md");
        }
        let result = install_local_skill(&app, &store, source, name)?;
        Ok::<_, anyhow::Error>(to_install_dto(result))
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
pub struct ManagedSkillDto {
    pub id: String,
    pub name: String,
    pub description: Option<String>,
    pub source_type: String,
    pub source_ref: Option<String>,
    pub central_path: String,
    pub created_at: i64,
    pub updated_at: i64,
    pub last_sync_at: Option<i64>,
    pub status: String,
    pub tags: Vec<TagDto>,
    pub targets: Vec<SkillTargetDto>,
}

#[derive(Debug, Clone, Serialize)]
pub struct TagDto {
    pub id: i64,
    pub name: String,
}

#[derive(Debug, Serialize)]
pub struct TagWithCountDto {
    pub id: i64,
    pub name: String,
    pub skill_count: i64,
    pub updated_at: i64,
}

#[derive(Debug, Serialize)]
pub struct SkillTargetDto {
    pub tool: String,
    pub scope: String,
    pub project_path: Option<String>,
    pub mode: String,
    pub status: String,
    pub target_path: String,
    pub synced_at: Option<i64>,
}

#[tauri::command]
pub fn get_managed_skills(store: State<'_, SkillStore>) -> Result<Vec<ManagedSkillDto>, String> {
    get_managed_skills_impl(store.inner())
}

#[tauri::command]
pub fn get_tags(store: State<'_, SkillStore>) -> Result<Vec<TagWithCountDto>, String> {
    store
        .list_tags_with_counts()
        .map(|tags| {
            tags.into_iter()
                .map(|tag| TagWithCountDto {
                    id: tag.id,
                    name: tag.name,
                    skill_count: tag.skill_count,
                    updated_at: tag.updated_at,
                })
                .collect()
        })
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub fn create_tag(store: State<'_, SkillStore>, name: String) -> Result<TagDto, String> {
    store
        .create_tag(&name)
        .map(|tag| TagDto {
            id: tag.id,
            name: tag.name,
        })
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub fn rename_tag(
    store: State<'_, SkillStore>,
    tagId: i64,
    name: String,
) -> Result<TagDto, String> {
    store
        .rename_tag(tagId, &name)
        .map(|tag| TagDto {
            id: tag.id,
            name: tag.name,
        })
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub fn delete_tag(store: State<'_, SkillStore>, tagId: i64) -> Result<(), String> {
    store.delete_tag(tagId).map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub fn get_skill_tags(
    store: State<'_, SkillStore>,
    skillId: String,
) -> Result<Vec<TagDto>, String> {
    store
        .get_skill_tags(&skillId)
        .map(|tags| {
            tags.into_iter()
                .map(|tag| TagDto {
                    id: tag.id,
                    name: tag.name,
                })
                .collect()
        })
        .map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub fn set_skill_tags(
    store: State<'_, SkillStore>,
    skillId: String,
    tagIds: Vec<i64>,
) -> Result<(), String> {
    store
        .set_skill_tags(&skillId, &tagIds)
        .map_err(format_anyhow_error)
}

#[tauri::command]
pub fn get_untagged_skill_ids(store: State<'_, SkillStore>) -> Result<Vec<String>, String> {
    store.list_untagged_skill_ids().map_err(format_anyhow_error)
}

#[tauri::command]
#[allow(non_snake_case)]
pub async fn delete_managed_skill(
    store: State<'_, SkillStore>,
    skillId: String,
) -> Result<(), String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        // 便于排查“按钮点了没反应”：确认前端确实触发了命令
        println!("[delete_managed_skill] skillId={}", skillId);

        // 先删除已同步到各工具目录的副本/软链接
        // 注意：如果先删 skills 行，会触发 skill_targets cascade，导致无法再拿到 target_path
        let targets = store.list_skill_targets(&skillId)?;

        let mut remove_failures: Vec<String> = Vec::new();
        for target in targets {
            if let Err(err) = remove_path_any(&target.target_path) {
                remove_failures.push(format!("{}: {}", target.target_path, err));
            }
        }

        let record = store.get_skill_by_id(&skillId)?;
        if let Some(skill) = record {
            let path = std::path::PathBuf::from(skill.central_path);
            if path.exists() {
                std::fs::remove_dir_all(&path)?;
            }
            store.delete_skill(&skillId)?;
        }

        if !remove_failures.is_empty() {
            anyhow::bail!(
                "已删除托管记录，但清理部分工具目录失败：\n- {}",
                remove_failures.join("\n- ")
            );
        }

        Ok::<_, anyhow::Error>(())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

fn remove_path_any(path: &str) -> Result<(), String> {
    let p = std::path::Path::new(path);
    if !p.exists() {
        return Ok(());
    }

    let meta = std::fs::symlink_metadata(p).map_err(|err| err.to_string())?;
    let ft = meta.file_type();

    // 软链接（即使指向目录）也应该用 remove_file 删除链接本身
    if ft.is_symlink() {
        std::fs::remove_file(p).map_err(|err| err.to_string())?;
        return Ok(());
    }

    if ft.is_dir() {
        std::fs::remove_dir_all(p).map_err(|err| err.to_string())?;
        return Ok(());
    }

    std::fs::remove_file(p).map_err(|err| err.to_string())?;
    Ok(())
}

fn to_install_dto(result: InstallResult) -> InstallResultDto {
    InstallResultDto {
        skill_id: result.skill_id,
        name: result.name,
        central_path: result.central_path.to_string_lossy().to_string(),
        content_hash: result.content_hash,
    }
}

fn now_ms() -> i64 {
    let now = std::time::SystemTime::now()
        .duration_since(std::time::SystemTime::UNIX_EPOCH)
        .unwrap_or_default();
    now.as_millis() as i64
}

fn get_managed_skills_impl(store: &SkillStore) -> Result<Vec<ManagedSkillDto>, String> {
    let skills = store.list_skills().map_err(|err| err.to_string())?;
    Ok(skills
        .into_iter()
        .map(|skill| {
            let targets = store
                .list_skill_targets(&skill.id)
                .unwrap_or_default()
                .into_iter()
                .map(|target| SkillTargetDto {
                    tool: target.tool,
                    scope: target.scope,
                    project_path: target.project_path,
                    mode: target.mode,
                    status: target.status,
                    target_path: target.target_path,
                    synced_at: target.synced_at,
                })
                .collect();
            let tags = store
                .get_skill_tags(&skill.id)
                .unwrap_or_default()
                .into_iter()
                .map(|tag| TagDto {
                    id: tag.id,
                    name: tag.name,
                })
                .collect();

            ManagedSkillDto {
                id: skill.id,
                name: skill.name,
                description: skill.description,
                source_type: skill.source_type,
                source_ref: skill.source_ref,
                central_path: skill.central_path,
                created_at: skill.created_at,
                updated_at: skill.updated_at,
                last_sync_at: skill.last_sync_at,
                status: skill.status,
                tags,
                targets,
            }
        })
        .collect())
}

#[derive(Debug, Serialize)]
pub struct FeaturedSkillDto {
    pub slug: String,
    pub name: String,
    pub summary: String,
    pub downloads: u64,
    pub stars: u64,
    pub source_url: String,
}

impl From<FeaturedSkill> for FeaturedSkillDto {
    fn from(s: FeaturedSkill) -> Self {
        Self {
            slug: s.slug,
            name: s.name,
            summary: s.summary,
            downloads: s.downloads,
            stars: s.stars,
            source_url: s.source_url,
        }
    }
}

#[tauri::command]
pub async fn get_featured_skills(
    store: State<'_, SkillStore>,
) -> Result<Vec<FeaturedSkillDto>, String> {
    let store = store.inner().clone();
    tauri::async_runtime::spawn_blocking(move || {
        let skills = fetch_featured_skills(&store)?;
        Ok::<_, anyhow::Error>(skills.into_iter().map(FeaturedSkillDto::from).collect())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
pub struct OnlineSkillDto {
    pub name: String,
    pub installs: u64,
    pub source: String,
    pub source_url: String,
}

impl From<OnlineSkillResult> for OnlineSkillDto {
    fn from(r: OnlineSkillResult) -> Self {
        Self {
            name: r.name,
            installs: r.installs,
            source: r.source,
            source_url: r.source_url,
        }
    }
}

#[tauri::command]
pub async fn search_skills_online(
    query: String,
    limit: Option<u32>,
) -> Result<Vec<OnlineSkillDto>, String> {
    let limit = limit.unwrap_or(20) as usize;
    tauri::async_runtime::spawn_blocking(move || {
        let results = search_skills_online_core(&query, limit)?;
        Ok::<_, anyhow::Error>(results.into_iter().map(OnlineSkillDto::from).collect())
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct SkillFileEntry {
    pub path: String,
    pub size: u64,
}

#[tauri::command]
pub async fn list_skill_files(central_path: String) -> Result<Vec<SkillFileEntry>, String> {
    let path = std::path::PathBuf::from(&central_path);
    tauri::async_runtime::spawn_blocking(move || {
        let entries = crate::core::skill_files::list_files(&path)?;
        Ok::<_, anyhow::Error>(
            entries
                .into_iter()
                .map(|e| SkillFileEntry {
                    path: e.path,
                    size: e.size,
                })
                .collect(),
        )
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub async fn read_skill_file(central_path: String, file_path: String) -> Result<String, String> {
    let base = std::path::PathBuf::from(&central_path);
    tauri::async_runtime::spawn_blocking(move || {
        crate::core::skill_files::read_file(&base, &file_path)
    })
    .await
    .map_err(|err| err.to_string())?
    .map_err(format_anyhow_error)
}

#[tauri::command]
pub fn cancel_current_operation(cancel: State<'_, Arc<CancelToken>>) -> Result<(), String> {
    cancel.cancel();
    Ok(())
}

#[cfg(test)]
#[path = "tests/commands.rs"]
mod tests;


================================================
FILE: src-tauri/src/commands/tests/commands.rs
================================================
use super::*;
use crate::core::skill_store::SkillRecord;

fn make_store() -> (tempfile::TempDir, SkillStore) {
    let dir = tempfile::tempdir().expect("tempdir");
    let store = SkillStore::new(dir.path().join("test.db"));
    store.ensure_schema().expect("ensure_schema");
    (dir, store)
}

#[test]
fn format_anyhow_error_passthrough_prefixes() {
    let err = anyhow::anyhow!("MULTI_SKILLS|abc");
    assert_eq!(format_anyhow_error(err), "MULTI_SKILLS|abc");
}

#[test]
fn format_anyhow_error_redacts_clone_temp_path() {
    let err = anyhow::anyhow!("clone https://example.com/a/b into /tmp/skills-hub-git-123");
    let msg = format_anyhow_error(err);
    assert!(msg.contains("已省略临时目录"));
    assert!(!msg.contains("/tmp/skills-hub-git-123"));
}

#[test]
fn format_anyhow_error_github_hint_auth() {
    let err = anyhow::anyhow!("git clone https://github.com/a/b failed: authentication failed");
    let msg = format_anyhow_error(err);
    assert!(msg.contains("无法访问该仓库"));
}

#[test]
fn expand_home_path_basic() {
    let home = dirs::home_dir().expect("home");
    assert_eq!(expand_home_path("~").unwrap(), home);
    assert_eq!(expand_home_path("~/abc").unwrap(), home.join("abc"));
}

#[test]
fn expand_home_path_empty_is_error() {
    let err = expand_home_path("  ").unwrap_err().to_string();
    assert!(err.contains("storage path is empty"));
}

#[test]
fn normalize_scope_defaults_to_global_and_rejects_unknown() {
    assert_eq!(normalize_scope(None).unwrap(), "global");
    assert_eq!(normalize_scope(Some("global")).unwrap(), "global");
    assert_eq!(normalize_scope(Some("project")).unwrap(), "project");
    assert!(normalize_scope(Some("workspace")).is_err());
}

#[test]
fn recent_projects_are_deduped_ordered_and_limited() {
    let (_dir, store) = make_store();
    let project_root = tempfile::tempdir().unwrap();
    let mut paths = Vec::new();
    for i in 0..9 {
        let path = project_root.path().join(format!("project-{i}"));
        std::fs::create_dir_all(&path).unwrap();
        paths.push(path);
    }

    for path in &paths {
        save_recent_project_impl(&store, path.to_string_lossy().as_ref()).unwrap();
    }

    let recent = get_recent_projects_impl(&store).unwrap();
    assert_eq!(recent.len(), 8);
    assert_eq!(recent[0], paths[8].to_string_lossy());
    assert_eq!(recent[7], paths[1].to_string_lossy());
    assert!(!recent.contains(&paths[0].to_string_lossy().to_string()));

    save_recent_project_impl(&store, paths[3].to_string_lossy().as_ref()).unwrap();
    let recent = get_recent_projects_impl(&store).unwrap();
    assert_eq!(recent.len(), 8);
    assert_eq!(recent[0], paths[3].to_string_lossy());
    assert_eq!(
        recent
            .iter()
            .filter(|item| *item == &paths[3].to_string_lossy())
            .count(),
        1
    );
}

#[test]
fn save_recent_project_rejects_missing_directory() {
    let (_dir, store) = make_store();
    let missing = tempfile::tempdir().unwrap().path().join("missing-project");
    let err = save_recent_project_impl(&store, missing.to_string_lossy().as_ref())
        .unwrap_err()
        .to_string();
    assert!(err.contains("projectPath must be an existing directory"));
}

#[test]
fn remove_path_any_handles_file_dir_and_missing() {
    let dir = tempfile::tempdir().unwrap();
    let file = dir.path().join("f.txt");
    std::fs::write(&file, b"1").unwrap();
    remove_path_any(file.to_string_lossy().as_ref()).unwrap();
    assert!(!file.exists());

    let sub = dir.path().join("d");
    std::fs::create_dir_all(&sub).unwrap();
    remove_path_any(sub.to_string_lossy().as_ref()).unwrap();
    assert!(!sub.exists());

    remove_path_any(dir.path().join("missing").to_string_lossy().as_ref()).unwrap();
}

#[test]
#[cfg(unix)]
fn remove_path_any_removes_symlink_only() {
    use std::os::unix::fs::symlink;

    let dir = tempfile::tempdir().unwrap();
    let target = dir.path().join("real");
    std::fs::create_dir_all(&target).unwrap();
    let link = dir.path().join("link");
    symlink(&target, &link).unwrap();

    remove_path_any(link.to_string_lossy().as_ref()).unwrap();
    assert!(!link.exists());
    assert!(target.exists());
}

#[test]
fn get_managed_skills_impl_maps_targets() {
    let (_dir, store) = make_store();
    let skill = SkillRecord {
        id: "s1".to_string(),
        name: "S1".to_string(),
        description: None,
        source_type: "local".to_string(),
        source_ref: Some("/tmp/src".to_string()),
        source_subpath: None,
        source_revision: None,
        central_path: "/tmp/central".to_string(),
        content_hash: None,
        created_at: 1,
        updated_at: 2,
        last_sync_at: None,
        last_seen_at: 1,
        status: "ok".to_string(),
    };
    store.upsert_skill(&skill).unwrap();

    let target = SkillTargetRecord {
        id: "t1".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: "/tmp/target".to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: None,
    };
    store.upsert_skill_target(&target).unwrap();
    let tag = store.create_tag("Frontend").unwrap();
    store.set_skill_tags("s1", &[tag.id]).unwrap();

    let out = get_managed_skills_impl(&store).unwrap();
    assert_eq!(out.len(), 1);
    assert_eq!(out[0].tags.len(), 1);
    assert_eq!(out[0].tags[0].name, "Frontend");
    assert_eq!(out[0].targets.len(), 1);
    assert_eq!(out[0].targets[0].tool, "cursor");
    assert_eq!(out[0].targets[0].scope, "global");
    assert!(out[0].targets[0].project_path.is_none());
}


================================================
FILE: src-tauri/src/core/cache_cleanup.rs
================================================
use std::path::{Path, PathBuf};
use std::time::{Duration, SystemTime};

use anyhow::{Context, Result};
use serde::Deserialize;
use tauri::Manager;

use super::skill_store::SkillStore;

const CACHE_DIR_NAME: &str = "skills-hub-git-cache";
const CACHE_META_FILE: &str = ".skills-hub-cache.json";
pub const GIT_CACHE_CLEANUP_DAYS_KEY: &str = "git_cache_cleanup_days";
pub const DEFAULT_GIT_CACHE_CLEANUP_DAYS: i64 = 30;
const MAX_GIT_CACHE_CLEANUP_DAYS: i64 = 3650;
pub const GIT_CACHE_TTL_SECS_KEY: &str = "git_cache_ttl_secs";
pub const DEFAULT_GIT_CACHE_TTL_SECS: i64 = 60;
const MAX_GIT_CACHE_TTL_SECS: i64 = 3600;

#[derive(Debug, Deserialize)]
struct RepoCacheMeta {
    last_fetched_ms: i64,
}

pub fn get_git_cache_cleanup_days(store: &SkillStore) -> i64 {
    let raw = store.get_setting(GIT_CACHE_CLEANUP_DAYS_KEY).ok().flatten();
    parse_cleanup_days(raw).unwrap_or(DEFAULT_GIT_CACHE_CLEANUP_DAYS)
}

pub fn set_git_cache_cleanup_days(store: &SkillStore, days: i64) -> Result<i64> {
    if !(0..=MAX_GIT_CACHE_CLEANUP_DAYS).contains(&days) {
        anyhow::bail!(
            "cleanup days must be between 0 and {}",
            MAX_GIT_CACHE_CLEANUP_DAYS
        );
    }
    store.set_setting(GIT_CACHE_CLEANUP_DAYS_KEY, &days.to_string())?;
    Ok(days)
}

pub fn get_git_cache_ttl_secs(store: &SkillStore) -> i64 {
    let raw = store.get_setting(GIT_CACHE_TTL_SECS_KEY).ok().flatten();
    parse_cache_ttl_secs(raw).unwrap_or(DEFAULT_GIT_CACHE_TTL_SECS)
}

pub fn set_git_cache_ttl_secs(store: &SkillStore, secs: i64) -> Result<i64> {
    if !(0..=MAX_GIT_CACHE_TTL_SECS).contains(&secs) {
        anyhow::bail!(
            "cache ttl seconds must be between 0 and {}",
            MAX_GIT_CACHE_TTL_SECS
        );
    }
    store.set_setting(GIT_CACHE_TTL_SECS_KEY, &secs.to_string())?;
    Ok(secs)
}

pub fn cleanup_git_cache_dirs<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    max_age: Duration,
) -> Result<usize> {
    let cache_dir = app
        .path()
        .app_cache_dir()
        .context("failed to resolve app cache dir")?;
    cleanup_git_cache_dirs_in(&cache_dir, max_age)
}

fn cleanup_git_cache_dirs_in(cache_dir: &Path, max_age: Duration) -> Result<usize> {
    let cache_root = cache_dir.join(CACHE_DIR_NAME);
    if !cache_root.exists() {
        return Ok(0);
    }

    let cutoff_ms = now_ms().saturating_sub(max_age.as_millis().try_into().unwrap_or(i64::MAX));
    let cutoff_time = SystemTime::now()
        .checked_sub(max_age)
        .unwrap_or(SystemTime::UNIX_EPOCH);

    let mut removed = 0usize;
    let rd = match std::fs::read_dir(&cache_root) {
        Ok(v) => v,
        Err(err) => {
            return Err(anyhow::anyhow!(
                "failed to read cache dir {:?}: {}",
                cache_root,
                err
            ));
        }
    };

    for entry in rd.flatten() {
        let path: PathBuf = entry.path();
        if !path.is_dir() {
            continue;
        }

        if !path.join(".git").exists() {
            continue;
        }

        let meta_path = path.join(CACHE_META_FILE);
        let mut should_remove = false;

        if let Ok(raw) = std::fs::read_to_string(&meta_path) {
            if let Ok(meta) = serde_json::from_str::<RepoCacheMeta>(&raw) {
                if meta.last_fetched_ms > 0 && meta.last_fetched_ms <= cutoff_ms {
                    should_remove = true;
                }
            }
        }

        if !should_remove {
            let meta = match std::fs::metadata(&path) {
                Ok(m) => m,
                Err(_) => continue,
            };
            let modified = meta.modified().unwrap_or(SystemTime::UNIX_EPOCH);
            if modified <= cutoff_time {
                should_remove = true;
            }
        }

        if should_remove && std::fs::remove_dir_all(&path).is_ok() {
            removed += 1;
        }
    }

    Ok(removed)
}

fn parse_cleanup_days(raw: Option<String>) -> Option<i64> {
    let value = raw?.trim().parse::<i64>().ok()?;
    if !(0..=MAX_GIT_CACHE_CLEANUP_DAYS).contains(&value) {
        None
    } else {
        Some(value)
    }
}

fn parse_cache_ttl_secs(raw: Option<String>) -> Option<i64> {
    let value = raw?.trim().parse::<i64>().ok()?;
    if !(0..=MAX_GIT_CACHE_TTL_SECS).contains(&value) {
        None
    } else {
        Some(value)
    }
}

fn now_ms() -> i64 {
    let now = SystemTime::now()
        .duration_since(SystemTime::UNIX_EPOCH)
        .unwrap_or_default();
    now.as_millis() as i64
}


================================================
FILE: src-tauri/src/core/cancel_token.rs
================================================
use std::sync::atomic::{AtomicBool, Ordering};

/// Shared cancellation flag for long-running operations.
/// Managed as Tauri state so both commands and core logic can access it.
#[derive(Debug, Default)]
pub struct CancelToken {
    cancelled: AtomicBool,
}

impl CancelToken {
    pub fn new() -> Self {
        Self {
            cancelled: AtomicBool::new(false),
        }
    }

    /// Request cancellation.
    pub fn cancel(&self) {
        self.cancelled.store(true, Ordering::SeqCst);
    }

    /// Reset the flag (call before starting a new operation).
    pub fn reset(&self) {
        self.cancelled.store(false, Ordering::SeqCst);
    }

    /// Check if cancellation was requested.
    pub fn is_cancelled(&self) -> bool {
        self.cancelled.load(Ordering::SeqCst)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn default_is_not_cancelled() {
        let token = CancelToken::new();
        assert!(!token.is_cancelled());
    }

    #[test]
    fn cancel_sets_flag() {
        let token = CancelToken::new();
        token.cancel();
        assert!(token.is_cancelled());
    }

    #[test]
    fn reset_clears_flag() {
        let token = CancelToken::new();
        token.cancel();
        assert!(token.is_cancelled());
        token.reset();
        assert!(!token.is_cancelled());
    }
}


================================================
FILE: src-tauri/src/core/central_repo.rs
================================================
use std::path::{Path, PathBuf};

use anyhow::{Context, Result};
use dirs::home_dir;
use tauri::Manager;

use super::skill_store::SkillStore;

const CENTRAL_DIR_NAME: &str = ".skillshub";

pub fn resolve_central_repo_path<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
) -> Result<PathBuf> {
    if let Some(path) = store.get_setting("central_repo_path")? {
        return Ok(PathBuf::from(path));
    }

    if let Some(home) = home_dir() {
        return Ok(home.join(CENTRAL_DIR_NAME));
    }

    let base = app
        .path()
        .app_data_dir()
        .context("failed to resolve app data dir")?;
    Ok(base.join(CENTRAL_DIR_NAME))
}

pub fn ensure_central_repo(path: &Path) -> Result<()> {
    std::fs::create_dir_all(path).with_context(|| format!("create {:?}", path))?;
    Ok(())
}

#[cfg(test)]
#[path = "tests/central_repo.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/content_hash.rs
================================================
use std::path::Path;

use anyhow::{Context, Result};
use sha2::{Digest, Sha256};
use walkdir::{DirEntry, WalkDir};

const IGNORE_NAMES: [&str; 4] = [".git", ".DS_Store", "Thumbs.db", ".gitignore"];

fn is_ignored(entry: &DirEntry) -> bool {
    let file_name = entry.file_name().to_string_lossy();
    IGNORE_NAMES.iter().any(|name| name == &file_name.as_ref())
}

pub fn hash_dir(path: &Path) -> Result<String> {
    let mut hasher = Sha256::new();

    for entry in WalkDir::new(path)
        .follow_links(false)
        .into_iter()
        .filter_entry(|entry| !is_ignored(entry))
    {
        let entry = entry?;
        if is_ignored(&entry) {
            continue;
        }

        let relative = entry
            .path()
            .strip_prefix(path)
            .with_context(|| format!("strip prefix {:?}", entry.path()))?;
        hasher.update(relative.to_string_lossy().as_bytes());

        if entry.file_type().is_file() {
            let bytes = std::fs::read(entry.path())
                .with_context(|| format!("read file {:?}", entry.path()))?;
            hasher.update(bytes);
        }
    }

    let digest = hasher.finalize();
    Ok(hex::encode(digest))
}

#[cfg(test)]
#[path = "tests/content_hash.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/featured_skills.rs
================================================
use anyhow::{Context, Result};
use reqwest::blocking::Client;
use serde::Deserialize;

use super::skill_store::SkillStore;

const FEATURED_SKILLS_URL: &str =
    "https://raw.githubusercontent.com/qufei1993/skills-hub/main/featured-skills.json";

const CACHE_KEY: &str = "featured_skills_cache";

// Bundled fallback so the app works even before the first network fetch succeeds.
const BUNDLED_JSON: &str = include_str!("../../../featured-skills.json");

#[derive(Debug, Deserialize)]
struct FeaturedSkillsData {
    skills: Vec<FeaturedSkillRaw>,
}

#[derive(Debug, Deserialize)]
struct FeaturedSkillRaw {
    slug: String,
    name: String,
    #[serde(default)]
    summary: String,
    #[serde(default)]
    downloads: u64,
    #[serde(default)]
    stars: u64,
    #[serde(default)]
    source_url: String,
}

#[derive(Debug, Clone, serde::Serialize)]
pub struct FeaturedSkill {
    pub slug: String,
    pub name: String,
    pub summary: String,
    pub downloads: u64,
    pub stars: u64,
    pub source_url: String,
}

pub fn fetch_featured_skills(store: &SkillStore) -> Result<Vec<FeaturedSkill>> {
    fetch_featured_skills_inner(FEATURED_SKILLS_URL, store)
}

fn fetch_featured_skills_inner(url: &str, store: &SkillStore) -> Result<Vec<FeaturedSkill>> {
    if let Ok(json_str) = fetch_from_url(url) {
        if let Ok(skills) = parse_and_filter(&json_str) {
            if !skills.is_empty() {
                let _ = store.set_setting(CACHE_KEY, &json_str);
                return Ok(skills);
            }
        }
    }
    // Fallback to cache
    if let Ok(Some(cached)) = store.get_setting(CACHE_KEY) {
        if let Ok(skills) = parse_and_filter(&cached) {
            if !skills.is_empty() {
                return Ok(skills);
            }
        }
    }
    // Fallback to bundled JSON
    Ok(parse_and_filter(BUNDLED_JSON).unwrap_or_default())
}

fn fetch_from_url(url: &str) -> Result<String> {
    let client = Client::builder()
        .timeout(std::time::Duration::from_secs(15))
        .build()
        .context("build HTTP client")?;

    let body = client
        .get(url)
        .header("User-Agent", "skills-hub")
        .send()
        .context("fetch featured skills")?
        .error_for_status()
        .context("featured skills HTTP error")?
        .text()
        .context("read featured skills body")?;

    Ok(body)
}

fn parse_and_filter(json_str: &str) -> Result<Vec<FeaturedSkill>> {
    let data: FeaturedSkillsData =
        serde_json::from_str(json_str).context("parse featured skills JSON")?;

    Ok(data
        .skills
        .into_iter()
        .filter(|s| !s.source_url.is_empty())
        .map(|s| FeaturedSkill {
            slug: s.slug,
            name: s.name,
            summary: s.summary,
            downloads: s.downloads,
            stars: s.stars,
            source_url: s.source_url,
        })
        .collect())
}

#[cfg(test)]
#[path = "tests/featured_skills.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/git_fetcher.rs
================================================
use std::path::Path;
use std::process::Command;
use std::process::Stdio;
use std::sync::OnceLock;
use std::time::{Duration, Instant};

use anyhow::{Context, Result};
use git2::{FetchOptions, Repository};

use super::cancel_token::CancelToken;

pub fn clone_or_pull(
    repo_url: &str,
    dest: &Path,
    branch: Option<&str>,
    cancel: Option<&CancelToken>,
) -> Result<String> {
    // Prefer the system `git` binary if available. It tends to work better on macOS
    // networks because it respects user git config (proxy/certs) and OS trust store.
    if let Some(git_bin) = resolve_git_bin() {
        let started = Instant::now();
        match clone_or_pull_via_git_cli(repo_url, dest, branch, cancel) {
            Ok(head) => {
                log::info!(
                    "[git_fetcher] git-cli ok (bin={}) {}s url={}",
                    git_bin,
                    started.elapsed().as_secs_f32(),
                    repo_url
                );
                return Ok(head);
            }
            Err(err) => {
                let allow_fallback = std::env::var("SKILLS_HUB_ALLOW_LIBGIT2_FALLBACK")
                    .ok()
                    .map(|v| v == "1" || v.eq_ignore_ascii_case("true"))
                    .unwrap_or(false);
                log::warn!(
                    "[git_fetcher] git-cli failed (bin={}) {}s url={} err={:#}",
                    git_bin,
                    started.elapsed().as_secs_f32(),
                    repo_url,
                    err
                );
                if !allow_fallback {
                    anyhow::bail!(
                        "git 命令执行失败（为避免卡死，已停止并不再回退到内置 git）。请检查系统 git/网络/代理；或设置环境变量 SKILLS_HUB_ALLOW_LIBGIT2_FALLBACK=1 允许回退。\n{:#}",
                        err
                    );
                }
                log::warn!(
                    "[git_fetcher] falling back to libgit2 (SKILLS_HUB_ALLOW_LIBGIT2_FALLBACK=1)"
                );
            }
        }
    } else {
        log::info!("[git_fetcher] system git not available; using libgit2");
    }

    let repo = if dest.exists() {
        let repo = Repository::open(dest).with_context(|| format!("open repo at {:?}", dest))?;
        fetch_origin(&repo)?;
        repo
    } else {
        Repository::clone(repo_url, dest)
            .with_context(|| format!("clone {} into {:?}", repo_url, dest))?
    };

    // Best-effort: move working tree HEAD to the fetched remote head (so "pull" actually updates).
    if let Some(branch) = branch {
        if let Ok(obj) = repo.revparse_single(&format!("refs/remotes/origin/{}", branch)) {
            repo.checkout_tree(&obj, None)?;
            repo.set_head_detached(obj.id())?;
        }
    } else {
        let candidates = [
            "refs/remotes/origin/HEAD",
            "refs/remotes/origin/main",
            "refs/remotes/origin/master",
        ];
        for r in candidates {
            if let Ok(obj) = repo.revparse_single(r) {
                repo.checkout_tree(&obj, None)?;
                repo.set_head_detached(obj.id())?;
                break;
            }
        }
    }

    let head = repo.head()?.target().context("missing HEAD target")?;
    Ok(head.to_string())
}

pub fn clone_or_pull_sparse(
    repo_url: &str,
    dest: &Path,
    branch: Option<&str>,
    subpath: &str,
    cancel: Option<&CancelToken>,
) -> Result<String> {
    let clean_subpath = subpath.trim_matches('/');
    if clean_subpath.is_empty() {
        anyhow::bail!("sparse checkout path is empty");
    }

    if resolve_git_bin().is_none() {
        anyhow::bail!("system git is required for sparse checkout");
    }

    // Ensure parent exists so `git clone` can create dest.
    if let Some(parent) = dest.parent() {
        std::fs::create_dir_all(parent)
            .with_context(|| format!("failed to create parent dir {:?}", parent))?;
    }

    if dest.exists() {
        let git_dir = dest.join(".git");
        for lock_name in &["index.lock", "shallow.lock", "HEAD.lock"] {
            let lock_path = git_dir.join(lock_name);
            if lock_path.exists() {
                log::warn!("[git_fetcher] removing stale lock file: {:?}", lock_path);
                let _ = std::fs::remove_file(&lock_path);
            }
        }

        let out = run_cmd_with_timeout(
            {
                let mut cmd = git_cmd();
                cmd.arg("-C").arg(dest).args([
                    "sparse-checkout",
                    "set",
                    "--no-cone",
                    clean_subpath,
                ]);
                cmd
            },
            git_fetch_timeout(),
            format!("git sparse-checkout set {} in {:?}", clean_subpath, dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!(
                "git sparse-checkout set failed: {}",
                String::from_utf8_lossy(&out.stderr)
            );
        }

        let out = run_cmd_with_timeout(
            {
                let mut cmd = git_cmd();
                cmd.arg("-C").arg(dest).args(["fetch", "--prune", "origin"]);
                cmd
            },
            git_fetch_timeout(),
            format!("git fetch in {:?}", dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!("git fetch failed: {}", String::from_utf8_lossy(&out.stderr));
        }

        if let Some(branch) = branch {
            let out = run_cmd_with_timeout(
                {
                    let mut cmd = git_cmd();
                    cmd.arg("-C").arg(dest).args([
                        "checkout",
                        "-B",
                        branch,
                        &format!("origin/{}", branch),
                    ]);
                    cmd
                },
                git_fetch_timeout(),
                format!("git checkout -B {} in {:?}", branch, dest),
                cancel,
            )?;
            if !out.status.success() {
                anyhow::bail!(
                    "git checkout branch failed: {}",
                    String::from_utf8_lossy(&out.stderr)
                );
            }
        } else {
            let out = run_cmd_with_timeout(
                {
                    let mut cmd = git_cmd();
                    cmd.arg("-C")
                        .arg(dest)
                        .args(["reset", "--hard", "FETCH_HEAD"]);
                    cmd
                },
                git_fetch_timeout(),
                format!("git reset --hard in {:?}", dest),
                cancel,
            )?;
            if !out.status.success() {
                anyhow::bail!(
                    "git reset --hard failed: {}",
                    String::from_utf8_lossy(&out.stderr)
                );
            }
        }
    } else {
        let mut cmd = git_cmd();
        cmd.arg("clone").args([
            "--depth",
            "1",
            "--filter=blob:none",
            "--sparse",
            "--no-tags",
        ]);
        if let Some(branch) = branch {
            cmd.arg("--branch").arg(branch).arg("--single-branch");
        }
        cmd.arg(repo_url).arg(dest);
        let out = run_cmd_with_timeout(
            cmd,
            git_timeout(),
            format!("git clone {} into {:?}", repo_url, dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!("git clone failed: {}", String::from_utf8_lossy(&out.stderr));
        }

        let out = run_cmd_with_timeout(
            {
                let mut cmd = git_cmd();
                cmd.arg("-C").arg(dest).args([
                    "sparse-checkout",
                    "set",
                    "--no-cone",
                    clean_subpath,
                ]);
                cmd
            },
            git_fetch_timeout(),
            format!("git sparse-checkout set {} in {:?}", clean_subpath, dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!(
                "git sparse-checkout set failed: {}",
                String::from_utf8_lossy(&out.stderr)
            );
        }
    }

    let out = run_cmd_with_timeout(
        {
            let mut cmd = git_cmd();
            cmd.arg("-C").arg(dest).args(["rev-parse", "HEAD"]);
            cmd
        },
        git_fetch_timeout(),
        format!("git rev-parse HEAD in {:?}", dest),
        cancel,
    )?;
    if !out.status.success() {
        anyhow::bail!(
            "git rev-parse failed: {}",
            String::from_utf8_lossy(&out.stderr)
        );
    }
    Ok(String::from_utf8_lossy(&out.stdout).trim().to_string())
}

fn git_timeout() -> Duration {
    let secs = std::env::var("SKILLS_HUB_GIT_TIMEOUT_SECS")
        .ok()
        .and_then(|v| v.parse::<u64>().ok())
        .unwrap_or(300);
    Duration::from_secs(secs)
}

fn git_fetch_timeout() -> Duration {
    let secs = std::env::var("SKILLS_HUB_GIT_FETCH_TIMEOUT_SECS")
        .ok()
        .and_then(|v| v.parse::<u64>().ok())
        .unwrap_or(180);
    Duration::from_secs(secs)
}

static GIT_BIN: OnceLock<Option<String>> = OnceLock::new();

fn resolve_git_bin() -> Option<String> {
    GIT_BIN
        .get_or_init(|| {
            // Allow overriding from environment for debugging / enterprise setups.
            for key in ["SKILLS_HUB_GIT_BIN", "SKILLS_HUB_GIT_PATH"] {
                if let Ok(v) = std::env::var(key) {
                    let v = v.trim().to_string();
                    if !v.is_empty() && git_bin_works(&v) {
                        log::info!("[git_fetcher] using git bin from {}: {}", key, v);
                        return Some(v);
                    }
                }
            }

            // Try PATH lookup first (works in dev; sometimes missing in macOS bundles).
            if git_bin_works("git") {
                log::info!("[git_fetcher] using git bin from PATH: git");
                return Some("git".to_string());
            }

            // Common macOS locations (system git and Homebrew).
            for cand in [
                "/usr/bin/git",
                "/opt/homebrew/bin/git",
                "/usr/local/bin/git",
            ] {
                if git_bin_works(cand) {
                    log::info!("[git_fetcher] using git bin: {}", cand);
                    return Some(cand.to_string());
                }
            }

            log::warn!("[git_fetcher] no usable git binary found");
            None
        })
        .clone()
}

fn git_bin_works(bin: &str) -> bool {
    Command::new(bin)
        .arg("--version")
        .stdin(Stdio::null())
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .output()
        .map(|o| o.status.success())
        .unwrap_or(false)
}

fn git_cmd() -> Command {
    let bin = resolve_git_bin().unwrap_or_else(|| "git".to_string());
    let mut cmd = Command::new(bin);
    // Never block on interactive auth prompts inside a GUI app.
    cmd.env("GIT_TERMINAL_PROMPT", "0")
        .env("GIT_ASKPASS", "echo");
    // Abort stalled HTTPS transfers (helps avoid "spinner forever" on bad networks).
    cmd.env("GIT_HTTP_LOW_SPEED_LIMIT", "1024")
        .env("GIT_HTTP_LOW_SPEED_TIME", "120");
    cmd
}

fn run_cmd_with_timeout(
    mut cmd: Command,
    timeout: Duration,
    context: String,
    cancel: Option<&CancelToken>,
) -> Result<std::process::Output> {
    cmd.stdin(Stdio::null())
        .stdout(Stdio::piped())
        .stderr(Stdio::piped());

    let mut child = cmd.spawn().with_context(|| context.clone())?;
    let start = Instant::now();
    loop {
        if cancel.is_some_and(|c| c.is_cancelled()) {
            let _ = child.kill();
            let _ = child.wait();
            anyhow::bail!("CANCELLED|操作已被用户取消。");
        }

        if start.elapsed() > timeout {
            let _ = child.kill();
            let stderr = child
                .wait_with_output()
                .map(|out| String::from_utf8_lossy(&out.stderr).to_string())
                .unwrap_or_default();
            anyhow::bail!(
                "git 操作超时（{}s）。请检查网络/代理是否可访问 GitHub；也可设置环境变量 SKILLS_HUB_GIT_TIMEOUT_SECS 增大超时。\n{}",
                timeout.as_secs(),
                stderr.trim()
            );
        }

        match child.try_wait() {
            Ok(Some(_)) => return child.wait_with_output().with_context(|| context.clone()),
            Ok(None) => std::thread::sleep(Duration::from_millis(200)),
            Err(err) => return Err(err).with_context(|| context.clone()),
        }
    }
}

fn clone_or_pull_via_git_cli(
    repo_url: &str,
    dest: &Path,
    branch: Option<&str>,
    cancel: Option<&CancelToken>,
) -> Result<String> {
    // Ensure parent exists so `git clone` can create dest.
    if let Some(parent) = dest.parent() {
        std::fs::create_dir_all(parent)
            .with_context(|| format!("failed to create parent dir {:?}", parent))?;
    }

    if dest.exists() {
        // Remove stale lock files left by a previously crashed git process.
        let git_dir = dest.join(".git");
        for lock_name in &["index.lock", "shallow.lock", "HEAD.lock"] {
            let lock_path = git_dir.join(lock_name);
            if lock_path.exists() {
                log::warn!("[git_fetcher] removing stale lock file: {:?}", lock_path);
                let _ = std::fs::remove_file(&lock_path);
            }
        }

        // Fetch updates.
        let out = run_cmd_with_timeout(
            {
                let mut cmd = git_cmd();
                cmd.arg("-C").arg(dest).args(["fetch", "--prune", "origin"]);
                cmd
            },
            git_fetch_timeout(),
            format!("git fetch in {:?}", dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!("git fetch failed: {}", String::from_utf8_lossy(&out.stderr));
        }

        // Move local HEAD to fetched commit.
        if let Some(branch) = branch {
            let out = run_cmd_with_timeout(
                {
                    let mut cmd = git_cmd();
                    cmd.arg("-C").arg(dest).args([
                        "checkout",
                        "-B",
                        branch,
                        &format!("origin/{}", branch),
                    ]);
                    cmd
                },
                git_fetch_timeout(),
                format!("git checkout -B {} in {:?}", branch, dest),
                cancel,
            )?;
            if !out.status.success() {
                anyhow::bail!(
                    "git checkout branch failed: {}",
                    String::from_utf8_lossy(&out.stderr)
                );
            }
        } else {
            let out = run_cmd_with_timeout(
                {
                    let mut cmd = git_cmd();
                    cmd.arg("-C")
                        .arg(dest)
                        .args(["reset", "--hard", "FETCH_HEAD"]);
                    cmd
                },
                git_fetch_timeout(),
                format!("git reset --hard in {:?}", dest),
                cancel,
            )?;
            if !out.status.success() {
                anyhow::bail!(
                    "git reset --hard failed: {}",
                    String::from_utf8_lossy(&out.stderr)
                );
            }
        }
    } else {
        // Clone.
        let mut cmd = git_cmd();
        cmd.arg("clone")
            .args(["--depth", "1", "--filter=blob:none", "--no-tags"]);
        if let Some(branch) = branch {
            cmd.arg("--branch").arg(branch).arg("--single-branch");
        }
        cmd.arg(repo_url).arg(dest);
        let out = run_cmd_with_timeout(
            cmd,
            git_timeout(),
            format!("git clone {} into {:?}", repo_url, dest),
            cancel,
        )?;
        if !out.status.success() {
            anyhow::bail!("git clone failed: {}", String::from_utf8_lossy(&out.stderr));
        }
    }

    // Checkout desired branch if specified (best-effort; shallow clones may already be on it).
    if let Some(branch) = branch {
        let out = run_cmd_with_timeout(
            {
                let mut cmd = git_cmd();
                cmd.arg("-C").arg(dest).args(["checkout", branch]);
                cmd
            },
            git_fetch_timeout(),
            format!("git checkout {} in {:?}", branch, dest),
            cancel,
        )?;
        if !out.status.success() {
            // Don't hard-fail; still return HEAD for caller.
            // But include useful context for debugging.
            let stderr = String::from_utf8_lossy(&out.stderr);
            if !stderr.trim().is_empty() {
                eprintln!("[git_fetcher] checkout warning: {}", stderr);
            }
        }
    }

    // Read HEAD revision.
    let out = run_cmd_with_timeout(
        {
            let mut cmd = git_cmd();
            cmd.arg("-C").arg(dest).args(["rev-parse", "HEAD"]);
            cmd
        },
        git_fetch_timeout(),
        format!("git rev-parse HEAD in {:?}", dest),
        cancel,
    )?;
    if !out.status.success() {
        anyhow::bail!(
            "git rev-parse failed: {}",
            String::from_utf8_lossy(&out.stderr)
        );
    }
    Ok(String::from_utf8_lossy(&out.stdout).trim().to_string())
}

fn fetch_origin(repo: &Repository) -> Result<()> {
    let mut remote = repo.find_remote("origin")?;
    let mut opts = FetchOptions::new();
    remote.fetch(
        &["refs/heads/*:refs/remotes/origin/*"],
        Some(&mut opts),
        None,
    )?;
    Ok(())
}

#[cfg(test)]
#[path = "tests/git_fetcher.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/github_download.rs
================================================
//! Download a GitHub directory via the Contents API, bypassing git clone entirely.
//! This is much faster than cloning large repos when only a subdirectory is needed.

use std::path::Path;

use anyhow::{Context, Result};
use reqwest::blocking::Client;
use serde::Deserialize;

use super::cancel_token::CancelToken;

#[derive(Debug, Deserialize)]
struct GithubContent {
    name: String,
    #[serde(rename = "type")]
    content_type: String,
    download_url: Option<String>,
    path: String,
}

/// Download a directory from a GitHub repo using the Contents API.
///
/// `owner`/`repo`: repository coordinates
/// `branch`: branch or ref (e.g. "main")
/// `path`: directory path within the repo (e.g. "skills/user/foo")
/// `dest`: local directory to write files into (will be created)
/// `cancel`: optional cancellation token
pub fn download_github_directory(
    owner: &str,
    repo: &str,
    branch: &str,
    path: &str,
    dest: &Path,
    cancel: Option<&CancelToken>,
    token: Option<&str>,
) -> Result<()> {
    let client = Client::builder()
        .timeout(std::time::Duration::from_secs(30))
        .build()
        .context("build HTTP client")?;

    std::fs::create_dir_all(dest).with_context(|| format!("create directory {:?}", dest))?;

    download_dir_recursive(&client, owner, repo, branch, path, dest, cancel, token)
}

#[allow(clippy::too_many_arguments)]
fn download_dir_recursive(
    client: &Client,
    owner: &str,
    repo: &str,
    branch: &str,
    path: &str,
    dest: &Path,
    cancel: Option<&CancelToken>,
    token: Option<&str>,
) -> Result<()> {
    if cancel.is_some_and(|c| c.is_cancelled()) {
        anyhow::bail!("CANCELLED|操作已被用户取消。");
    }

    let url = format!(
        "https://api.github.com/repos/{}/{}/contents/{}?ref={}",
        owner, repo, path, branch
    );

    let mut req = client
        .get(&url)
        .header("User-Agent", "skills-hub")
        .header("Accept", "application/vnd.github.v3+json");
    if let Some(t) = token {
        req = req.header("Authorization", format!("Bearer {}", t));
    }
    let resp = req
        .send()
        .with_context(|| format!("request GitHub contents: {}", url))?;
    let resp = check_github_response(resp, &url)?;

    let items: Vec<GithubContent> = resp
        .json()
        .with_context(|| format!("parse GitHub contents response: {}", url))?;

    for item in items {
        if cancel.is_some_and(|c| c.is_cancelled()) {
            anyhow::bail!("CANCELLED|操作已被用户取消。");
        }

        let local_path = dest.join(&item.name);

        match item.content_type.as_str() {
            "file" => {
                if let Some(download_url) = &item.download_url {
                    if let Some(parent) = local_path.parent() {
                        std::fs::create_dir_all(parent)
                            .with_context(|| format!("create parent dir {:?}", parent))?;
                    }
                    let mut file_req = client.get(download_url).header("User-Agent", "skills-hub");
                    if let Some(t) = token {
                        file_req = file_req.header("Authorization", format!("Bearer {}", t));
                    }
                    let file_resp = file_req
                        .send()
                        .with_context(|| format!("download file: {}", item.path))?;
                    let file_resp = check_github_response(file_resp, &item.path)?;
                    let bytes = file_resp
                        .bytes()
                        .with_context(|| format!("read file bytes: {}", item.path))?;

                    std::fs::write(&local_path, &bytes)
                        .with_context(|| format!("write file {:?}", local_path))?;
                }
            }
            "dir" => {
                download_dir_recursive(
                    client,
                    owner,
                    repo,
                    branch,
                    &item.path,
                    &local_path,
                    cancel,
                    token,
                )?;
            }
            _ => {
                // Skip symlinks, submodules, etc.
            }
        }
    }

    Ok(())
}

/// Check a GitHub API response for rate-limit errors and surface a helpful message.
fn check_github_response(
    resp: reqwest::blocking::Response,
    context: &str,
) -> Result<reqwest::blocking::Response> {
    let status = resp.status();
    if status.is_success() {
        return Ok(resp);
    }
    if status.as_u16() == 403 {
        let reset_hint = resp
            .headers()
            .get("x-ratelimit-reset")
            .and_then(|v| v.to_str().ok())
            .and_then(|v| v.parse::<i64>().ok())
            .map(|ts| {
                let now = std::time::SystemTime::now()
                    .duration_since(std::time::UNIX_EPOCH)
                    .unwrap_or_default()
                    .as_secs() as i64;
                let wait_mins = ((ts - now).max(0) + 59) / 60; // round up
                format!("RATE_LIMITED|{}", wait_mins)
            })
            .unwrap_or_else(|| "403 Forbidden".to_string());
        anyhow::bail!("{}", reset_hint);
    }
    // For other errors, use the standard error_for_status logic.
    Err(anyhow::anyhow!(
        "GitHub API error {} for: {}",
        status,
        context
    ))
}

/// Check if a GitHub URL with subpath can use the fast API download path.
/// Returns Some((owner, repo, branch, subpath)) if applicable.
pub fn parse_github_api_params(
    clone_url: &str,
    branch: Option<&str>,
    subpath: Option<&str>,
) -> Option<(String, String, String, String)> {
    // Only for GitHub URLs with a subpath
    let subpath = subpath?;
    if subpath.is_empty() || subpath == "." {
        return None;
    }

    // Extract owner/repo from clone_url like https://github.com/owner/repo.git
    let url = clone_url.trim_end_matches('/').trim_end_matches(".git");
    let prefix = "https://github.com/";
    if !url.starts_with(prefix) {
        return None;
    }
    let rest = &url[prefix.len()..];
    let parts: Vec<&str> = rest.split('/').collect();
    if parts.len() < 2 {
        return None;
    }

    Some((
        parts[0].to_string(),
        parts[1].to_string(),
        branch.unwrap_or("main").to_string(),
        subpath.to_string(),
    ))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn parse_github_api_params_extracts_correctly() {
        let result = parse_github_api_params(
            "https://github.com/openclaw/skills.git",
            Some("main"),
            Some("skills/user/foo"),
        );
        assert_eq!(
            result,
            Some((
                "openclaw".to_string(),
                "skills".to_string(),
                "main".to_string(),
                "skills/user/foo".to_string(),
            ))
        );
    }

    #[test]
    fn parse_github_api_params_returns_none_without_subpath() {
        let result =
            parse_github_api_params("https://github.com/openclaw/skills.git", Some("main"), None);
        assert_eq!(result, None);
    }

    #[test]
    fn parse_github_api_params_returns_none_for_root_subpath() {
        let result = parse_github_api_params(
            "https://github.com/openclaw/skills.git",
            Some("main"),
            Some("."),
        );
        assert_eq!(result, None);
    }

    #[test]
    fn parse_github_api_params_returns_none_for_non_github() {
        let result = parse_github_api_params(
            "https://gitlab.com/user/repo.git",
            Some("main"),
            Some("path"),
        );
        assert_eq!(result, None);
    }

    #[test]
    fn check_github_response_passes_success() {
        let mut server = mockito::Server::new();
        let _m = server
            .mock("GET", "/ok")
            .with_status(200)
            .with_body("ok")
            .create();
        let client = Client::new();
        let resp = client.get(format!("{}/ok", server.url())).send().unwrap();
        assert!(check_github_response(resp, "test").is_ok());
    }

    #[test]
    fn check_github_response_extracts_rate_limit_reset() {
        let mut server = mockito::Server::new();
        let reset_ts = std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap()
            .as_secs()
            + 600; // 10 minutes from now
        let _m = server
            .mock("GET", "/limited")
            .with_status(403)
            .with_header("x-ratelimit-reset", &reset_ts.to_string())
            .with_body("rate limited")
            .create();
        let client = Client::new();
        let resp = client
            .get(format!("{}/limited", server.url()))
            .send()
            .unwrap();
        let err = check_github_response(resp, "test").unwrap_err();
        let msg = format!("{:#}", err);
        assert!(msg.contains("RATE_LIMITED|"), "got: {}", msg);
        // Should contain a number of minutes (around 10)
        let mins: i64 = msg
            .strip_prefix("RATE_LIMITED|")
            .unwrap()
            .trim()
            .parse()
            .unwrap();
        assert!((9..=11).contains(&mins), "expected ~10 mins, got {}", mins);
    }

    #[test]
    fn check_github_response_handles_403_without_reset_header() {
        let mut server = mockito::Server::new();
        let _m = server
            .mock("GET", "/forbidden")
            .with_status(403)
            .with_body("forbidden")
            .create();
        let client = Client::new();
        let resp = client
            .get(format!("{}/forbidden", server.url()))
            .send()
            .unwrap();
        let err = check_github_response(resp, "test").unwrap_err();
        let msg = format!("{:#}", err);
        assert!(msg.contains("403"), "got: {}", msg);
    }

    #[test]
    fn check_github_response_handles_other_errors() {
        let mut server = mockito::Server::new();
        let _m = server
            .mock("GET", "/notfound")
            .with_status(404)
            .with_body("not found")
            .create();
        let client = Client::new();
        let resp = client
            .get(format!("{}/notfound", server.url()))
            .send()
            .unwrap();
        let err = check_github_response(resp, "test").unwrap_err();
        let msg = format!("{:#}", err);
        assert!(msg.contains("404"), "got: {}", msg);
    }
}


================================================
FILE: src-tauri/src/core/github_search.rs
================================================
use anyhow::{Context, Result};
use reqwest::blocking::Client;
use serde::Deserialize;

#[derive(Debug, Deserialize)]
struct SearchResponse {
    items: Vec<RepoItem>,
}

#[derive(Debug, Deserialize)]
struct RepoItem {
    full_name: String,
    html_url: String,
    description: Option<String>,
    stargazers_count: u64,
    updated_at: String,
    clone_url: String,
}

#[derive(Debug, Clone, serde::Serialize)]
pub struct RepoSummary {
    pub full_name: String,
    pub html_url: String,
    pub description: Option<String>,
    pub stars: u64,
    pub updated_at: String,
    pub clone_url: String,
}

pub fn search_github_repos(
    query: &str,
    limit: usize,
    token: Option<&str>,
) -> Result<Vec<RepoSummary>> {
    search_github_repos_inner("https://api.github.com", query, limit, token)
}

fn search_github_repos_inner(
    base_url: &str,
    query: &str,
    limit: usize,
    token: Option<&str>,
) -> Result<Vec<RepoSummary>> {
    let client = Client::new();
    let base_url = base_url.trim_end_matches('/');
    let url = format!(
        "{}/search/repositories?q={}&per_page={}",
        base_url,
        urlencoding::encode(query),
        limit.clamp(1, 50)
    );

    let mut req = client.get(url).header("User-Agent", "skills-hub");
    if let Some(t) = token {
        req = req.header("Authorization", format!("Bearer {}", t));
    }
    let response = req
        .send()
        .context("GitHub search request failed")?
        .error_for_status()
        .context("GitHub search returned error")?;

    let result: SearchResponse = response.json().context("parse GitHub response")?;

    Ok(result
        .items
        .into_iter()
        .map(|item| RepoSummary {
            full_name: item.full_name,
            html_url: item.html_url,
            description: item.description,
            stars: item.stargazers_count,
            updated_at: item.updated_at,
            clone_url: item.clone_url,
        })
        .collect())
}

#[cfg(test)]
#[path = "tests/github_search.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/installer.rs
================================================
use std::path::{Path, PathBuf};
use std::sync::{Mutex, OnceLock};

use anyhow::{Context, Result};
use serde::{Deserialize, Serialize};
use tauri::Manager;
use uuid::Uuid;

use super::cache_cleanup::get_git_cache_ttl_secs;
use super::cancel_token::CancelToken;
use super::central_repo::{ensure_central_repo, resolve_central_repo_path};
use super::content_hash::hash_dir;
use super::git_fetcher::{clone_or_pull, clone_or_pull_sparse};
use super::github_download::{download_github_directory, parse_github_api_params};
use super::skill_store::{SkillRecord, SkillStore};
use super::sync_engine::copy_dir_recursive;
use super::sync_engine::sync_dir_copy_with_overwrite;
use super::tool_adapters::adapter_by_key;
use super::tool_adapters::is_tool_installed;

pub struct InstallResult {
    pub skill_id: String,
    pub name: String,
    pub central_path: PathBuf,
    pub content_hash: Option<String>,
}

pub fn install_local_skill<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    source_path: &Path,
    name: Option<String>,
) -> Result<InstallResult> {
    if !source_path.exists() {
        anyhow::bail!("source path not found: {:?}", source_path);
    }

    let name = name.unwrap_or_else(|| {
        source_path
            .file_name()
            .map(|v| v.to_string_lossy().to_string())
            .unwrap_or_else(|| "unnamed-skill".to_string())
    });

    let central_dir = resolve_central_repo_path(app, store)?;
    ensure_central_repo(&central_dir)?;
    let central_path = central_dir.join(&name);

    if central_path.exists() {
        anyhow::bail!("skill already exists in central repo: {:?}", central_path);
    }

    copy_dir_recursive(source_path, &central_path)
        .with_context(|| format!("copy {:?} -> {:?}", source_path, central_path))?;

    let now = now_ms();
    let content_hash = compute_content_hash(&central_path);
    let description = parse_skill_md(&central_path.join("SKILL.md")).and_then(|(_, desc)| desc);

    let record = SkillRecord {
        id: Uuid::new_v4().to_string(),
        name,
        description,
        source_type: "local".to_string(),
        source_ref: Some(source_path.to_string_lossy().to_string()),
        source_subpath: None,
        source_revision: None,
        central_path: central_path.to_string_lossy().to_string(),
        content_hash: content_hash.clone(),
        created_at: now,
        updated_at: now,
        last_sync_at: None,
        last_seen_at: now,
        status: "ok".to_string(),
    };

    store.upsert_skill(&record)?;

    Ok(InstallResult {
        skill_id: record.id,
        name: record.name,
        central_path,
        content_hash,
    })
}

pub fn install_git_skill<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    repo_url: &str,
    name: Option<String>,
    cancel: Option<&CancelToken>,
) -> Result<InstallResult> {
    let parsed = parse_github_url(repo_url);
    let user_provided_name = name.is_some();
    let mut name = name.unwrap_or_else(|| {
        if let Some(subpath) = &parsed.subpath {
            if subpath == "." {
                derive_name_from_repo_url(&parsed.clone_url)
            } else {
                subpath
                    .rsplit('/')
                    .next()
                    .map(|s| s.to_string())
                    .unwrap_or_else(|| derive_name_from_repo_url(&parsed.clone_url))
            }
        } else {
            derive_name_from_repo_url(&parsed.clone_url)
        }
    });

    let central_dir = resolve_central_repo_path(app, store)?;
    ensure_central_repo(&central_dir)?;
    let mut central_path = central_dir.join(&name);

    if central_path.exists() {
        anyhow::bail!("skill already exists in central repo: {:?}", central_path);
    }

    // Fast path: for subpath installs, prefer sparse git checkout.
    // The old GitHub Contents API path is much slower on large repos because it performs
    // one directory/file request at a time and can time out before we even attempt git.
    let github_token = store.get_setting("github_token")?.unwrap_or_default();
    let github_token_opt = if github_token.is_empty() {
        None
    } else {
        Some(github_token.as_str())
    };
    let revision;
    if let Some((owner, repo, branch, subpath)) = parse_github_api_params(
        &parsed.clone_url,
        parsed.branch.as_deref(),
        parsed.subpath.as_deref(),
    ) {
        log::info!(
            "[installer] using sparse git checkout for subpath install: {}/{} path={}",
            owner,
            repo,
            subpath
        );
        match clone_to_cache_subpath(
            app,
            store,
            &parsed.clone_url,
            Some(branch.as_str()),
            &subpath,
            cancel,
        ) {
            Ok((repo_dir, rev)) => {
                let sub_src = repo_dir.join(&subpath);
                if !sub_src.exists() {
                    anyhow::bail!("subpath not found in repo: {:?}", sub_src);
                }
                ensure_installable_skill_dir(&sub_src)?;
                copy_dir_recursive(&sub_src, &central_path)
                    .with_context(|| format!("copy {:?} -> {:?}", sub_src, central_path))?;
                revision = rev;
            }
            Err(err) => {
                // Clean up partial content before fallback.
                let _ = std::fs::remove_dir_all(&central_path);
                let err_msg = format!("{:#}", err);
                if err_msg.contains("CANCELLED|") {
                    return Err(err);
                }
                log::warn!(
                    "[installer] sparse git checkout failed, falling back to GitHub API download: {:#}",
                    err
                );
                match download_github_directory(
                    &owner,
                    &repo,
                    &branch,
                    &subpath,
                    &central_path,
                    cancel,
                    github_token_opt,
                ) {
                    Ok(()) => {
                        revision = format!("api-download-{}", branch);
                    }
                    Err(err) => {
                        let _ = std::fs::remove_dir_all(&central_path);
                        let err_msg = format!("{:#}", err);
                        if err_msg.contains("CANCELLED|") {
                            return Err(err);
                        }
                        if err_msg.contains("404") || err_msg.contains("Not Found") {
                            anyhow::bail!(
                                "该 Skill 在 GitHub 上未找到（可能已被删除或路径已变更）。\n请检查链接是否正确：{}/tree/{}/{}",
                                parsed.clone_url.trim_end_matches(".git"),
                                branch,
                                subpath
                            );
                        }
                        if let Some(rest) = err_msg.strip_prefix("RATE_LIMITED|") {
                            let mins: i64 = rest.trim().parse().unwrap_or(0);
                            if mins > 0 {
                                anyhow::bail!(
                                    "GitHub API 频率限制已触发，约 {} 分钟后重置。可在设置中配置 GitHub Token 以提升限额。",
                                    mins
                                );
                            }
                            anyhow::bail!(
                                "GitHub API 频率限制已触发。可在设置中配置 GitHub Token 以提升限额。"
                            );
                        }
                        if err_msg.contains("403") || err_msg.contains("Forbidden") {
                            anyhow::bail!(
                                "GitHub API 访问被拒绝（可能触发了频率限制）。请稍后再试。"
                            );
                        }
                        return Err(err);
                    }
                }
            }
        }
    } else {
        // Standard git clone path (no subpath or non-GitHub URL)
        let (repo_dir, rev) = clone_to_cache(
            app,
            store,
            &parsed.clone_url,
            parsed.branch.as_deref(),
            cancel,
        )?;

        let copy_src = if let Some(subpath) = &parsed.subpath {
            let sub_src = repo_dir.join(subpath);
            if !sub_src.exists() {
                anyhow::bail!("subpath not found in repo: {:?}", sub_src);
            }
            ensure_installable_skill_dir(&sub_src)?;
            sub_src
        } else {
            // Repo root URL: detect multi-skill repos and ask user to pick one.
            let skill_count = count_skills_in_repo(&repo_dir);
            if skill_count >= 2 {
                anyhow::bail!(
                    "MULTI_SKILLS|该仓库包含多个 Skills，请复制具体 Skill 文件夹链接（例如 GitHub 的 /tree/<branch>/<skill-folder>），再导入。"
                );
            }
            ensure_installable_skill_dir(&repo_dir)?;
            repo_dir.clone()
        };

        copy_dir_recursive(&copy_src, &central_path)
            .with_context(|| format!("copy {:?} -> {:?}", copy_src, central_path))?;
        revision = rev;
    }
    // After download, prefer the name from SKILL.md over the derived name (fixes #28:
    // when subpath is "skills", the derived name collides with tool directory names).
    let (mut description, md_name) = match parse_skill_md(&central_path.join("SKILL.md")) {
        Some((n, d)) => (d, Some(n)),
        None => (None, None),
    };
    if !user_provided_name {
        if let Some(ref better_name) = md_name {
            if *better_name != name {
                let new_central = central_dir.join(better_name);
                if !new_central.exists() {
                    std::fs::rename(&central_path, &new_central).with_context(|| {
                        format!("rename {:?} -> {:?}", central_path, new_central)
                    })?;
                    name = better_name.clone();
                    central_path = new_central;
                }
                // Re-read description after rename (path changed)
                description = parse_skill_md(&central_path.join("SKILL.md")).and_then(|(_, d)| d);
            }
        }
    }

    let now = now_ms();
    let content_hash = compute_content_hash(&central_path);

    let record = SkillRecord {
        id: Uuid::new_v4().to_string(),
        name,
        description,
        source_type: "git".to_string(),
        source_ref: Some(repo_url.to_string()),
        source_subpath: parsed.subpath.clone(),
        source_revision: Some(revision),
        central_path: central_path.to_string_lossy().to_string(),
        content_hash: content_hash.clone(),
        created_at: now,
        updated_at: now,
        last_sync_at: None,
        last_seen_at: now,
        status: "ok".to_string(),
    };

    store.upsert_skill(&record)?;

    Ok(InstallResult {
        skill_id: record.id,
        name: record.name,
        central_path,
        content_hash,
    })
}

#[derive(Clone, Debug)]
struct ParsedGitSource {
    clone_url: String,
    branch: Option<String>,
    subpath: Option<String>,
}

fn parse_github_url(input: &str) -> ParsedGitSource {
    // Supports:
    // - https://github.com/owner/repo
    // - https://github.com/owner/repo.git
    // - https://github.com/owner/repo/tree/<branch>/<path>
    // - https://github.com/owner/repo/blob/<branch>/<path>
    let trimmed = input.trim().trim_end_matches('/');

    // Convenience: allow GitHub shorthand inputs like `owner/repo` (and `owner/repo/tree/<branch>/...`).
    // This keeps the UI friendly while still allowing local paths or other git remotes.
    let normalized = if trimmed.starts_with("https://github.com/") {
        trimmed.to_string()
    } else if trimmed.starts_with("http://github.com/") {
        trimmed.replacen("http://github.com/", "https://github.com/", 1)
    } else if trimmed.starts_with("github.com/") {
        format!("https://{}", trimmed)
    } else if looks_like_github_shorthand(trimmed) {
        format!("https://github.com/{}", trimmed)
    } else {
        trimmed.to_string()
    };

    let trimmed = normalized.trim_end_matches('/');
    let gh_prefix = "https://github.com/";
    if !trimmed.starts_with(gh_prefix) {
        return ParsedGitSource {
            clone_url: trimmed.to_string(),
            branch: None,
            subpath: None,
        };
    }

    let rest = &trimmed[gh_prefix.len()..];
    let parts: Vec<&str> = rest.split('/').collect();
    if parts.len() < 2 {
        return ParsedGitSource {
            clone_url: trimmed.to_string(),
            branch: None,
            subpath: None,
        };
    }

    let owner = parts[0];
    let mut repo = parts[1].to_string();
    if let Some(stripped) = repo.strip_suffix(".git") {
        repo = stripped.to_string();
    }
    let clone_url = format!("https://github.com/{}/{}.git", owner, repo);

    if parts.len() >= 4 && (parts[2] == "tree" || parts[2] == "blob") {
        let branch = Some(parts[3].to_string());
        let subpath = if parts.len() > 4 {
            Some(normalize_github_skill_subpath(&parts[4..].join("/")))
        } else {
            None
        };
        return ParsedGitSource {
            clone_url,
            branch,
            subpath,
        };
    }

    ParsedGitSource {
        clone_url,
        branch: None,
        subpath: None,
    }
}

fn normalize_github_skill_subpath(subpath: &str) -> String {
    let trimmed = subpath.trim_matches('/');
    if trimmed.eq_ignore_ascii_case("SKILL.md") {
        return ".".to_string();
    }
    trimmed
        .strip_suffix("/SKILL.md")
        .or_else(|| trimmed.strip_suffix("/skill.md"))
        .unwrap_or(trimmed)
        .to_string()
}

fn looks_like_github_shorthand(input: &str) -> bool {
    if input.is_empty() {
        return false;
    }
    if input.starts_with('/') || input.starts_with('~') || input.starts_with('.') {
        return false;
    }
    // Avoid scp-like ssh URLs (git@github.com:owner/repo) and any explicit schemes.
    if input.contains("://") || input.contains('@') || input.contains(':') {
        return false;
    }

    let parts: Vec<&str> = input.split('/').collect();
    if parts.len() < 2 {
        return false;
    }

    let owner = parts[0];
    let repo = parts[1];
    if owner.is_empty()
        || repo.is_empty()
        || owner == "."
        || owner == ".."
        || repo == "."
        || repo == ".."
    {
        return false;
    }

    let is_safe_segment = |s: &str| {
        s.chars()
            .all(|c| c.is_ascii_alphanumeric() || c == '-' || c == '_' || c == '.')
    };
    if !is_safe_segment(owner) || !is_safe_segment(repo.trim_end_matches(".git")) {
        return false;
    }

    // If there are more path parts, only accept the GitHub UI patterns we can parse.
    if parts.len() > 2 {
        matches!(parts[2], "tree" | "blob")
    } else {
        true
    }
}

fn now_ms() -> i64 {
    let now = std::time::SystemTime::now()
        .duration_since(std::time::SystemTime::UNIX_EPOCH)
        .unwrap_or_default();
    now.as_millis() as i64
}

fn derive_name_from_repo_url(repo_url: &str) -> String {
    let mut name = repo_url
        .split('/')
        .next_back()
        .unwrap_or("skill")
        .to_string();
    if let Some(stripped) = name.strip_suffix(".git") {
        name = stripped.to_string();
    }
    if name.is_empty() {
        "skill".to_string()
    } else {
        name
    }
}

/// Scan base directories used for skill discovery.
const SKILL_SCAN_BASES: [&str; 5] = [
    "skills",
    "skills/.curated",
    "skills/.experimental",
    "skills/.system",
    ".claude/skills",
];

/// Check if a directory is a valid skill (has SKILL.md or is under .claude/skills/).
fn is_skill_dir(p: &Path) -> bool {
    p.is_dir() && (p.join("SKILL.md").exists() || is_claude_skill_dir(p))
}

fn ensure_installable_skill_dir(p: &Path) -> Result<()> {
    if is_skill_dir(p) {
        Ok(())
    } else {
        anyhow::bail!(
            "SKILL_INVALID|missing_skill_md|该路径不是有效 Skill 目录：未找到 SKILL.md。请粘贴具体 Skill 文件夹链接。"
        );
    }
}

/// Check if a directory is a Claude plugin skill (under .claude/skills/ without SKILL.md).
fn is_claude_skill_dir(p: &Path) -> bool {
    // A directory under .claude/skills/ is treated as a valid skill even without SKILL.md
    if let Some(parent) = p.parent() {
        let parent_str = parent.to_string_lossy();
        if parent_str.ends_with(".claude/skills") || parent_str.ends_with(".claude\\skills") {
            return p.is_dir();
        }
    }
    false
}

/// Try to read the description for a skill from .claude-plugin/plugin.json.
fn read_plugin_description(repo_dir: &Path) -> Option<String> {
    let plugin_json = repo_dir.join(".claude-plugin/plugin.json");
    if !plugin_json.exists() {
        return None;
    }
    let content = std::fs::read_to_string(&plugin_json).ok()?;
    let json: serde_json::Value = serde_json::from_str(&content).ok()?;
    json.get("description")
        .and_then(|v| v.as_str())
        .map(|s| s.to_string())
}

/// Extract name and description for a skill directory.
/// Prefers SKILL.md frontmatter; falls back to folder name + plugin.json description.
fn extract_skill_info(skill_dir: &Path, repo_dir: &Path) -> (String, Option<String>) {
    let skill_md = skill_dir.join("SKILL.md");
    if skill_md.exists() {
        if let Some((name, desc)) = parse_skill_md(&skill_md) {
            return (name, desc);
        }
    }
    // Fallback: folder name + optional plugin.json description
    let name = skill_dir
        .file_name()
        .unwrap_or_default()
        .to_string_lossy()
        .to_string();
    let desc = read_plugin_description(repo_dir);
    (name, desc)
}

fn is_hidden_dir_name(name: &str) -> bool {
    name.starts_with('.')
}

fn is_known_root_scan_dir(name: &str) -> bool {
    SKILL_SCAN_BASES
        .iter()
        .filter_map(|base| base.split('/').next())
        .any(|base| base == name)
}

fn is_skill_container_dir_name(name: &str) -> bool {
    let normalized = name.to_ascii_lowercase();
    normalized.contains("skill")
}

fn push_skill_dirs_from_base(out: &mut Vec<PathBuf>, base_dir: &Path) {
    if let Ok(rd) = std::fs::read_dir(base_dir) {
        for entry in rd.flatten() {
            let p = entry.path();
            if is_skill_dir(&p) {
                out.push(p);
            }
        }
    }
}

fn collect_skill_dirs(repo_dir: &Path) -> Vec<PathBuf> {
    let mut out = Vec::new();

    // 1) Fast path: known skill locations such as skills/* and .claude/skills/*.
    for base in SKILL_SCAN_BASES {
        push_skill_dirs_from_base(&mut out, &repo_dir.join(base));
    }

    // 2) Root-level skills: repo/my-skill/SKILL.md.
    // 3) Root-level skill containers: repo/*skill*/my-skill/SKILL.md.
    if let Ok(rd) = std::fs::read_dir(repo_dir) {
        for entry in rd.flatten() {
            let p = entry.path();
            if !p.is_dir() {
                continue;
            }
            let dir_name = entry.file_name();
            let dir_name = dir_name.to_string_lossy();
            if is_hidden_dir_name(&dir_name) || is_known_root_scan_dir(&dir_name) {
                continue;
            }
            if p.join("SKILL.md").exists() {
                out.push(p);
            } else if is_skill_container_dir_name(&dir_name) {
                push_skill_dirs_from_base(&mut out, &p);
            }
        }
    }

    out.sort();
    out.dedup();
    out
}

/// Scan all skill candidates in a repo directory, returning (name, relative_subpath) pairs.
/// Used for auto-matching when updating legacy skills with missing source_subpath.
fn scan_skill_candidates_in_dir(repo_dir: &Path) -> Vec<(String, String)> {
    let mut out = Vec::new();
    for p in collect_skill_dirs(repo_dir) {
        let (name, _) = extract_skill_info(&p, repo_dir);
        let rel = p
            .strip_prefix(repo_dir)
            .unwrap_or(&p)
            .to_string_lossy()
            .to_string();
        out.push((name, rel));
    }
    out
}

/// Count skill directories in a repo: checks both `skills/*` and root-level subdirectories.
fn count_skills_in_repo(repo_dir: &Path) -> usize {
    collect_skill_dirs(repo_dir).len()
}

fn compute_content_hash(path: &Path) -> Option<String> {
    if should_compute_content_hash() {
        hash_dir(path).ok()
    } else {
        None
    }
}

fn should_compute_content_hash() -> bool {
    if cfg!(debug_assertions) {
        return true;
    }
    std::env::var("SKILLS_HUB_COMPUTE_HASH")
        .ok()
        .map(|v| v == "1" || v.eq_ignore_ascii_case("true"))
        .unwrap_or(false)
}

pub struct UpdateResult {
    pub skill_id: String,
    pub name: String,
    #[allow(dead_code)]
    pub central_path: PathBuf,
    pub content_hash: Option<String>,
    pub source_revision: Option<String>,
    pub updated_targets: Vec<String>,
}

pub fn update_managed_skill_from_source<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    skill_id: &str,
) -> Result<UpdateResult> {
    let record = store
        .get_skill_by_id(skill_id)?
        .ok_or_else(|| anyhow::anyhow!("skill not found"))?;

    let central_path = PathBuf::from(record.central_path.clone());
    if !central_path.exists() {
        anyhow::bail!("central path not found: {:?}", central_path);
    }
    let central_parent = central_path
        .parent()
        .ok_or_else(|| anyhow::anyhow!("invalid central path"))?
        .to_path_buf();

    let now = now_ms();

    // Build new content in a sibling temp dir for safe swap.
    let staging_dir = central_parent.join(format!(".skills-hub-update-{}", Uuid::new_v4()));
    if staging_dir.exists() {
        let _ = std::fs::remove_dir_all(&staging_dir);
    }

    let mut new_revision: Option<String> = None;

    if record.source_type == "git" {
        let repo_url = record
            .source_ref
            .as_deref()
            .ok_or_else(|| anyhow::anyhow!("missing source_ref for git skill"))?;
        let parsed = parse_github_url(repo_url);

        let (repo_dir, rev) = if let Some(subpath) = record.source_subpath.as_deref() {
            clone_to_cache_subpath(
                app,
                store,
                &parsed.clone_url,
                parsed.branch.as_deref(),
                subpath,
                None,
            )?
        } else {
            clone_to_cache(
                app,
                store,
                &parsed.clone_url,
                parsed.branch.as_deref(),
                None,
            )?
        };
        new_revision = Some(rev);

        // Prefer stored source_subpath (from install time) over URL-parsed subpath.
        // For legacy records where source_subpath is NULL and URL has no subpath,
        // try to auto-match by skill name in the repo (backfill).
        let mut resolved_subpath = record
            .source_subpath
            .as_deref()
            .or(parsed.subpath.as_deref())
            .map(|s| s.to_string());
        if resolved_subpath.is_none() && count_skills_in_repo(&repo_dir) >= 2 {
            // Multi-skill repo with no stored subpath: match by name
            let candidates = scan_skill_candidates_in_dir(&repo_dir);
            let skill_name = record.name.to_lowercase();
            if let Some(matched) = candidates.iter().find(|c| c.0 == record.name).or_else(|| {
                // Fuzzy: bidirectional containment (e.g. "react-best-practices" vs "vercel-react-best-practices")
                let fuzzy: Vec<_> = candidates
                    .iter()
                    .filter(|c| {
                        let cn = c.0.to_lowercase();
                        cn.contains(&skill_name) || skill_name.contains(&cn)
                    })
                    .collect();
                if fuzzy.len() == 1 {
                    Some(fuzzy[0])
                } else {
                    None
                }
            }) {
                resolved_subpath = Some(matched.1.clone());
                // Backfill source_subpath for future updates
                let mut patched = record.clone();
                patched.source_subpath = Some(matched.1.clone());
                let _ = store.upsert_skill(&patched);
            }
        }
        let copy_src = if let Some(subpath) = &resolved_subpath {
            repo_dir.join(subpath)
        } else {
            repo_dir.clone()
        };
        if !copy_src.exists() {
            anyhow::bail!("path not found in repo: {:?}", copy_src);
        }

        copy_dir_recursive(&copy_src, &staging_dir)
            .with_context(|| format!("copy {:?} -> {:?}", copy_src, staging_dir))?;
    } else if record.source_type == "local" {
        let source = record
            .source_ref
            .as_deref()
            .ok_or_else(|| anyhow::anyhow!("missing source_ref for local skill"))?;
        let source_path = PathBuf::from(source);
        if !source_path.exists() {
            anyhow::bail!("source path not found: {:?}", source_path);
        }
        copy_dir_recursive(&source_path, &staging_dir)
            .with_context(|| format!("copy {:?} -> {:?}", source_path, staging_dir))?;
    } else {
        anyhow::bail!("unsupported source_type for update: {}", record.source_type);
    }

    // Swap: remove old dir and rename staging into place (best effort).
    std::fs::remove_dir_all(&central_path)
        .with_context(|| format!("failed to remove old central dir {:?}", central_path))?;
    if let Err(err) = std::fs::rename(&staging_dir, &central_path) {
        // Fallback for cross-device rename: copy then delete staging.
        copy_dir_recursive(&staging_dir, &central_path)
            .with_context(|| format!("fallback copy {:?} -> {:?}", staging_dir, central_path))?;
        let _ = std::fs::remove_dir_all(&staging_dir);
        // Still surface original rename error in logs for troubleshooting.
        eprintln!("[update] rename warning: {}", err);
    }

    let content_hash = compute_content_hash(&central_path);
    let description = parse_skill_md(&central_path.join("SKILL.md"))
        .and_then(|(_, desc)| desc)
        .or(record.description.clone());

    // Update DB skill row.
    let updated = SkillRecord {
        id: record.id.clone(),
        name: record.name.clone(),
        description,
        source_type: record.source_type.clone(),
        source_ref: record.source_ref.clone(),
        source_subpath: record.source_subpath.clone(),
        source_revision: new_revision.clone().or(record.source_revision.clone()),
        central_path: record.central_path.clone(),
        content_hash: content_hash.clone(),
        created_at: record.created_at,
        updated_at: now,
        last_sync_at: record.last_sync_at,
        last_seen_at: now,
        status: "ok".to_string(),
    };
    store.upsert_skill(&updated)?;

    // If any targets are "copy", re-sync them so changes propagate. Symlinks update automatically.
    // Cursor 目前不支持软链/junction，因此无论历史 mode 如何，都需要强制 copy 回灌。
    let targets = store.list_skill_targets(skill_id)?;
    let mut updated_targets: Vec<String> = Vec::new();
    for t in targets {
        // Project scoped targets live under a project root and do not require global tool install detection.
        if t.scope == "global" {
            if let Some(adapter) = adapter_by_key(&t.tool) {
                if !is_tool_installed(&adapter).unwrap_or(false) {
                    continue;
                }
            }
        }
        let force_copy = t.mode == "copy" || t.tool == "cursor";
        if force_copy {
            let target_path = PathBuf::from(&t.target_path);
            let sync_res = sync_dir_copy_with_overwrite(&central_path, &target_path, true)?;
            let record = super::skill_store::SkillTargetRecord {
                id: t.id.clone(),
                skill_id: t.skill_id.clone(),
                tool: t.tool.clone(),
                scope: t.scope.clone(),
                project_path: t.project_path.clone(),
                target_path: sync_res.target_path.to_string_lossy().to_string(),
                mode: "copy".to_string(),
                status: "ok".to_string(),
                last_error: None,
                synced_at: Some(now),
            };
            store.upsert_skill_target(&record)?;
            updated_targets.push(t.tool.clone());
        }
    }

    Ok(UpdateResult {
        skill_id: record.id,
        name: record.name,
        central_path,
        content_hash,
        source_revision: new_revision,
        updated_targets,
    })
}

#[derive(Clone, Debug, serde::Serialize)]
pub struct GitSkillCandidate {
    pub name: String,
    pub description: Option<String>,
    pub subpath: String,
}

#[derive(Clone, Debug, serde::Serialize)]
pub struct LocalSkillCandidate {
    pub name: String,
    pub description: Option<String>,
    pub subpath: String,
    pub valid: bool,
    pub reason: Option<String>,
}

pub fn list_git_skills<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    repo_url: &str,
) -> Result<Vec<GitSkillCandidate>> {
    let parsed = parse_github_url(repo_url);
    let (repo_dir, _rev) = clone_to_cache(
        app,
        store,
        &parsed.clone_url,
        parsed.branch.as_deref(),
        None,
    )?;

    let mut out: Vec<GitSkillCandidate> = Vec::new();

    // If user provided a folder URL, treat it as a single candidate.
    if let Some(subpath) = &parsed.subpath {
        let dir = repo_dir.join(subpath);
        if dir.is_dir() && (dir.join("SKILL.md").exists() || is_claude_skill_dir(&dir)) {
            let (name, desc) = extract_skill_info(&dir, &repo_dir);
            out.push(GitSkillCandidate {
                name,
                description: desc,
                subpath: subpath.to_string(),
            });
        } else if dir.is_dir() {
            for p in collect_skill_dirs(&dir) {
                let (name, desc) = extract_skill_info(&p, &repo_dir);
                let rel = p
                    .strip_prefix(&repo_dir)
                    .unwrap_or(&p)
                    .to_string_lossy()
                    .to_string();
                out.push(GitSkillCandidate {
                    name,
                    description: desc,
                    subpath: rel,
                });
            }
        }
        out.sort_by(|a, b| a.name.cmp(&b.name));
        out.dedup_by(|a, b| a.subpath == b.subpath);
        return Ok(out);
    }

    // Root-level skill
    let root_skill = repo_dir.join("SKILL.md");
    if root_skill.exists() {
        let (name, desc) = parse_skill_md(&root_skill).unwrap_or(("root-skill".to_string(), None));
        out.push(GitSkillCandidate {
            name,
            description: desc,
            subpath: ".".to_string(),
        });
    }

    for p in collect_skill_dirs(&repo_dir) {
        let (name, desc) = extract_skill_info(&p, &repo_dir);
        let rel = p
            .strip_prefix(&repo_dir)
            .unwrap_or(&p)
            .to_string_lossy()
            .to_string();
        out.push(GitSkillCandidate {
            name,
            description: desc,
            subpath: rel,
        });
    }

    out.sort_by(|a, b| a.name.cmp(&b.name));
    out.dedup_by(|a, b| a.subpath == b.subpath);

    Ok(out)
}

pub fn list_local_skills(base_path: &Path) -> Result<Vec<LocalSkillCandidate>> {
    if !base_path.exists() {
        anyhow::bail!("source path not found: {:?}", base_path);
    }

    let mut out: Vec<LocalSkillCandidate> = Vec::new();

    let root_skill = base_path.join("SKILL.md");
    if root_skill.exists() {
        match parse_skill_md_with_reason(&root_skill) {
            Ok((name, desc)) => {
                out.push(LocalSkillCandidate {
                    name,
                    description: desc,
                    subpath: ".".to_string(),
                    valid: true,
                    reason: None,
                });
            }
            Err(reason) => {
                let fallback_name = base_path
                    .file_name()
                    .unwrap_or_default()
                    .to_string_lossy()
                    .to_string();
                out.push(LocalSkillCandidate {
                    name: if fallback_name.is_empty() {
                        "root-skill".to_string()
                    } else {
                        fallback_name
                    },
                    description: None,
                    subpath: ".".to_string(),
                    valid: false,
                    reason: Some(reason.to_string()),
                });
            }
        }
    }

    for base in SKILL_SCAN_BASES {
        let base_dir = base_path.join(base);
        if !base_dir.exists() {
            continue;
        }
        if let Ok(rd) = std::fs::read_dir(&base_dir) {
            for entry in rd.flatten() {
                let p = entry.path();
                if !p.is_dir() {
                    continue;
                }
                let skill_md = p.join("SKILL.md");
                let rel = p
                    .strip_prefix(base_path)
                    .unwrap_or(&p)
                    .to_string_lossy()
                    .to_string();
                if skill_md.exists() {
                    match parse_skill_md_with_reason(&skill_md) {
                        Ok((name, desc)) => {
                            out.push(LocalSkillCandidate {
                                name,
                                description: desc,
                                subpath: rel,
                                valid: true,
                                reason: None,
                            });
                        }
                        Err(reason) => {
                            out.push(LocalSkillCandidate {
                                name: p
                                    .file_name()
                                    .unwrap_or_default()
                                    .to_string_lossy()
                                    .to_string(),
                                description: None,
                                subpath: rel,
                                valid: false,
                                reason: Some(reason.to_string()),
                            });
                        }
                    }
                } else if is_claude_skill_dir(&p) {
                    // .claude/skills/* directories are valid without SKILL.md
                    let name = p
                        .file_name()
                        .unwrap_or_default()
                        .to_string_lossy()
                        .to_string();
                    let desc = read_plugin_description(base_path);
                    out.push(LocalSkillCandidate {
                        name,
                        description: desc,
                        subpath: rel,
                        valid: true,
                        reason: None,
                    });
                } else {
                    out.push(LocalSkillCandidate {
                        name: p
                            .file_name()
                            .unwrap_or_default()
                            .to_string_lossy()
                            .to_string(),
                        description: None,
                        subpath: rel,
                        valid: false,
                        reason: Some("missing_skill_md".to_string()),
                    });
                }
            }
        }
    }

    out.sort_by(|a, b| a.name.cmp(&b.name));
    out.dedup_by(|a, b| a.subpath == b.subpath);

    Ok(out)
}

pub fn install_git_skill_from_selection<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    repo_url: &str,
    subpath: &str,
    name: Option<String>,
) -> Result<InstallResult> {
    let parsed = parse_github_url(repo_url);
    let user_provided_name = name.is_some();
    let mut display_name = name.unwrap_or_else(|| {
        if subpath == "." {
            derive_name_from_repo_url(&parsed.clone_url)
        } else {
            subpath
                .rsplit('/')
                .next()
                .map(|s| s.to_string())
                .unwrap_or_else(|| derive_name_from_repo_url(&parsed.clone_url))
        }
    });

    let central_dir = resolve_central_repo_path(app, store)?;
    ensure_central_repo(&central_dir)?;
    let mut central_path = central_dir.join(&display_name);
    if central_path.exists() {
        anyhow::bail!("skill already exists in central repo: {:?}", central_path);
    }

    let (repo_dir, revision) = clone_to_cache(
        app,
        store,
        &parsed.clone_url,
        parsed.branch.as_deref(),
        None,
    )?;

    let copy_src = if subpath == "." {
        repo_dir.clone()
    } else {
        repo_dir.join(subpath)
    };
    if !copy_src.exists() {
        anyhow::bail!("path not found in repo: {:?}", copy_src);
    }
    ensure_installable_skill_dir(&copy_src)?;

    copy_dir_recursive(&copy_src, &central_path)
        .with_context(|| format!("copy {:?} -> {:?}", copy_src, central_path))?;

    // Prefer name from SKILL.md over derived name (fixes #28).
    let (mut description, md_name) = match parse_skill_md(&central_path.join("SKILL.md")) {
        Some((n, d)) => (d, Some(n)),
        None => (None, None),
    };
    if !user_provided_name {
        if let Some(ref better_name) = md_name {
            if *better_name != display_name {
                let new_central = central_dir.join(better_name);
                if !new_central.exists() {
                    std::fs::rename(&central_path, &new_central).with_context(|| {
                        format!("rename {:?} -> {:?}", central_path, new_central)
                    })?;
                    display_name = better_name.clone();
                    central_path = new_central;
                    description =
                        parse_skill_md(&central_path.join("SKILL.md")).and_then(|(_, d)| d);
                }
            }
        }
    }

    let now = now_ms();
    let content_hash = compute_content_hash(&central_path);
    let source_subpath = if subpath == "." {
        None
    } else {
        Some(subpath.to_string())
    };
    let record = SkillRecord {
        id: Uuid::new_v4().to_string(),
        name: display_name,
        description,
        source_type: "git".to_string(),
        source_ref: Some(repo_url.to_string()),
        source_subpath,
        source_revision: Some(revision),
        central_path: central_path.to_string_lossy().to_string(),
        content_hash: content_hash.clone(),
        created_at: now,
        updated_at: now,
        last_sync_at: None,
        last_seen_at: now,
        status: "ok".to_string(),
    };
    store.upsert_skill(&record)?;

    Ok(InstallResult {
        skill_id: record.id,
        name: record.name,
        central_path,
        content_hash,
    })
}

pub fn install_local_skill_from_selection<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    base_path: &Path,
    subpath: &str,
    name: Option<String>,
) -> Result<InstallResult> {
    if !base_path.exists() {
        anyhow::bail!("source path not found: {:?}", base_path);
    }

    let selected_dir = if subpath == "." {
        base_path.to_path_buf()
    } else {
        base_path.join(subpath)
    };
    if !selected_dir.exists() {
        anyhow::bail!("source path not found: {:?}", selected_dir);
    }

    let skill_md = selected_dir.join("SKILL.md");
    if !skill_md.exists() {
        anyhow::bail!("SKILL_INVALID|missing_skill_md");
    }
    let (parsed_name, _desc) = parse_skill_md_with_reason(&skill_md)
        .map_err(|reason| anyhow::anyhow!("SKILL_INVALID|{}", reason))?;

    let display_name = name.unwrap_or(parsed_name);

    install_local_skill(app, store, &selected_dir, Some(display_name))
}

#[derive(Clone, Debug, Serialize, Deserialize)]
struct RepoCacheMeta {
    last_fetched_ms: i64,
    head: Option<String>,
}

static GIT_CACHE_LOCK: OnceLock<Mutex<()>> = OnceLock::new();

fn clone_to_cache<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    clone_url: &str,
    branch: Option<&str>,
    cancel: Option<&CancelToken>,
) -> Result<(PathBuf, String)> {
    let started = std::time::Instant::now();
    let cache_dir = app
        .path()
        .app_cache_dir()
        .context("failed to resolve app cache dir")?;
    let cache_root = cache_dir.join("skills-hub-git-cache");
    std::fs::create_dir_all(&cache_root)
        .with_context(|| format!("failed to create cache dir {:?}", cache_root))?;

    let repo_dir = cache_root.join(repo_cache_key(clone_url, branch, None));
    let meta_path = repo_dir.join(".skills-hub-cache.json");

    let lock = GIT_CACHE_LOCK.get_or_init(|| Mutex::new(()));
    let _guard = lock.lock().unwrap_or_else(|err| err.into_inner());

    if repo_dir.join(".git").exists() {
        if let Ok(meta) = std::fs::read_to_string(&meta_path) {
            if let Ok(meta) = serde_json::from_str::<RepoCacheMeta>(&meta) {
                if let Some(head) = meta.head {
                    let ttl_ms = get_git_cache_ttl_secs(store).saturating_mul(1000);
                    if ttl_ms > 0 && now_ms().saturating_sub(meta.last_fetched_ms) < ttl_ms {
                        log::info!(
                            "[installer] git cache hit (fresh) {}s url={} branch={:?} repo_dir={:?}",
                            started.elapsed().as_secs_f32(),
                            clone_url,
                            branch,
                            repo_dir
                        );
                        return Ok((repo_dir, head));
                    }
                }
            }
        }
    }

    log::info!(
        "[installer] git cache miss/stale; fetching {} url={} branch={:?} repo_dir={:?}",
        started.elapsed().as_secs_f32(),
        clone_url,
        branch,
        repo_dir
    );

    let rev = match clone_or_pull(clone_url, &repo_dir, branch, cancel) {
        Ok(rev) => rev,
        Err(err) => {
            // If cache got corrupted, retry once from a clean state.
            if repo_dir.exists() {
                let _ = std::fs::remove_dir_all(&repo_dir);
            }
            clone_or_pull(clone_url, &repo_dir, branch, cancel)
                .with_context(|| format!("{:#}", err))?
        }
    };

    let _ = std::fs::write(
        &meta_path,
        serde_json::to_string(&RepoCacheMeta {
            last_fetched_ms: now_ms(),
            head: Some(rev.clone()),
        })
        .unwrap_or_else(|_| "{}".to_string()),
    );

    log::info!(
        "[installer] git cache ready {}s url={} branch={:?} head={}",
        started.elapsed().as_secs_f32(),
        clone_url,
        branch,
        rev
    );
    Ok((repo_dir, rev))
}

fn clone_to_cache_subpath<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
    clone_url: &str,
    branch: Option<&str>,
    subpath: &str,
    cancel: Option<&CancelToken>,
) -> Result<(PathBuf, String)> {
    let started = std::time::Instant::now();
    let cache_dir = app
        .path()
        .app_cache_dir()
        .context("failed to resolve app cache dir")?;
    let cache_root = cache_dir.join("skills-hub-git-cache");
    std::fs::create_dir_all(&cache_root)
        .with_context(|| format!("failed to create cache dir {:?}", cache_root))?;

    let repo_dir = cache_root.join(repo_cache_key(clone_url, branch, Some(subpath)));
    let meta_path = repo_dir.join(".skills-hub-cache.json");

    let lock = GIT_CACHE_LOCK.get_or_init(|| Mutex::new(()));
    let _guard = lock.lock().unwrap_or_else(|err| err.into_inner());

    if repo_dir.join(".git").exists() {
        if let Ok(meta) = std::fs::read_to_string(&meta_path) {
            if let Ok(meta) = serde_json::from_str::<RepoCacheMeta>(&meta) {
                if let Some(head) = meta.head {
                    let ttl_ms = get_git_cache_ttl_secs(store).saturating_mul(1000);
                    if ttl_ms > 0 && now_ms().saturating_sub(meta.last_fetched_ms) < ttl_ms {
                        log::info!(
                            "[installer] sparse git cache hit (fresh) {}s url={} branch={:?} subpath={} repo_dir={:?}",
                            started.elapsed().as_secs_f32(),
                            clone_url,
                            branch,
                            subpath,
                            repo_dir
                        );
                        return Ok((repo_dir, head));
                    }
                }
            }
        }
    }

    log::info!(
        "[installer] sparse git cache miss/stale; fetching {} url={} branch={:?} subpath={} repo_dir={:?}",
        started.elapsed().as_secs_f32(),
        clone_url,
        branch,
        subpath,
        repo_dir
    );

    let rev = match clone_or_pull_sparse(clone_url, &repo_dir, branch, subpath, cancel) {
        Ok(rev) => rev,
        Err(err) => {
            if repo_dir.exists() {
                let _ = std::fs::remove_dir_all(&repo_dir);
            }
            clone_or_pull_sparse(clone_url, &repo_dir, branch, subpath, cancel)
                .with_context(|| format!("{:#}", err))?
        }
    };

    let _ = std::fs::write(
        &meta_path,
        serde_json::to_string(&RepoCacheMeta {
            last_fetched_ms: now_ms(),
            head: Some(rev.clone()),
        })
        .unwrap_or_else(|_| "{}".to_string()),
    );

    log::info!(
        "[installer] sparse git cache ready {}s url={} branch={:?} subpath={} head={}",
        started.elapsed().as_secs_f32(),
        clone_url,
        branch,
        subpath,
        rev
    );
    Ok((repo_dir, rev))
}

fn repo_cache_key(clone_url: &str, branch: Option<&str>, subpath: Option<&str>) -> String {
    use sha2::Digest;
    let mut hasher = sha2::Sha256::new();
    hasher.update(clone_url.as_bytes());
    hasher.update(b"\n");
    if let Some(b) = branch {
        hasher.update(b.as_bytes());
    }
    hasher.update(b"\n");
    if let Some(s) = subpath {
        hasher.update(s.as_bytes());
    }
    hex::encode(hasher.finalize())
}

/// Backfill description for skills from SKILL.md.
pub fn backfill_skill_descriptions(store: &SkillStore) {
    let skills = match store.list_skills() {
        Ok(s) => s,
        Err(_) => return,
    };
    for skill in skills {
        let central = std::path::Path::new(&skill.central_path);
        let skill_md = central.join("SKILL.md");
        if let Some((_, Some(desc))) = parse_skill_md(&skill_md) {
            if skill.description.as_deref() != Some(desc.as_str()) {
                let _ = store.update_skill_description(&skill.id, Some(&desc));
            }
        }
    }
}

fn parse_skill_md(path: &Path) -> Option<(String, Option<String>)> {
    parse_skill_md_with_reason(path).ok()
}

fn parse_skill_md_with_reason(path: &Path) -> Result<(String, Option<String>), &'static str> {
    let text = std::fs::read_to_string(path).map_err(|_| "read_failed")?;
    let lines: Vec<&str> = text.lines().collect();
    if lines.first().map(|v| v.trim()) != Some("---") {
        return Err("invalid_frontmatter");
    }
    let mut name: Option<String> = None;
    let mut desc: Option<String> = None;
    let mut found_end = false;
    let mut i = 1usize;
    while i < lines.len() {
        let raw = lines[i];
        let l = raw.trim();
        if l == "---" {
            found_end = true;
            break;
        }
        if let Some(v) = l.strip_prefix("name:") {
            name = Some(clean_frontmatter_value(v));
        } else if let Some(v) = l.strip_prefix("description:") {
            let v = v.trim();
            if let Some(block_style) = frontmatter_block_style(v) {
                let folded = block_style == '>';
                let mut block_lines: Vec<String> = Vec::new();
                while i + 1 < lines.len() {
                    let next = lines[i + 1];
                    if next.trim() == "---" {
                        break;
                    }
                    if !next.trim().is_empty() && !next.starts_with(char::is_whitespace) {
                        break;
                    }
                    block_lines.push(next.strip_prefix("  ").unwrap_or(next).to_string());
                    i += 1;
                }
                let value = if folded {
                    block_lines
                        .iter()
                        .map(|line| line.trim())
                        .filter(|line| !line.is_empty())
                        .collect::<Vec<_>>()
                        .join(" ")
                } else {
                    block_lines.join("\n").trim().to_string()
                };
                desc = Some(value);
            } else {
                desc = Some(clean_frontmatter_value(v));
            }
        }
        i += 1;
    }
    if !found_end {
        return Err("invalid_frontmatter");
    }
    let name = name.ok_or("missing_name")?;
    Ok((name, desc))
}

fn clean_frontmatter_value(value: &str) -> String {
    let value = value.trim();
    if value.len() >= 2
        && ((value.starts_with('"') && value.ends_with('"'))
            || (value.starts_with('\'') && value.ends_with('\'')))
    {
        value[1..value.len() - 1].to_string()
    } else {
        value.to_string()
    }
}

fn frontmatter_block_style(value: &str) -> Option<char> {
    let mut chars = value.chars();
    let style = chars.next()?;
    if style != '|' && style != '>' {
        return None;
    }
    match chars.next() {
        None => Some(style),
        Some('-' | '+') if chars.next().is_none() => Some(style),
        _ => None,
    }
}

#[cfg(test)]
#[path = "tests/installer.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/mod.rs
================================================
pub mod cache_cleanup;
pub mod cancel_token;
pub mod central_repo;
pub mod content_hash;
pub mod featured_skills;
pub mod git_fetcher;
pub mod github_download;
pub mod github_search;
pub mod installer;
pub mod onboarding;
pub mod skill_files;
pub mod skill_store;
pub mod skills_search;
pub mod sync_engine;
pub mod temp_cleanup;
pub mod tool_adapters;


================================================
FILE: src-tauri/src/core/onboarding.rs
================================================
use std::collections::HashMap;
use std::path::{Path, PathBuf};

use anyhow::Result;
use serde::Serialize;

use super::central_repo::resolve_central_repo_path;
use super::content_hash::hash_dir;
use super::skill_store::SkillStore;
use super::tool_adapters::{default_tool_adapters, scan_tool_dir, DetectedSkill};

#[derive(Clone, Debug, Serialize)]
pub struct OnboardingVariant {
    pub tool: String,
    pub name: String,
    pub path: PathBuf,
    pub fingerprint: Option<String>,
    pub is_link: bool,
    pub link_target: Option<PathBuf>,
}

#[derive(Clone, Debug, Serialize)]
pub struct OnboardingGroup {
    pub name: String,
    pub variants: Vec<OnboardingVariant>,
    pub has_conflict: bool,
}

#[derive(Clone, Debug, Serialize)]
pub struct OnboardingPlan {
    pub total_tools_scanned: usize,
    pub total_skills_found: usize,
    pub groups: Vec<OnboardingGroup>,
}

pub fn build_onboarding_plan<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    store: &SkillStore,
) -> Result<OnboardingPlan> {
    let home =
        dirs::home_dir().ok_or_else(|| anyhow::anyhow!("failed to resolve home directory"))?;
    let central = resolve_central_repo_path(app, store)?;
    let managed_targets = store
        .list_all_skill_target_paths()
        .unwrap_or_default()
        .into_iter()
        .map(|(tool, path)| managed_target_key(&tool, Path::new(&path)))
        .collect::<std::collections::HashSet<_>>();
    build_onboarding_plan_in_home(&home, Some(&central), Some(&managed_targets))
}

fn build_onboarding_plan_in_home(
    home: &Path,
    exclude_root: Option<&Path>,
    exclude_managed_targets: Option<&std::collections::HashSet<String>>,
) -> Result<OnboardingPlan> {
    let adapters = default_tool_adapters();
    let mut all_detected: Vec<DetectedSkill> = Vec::new();
    let mut scanned = 0usize;

    for adapter in &adapters {
        if !home.join(adapter.relative_detect_dir).exists() {
            continue;
        }
        scanned += 1;
        let dir = home.join(adapter.relative_skills_dir);
        let detected = scan_tool_dir(adapter, &dir)?;
        all_detected.extend(filter_detected(
            detected,
            exclude_root,
            exclude_managed_targets,
        ));
    }

    let mut grouped: HashMap<String, Vec<OnboardingVariant>> = HashMap::new();
    for skill in all_detected.iter() {
        let fingerprint = hash_dir(&skill.path).ok();
        let entry = grouped.entry(skill.name.clone()).or_default();
        entry.push(OnboardingVariant {
            tool: skill.tool.as_key().to_string(),
            name: skill.name.clone(),
            path: skill.path.clone(),
            fingerprint,
            is_link: skill.is_link,
            link_target: skill.link_target.clone(),
        });
    }

    let groups: Vec<OnboardingGroup> = grouped
        .into_iter()
        .map(|(name, variants)| {
            let mut uniq = variants
                .iter()
                .filter_map(|v| v.fingerprint.as_ref())
                .collect::<std::collections::HashSet<_>>()
                .len();
            if uniq == 0 {
                uniq = 1;
            }
            OnboardingGroup {
                name,
                has_conflict: uniq > 1,
                variants,
            }
        })
        .collect();

    Ok(OnboardingPlan {
        total_tools_scanned: scanned,
        total_skills_found: all_detected.len(),
        groups,
    })
}

fn filter_detected(
    detected: Vec<DetectedSkill>,
    exclude_root: Option<&Path>,
    exclude_managed_targets: Option<&std::collections::HashSet<String>>,
) -> Vec<DetectedSkill> {
    if exclude_root.is_none() && exclude_managed_targets.is_none() {
        return detected;
    }
    detected
        .into_iter()
        .filter(|skill| {
            if let Some(exclude_root) = exclude_root {
                if is_under(&skill.path, exclude_root) {
                    return false;
                }
                if let Some(target) = &skill.link_target {
                    if is_under(target, exclude_root) {
                        return false;
                    }
                }
            }
            if let Some(exclude) = exclude_managed_targets {
                if exclude.contains(&managed_target_key(skill.tool.as_key(), &skill.path)) {
                    return false;
                }
            }
            true
        })
        .collect()
}

fn is_under(path: &Path, base: &Path) -> bool {
    path.starts_with(base)
}

fn managed_target_key(tool: &str, path: &Path) -> String {
    let tool = tool.to_ascii_lowercase();
    let normalized = normalize_path_for_key(path);
    format!("{tool}\n{normalized}")
}

fn normalize_path_for_key(path: &Path) -> String {
    let normalized: PathBuf = path.components().collect();
    let s = normalized.to_string_lossy().to_string();
    #[cfg(windows)]
    {
        s.to_lowercase()
    }
    #[cfg(not(windows))]
    {
        s
    }
}

#[cfg(test)]
#[path = "tests/onboarding.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/skill_files.rs
================================================
use std::path::Path;

use anyhow::{bail, Context, Result};
use walkdir::{DirEntry, WalkDir};

const IGNORE_NAMES: [&str; 4] = [".git", ".DS_Store", "Thumbs.db", ".gitignore"];
const MAX_FILE_SIZE: u64 = 1_048_576; // 1 MB

fn is_ignored(entry: &DirEntry) -> bool {
    let file_name = entry.file_name().to_string_lossy();
    IGNORE_NAMES.iter().any(|name| name == &file_name.as_ref())
}

pub struct FileEntry {
    pub path: String,
    pub size: u64,
}

pub fn list_files(central_path: &Path) -> Result<Vec<FileEntry>> {
    let mut entries: Vec<FileEntry> = Vec::new();

    for entry in WalkDir::new(central_path)
        .follow_links(false)
        .into_iter()
        .filter_entry(|e| !is_ignored(e))
    {
        let entry = entry?;
        if !entry.file_type().is_file() || is_ignored(&entry) {
            continue;
        }

        let relative = entry
            .path()
            .strip_prefix(central_path)
            .with_context(|| format!("strip prefix {:?}", entry.path()))?;

        let metadata = entry.metadata()?;
        entries.push(FileEntry {
            path: relative.to_string_lossy().to_string(),
            size: metadata.len(),
        });
    }

    // Sort: SKILL.md first, then alphabetical
    entries.sort_by(|a, b| {
        let a_is_skill = a.path.eq_ignore_ascii_case("skill.md");
        let b_is_skill = b.path.eq_ignore_ascii_case("skill.md");
        match (a_is_skill, b_is_skill) {
            (true, false) => std::cmp::Ordering::Less,
            (false, true) => std::cmp::Ordering::Greater,
            _ => a.path.to_lowercase().cmp(&b.path.to_lowercase()),
        }
    });

    Ok(entries)
}

pub fn read_file(central_path: &Path, relative_path: &str) -> Result<String> {
    // Path traversal protection
    if relative_path.contains("..") {
        bail!("Invalid file path: path traversal not allowed");
    }

    let full_path = central_path.join(relative_path);
    let canonical = full_path
        .canonicalize()
        .with_context(|| format!("resolve path: {:?}", full_path))?;
    let canonical_base = central_path
        .canonicalize()
        .with_context(|| format!("resolve base: {:?}", central_path))?;

    if !canonical.starts_with(&canonical_base) {
        bail!("Invalid file path: outside skill directory");
    }

    let metadata =
        std::fs::metadata(&canonical).with_context(|| format!("read metadata: {:?}", canonical))?;

    if metadata.len() > MAX_FILE_SIZE {
        bail!(
            "File too large to display ({:.1} KB, max 1 MB)",
            metadata.len() as f64 / 1024.0
        );
    }

    let bytes = std::fs::read(&canonical).with_context(|| format!("read file: {:?}", canonical))?;

    String::from_utf8(bytes)
        .map_err(|_| anyhow::anyhow!("File is not valid UTF-8 text and cannot be displayed"))
}


================================================
FILE: src-tauri/src/core/skill_store.rs
================================================
use std::path::{Path, PathBuf};

use anyhow::{Context, Result};
use rusqlite::{params, Connection};
use tauri::Manager;

const DB_FILE_NAME: &str = "skills_hub.db";
const LEGACY_APP_IDENTIFIERS: &[&str] = &["com.tauri.dev", "com.tauri.dev.skillshub"];

// Schema versioning: bump when making changes and add a migration step.
const SCHEMA_VERSION: i32 = 5;

// Minimal schema for MVP: skills, skill_targets, settings, discovered_skills(optional).
const SCHEMA_V1: &str = r#"
CREATE TABLE IF NOT EXISTS skills (
  id TEXT PRIMARY KEY,
  name TEXT NOT NULL,
  source_type TEXT NOT NULL,
  source_ref TEXT NULL,
  source_revision TEXT NULL,
  central_path TEXT NOT NULL UNIQUE,
  content_hash TEXT NULL,
  created_at INTEGER NOT NULL,
  updated_at INTEGER NOT NULL,
  last_sync_at INTEGER NULL,
  last_seen_at INTEGER NOT NULL,
  status TEXT NOT NULL
);

CREATE TABLE IF NOT EXISTS skill_targets (
  id TEXT PRIMARY KEY,
  skill_id TEXT NOT NULL,
  tool TEXT NOT NULL,
  scope TEXT NOT NULL DEFAULT 'global',
  project_path TEXT NULL,
  target_path TEXT NOT NULL,
  mode TEXT NOT NULL,
  status TEXT NOT NULL,
  last_error TEXT NULL,
  synced_at INTEGER NULL,
  FOREIGN KEY(skill_id) REFERENCES skills(id) ON DELETE CASCADE
);

CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_targets_unique_scope
ON skill_targets(skill_id, tool, scope, COALESCE(project_path, ''));

CREATE TABLE IF NOT EXISTS settings (
  key TEXT PRIMARY KEY,
  value TEXT NOT NULL
);

CREATE TABLE IF NOT EXISTS discovered_skills (
  id TEXT PRIMARY KEY,
  tool TEXT NOT NULL,
  found_path TEXT NOT NULL,
  name_guess TEXT NULL,
  fingerprint TEXT NULL,
  found_at INTEGER NOT NULL,
  imported_skill_id TEXT NULL,
  FOREIGN KEY(imported_skill_id) REFERENCES skills(id) ON DELETE SET NULL
);

CREATE INDEX IF NOT EXISTS idx_skills_name ON skills(name);
CREATE INDEX IF NOT EXISTS idx_skills_updated_at ON skills(updated_at);

CREATE TABLE IF NOT EXISTS skill_tags (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL UNIQUE COLLATE NOCASE,
  created_at INTEGER NOT NULL,
  updated_at INTEGER NOT NULL
);

CREATE TABLE IF NOT EXISTS skill_tag_links (
  skill_id TEXT NOT NULL,
  tag_id INTEGER NOT NULL,
  created_at INTEGER NOT NULL,
  PRIMARY KEY (skill_id, tag_id),
  FOREIGN KEY(skill_id) REFERENCES skills(id) ON DELETE CASCADE,
  FOREIGN KEY(tag_id) REFERENCES skill_tags(id) ON DELETE CASCADE
);
"#;

#[derive(Clone, Debug)]
pub struct SkillStore {
    db_path: PathBuf,
}

#[derive(Clone, Debug)]
pub struct SkillRecord {
    pub id: String,
    pub name: String,
    pub description: Option<String>,
    pub source_type: String,
    pub source_ref: Option<String>,
    pub source_subpath: Option<String>,
    pub source_revision: Option<String>,
    pub central_path: String,
    pub content_hash: Option<String>,
    pub created_at: i64,
    pub updated_at: i64,
    pub last_sync_at: Option<i64>,
    pub last_seen_at: i64,
    pub status: String,
}

#[derive(Clone, Debug)]
pub struct SkillTargetRecord {
    pub id: String,
    pub skill_id: String,
    pub tool: String,
    pub scope: String,
    pub project_path: Option<String>,
    pub target_path: String,
    pub mode: String,
    pub status: String,
    pub last_error: Option<String>,
    pub synced_at: Option<i64>,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct TagRecord {
    pub id: i64,
    pub name: String,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct TagWithCountRecord {
    pub id: i64,
    pub name: String,
    pub skill_count: i64,
    pub updated_at: i64,
}

impl SkillStore {
    pub fn new(db_path: PathBuf) -> Self {
        Self { db_path }
    }

    #[allow(dead_code)]
    pub fn db_path(&self) -> &Path {
        &self.db_path
    }

    pub fn ensure_schema(&self) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute_batch("PRAGMA foreign_keys = ON;")?;

            let user_version: i32 = conn.query_row("PRAGMA user_version;", [], |row| row.get(0))?;
            if user_version == 0 {
                conn.execute_batch(SCHEMA_V1)?;
                // V2: add description column
                conn.execute_batch("ALTER TABLE skills ADD COLUMN description TEXT NULL;")?;
                // V3: add source_subpath column
                conn.execute_batch("ALTER TABLE skills ADD COLUMN source_subpath TEXT NULL;")?;
                migrate_skill_targets_to_v4(conn)?;
                conn.pragma_update(None, "user_version", SCHEMA_VERSION)?;
            } else if user_version < SCHEMA_VERSION {
                // Incremental migrations
                if user_version < 2 {
                    conn.execute_batch("ALTER TABLE skills ADD COLUMN description TEXT NULL;")?;
                }
                if user_version < 3 {
                    conn.execute_batch("ALTER TABLE skills ADD COLUMN source_subpath TEXT NULL;")?;
                }
                if user_version < 4 {
                    migrate_skill_targets_to_v4(conn)?;
                }
                if user_version < 5 {
                    migrate_tags_to_v5(conn)?;
                }
                conn.pragma_update(None, "user_version", SCHEMA_VERSION)?;
            } else if user_version > SCHEMA_VERSION {
                anyhow::bail!(
                    "database schema version {} is newer than app supports {}",
                    user_version,
                    SCHEMA_VERSION
                );
            }

            Ok(())
        })
    }

    pub fn get_setting(&self, key: &str) -> Result<Option<String>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare("SELECT value FROM settings WHERE key = ?1")?;
            let mut rows = stmt.query(params![key])?;
            Ok(rows
                .next()?
                .map(|row| row.get::<_, String>(0))
                .transpose()?)
        })
    }

    pub fn set_setting(&self, key: &str, value: &str) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute(
                "INSERT INTO settings (key, value) VALUES (?1, ?2)
         ON CONFLICT(key) DO UPDATE SET value = excluded.value",
                params![key, value],
            )?;
            Ok(())
        })
    }

    #[allow(dead_code)]
    pub fn set_onboarding_completed(&self, completed: bool) -> Result<()> {
        self.set_setting(
            "onboarding_completed",
            if completed { "true" } else { "false" },
        )
    }

    pub fn upsert_skill(&self, record: &SkillRecord) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute(
                "INSERT INTO skills (
          id, name, description, source_type, source_ref, source_subpath, source_revision, central_path, content_hash,
          created_at, updated_at, last_sync_at, last_seen_at, status
        ) VALUES (
          ?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9,
          ?10, ?11, ?12, ?13, ?14
        )
        ON CONFLICT(id) DO UPDATE SET
          name = excluded.name,
          description = excluded.description,
          source_type = excluded.source_type,
          source_ref = excluded.source_ref,
          source_subpath = excluded.source_subpath,
          source_revision = excluded.source_revision,
          central_path = excluded.central_path,
          content_hash = excluded.content_hash,
          created_at = excluded.created_at,
          updated_at = excluded.updated_at,
          last_sync_at = excluded.last_sync_at,
          last_seen_at = excluded.last_seen_at,
          status = excluded.status",
                params![
                    record.id,
                    record.name,
                    record.description,
                    record.source_type,
                    record.source_ref,
                    record.source_subpath,
                    record.source_revision,
                    record.central_path,
                    record.content_hash,
                    record.created_at,
                    record.updated_at,
                    record.last_sync_at,
                    record.last_seen_at,
                    record.status
                ],
            )?;
            Ok(())
        })
    }

    pub fn upsert_skill_target(&self, record: &SkillTargetRecord) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute(
                "INSERT INTO skill_targets (
          id, skill_id, tool, scope, project_path, target_path, mode, status, last_error, synced_at
        ) VALUES (
          ?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10
        )
        ON CONFLICT DO UPDATE SET
          target_path = excluded.target_path,
          mode = excluded.mode,
          status = excluded.status,
          last_error = excluded.last_error,
          synced_at = excluded.synced_at",
                params![
                    record.id,
                    record.skill_id,
                    record.tool,
                    record.scope,
                    record.project_path,
                    record.target_path,
                    record.mode,
                    record.status,
                    record.last_error,
                    record.synced_at
                ],
            )?;
            Ok(())
        })
    }

    pub fn list_skills(&self) -> Result<Vec<SkillRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
        "SELECT id, name, description, source_type, source_ref, source_subpath, source_revision, central_path, content_hash,
                created_at, updated_at, last_sync_at, last_seen_at, status
         FROM skills
         ORDER BY updated_at DESC",
      )?;
            let rows = stmt.query_map([], |row| {
                Ok(SkillRecord {
                    id: row.get(0)?,
                    name: row.get(1)?,
                    description: row.get(2)?,
                    source_type: row.get(3)?,
                    source_ref: row.get(4)?,
                    source_subpath: row.get(5)?,
                    source_revision: row.get(6)?,
                    central_path: row.get(7)?,
                    content_hash: row.get(8)?,
                    created_at: row.get(9)?,
                    updated_at: row.get(10)?,
                    last_sync_at: row.get(11)?,
                    last_seen_at: row.get(12)?,
                    status: row.get(13)?,
                })
            })?;

            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn get_skill_by_id(&self, skill_id: &str) -> Result<Option<SkillRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
        "SELECT id, name, description, source_type, source_ref, source_subpath, source_revision, central_path, content_hash,
                created_at, updated_at, last_sync_at, last_seen_at, status
         FROM skills
         WHERE id = ?1
         LIMIT 1",
      )?;
            let mut rows = stmt.query(params![skill_id])?;
            if let Some(row) = rows.next()? {
                Ok(Some(SkillRecord {
                    id: row.get(0)?,
                    name: row.get(1)?,
                    description: row.get(2)?,
                    source_type: row.get(3)?,
                    source_ref: row.get(4)?,
                    source_subpath: row.get(5)?,
                    source_revision: row.get(6)?,
                    central_path: row.get(7)?,
                    content_hash: row.get(8)?,
                    created_at: row.get(9)?,
                    updated_at: row.get(10)?,
                    last_sync_at: row.get(11)?,
                    last_seen_at: row.get(12)?,
                    status: row.get(13)?,
                }))
            } else {
                Ok(None)
            }
        })
    }

    pub fn update_skill_description(
        &self,
        skill_id: &str,
        description: Option<&str>,
    ) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute(
                "UPDATE skills SET description = ?1 WHERE id = ?2",
                params![description, skill_id],
            )?;
            Ok(())
        })
    }

    pub fn delete_skill(&self, skill_id: &str) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute("DELETE FROM skills WHERE id = ?1", params![skill_id])?;
            Ok(())
        })
    }

    pub fn create_tag(&self, name: &str) -> Result<TagRecord> {
        let normalized = normalize_tag_name(name)?;
        self.with_conn(|conn| {
            let now = now_ms();
            conn.execute(
                "INSERT INTO skill_tags (name, created_at, updated_at) VALUES (?1, ?2, ?2)",
                params![normalized, now],
            )
            .with_context(|| format!("tag already exists: {}", normalized))?;
            let id = conn.last_insert_rowid();
            Ok(TagRecord {
                id,
                name: normalized,
            })
        })
    }

    pub fn rename_tag(&self, tag_id: i64, name: &str) -> Result<TagRecord> {
        let normalized = normalize_tag_name(name)?;
        self.with_conn(|conn| {
            let changed = conn
                .execute(
                    "UPDATE skill_tags SET name = ?1, updated_at = ?2 WHERE id = ?3",
                    params![normalized, now_ms(), tag_id],
                )
                .with_context(|| format!("tag already exists: {}", normalized))?;
            if changed == 0 {
                anyhow::bail!("tag not found: {}", tag_id);
            }
            Ok(TagRecord {
                id: tag_id,
                name: normalized,
            })
        })
    }

    pub fn delete_tag(&self, tag_id: i64) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute("DELETE FROM skill_tags WHERE id = ?1", params![tag_id])?;
            Ok(())
        })
    }

    pub fn list_tags_with_counts(&self) -> Result<Vec<TagWithCountRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT t.id, t.name, COUNT(l.skill_id) AS skill_count,
                        COALESCE(MAX(l.created_at), t.updated_at) AS last_used_at
                 FROM skill_tags t
                 LEFT JOIN skill_tag_links l ON l.tag_id = t.id
                 GROUP BY t.id, t.name, t.updated_at
                 ORDER BY LOWER(t.name) ASC",
            )?;
            let rows = stmt.query_map([], |row| {
                Ok(TagWithCountRecord {
                    id: row.get(0)?,
                    name: row.get(1)?,
                    skill_count: row.get(2)?,
                    updated_at: row.get(3)?,
                })
            })?;

            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn get_skill_tags(&self, skill_id: &str) -> Result<Vec<TagRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT t.id, t.name
                 FROM skill_tags t
                 INNER JOIN skill_tag_links l ON l.tag_id = t.id
                 WHERE l.skill_id = ?1
                 ORDER BY LOWER(t.name) ASC",
            )?;
            let rows = stmt.query_map(params![skill_id], |row| {
                Ok(TagRecord {
                    id: row.get(0)?,
                    name: row.get(1)?,
                })
            })?;

            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn set_skill_tags(&self, skill_id: &str, tag_ids: &[i64]) -> Result<()> {
        self.with_conn(|conn| {
            let now = now_ms();
            conn.execute_batch("BEGIN;")?;
            let result = (|| -> Result<()> {
                conn.execute(
                    "DELETE FROM skill_tag_links WHERE skill_id = ?1",
                    params![skill_id],
                )?;
                for tag_id in tag_ids {
                    conn.execute(
                        "INSERT OR IGNORE INTO skill_tag_links (skill_id, tag_id, created_at)
                         VALUES (?1, ?2, ?3)",
                        params![skill_id, tag_id, now],
                    )?;
                }
                Ok(())
            })();

            match result {
                Ok(()) => {
                    conn.execute_batch("COMMIT;")?;
                    Ok(())
                }
                Err(err) => {
                    let _ = conn.execute_batch("ROLLBACK;");
                    Err(err)
                }
            }
        })
    }

    pub fn list_untagged_skill_ids(&self) -> Result<Vec<String>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT s.id
                 FROM skills s
                 WHERE NOT EXISTS (
                   SELECT 1 FROM skill_tag_links l WHERE l.skill_id = s.id
                 )
                 ORDER BY s.updated_at DESC",
            )?;
            let rows = stmt.query_map([], |row| row.get::<_, String>(0))?;
            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn list_skill_targets(&self, skill_id: &str) -> Result<Vec<SkillTargetRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT id, skill_id, tool, scope, project_path, target_path, mode, status, last_error, synced_at
         FROM skill_targets
         WHERE skill_id = ?1
         ORDER BY tool ASC, scope ASC, project_path ASC",
            )?;
            let rows = stmt.query_map(params![skill_id], |row| {
                Ok(SkillTargetRecord {
                    id: row.get(0)?,
                    skill_id: row.get(1)?,
                    tool: row.get(2)?,
                    scope: row.get(3)?,
                    project_path: row.get(4)?,
                    target_path: row.get(5)?,
                    mode: row.get(6)?,
                    status: row.get(7)?,
                    last_error: row.get(8)?,
                    synced_at: row.get(9)?,
                })
            })?;

            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn list_all_skill_target_paths(&self) -> Result<Vec<(String, String)>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT tool, target_path
         FROM skill_targets",
            )?;
            let rows = stmt.query_map([], |row| Ok((row.get(0)?, row.get(1)?)))?;

            let mut items = Vec::new();
            for row in rows {
                items.push(row?);
            }
            Ok(items)
        })
    }

    pub fn get_skill_target(
        &self,
        skill_id: &str,
        tool: &str,
        scope: &str,
        project_path: Option<&str>,
    ) -> Result<Option<SkillTargetRecord>> {
        self.with_conn(|conn| {
            let mut stmt = conn.prepare(
                "SELECT id, skill_id, tool, scope, project_path, target_path, mode, status, last_error, synced_at
         FROM skill_targets
         WHERE skill_id = ?1
           AND tool = ?2
           AND scope = ?3
           AND ((?4 IS NULL AND project_path IS NULL) OR project_path = ?4)",
            )?;
            let mut rows = stmt.query(params![skill_id, tool, scope, project_path])?;
            if let Some(row) = rows.next()? {
                Ok(Some(SkillTargetRecord {
                    id: row.get(0)?,
                    skill_id: row.get(1)?,
                    tool: row.get(2)?,
                    scope: row.get(3)?,
                    project_path: row.get(4)?,
                    target_path: row.get(5)?,
                    mode: row.get(6)?,
                    status: row.get(7)?,
                    last_error: row.get(8)?,
                    synced_at: row.get(9)?,
                }))
            } else {
                Ok(None)
            }
        })
    }

    pub fn delete_skill_target(
        &self,
        skill_id: &str,
        tool: &str,
        scope: &str,
        project_path: Option<&str>,
    ) -> Result<()> {
        self.with_conn(|conn| {
            conn.execute(
                "DELETE FROM skill_targets
                 WHERE skill_id = ?1
                   AND tool = ?2
                   AND scope = ?3
                   AND ((?4 IS NULL AND project_path IS NULL) OR project_path = ?4)",
                params![skill_id, tool, scope, project_path],
            )?;
            Ok(())
        })
    }

    fn with_conn<T>(&self, f: impl FnOnce(&Connection) -> Result<T>) -> Result<T> {
        let conn = Connection::open(&self.db_path)
            .with_context(|| format!("failed to open db at {:?}", self.db_path))?;
        // Enforce foreign key constraints on every connection (rusqlite PRAGMA is per-connection).
        conn.execute_batch("PRAGMA foreign_keys = ON;")?;
        f(&conn)
    }
}

fn migrate_skill_targets_to_v4(conn: &Connection) -> Result<()> {
    conn.execute_batch(
        "BEGIN;
         DROP INDEX IF EXISTS idx_skill_targets_unique_scope;
         CREATE TABLE skill_targets_new (
           id TEXT PRIMARY KEY,
           skill_id TEXT NOT NULL,
           tool TEXT NOT NULL,
           scope TEXT NOT NULL DEFAULT 'global',
           project_path TEXT NULL,
           target_path TEXT NOT NULL,
           mode TEXT NOT NULL,
           status TEXT NOT NULL,
           last_error TEXT NULL,
           synced_at INTEGER NULL,
           FOREIGN KEY(skill_id) REFERENCES skills(id) ON DELETE CASCADE
         );
         INSERT INTO skill_targets_new (
           id, skill_id, tool, scope, project_path, target_path, mode, status, last_error, synced_at
         )
         SELECT id, skill_id, tool, 'global', NULL, target_path, mode, status, last_error, synced_at
         FROM skill_targets;
         DROP TABLE skill_targets;
         ALTER TABLE skill_targets_new RENAME TO skill_targets;
         CREATE UNIQUE INDEX idx_skill_targets_unique_scope
         ON skill_targets(skill_id, tool, scope, COALESCE(project_path, ''));
         COMMIT;",
    )?;
    Ok(())
}

fn migrate_tags_to_v5(conn: &Connection) -> Result<()> {
    conn.execute_batch(
        "CREATE TABLE IF NOT EXISTS skill_tags (
           id INTEGER PRIMARY KEY AUTOINCREMENT,
           name TEXT NOT NULL UNIQUE COLLATE NOCASE,
           created_at INTEGER NOT NULL,
           updated_at INTEGER NOT NULL
         );

         CREATE TABLE IF NOT EXISTS skill_tag_links (
           skill_id TEXT NOT NULL,
           tag_id INTEGER NOT NULL,
           created_at INTEGER NOT NULL,
           PRIMARY KEY (skill_id, tag_id),
           FOREIGN KEY(skill_id) REFERENCES skills(id) ON DELETE CASCADE,
           FOREIGN KEY(tag_id) REFERENCES skill_tags(id) ON DELETE CASCADE
         );",
    )?;
    Ok(())
}

fn normalize_tag_name(name: &str) -> Result<String> {
    let normalized = name.trim().to_string();
    if normalized.is_empty() {
        anyhow::bail!("tag name cannot be empty");
    }
    Ok(normalized)
}

fn now_ms() -> i64 {
    let now = std::time::SystemTime::now()
        .duration_since(std::time::SystemTime::UNIX_EPOCH)
        .unwrap_or_default();
    now.as_millis() as i64
}

pub fn default_db_path<R: tauri::Runtime>(app: &tauri::AppHandle<R>) -> Result<PathBuf> {
    let app_dir = app
        .path()
        .app_data_dir()
        .context("failed to resolve app data dir")?;
    std::fs::create_dir_all(&app_dir)
        .with_context(|| format!("failed to create app data dir {:?}", app_dir))?;
    Ok(app_dir.join(DB_FILE_NAME))
}

pub fn migrate_legacy_db_if_needed(target_db_path: &Path) -> Result<()> {
    let Some(data_dir) = dirs::data_dir() else {
        return Ok(());
    };

    if let Ok(true) = db_has_any_skills(target_db_path) {
        return Ok(());
    }

    let legacy_db_path = LEGACY_APP_IDENTIFIERS
        .iter()
        .map(|id| data_dir.join(id).join(DB_FILE_NAME))
        .find(|path| path.exists());

    let Some(legacy_db_path) = legacy_db_path else {
        return Ok(());
    };

    if legacy_db_path == target_db_path {
        return Ok(());
    }

    if let Some(parent) = target_db_path.parent() {
        std::fs::create_dir_all(parent)
            .with_context(|| format!("failed to create app data dir {:?}", parent))?;
    }

    if target_db_path.exists() {
        let backup = target_db_path.with_extension(format!(
            "bak-{}",
            std::time::SystemTime::now()
                .duration_since(std::time::UNIX_EPOCH)
                .unwrap_or_default()
                .as_secs()
        ));
        std::fs::rename(target_db_path, &backup).with_context(|| {
            format!(
                "failed to backup existing db {:?} -> {:?}",
                target_db_path, backup
            )
        })?;
    }

    std::fs::copy(&legacy_db_path, target_db_path).with_context(|| {
        format!(
            "failed to migrate legacy db {:?} -> {:?}",
            legacy_db_path, target_db_path
        )
    })?;

    Ok(())
}

fn db_has_any_skills(db_path: &Path) -> Result<bool> {
    if !db_path.exists() {
        return Ok(false);
    }

    let conn =
        Connection::open(db_path).with_context(|| format!("failed to open db at {:?}", db_path))?;
    let has_table: i64 = conn.query_row(
        "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name='skills';",
        [],
        |row| row.get(0),
    )?;
    if has_table == 0 {
        return Ok(false);
    }

    let count: i64 = conn.query_row("SELECT COUNT(*) FROM skills;", [], |row| row.get(0))?;
    Ok(count > 0)
}

#[cfg(test)]
#[path = "tests/skill_store.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/skills_search.rs
================================================
use anyhow::{Context, Result};
use reqwest::blocking::Client;
use serde::Deserialize;

#[derive(Debug, Deserialize)]
struct SkillsShResponse {
    skills: Vec<SkillsShItem>,
}

#[derive(Debug, Deserialize)]
struct SkillsShItem {
    name: String,
    installs: u64,
    source: String,
}

#[derive(Debug, Clone, serde::Serialize)]
pub struct OnlineSkillResult {
    pub name: String,
    pub installs: u64,
    pub source: String,
    pub source_url: String,
}

pub fn search_skills_online(query: &str, limit: usize) -> Result<Vec<OnlineSkillResult>> {
    search_skills_online_inner("https://skills.sh", query, limit)
}

fn search_skills_online_inner(
    base_url: &str,
    query: &str,
    limit: usize,
) -> Result<Vec<OnlineSkillResult>> {
    let client = Client::new();
    let base_url = base_url.trim_end_matches('/');
    let url = format!(
        "{}/api/search?q={}&limit={}",
        base_url,
        urlencoding::encode(query),
        limit.clamp(1, 50)
    );

    let response = client
        .get(url)
        .header("User-Agent", "skills-hub")
        .send()
        .context("skills.sh search request failed")?
        .error_for_status()
        .context("skills.sh search returned error")?;

    let result: SkillsShResponse = response.json().context("parse skills.sh response")?;

    Ok(result
        .skills
        .into_iter()
        .map(|item| {
            let source_url = format!("https://github.com/{}", item.source);
            OnlineSkillResult {
                name: item.name,
                installs: item.installs,
                source: item.source,
                source_url,
            }
        })
        .collect())
}

#[cfg(test)]
#[path = "tests/skills_search.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/sync_engine.rs
================================================
use std::path::{Path, PathBuf};

use anyhow::{Context, Result};

#[allow(dead_code)]
#[derive(Clone, Debug)]
pub enum SyncMode {
    Auto,
    Symlink,
    Junction,
    Copy,
}

#[derive(Clone, Debug)]
pub struct SyncOutcome {
    pub mode_used: SyncMode,
    pub target_path: PathBuf,
    pub replaced: bool,
}

pub fn sync_dir_hybrid(source: &Path, target: &Path) -> Result<SyncOutcome> {
    if target.exists() {
        if is_same_link(target, source) {
            return Ok(SyncOutcome {
                mode_used: SyncMode::Symlink,
                target_path: target.to_path_buf(),
                replaced: false,
            });
        }
        anyhow::bail!("target already exists: {:?}", target);
    }

    ensure_parent_dir(target)?;

    if try_link_dir(source, target).is_ok() {
        return Ok(SyncOutcome {
            mode_used: SyncMode::Symlink,
            target_path: target.to_path_buf(),
            replaced: false,
        });
    }

    #[cfg(windows)]
    if try_junction(source, target).is_ok() {
        return Ok(SyncOutcome {
            mode_used: SyncMode::Junction,
            target_path: target.to_path_buf(),
            replaced: false,
        });
    }

    copy_dir_recursive(source, target)?;
    Ok(SyncOutcome {
        mode_used: SyncMode::Copy,
        target_path: target.to_path_buf(),
        replaced: false,
    })
}

pub fn sync_dir_hybrid_with_overwrite(
    source: &Path,
    target: &Path,
    overwrite: bool,
) -> Result<SyncOutcome> {
    let mut did_replace = false;
    if std::fs::symlink_metadata(target).is_ok() {
        if is_same_link(target, source) {
            return Ok(SyncOutcome {
                mode_used: SyncMode::Symlink,
                target_path: target.to_path_buf(),
                replaced: false,
            });
        }

        if overwrite {
            std::fs::remove_dir_all(target)
                .with_context(|| format!("remove existing target {:?}", target))?;
            did_replace = true;
        } else {
            anyhow::bail!("target already exists: {:?}", target);
        }
    }

    // reuse normal flow
    sync_dir_hybrid(source, target).map(|mut out| {
        out.replaced = did_replace;
        out
    })
}

pub fn sync_dir_copy_with_overwrite(
    source: &Path,
    target: &Path,
    overwrite: bool,
) -> Result<SyncOutcome> {
    let mut did_replace = false;
    if std::fs::symlink_metadata(target).is_ok() {
        if overwrite {
            remove_path_any(target)
                .with_context(|| format!("remove existing target {:?}", target))?;
            did_replace = true;
        } else {
            anyhow::bail!("target already exists: {:?}", target);
        }
    }

    ensure_parent_dir(target)?;
    copy_dir_recursive(source, target)?;

    Ok(SyncOutcome {
        mode_used: SyncMode::Copy,
        target_path: target.to_path_buf(),
        replaced: did_replace,
    })
}

pub fn sync_dir_for_tool_with_overwrite(
    tool_key: &str,
    source: &Path,
    target: &Path,
    overwrite: bool,
) -> Result<SyncOutcome> {
    // Cursor 目前不支持软链/junction：强制使用 copy，避免同步后在 Cursor 内不可用。
    if tool_key.eq_ignore_ascii_case("cursor") {
        return sync_dir_copy_with_overwrite(source, target, overwrite);
    }
    sync_dir_hybrid_with_overwrite(source, target, overwrite)
}

fn ensure_parent_dir(path: &Path) -> Result<()> {
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent).with_context(|| format!("create dir {:?}", parent))?;
    }
    Ok(())
}

fn remove_path_any(path: &Path) -> Result<()> {
    let meta = match std::fs::symlink_metadata(path) {
        Ok(meta) => meta,
        Err(err) if err.kind() == std::io::ErrorKind::NotFound => return Ok(()),
        Err(err) => return Err(err).with_context(|| format!("stat {:?}", path)),
    };
    let ft = meta.file_type();

    // 软链接（即使指向目录）也应该用 remove_file 删除链接本身
    if ft.is_symlink() {
        std::fs::remove_file(path).with_context(|| format!("remove symlink {:?}", path))?;
        return Ok(());
    }
    if ft.is_dir() {
        std::fs::remove_dir_all(path).with_context(|| format!("remove dir {:?}", path))?;
        return Ok(());
    }
    std::fs::remove_file(path).with_context(|| format!("remove file {:?}", path))?;
    Ok(())
}

fn is_same_link(link_path: &Path, target: &Path) -> bool {
    if let Ok(existing) = std::fs::read_link(link_path) {
        return existing == target;
    }
    false
}

fn try_link_dir(source: &Path, target: &Path) -> Result<()> {
    #[cfg(unix)]
    {
        std::os::unix::fs::symlink(source, target)
            .with_context(|| format!("symlink {:?} -> {:?}", target, source))?;
        Ok(())
    }

    #[cfg(windows)]
    {
        std::os::windows::fs::symlink_dir(source, target)
            .with_context(|| format!("symlink {:?} -> {:?}", target, source))?;
        return Ok(());
    }

    #[cfg(not(any(unix, windows)))]
    anyhow::bail!("symlink not supported on this platform");
}

#[cfg(windows)]
fn try_junction(source: &Path, target: &Path) -> Result<()> {
    junction::create(source, target)
        .with_context(|| format!("junction {:?} -> {:?}", target, source))?;
    Ok(())
}

fn should_skip_copy(entry: &walkdir::DirEntry) -> bool {
    entry.file_name() == ".git"
}

pub fn copy_dir_recursive(source: &Path, target: &Path) -> Result<()> {
    let profile = std::env::var("SKILLS_HUB_PROFILE_IO")
        .ok()
        .map(|v| v == "1" || v.eq_ignore_ascii_case("true"))
        .unwrap_or(false);
    let started = std::time::Instant::now();
    let mut copied_files: u64 = 0;
    let mut copied_bytes: u64 = 0;

    for entry in walkdir::WalkDir::new(source)
        .follow_links(false)
        .into_iter()
        .filter_entry(|entry| !should_skip_copy(entry))
    {
        let entry = entry?;
        if should_skip_copy(&entry) {
            continue;
        }
        let relative = entry.path().strip_prefix(source)?;
        let target_path = target.join(relative);

        if entry.file_type().is_dir() {
            std::fs::create_dir_all(&target_path)
                .with_context(|| format!("create dir {:?}", target_path))?;
        } else if entry.file_type().is_file() {
            if let Some(parent) = target_path.parent() {
                std::fs::create_dir_all(parent)?;
            }
            let bytes = std::fs::copy(entry.path(), &target_path)
                .with_context(|| format!("copy file {:?} -> {:?}", entry.path(), target_path))?;
            if profile {
                copied_files += 1;
                copied_bytes = copied_bytes.saturating_add(bytes);
            }
        }
    }
    if profile {
        log::info!(
            "[sync_engine] copy_dir_recursive {} files, {} bytes in {}s (src={:?} dst={:?})",
            copied_files,
            copied_bytes,
            started.elapsed().as_secs_f32(),
            source,
            target
        );
    }
    Ok(())
}

#[cfg(test)]
#[path = "tests/sync_engine.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/temp_cleanup.rs
================================================
use std::path::{Path, PathBuf};
use std::time::{Duration, SystemTime};

use anyhow::{Context, Result};
use tauri::Manager;

const TEMP_PREFIX: &str = "skills-hub-git-";
const TEMP_MARKER: &str = ".skills-hub-git-temp";

#[allow(dead_code)]
pub fn mark_temp_dir(dir: &Path) -> Result<()> {
    let marker = dir.join(TEMP_MARKER);
    if marker.exists() {
        return Ok(());
    }
    std::fs::write(&marker, b"skills-hub-git-temp-v1\n")
        .with_context(|| format!("failed to write marker {:?}", marker))?;
    Ok(())
}

pub fn cleanup_old_git_temp_dirs<R: tauri::Runtime>(
    app: &tauri::AppHandle<R>,
    max_age: Duration,
) -> Result<usize> {
    let cache_dir = app
        .path()
        .app_cache_dir()
        .context("failed to resolve app cache dir")?;

    cleanup_old_git_temp_dirs_in(&cache_dir, max_age)
}

fn cleanup_old_git_temp_dirs_in(cache_dir: &Path, max_age: Duration) -> Result<usize> {
    if !cache_dir.exists() {
        return Ok(0);
    }

    let cutoff = SystemTime::now()
        .checked_sub(max_age)
        .unwrap_or(SystemTime::UNIX_EPOCH);

    let mut removed = 0usize;
    let rd = match std::fs::read_dir(cache_dir) {
        Ok(v) => v,
        Err(err) => {
            // No permission / missing dir is not fatal.
            return Err(anyhow::anyhow!(
                "failed to read cache dir {:?}: {}",
                cache_dir,
                err
            ));
        }
    };

    for entry in rd.flatten() {
        let path: PathBuf = entry.path();
        if !path.is_dir() {
            continue;
        }
        let name = entry.file_name().to_string_lossy().to_string();
        if !name.starts_with(TEMP_PREFIX) {
            continue;
        }

        // Safety: only delete directories we have explicitly marked.
        if !path.join(TEMP_MARKER).exists() {
            continue;
        }

        let meta = match std::fs::metadata(&path) {
            Ok(m) => m,
            Err(_) => continue,
        };
        let modified = meta.modified().unwrap_or(SystemTime::UNIX_EPOCH);
        if modified > cutoff {
            continue;
        }

        // Best-effort delete; do not fail the whole cleanup.
        if std::fs::remove_dir_all(&path).is_ok() {
            removed += 1;
        }
    }

    Ok(removed)
}

#[cfg(test)]
#[path = "tests/temp_cleanup.rs"]
mod tests;


================================================
FILE: src-tauri/src/core/tests/central_repo.rs
================================================
use std::path::PathBuf;

use crate::core::central_repo::{ensure_central_repo, resolve_central_repo_path};
use crate::core::skill_store::SkillStore;

fn make_store() -> (tempfile::TempDir, SkillStore) {
    let dir = tempfile::tempdir().expect("tempdir");
    let store = SkillStore::new(dir.path().join("test.db"));
    store.ensure_schema().expect("ensure_schema");
    (dir, store)
}

#[test]
fn resolve_uses_setting_when_present() {
    let (dir, store) = make_store();
    let app = tauri::test::mock_app();
    let expected = dir.path().join("central");
    store
        .set_setting("central_repo_path", expected.to_string_lossy().as_ref())
        .unwrap();

    let got = resolve_central_repo_path(app.handle(), &store).unwrap();
    assert_eq!(got, expected);
}

#[test]
fn ensure_central_repo_creates_dir() {
    let dir = tempfile::tempdir().expect("tempdir");
    let p: PathBuf = dir.path().join("a/b/c");
    assert!(!p.exists());
    ensure_central_repo(&p).unwrap();
    assert!(p.exists());
}


================================================
FILE: src-tauri/src/core/tests/content_hash.rs
================================================
use std::fs;

use crate::core::content_hash::hash_dir;

#[test]
fn hash_changes_with_content_and_ignores_git_dir() {
    let dir = tempfile::tempdir().expect("tempdir");
    let root = dir.path();

    fs::create_dir_all(root.join("sub")).unwrap();
    fs::write(root.join("a.txt"), b"hello").unwrap();
    fs::write(root.join("sub/b.txt"), b"world").unwrap();

    let h1 = hash_dir(root).unwrap();

    fs::create_dir_all(root.join(".git")).unwrap();
    fs::write(root.join(".git/ignored"), b"ignored").unwrap();
    let h2 = hash_dir(root).unwrap();
    assert_eq!(h1, h2, "应忽略 .git 内容");

    fs::write(root.join("a.txt"), b"hello2").unwrap();
    let h3 = hash_dir(root).unwrap();
    assert_ne!(h2, h3);
}


================================================
FILE: src-tauri/src/core/tests/featured_skills.rs
================================================
use super::fetch_featured_skills_inner;
use crate::core::skill_store::SkillStore;

fn temp_store() -> SkillStore {
    let dir = tempfile::tempdir().unwrap();
    let db_path = dir.path().join("test.db");
    let store = SkillStore::new(db_path);
    store.ensure_schema().unwrap();
    // Leak the tempdir so it stays alive for the duration of the test.
    std::mem::forget(dir);
    store
}

fn json_payload() -> String {
    r#"{
  "updated_at": "2026-01-01T00:00:00Z",
  "skills": [
    {
      "slug": "foo",
      "name": "Foo Skill",
      "summary": "Does foo",
      "downloads": 100,
      "stars": 10,
      "source_url": "https://github.com/openclaw/skills/tree/main/skills/user/foo"
    },
    {
      "slug": "bar",
      "name": "Bar Skill",
      "summary": "Does bar",
      "downloads": 50,
      "stars": 5,
      "source_url": ""
    }
  ]
}"#
    .to_string()
}

#[test]
fn parses_and_filters_empty_source_url() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/featured.json")
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_payload())
        .create();

    let store = temp_store();
    let url = format!("{}/featured.json", server.url());
    let skills = fetch_featured_skills_inner(&url, &store).unwrap();

    assert_eq!(skills.len(), 1);
    assert_eq!(skills[0].slug, "foo");
    assert_eq!(skills[0].downloads, 100);
}

#[test]
fn falls_back_to_cache_on_http_failure() {
    let store = temp_store();

    // Pre-populate cache
    store
        .set_setting("featured_skills_cache", &json_payload())
        .unwrap();

    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/featured.json")
        .with_status(500)
        .with_body("error")
        .create();

    let url = format!("{}/featured.json", server.url());
    let skills = fetch_featured_skills_inner(&url, &store).unwrap();
    assert_eq!(skills.len(), 1);
    assert_eq!(skills[0].slug, "foo");
}

#[test]
fn falls_back_to_bundled_on_total_failure() {
    let store = temp_store();

    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/featured.json")
        .with_status(500)
        .with_body("error")
        .create();

    let url = format!("{}/featured.json", server.url());
    let skills = fetch_featured_skills_inner(&url, &store).unwrap();
    // Should not panic — returns bundled data (may or may not be empty
    // depending on the current bundled JSON, but should not error).
    let _ = skills.len();
}

#[test]
fn falls_back_to_bundled_on_malformed_json() {
    let store = temp_store();

    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/featured.json")
        .with_status(200)
        .with_body("not json")
        .create();

    let url = format!("{}/featured.json", server.url());
    // No cache, malformed body → falls back to bundled JSON gracefully
    let skills = fetch_featured_skills_inner(&url, &store).unwrap();
    let _ = skills.len();
}


================================================
FILE: src-tauri/src/core/tests/git_fetcher.rs
================================================
use std::fs;

use crate::core::git_fetcher::{clone_or_pull, clone_or_pull_sparse};

fn commit_file(repo: &git2::Repository, path: &str, content: &[u8], msg: &str) -> git2::Oid {
    let workdir = repo.workdir().expect("workdir");
    let file_path = workdir.join(path);
    if let Some(parent) = file_path.parent() {
        fs::create_dir_all(parent).unwrap();
    }
    fs::write(&file_path, content).unwrap();

    let mut index = repo.index().unwrap();
    index.add_path(std::path::Path::new(path)).unwrap();
    let tree_id = index.write_tree().unwrap();
    let tree = repo.find_tree(tree_id).unwrap();

    let sig = git2::Signature::now("t", "t@example.com").unwrap();
    let parents = match repo.head() {
        Ok(head) => vec![repo.find_commit(head.target().unwrap()).unwrap()],
        Err(_) => vec![],
    };
    let parent_refs: Vec<&git2::Commit> = parents.iter().collect();
    repo.commit(Some("HEAD"), &sig, &sig, msg, &tree, parent_refs.as_slice())
        .unwrap()
}

#[test]
fn clone_then_pull_updates_head() {
    let origin_dir = tempfile::tempdir().unwrap();
    let origin = git2::Repository::init(origin_dir.path()).unwrap();
    let _c1 = commit_file(&origin, "a.txt", b"v1", "c1");
    let c2 = commit_file(&origin, "a.txt", b"v2", "c2");

    let dest_dir = tempfile::tempdir().unwrap();
    let dest = dest_dir.path().join("clone");

    let h1 = clone_or_pull(
        origin_dir.path().to_string_lossy().as_ref(),
        &dest,
        None,
        None,
    )
    .unwrap();
    assert_eq!(h1, c2.to_string(), "首次 clone 应指向最新提交");

    let c3 = commit_file(&origin, "b.txt", b"v3", "c3");
    let h2 = clone_or_pull(
        origin_dir.path().to_string_lossy().as_ref(),
        &dest,
        None,
        None,
    )
    .unwrap();
    assert_eq!(h2, c3.to_string(), "再次调用应更新到最新提交");
}

#[test]
fn sparse_clone_only_materializes_requested_subpath() {
    let origin_dir = tempfile::tempdir().unwrap();
    let origin = git2::Repository::init(origin_dir.path()).unwrap();
    let _ = commit_file(&origin, "skills/a/SKILL.md", b"---\nname: A\n---\n", "c1");
    let _ = commit_file(&origin, "skills/b/SKILL.md", b"---\nname: B\n---\n", "c2");

    let dest_dir = tempfile::tempdir().unwrap();
    let dest = dest_dir.path().join("clone");

    let head = match clone_or_pull_sparse(
        origin_dir.path().to_string_lossy().as_ref(),
        &dest,
        None,
        "skills/a",
        None,
    ) {
        Ok(head) => head,
        Err(err) if format!("{:#}", err).contains("system git is required") => return,
        Err(err) => panic!("sparse clone failed: {:#}", err),
    };

    assert!(!head.is_empty());
    assert!(dest.join("skills/a/SKILL.md").exists());
    assert!(
        !dest.join("skills/b/SKILL.md").exists(),
        "未请求的子目录不应被检出到工作区"
    );
}


================================================
FILE: src-tauri/src/core/tests/github_search.rs
================================================
use mockito::Matcher;

use super::search_github_repos_inner;

fn json_one_repo() -> String {
    r#"{
  "items": [
    {
      "full_name": "o/r",
      "html_url": "https://example.com/o/r",
      "description": "d",
      "stargazers_count": 123,
      "updated_at": "2020-01-01T00:00:00Z",
      "clone_url": "https://example.com/o/r.git"
    }
  ]
}"#
    .to_string()
}

#[test]
fn limit_is_clamped() {
    let mut server = mockito::Server::new();

    let _m1 = server
        .mock("GET", "/search/repositories")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "hello".into()),
            Matcher::UrlEncoded("per_page".into(), "1".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_one_repo())
        .create();

    let out = search_github_repos_inner(&server.url(), "hello", 0, None).unwrap();
    assert_eq!(out.len(), 1);

    let _m2 = server
        .mock("GET", "/search/repositories")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "hello".into()),
            Matcher::UrlEncoded("per_page".into(), "50".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_one_repo())
        .create();

    let _ = search_github_repos_inner(&server.url(), "hello", 999, None).unwrap();
}

#[test]
fn maps_fields() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/search/repositories")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "x".into()),
            Matcher::UrlEncoded("per_page".into(), "2".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_one_repo())
        .create();

    let out = search_github_repos_inner(&server.url(), "x", 2, None).unwrap();
    assert_eq!(out[0].full_name, "o/r");
    assert_eq!(out[0].stars, 123);
}

#[test]
fn http_error_has_context() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/search/repositories")
        .with_status(500)
        .with_body("oops")
        .create();

    let err = search_github_repos_inner(&server.url(), "x", 2, None).unwrap_err();
    let msg = format!("{:#}", err);
    assert!(msg.contains("GitHub search returned error"), "{msg}");
}


================================================
FILE: src-tauri/src/core/tests/installer.rs
================================================
use std::fs;
use std::path::{Path, PathBuf};

use crate::core::skill_store::{SkillRecord, SkillStore, SkillTargetRecord};

fn make_store() -> (tempfile::TempDir, SkillStore) {
    let dir = tempfile::tempdir().expect("tempdir");
    let store = SkillStore::new(dir.path().join("test.db"));
    store.ensure_schema().expect("ensure_schema");
    (dir, store)
}

fn set_central_path(store: &SkillStore, central: &Path) {
    store
        .set_setting("central_repo_path", central.to_string_lossy().as_ref())
        .unwrap();
}

fn init_git_repo(dir: &Path) -> git2::Repository {
    let repo = git2::Repository::init(dir).unwrap();
    let sig = git2::Signature::now("t", "t@example.com").unwrap();

    let mut index = repo.index().unwrap();
    index
        .add_all(["*"].iter(), git2::IndexAddOption::DEFAULT, None)
        .unwrap();
    let tree_id = index.write_tree().unwrap();
    {
        let tree = repo.find_tree(tree_id).unwrap();
        repo.commit(Some("HEAD"), &sig, &sig, "init", &tree, &[])
            .unwrap();
    }
    repo
}

fn commit_all(repo: &git2::Repository, msg: &str) -> git2::Oid {
    let sig = git2::Signature::now("t", "t@example.com").unwrap();
    let mut index = repo.index().unwrap();
    index
        .add_all(["*"].iter(), git2::IndexAddOption::DEFAULT, None)
        .unwrap();
    let tree_id = index.write_tree().unwrap();
    let tree = repo.find_tree(tree_id).unwrap();

    let parent = repo
        .head()
        .ok()
        .and_then(|h| h.target())
        .and_then(|oid| repo.find_commit(oid).ok());
    match parent {
        Some(p) => repo
            .commit(Some("HEAD"), &sig, &sig, msg, &tree, &[&p])
            .unwrap(),
        None => repo
            .commit(Some("HEAD"), &sig, &sig, msg, &tree, &[])
            .unwrap(),
    }
}

#[test]
fn parses_github_urls() {
    let p = super::parse_github_url("https://github.com/owner/repo");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert!(p.branch.is_none());
    assert!(p.subpath.is_none());

    let p = super::parse_github_url("anthropics/skills");
    assert_eq!(p.clone_url, "https://github.com/anthropics/skills.git");
    assert!(p.branch.is_none());
    assert!(p.subpath.is_none());

    let p = super::parse_github_url("github.com/owner/repo");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert!(p.branch.is_none());
    assert!(p.subpath.is_none());

    let p = super::parse_github_url("https://github.com/owner/repo/tree/main/skills/x");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert_eq!(p.branch.as_deref(), Some("main"));
    assert_eq!(p.subpath.as_deref(), Some("skills/x"));

    let p = super::parse_github_url("owner/repo/tree/main/skills/x");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert_eq!(p.branch.as_deref(), Some("main"));
    assert_eq!(p.subpath.as_deref(), Some("skills/x"));

    let p = super::parse_github_url("https://github.com/owner/repo/blob/main/skills/x/SKILL.md");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert_eq!(p.branch.as_deref(), Some("main"));
    assert_eq!(p.subpath.as_deref(), Some("skills/x"));

    let p = super::parse_github_url("https://github.com/owner/repo/blob/main/SKILL.md");
    assert_eq!(p.clone_url, "https://github.com/owner/repo.git");
    assert_eq!(p.branch.as_deref(), Some("main"));
    assert_eq!(p.subpath.as_deref(), Some("."));

    let p = super::parse_github_url("/local/path/to/repo");
    assert_eq!(p.clone_url, "/local/path/to/repo");
}

#[test]
fn parses_skill_md_frontmatter() {
    let dir = tempfile::tempdir().unwrap();
    let p = dir.path().join("SKILL.md");
    fs::write(
        &p,
        r#"---
name: "My Skill"
description: "Desc"
---

body
"#,
    )
    .unwrap();

    let (name, desc) = super::parse_skill_md(&p).unwrap();
    assert_eq!(name, "My Skill");
    assert_eq!(desc.as_deref(), Some("Desc"));
}

#[test]
fn parses_skill_md_frontmatter_literal_description() {
    let dir = tempfile::tempdir().unwrap();
    let p = dir.path().join("SKILL.md");
    fs::write(
        &p,
        r#"---
name: technical-writer
description: |
  Creates clear documentation, API references, guides, and
  technical content for developers and users.
author: awesome-llm-apps
---

body
"#,
    )
    .unwrap();

    let (name, desc) = super::parse_skill_md(&p).unwrap();
    assert_eq!(name, "technical-writer");
    assert_eq!(
        desc.as_deref(),
        Some("Creates clear documentation, API references, guides, and\ntechnical content for developers and users.")
    );
}

#[test]
fn parses_skill_md_frontmatter_folded_chomp_description() {
    let dir = tempfile::tempdir().unwrap();
    let p = dir.path().join("SKILL.md");
    fs::write(
        &p,
        r#"---
name: fireworks-tech-graph
description: >-
  Use when the user wants to create any technical diagram - architecture, data
  flow, flowchart, sequence, agent/memory, or concept map - and export as
  SVG+PNG.
---

body
"#,
    )
    .unwrap();

    let (name, desc) = super::parse_skill_md(&p).unwrap();
    assert_eq!(name, "fireworks-tech-graph");
    assert_eq!(
        desc.as_deref(),
        Some(
            "Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG."
        )
    );
}

#[test]
fn backfill_skill_descriptions_replaces_stale_frontmatter_marker() {
    let (_dir, store) = make_store();
    let central = tempfile::tempdir().unwrap();
    fs::write(
        central.path().join("SKILL.md"),
        r#"---
name: fireworks-tech-graph
description: >-
  Correct folded description.
---
"#,
    )
    .unwrap();

    store
        .upsert_skill(&SkillRecord {
            id: "fireworks".to_string(),
            name: "fireworks-tech-graph".to_string(),
            description: Some(">-".to_string()),
            source_type: "local".to_string(),
            source_ref: None,
            source_subpath: None,
            source_revision: None,
            central_path: central.path().to_string_lossy().to_string(),
            content_hash: None,
            created_at: 1,
            updated_at: 1,
            last_sync_at: None,
            last_seen_at: 1,
            status: "ok".to_string(),
        })
        .unwrap();

    super::backfill_skill_descriptions(&store);

    let skill = store.get_skill_by_id("fireworks").unwrap().unwrap();
    assert_eq!(
        skill.description.as_deref(),
        Some("Correct folded description.")
    );
}

#[test]
fn installs_local_skill_and_updates_from_source() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();

    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let source = tempfile::tempdir().unwrap();
    fs::write(source.path().join("SKILL.md"), b"---\nname: x\n---\n").unwrap();
    fs::write(source.path().join("a.txt"), b"v1").unwrap();

    let res = super::install_local_skill(
        app.handle(),
        &store,
        source.path(),
        Some("local1".to_string()),
    )
    .unwrap();
    assert!(res.central_path.exists());

    let skill = store.get_skill_by_id(&res.skill_id).unwrap().unwrap();
    assert_eq!(skill.name, "local1");

    // add a copy target so update will resync it
    let target_root = tempfile::tempdir().unwrap();
    let target = target_root.path().join("target");
    let t = SkillTargetRecord {
        id: "t1".to_string(),
        skill_id: res.skill_id.clone(),
        tool: "unknown_tool".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: target.to_string_lossy().to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: None,
    };
    store.upsert_skill_target(&t).unwrap();

    fs::write(source.path().join("a.txt"), b"v2").unwrap();
    let up = super::update_managed_skill_from_source(app.handle(), &store, &res.skill_id).unwrap();
    assert_eq!(up.skill_id, res.skill_id);
    assert!(up.updated_targets.contains(&"unknown_tool".to_string()));
    assert!(PathBuf::from(
        store
            .get_skill_by_id(&res.skill_id)
            .unwrap()
            .unwrap()
            .central_path
    )
    .exists());
    assert!(
        target.join("a.txt").exists(),
        "目标路径应存在并包含同步后的文件"
    );
    assert_eq!(fs::read(target.join("a.txt")).unwrap(), b"v2");

    let err = match super::install_local_skill(
        app.handle(),
        &store,
        source.path(),
        Some("local1".to_string()),
    ) {
        Ok(_) => panic!("expected error"),
        Err(e) => e,
    };
    assert!(format!("{:#}", err).contains("skill already exists"));
}

#[test]
fn lists_and_installs_git_skills_without_network() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::write(repo_dir.path().join("SKILL.md"), "---\nname: Root\n---\n").unwrap();
    fs::create_dir_all(repo_dir.path().join("skills/a")).unwrap();
    fs::write(
        repo_dir.path().join("skills/a/SKILL.md"),
        "---\nname: A\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add skills");

    let candidates = super::list_git_skills(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
    )
    .unwrap();
    let subpaths: Vec<String> = candidates.into_iter().map(|c| c.subpath).collect();
    assert!(subpaths.contains(&".".to_string()));
    assert!(subpaths.iter().any(|s| s.ends_with("skills/a")));

    let res = super::install_git_skill_from_selection(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        "skills/a",
        None,
    )
    .unwrap();
    assert!(res.central_path.exists());
}

#[test]
fn install_git_skill_errors_on_multi_skills_repo_root() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(repo_dir.path().join("skills/a")).unwrap();
    fs::create_dir_all(repo_dir.path().join("skills/b")).unwrap();
    fs::write(
        repo_dir.path().join("skills/a/SKILL.md"),
        "---\nname: A\n---\n",
    )
    .unwrap();
    fs::write(
        repo_dir.path().join("skills/b/SKILL.md"),
        "---\nname: B\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "multi skills");

    let err = match super::install_git_skill(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        None,
        None,
    ) {
        Ok(_) => panic!("expected error"),
        Err(e) => e,
    };
    assert!(format!("{:#}", err).contains("MULTI_SKILLS|"));
}

#[test]
fn lists_local_skills_with_invalid_entries() {
    let dir = tempfile::tempdir().unwrap();
    let base = dir.path();
    fs::create_dir_all(base.join("skills/a")).unwrap();
    fs::create_dir_all(base.join("skills/b")).unwrap();
    fs::create_dir_all(base.join("skills/c")).unwrap();
    fs::create_dir_all(base.join("skills/d")).unwrap();

    fs::write(base.join("skills/a/SKILL.md"), "---\nname: A\n---\n").unwrap();
    fs::write(base.join("skills/c/SKILL.md"), "name: C\n").unwrap();
    fs::write(base.join("skills/d/SKILL.md"), "---\ndescription: D\n---\n").unwrap();

    let list = super::list_local_skills(base).unwrap();

    let find = |subpath: &str| list.iter().find(|c| c.subpath == subpath).cloned();

    let a = find("skills/a").expect("skills/a");
    assert!(a.valid);
    assert_eq!(a.name, "A");

    let b = find("skills/b").expect("skills/b");
    assert!(!b.valid);
    assert_eq!(b.reason.as_deref(), Some("missing_skill_md"));

    let c = find("skills/c").expect("skills/c");
    assert!(!c.valid);
    assert_eq!(c.reason.as_deref(), Some("invalid_frontmatter"));

    let d = find("skills/d").expect("skills/d");
    assert!(!d.valid);
    assert_eq!(d.reason.as_deref(), Some("missing_name"));
}

#[test]
fn install_local_selection_validates_skill_md() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();

    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let base = tempfile::tempdir().unwrap();
    fs::create_dir_all(base.path().join("skills/a")).unwrap();
    fs::create_dir_all(base.path().join("skills/b")).unwrap();
    fs::write(
        base.path().join("skills/a/SKILL.md"),
        "---\nname: Local A\n---\n",
    )
    .unwrap();

    let res = super::install_local_skill_from_selection(
        app.handle(),
        &store,
        base.path(),
        "skills/a",
        None,
    )
    .unwrap();
    assert!(res.central_path.exists());
    let skill = store.get_skill_by_id(&res.skill_id).unwrap().unwrap();
    assert_eq!(skill.name, "Local A");

    let err = match super::install_local_skill_from_selection(
        app.handle(),
        &store,
        base.path(),
        "skills/b",
        None,
    ) {
        Ok(_) => panic!("expected error"),
        Err(e) => e,
    };
    assert!(format!("{:#}", err).contains("SKILL_INVALID|missing_skill_md"));
}

/// Issue #28: when a git subpath is "skills", the derived name should be replaced by the
/// SKILL.md name to avoid path duplication (e.g. `~/.claude/skills/skills/`).
#[test]
fn install_git_skill_uses_skill_md_name_over_subpath_skills() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    // Build a repo with skills/<folder> where the folder is named "skills" (simulating
    // a URL like https://github.com/owner/repo/tree/main/skills).
    let repo_dir = tempfile::tempdir().unwrap();
    let skills_dir = repo_dir.path().join("skills");
    fs::create_dir_all(&skills_dir).unwrap();
    fs::write(
        skills_dir.join("SKILL.md"),
        "---\nname: my-real-skill\ndescription: A real skill\n---\n",
    )
    .unwrap();
    fs::write(skills_dir.join("helper.txt"), b"data").unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add skill in skills dir");

    // install_git_skill_from_selection with subpath "skills" (no user-provided name)
    let res = super::install_git_skill_from_selection(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        "skills",
        None,
    )
    .unwrap();

    // The name should be "my-real-skill" from SKILL.md, NOT "skills" from the subpath.
    assert_eq!(res.name, "my-real-skill");
    assert!(res.central_path.ends_with("my-real-skill"));
    assert!(res.central_path.join("SKILL.md").exists());

    let skill = store.get_skill_by_id(&res.skill_id).unwrap().unwrap();
    assert_eq!(skill.name, "my-real-skill");
    assert_eq!(skill.description.as_deref(), Some("A real skill"));
}

#[test]
fn install_git_skill_rejects_container_subpath_without_skill_md() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(
        repo_dir
            .path()
            .join("awesome_agent_skills/technical-writer"),
    )
    .unwrap();
    fs::write(
        repo_dir
            .path()
            .join("awesome_agent_skills/technical-writer/SKILL.md"),
        "---\nname: technical-writer\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add container skill");

    let err = match super::install_git_skill_from_selection(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        "awesome_agent_skills",
        None,
    ) {
        Ok(_) => panic!("expected invalid skill path"),
        Err(e) => e,
    };
    assert!(format!("{:#}", err).contains("SKILL_INVALID|missing_skill_md"));
}

#[test]
fn install_git_skill_selection_accepts_specific_child_under_container() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(
        repo_dir
            .path()
            .join("awesome_agent_skills/technical-writer"),
    )
    .unwrap();
    fs::write(
        repo_dir
            .path()
            .join("awesome_agent_skills/technical-writer/SKILL.md"),
        "---\nname: technical-writer\ndescription: docs\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add container skill");

    let res = super::install_git_skill_from_selection(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        "awesome_agent_skills/technical-writer",
        None,
    )
    .unwrap();

    assert_eq!(res.name, "technical-writer");
    assert!(res.central_path.join("SKILL.md").exists());
}

/// Issue #28: when user explicitly provides a name, SKILL.md should NOT override it.
#[test]
fn install_git_skill_respects_user_provided_name() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    let skills_dir = repo_dir.path().join("skills");
    fs::create_dir_all(&skills_dir).unwrap();
    fs::write(skills_dir.join("SKILL.md"), "---\nname: md-name\n---\n").unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add skill");

    let res = super::install_git_skill_from_selection(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        "skills",
        Some("user-custom-name".to_string()),
    )
    .unwrap();

    // User-provided name takes priority.
    assert_eq!(res.name, "user-custom-name");
}

/// Issue #28: install_git_skill (non-selection variant) also uses SKILL.md name.
#[test]
fn install_git_skill_derives_name_from_skill_md() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::write(
        repo_dir.path().join("SKILL.md"),
        "---\nname: proper-name\ndescription: desc\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "init");

    // The repo name (derived from path) will be something like a temp dir name.
    // After install, the name should be "proper-name" from SKILL.md.
    let res = super::install_git_skill(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        None,
        None,
    )
    .unwrap();

    assert_eq!(res.name, "proper-name");
    assert!(res.central_path.ends_with("proper-name"));
}

/// Issue #18: repos with skills in root-level subdirectories (no `skills/` parent)
/// should be detected as multi-skill repos.
#[test]
fn install_git_skill_detects_root_level_multi_skills() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    // Build a repo with skills directly in root subdirectories (no skills/ parent)
    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(repo_dir.path().join("skill-a")).unwrap();
    fs::create_dir_all(repo_dir.path().join("skill-b")).unwrap();
    fs::write(
        repo_dir.path().join("skill-a/SKILL.md"),
        "---\nname: Skill A\n---\n",
    )
    .unwrap();
    fs::write(
        repo_dir.path().join("skill-b/SKILL.md"),
        "---\nname: Skill B\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add root-level skills");

    // install_git_skill should detect multiple skills and bail with MULTI_SKILLS
    let err = match super::install_git_skill(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
        None,
        None,
    ) {
        Ok(_) => panic!("expected MULTI_SKILLS error"),
        Err(e) => e,
    };
    assert!(format!("{:#}", err).contains("MULTI_SKILLS|"));
}

/// Issue #18: list_git_skills should discover skills in root-level subdirectories.
#[test]
fn list_git_skills_finds_root_level_skills() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(repo_dir.path().join("my-skill-1")).unwrap();
    fs::create_dir_all(repo_dir.path().join("my-skill-2")).unwrap();
    fs::create_dir_all(repo_dir.path().join("not-a-skill")).unwrap();
    fs::write(
        repo_dir.path().join("my-skill-1/SKILL.md"),
        "---\nname: First\n---\n",
    )
    .unwrap();
    fs::write(
        repo_dir.path().join("my-skill-2/SKILL.md"),
        "---\nname: Second\n---\n",
    )
    .unwrap();
    // not-a-skill has no SKILL.md — should NOT be discovered
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add root-level skills");

    let candidates = super::list_git_skills(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
    )
    .unwrap();

    let names: Vec<String> = candidates.iter().map(|c| c.name.clone()).collect();
    assert!(names.contains(&"First".to_string()), "should find First");
    assert!(names.contains(&"Second".to_string()), "should find Second");
    // "not-a-skill" should NOT appear
    assert!(
        !candidates.iter().any(|c| c.subpath.contains("not-a-skill")),
        "should not find not-a-skill"
    );
}

#[test]
fn list_git_skills_finds_root_skill_container_layout() {
    let app = tauri::test::mock_app();
    let (_dir, store) = make_store();
    let central_root = tempfile::tempdir().unwrap();
    set_central_path(&store, central_root.path());

    let repo_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(repo_dir.path().join("custom-agent-skills/technical-writer")).unwrap();
    fs::write(
        repo_dir
            .path()
            .join("custom-agent-skills/technical-writer/SKILL.md"),
        "---\nname: technical-writer\ndescription: docs\n---\n",
    )
    .unwrap();
    let repo = init_git_repo(repo_dir.path());
    commit_all(&repo, "add container skill");

    let candidates = super::list_git_skills(
        app.handle(),
        &store,
        repo_dir.path().to_string_lossy().as_ref(),
    )
    .unwrap();

    let candidate = candidates
        .iter()
        .find(|c| c.name == "technical-writer")
        .expect("technical-writer should be discovered");
    assert_eq!(candidate.subpath, "custom-agent-skills/technical-writer");
    assert_eq!(candidate.description.as_deref(), Some("docs"));
}

#[test]
fn collect_skill_dirs_finds_skills_under_explicit_container() {
    let dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(dir.path().join("technical-writer")).unwrap();
    fs::create_dir_all(dir.path().join("not-a-skill")).unwrap();
    fs::write(
        dir.path().join("technical-writer/SKILL.md"),
        "---\nname: technical-writer\n---\n",
    )
    .unwrap();

    let dirs = super::collect_skill_dirs(dir.path());
    let rels: Vec<String> = dirs
        .iter()
        .map(|p| {
            p.strip_prefix(dir.path())
                .unwrap_or(p)
                .to_string_lossy()
                .to_string()
        })
        .collect();
    assert_eq!(rels, vec!["technical-writer".to_string()]);
}

#[test]
fn collect_skill_dirs_finds_multiple_skills_under_explicit_container() {
    let dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(dir.path().join("technical-writer")).unwrap();
    fs::create_dir_all(dir.path().join("python-expert")).unwrap();
    fs::create_dir_all(dir.path().join("not-a-skill")).unwrap();
    fs::write(
        dir.path().join("technical-writer/SKILL.md"),
        "---\nname: technical-writer\n---\n",
    )
    .unwrap();
    fs::write(
        dir.path().join("python-expert/SKILL.md"),
        "---\nname: python-expert\n---\n",
    )
    .unwrap();

    let dirs = super::collect_skill_dirs(dir.path());
    let rels: Vec<String> = dirs
        .iter()
        .map(|p| {
            p.strip_prefix(dir.path())
                .unwrap_or(p)
                .to_string_lossy()
                .to_string()
        })
        .collect();
    assert_eq!(
        rels,
        vec!["python-expert".to_string(), "technical-writer".to_string()]
    );
}

#[test]
fn collect_skill_dirs_scans_named_skill_containers_but_not_generic_dirs() {
    let dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(dir.path().join("agent-pack/hidden-skill")).unwrap();
    fs::create_dir_all(dir.path().join("agent-skills/visible-skill")).unwrap();
    fs::write(
        dir.path().join("agent-pack/hidden-skill/SKILL.md"),
        "---\nname: hidden\n---\n",
    )
    .unwrap();
    fs::write(
        dir.path().join("agent-skills/visible-skill/SKILL.md"),
        "---\nname: visible\n---\n",
    )
    .unwrap();

    let dirs = super::collect_skill_dirs(dir.path());
    let rels: Vec<String> = dirs
        .iter()
        .map(|p| {
            p.strip_prefix(dir.path())
                .unwrap_or(p)
                .to_string_lossy()
                .to_string()
        })
        .collect();
    assert_eq!(rels, vec!["agent-skills/visible-skill".to_string()]);
}

#[test]
fn collect_skill_dirs_deduplicates_known_root_containers() {
    let dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(dir.path().join("skills/technical-writer")).unwrap();
    fs::write(
        dir.path().join("skills/technical-writer/SKILL.md"),
        "---\nname: technical-writer\n---\n",
    )
    .unwrap();

    let dirs = super::collect_skill_dirs(dir.path());
    assert_eq!(dirs.len(), 1);
    assert!(dirs[0].ends_with("skills/technical-writer"));
}


================================================
FILE: src-tauri/src/core/tests/onboarding.rs
================================================
use std::fs;

use super::build_onboarding_plan_in_home;

#[test]
fn groups_by_name_and_detects_conflicts_by_fingerprint() {
    let home = tempfile::tempdir().unwrap();

    // Cursor installed
    fs::create_dir_all(home.path().join(".cursor")).unwrap();
    fs::create_dir_all(home.path().join(".cursor/skills/foo")).unwrap();
    fs::write(home.path().join(".cursor/skills/foo/a.txt"), b"cursor").unwrap();

    // Codex installed
    fs::create_dir_all(home.path().join(".codex")).unwrap();
    fs::create_dir_all(home.path().join(".codex/skills/foo")).unwrap();
    fs::write(home.path().join(".codex/skills/foo/a.txt"), b"codex").unwrap();

    // Codex .system should be ignored
    fs::create_dir_all(home.path().join(".codex/skills/.system")).unwrap();
    fs::write(home.path().join(".codex/skills/.system/SKILL.md"), b"x").unwrap();

    let plan = build_onboarding_plan_in_home(home.path(), None, None).unwrap();
    assert_eq!(plan.total_tools_scanned, 2);
    assert_eq!(plan.total_skills_found, 2);
    assert_eq!(plan.groups.len(), 1);
    assert_eq!(plan.groups[0].name, "foo");
    assert!(plan.groups[0].has_conflict, "同名但内容不同应冲突");
    assert_eq!(plan.groups[0].variants.len(), 2);
}

#[test]
#[cfg(unix)]
fn excludes_central_repo_path() {
    use std::os::unix::fs::symlink;

    let home = tempfile::tempdir().unwrap();

    // Cursor installed
    std::fs::create_dir_all(home.path().join(".cursor")).unwrap();
    std::fs::create_dir_all(home.path().join(".cursor/skills")).unwrap();

    let central = home.path().join("central");
    std::fs::create_dir_all(central.join("skill-a")).unwrap();

    let link_path = home.path().join(".cursor/skills/skill-a");
    symlink(central.join("skill-a"), &link_path).unwrap();

    let plan = build_onboarding_plan_in_home(home.path(), Some(&central), None).unwrap();
    assert_eq!(plan.total_skills_found, 0);
}

#[test]
fn excludes_managed_skill_targets() {
    let home = tempfile::tempdir().unwrap();

    // Cursor installed
    fs::create_dir_all(home.path().join(".cursor")).unwrap();
    fs::create_dir_all(home.path().join(".cursor/skills/foo")).unwrap();
    fs::write(home.path().join(".cursor/skills/foo/a.txt"), b"cursor").unwrap();

    let mut exclude = std::collections::HashSet::new();
    exclude.insert(super::managed_target_key(
        "cursor",
        &home.path().join(".cursor/skills/foo"),
    ));

    let plan = build_onboarding_plan_in_home(home.path(), None, Some(&exclude)).unwrap();
    assert_eq!(plan.total_skills_found, 0);
}


================================================
FILE: src-tauri/src/core/tests/skill_store.rs
================================================
use std::path::PathBuf;

use crate::core::skill_store::{SkillRecord, SkillStore, SkillTargetRecord};
use rusqlite::Connection;

fn make_store() -> (tempfile::TempDir, SkillStore) {
    let dir = tempfile::tempdir().expect("tempdir");
    let db = dir.path().join("test.db");
    let store = SkillStore::new(db);
    store.ensure_schema().expect("ensure_schema");
    (dir, store)
}

fn make_skill(id: &str, name: &str, central_path: &str, updated_at: i64) -> SkillRecord {
    SkillRecord {
        id: id.to_string(),
        name: name.to_string(),
        description: None,
        source_type: "local".to_string(),
        source_ref: Some("/tmp/source".to_string()),
        source_subpath: None,
        source_revision: None,
        central_path: central_path.to_string(),
        content_hash: None,
        created_at: 1,
        updated_at,
        last_sync_at: None,
        last_seen_at: 1,
        status: "ok".to_string(),
    }
}

#[test]
fn schema_is_idempotent() {
    let (_dir, store) = make_store();
    store.ensure_schema().expect("ensure_schema again");
}

#[test]
fn migrates_v3_targets_to_global_scope() {
    let dir = tempfile::tempdir().expect("tempdir");
    let db = dir.path().join("test.db");
    let conn = Connection::open(&db).unwrap();
    conn.execute_batch(
        "CREATE TABLE skills (
          id TEXT PRIMARY KEY,
          name TEXT NOT NULL,
          description TEXT NULL,
          source_type TEXT NOT NULL,
          source_ref TEXT NULL,
          source_subpath TEXT NULL,
          source_revision TEXT NULL,
          central_path TEXT NOT NULL UNIQUE,
          content_hash TEXT NULL,
          created_at INTEGER NOT NULL,
          updated_at INTEGER NOT NULL,
          last_sync_at INTEGER NULL,
          last_seen_at INTEGER NOT NULL,
          status TEXT NOT NULL
        );
        CREATE TABLE skill_targets (
          id TEXT PRIMARY KEY,
          skill_id TEXT NOT NULL,
          tool TEXT NOT NULL,
          target_path TEXT NOT NULL,
          mode TEXT NOT NULL,
          status TEXT NOT NULL,
          last_error TEXT NULL,
          synced_at INTEGER NULL,
          UNIQUE(skill_id, tool),
          FOREIGN KEY(skill_id) REFERENCES skills(id) ON DELETE CASCADE
        );
        CREATE TABLE settings (key TEXT PRIMARY KEY, value TEXT NOT NULL);
        CREATE TABLE discovered_skills (
          id TEXT PRIMARY KEY,
          tool TEXT NOT NULL,
          found_path TEXT NOT NULL,
          name_guess TEXT NULL,
          fingerprint TEXT NULL,
          found_at INTEGER NOT NULL,
          imported_skill_id TEXT NULL,
          FOREIGN KEY(imported_skill_id) REFERENCES skills(id) ON DELETE SET NULL
        );
        INSERT INTO skills (
          id, name, description, source_type, source_ref, source_subpath, source_revision,
          central_path, content_hash, created_at, updated_at, last_sync_at, last_seen_at, status
        ) VALUES (
          's1', 'S1', NULL, 'local', NULL, NULL, NULL,
          '/central/s1', NULL, 1, 2, NULL, 1, 'ok'
        );
        INSERT INTO skill_targets (
          id, skill_id, tool, target_path, mode, status, last_error, synced_at
        ) VALUES (
          't1', 's1', 'cursor', '/target/s1', 'copy', 'ok', NULL, 3
        );
        PRAGMA user_version = 3;",
    )
    .unwrap();
    drop(conn);

    let store = SkillStore::new(db);
    store.ensure_schema().unwrap();

    let target = store
        .get_skill_target("s1", "cursor", "global", None)
        .unwrap()
        .unwrap();
    assert_eq!(target.target_path, "/target/s1");
    assert_eq!(target.scope, "global");
    assert!(target.project_path.is_none());
}

#[test]
fn settings_roundtrip_and_update() {
    let (_dir, store) = make_store();

    assert_eq!(store.get_setting("missing").unwrap(), None);
    store.set_setting("k", "v1").unwrap();
    assert_eq!(store.get_setting("k").unwrap().as_deref(), Some("v1"));
    store.set_setting("k", "v2").unwrap();
    assert_eq!(store.get_setting("k").unwrap().as_deref(), Some("v2"));

    store.set_onboarding_completed(true).unwrap();
    assert_eq!(
        store
            .get_setting("onboarding_completed")
            .unwrap()
            .as_deref(),
        Some("true")
    );
    store.set_onboarding_completed(false).unwrap();
    assert_eq!(
        store
            .get_setting("onboarding_completed")
            .unwrap()
            .as_deref(),
        Some("false")
    );
}

#[test]
fn skills_upsert_list_get_delete() {
    let (_dir, store) = make_store();

    let a = make_skill("a", "A", "/central/a", 10);
    let b = make_skill("b", "B", "/central/b", 20);
    store.upsert_skill(&a).unwrap();
    store.upsert_skill(&b).unwrap();

    let listed = store.list_skills().unwrap();
    assert_eq!(listed.len(), 2);
    assert_eq!(listed[0].id, "b");
    assert_eq!(listed[1].id, "a");

    let got = store.get_skill_by_id("a").unwrap().unwrap();
    assert_eq!(got.name, "A");

    let mut a2 = a.clone();
    a2.name = "A2".to_string();
    a2.updated_at = 30;
    store.upsert_skill(&a2).unwrap();
    assert_eq!(store.get_skill_by_id("a").unwrap().unwrap().name, "A2");
    assert_eq!(store.list_skills().unwrap()[0].id, "a");

    store.delete_skill("a").unwrap();
    assert!(store.get_skill_by_id("a").unwrap().is_none());
}

#[test]
fn skill_targets_upsert_unique_constraint_and_list_order() {
    let (_dir, store) = make_store();
    let skill = make_skill("s1", "S1", "/central/s1", 1);
    store.upsert_skill(&skill).unwrap();

    let t1 = SkillTargetRecord {
        id: "t1".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: "/target/1".to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: None,
    };
    store.upsert_skill_target(&t1).unwrap();
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "global", None)
            .unwrap()
            .unwrap()
            .target_path,
        "/target/1"
    );

    let mut t1b = t1.clone();
    t1b.id = "t2".to_string();
    t1b.target_path = "/target/2".to_string();
    store.upsert_skill_target(&t1b).unwrap();
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "global", None)
            .unwrap()
            .unwrap()
            .id,
        "t1",
        "unique(skill_id, tool) 冲突时应更新现有行而不是替换 id"
    );
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "global", None)
            .unwrap()
            .unwrap()
            .target_path,
        "/target/2"
    );

    let t2 = SkillTargetRecord {
        id: "t3".to_string(),
        skill_id: "s1".to_string(),
        tool: "claude_code".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: "/target/cc".to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: None,
    };
    store.upsert_skill_target(&t2).unwrap();

    let targets = store.list_skill_targets("s1").unwrap();
    assert_eq!(targets.len(), 2);
    assert_eq!(targets[0].tool, "claude_code");
    assert_eq!(targets[1].tool, "cursor");

    store
        .delete_skill_target("s1", "cursor", "global", None)
        .unwrap();
    assert!(store
        .get_skill_target("s1", "cursor", "global", None)
        .unwrap()
        .is_none());
}

#[test]
fn project_targets_coexist_by_project_path_and_delete_precisely() {
    let (_dir, store) = make_store();
    let skill = make_skill("s1", "S1", "/central/s1", 1);
    store.upsert_skill(&skill).unwrap();

    let global = SkillTargetRecord {
        id: "global".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: "/global/cursor/s1".to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: Some(1),
    };
    let project_a = SkillTargetRecord {
        id: "project-a".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "project".to_string(),
        project_path: Some("/projects/a".to_string()),
        target_path: "/projects/a/.agents/skills/s1".to_string(),
        mode: "symlink".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: Some(2),
    };
    let project_b = SkillTargetRecord {
        id: "project-b".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "project".to_string(),
        project_path: Some("/projects/b".to_string()),
        target_path: "/projects/b/.agents/skills/s1".to_string(),
        mode: "symlink".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: Some(3),
    };

    store.upsert_skill_target(&global).unwrap();
    store.upsert_skill_target(&project_a).unwrap();
    store.upsert_skill_target(&project_b).unwrap();

    assert_eq!(store.list_skill_targets("s1").unwrap().len(), 3);
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "global", None)
            .unwrap()
            .unwrap()
            .target_path,
        "/global/cursor/s1"
    );
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "project", Some("/projects/a"))
            .unwrap()
            .unwrap()
            .target_path,
        "/projects/a/.agents/skills/s1"
    );
    assert_eq!(
        store
            .get_skill_target("s1", "cursor", "project", Some("/projects/b"))
            .unwrap()
            .unwrap()
            .target_path,
        "/projects/b/.agents/skills/s1"
    );

    let mut updated_project_a = project_a.clone();
    updated_project_a.id = "project-a-new-id".to_string();
    updated_project_a.target_path = "/projects/a/.agents/skills/s1-updated".to_string();
    store.upsert_skill_target(&updated_project_a).unwrap();

    let got_project_a = store
        .get_skill_target("s1", "cursor", "project", Some("/projects/a"))
        .unwrap()
        .unwrap();
    assert_eq!(got_project_a.id, "project-a");
    assert_eq!(
        got_project_a.target_path,
        "/projects/a/.agents/skills/s1-updated"
    );
    assert_eq!(store.list_skill_targets("s1").unwrap().len(), 3);

    store
        .delete_skill_target("s1", "cursor", "project", Some("/projects/a"))
        .unwrap();

    assert!(store
        .get_skill_target("s1", "cursor", "project", Some("/projects/a"))
        .unwrap()
        .is_none());
    assert!(store
        .get_skill_target("s1", "cursor", "project", Some("/projects/b"))
        .unwrap()
        .is_some());
    assert!(store
        .get_skill_target("s1", "cursor", "global", None)
        .unwrap()
        .is_some());
}

#[test]
fn deleting_skill_cascades_targets() {
    let (_dir, store) = make_store();
    let skill = make_skill("s1", "S1", "/central/s1", 1);
    store.upsert_skill(&skill).unwrap();

    let t = SkillTargetRecord {
        id: "t1".to_string(),
        skill_id: "s1".to_string(),
        tool: "cursor".to_string(),
        scope: "global".to_string(),
        project_path: None,
        target_path: "/target/1".to_string(),
        mode: "copy".to_string(),
        status: "ok".to_string(),
        last_error: None,
        synced_at: None,
    };
    store.upsert_skill_target(&t).unwrap();
    assert_eq!(store.list_skill_targets("s1").unwrap().len(), 1);

    store.delete_skill("s1").unwrap();
    assert_eq!(store.list_skill_targets("s1").unwrap().len(), 0);
}

#[test]
fn tags_can_be_created_renamed_linked_and_deleted() {
    let (_dir, store) = make_store();
    let skill = make_skill("s1", "S1", "/central/s1", 1);
    store.upsert_skill(&skill).unwrap();

    let frontend = store.create_tag(" Frontend ").unwrap();
    assert_eq!(frontend.name, "Frontend");
    assert!(store.create_tag("frontend").is_err());

    let docs = store.create_tag("Docs").unwrap();
    store.set_skill_tags("s1", &[frontend.id, docs.id]).unwrap();
    store
        .set_skill_tags("s1", &[frontend.id, frontend.id, docs.id])
        .unwrap();

    let linked = store.get_skill_tags("s1").unwrap();
    assert_eq!(linked.len(), 2);
    assert_eq!(linked[0].name, "Docs");
    assert_eq!(linked[1].name, "Frontend");

    let renamed = store.rename_tag(frontend.id, "UI").unwrap();
    assert_eq!(renamed.name, "UI");
    assert!(store.rename_tag(renamed.id, "docs").is_err());

    let tags = store.list_tags_with_counts().unwrap();
    assert_eq!(tags.len(), 2);
    assert_eq!(tags[0].name, "Docs");
    assert_eq!(tags[0].skill_count, 1);
    assert_eq!(tags[1].name, "UI");
    assert_eq!(tags[1].skill_count, 1);

    store.delete_tag(docs.id).unwrap();
    let linked = store.get_skill_tags("s1").unwrap();
    assert_eq!(linked.len(), 1);
    assert_eq!(linked[0].name, "UI");
}

#[test]
fn tag_links_are_removed_when_skill_is_deleted_and_untagged_is_counted() {
    let (_dir, store) = make_store();
    let tagged = make_skill("tagged", "Tagged", "/central/tagged", 2);
    let untagged = make_skill("untagged", "Untagged", "/central/untagged", 1);
    store.upsert_skill(&tagged).unwrap();
    store.upsert_skill(&untagged).unwrap();

    let tag = store.create_tag("Frontend").unwrap();
    store.set_skill_tags("tagged", &[tag.id]).unwrap();

    assert_eq!(store.list_untagged_skill_ids().unwrap(), vec!["untagged"]);

    store.delete_skill("tagged").unwrap();
    assert!(store.get_skill_tags("tagged").unwrap().is_empty());
    assert_eq!(store.list_tags_with_counts().unwrap()[0].skill_count, 0);
}

#[test]
fn description_stored_and_retrieved() {
    let (_dir, store) = make_store();
    let mut skill = make_skill("d1", "D1", "/central/d1", 1);
    skill.description = Some("A test skill description".to_string());
    store.upsert_skill(&skill).unwrap();

    let got = store.get_skill_by_id("d1").unwrap().unwrap();
    assert_eq!(got.description.as_deref(), Some("A test skill description"));
}

#[test]
fn description_null_by_default() {
    let (_dir, store) = make_store();
    let skill = make_skill("d2", "D2", "/central/d2", 1);
    store.upsert_skill(&skill).unwrap();

    let got = store.get_skill_by_id("d2").unwrap().unwrap();
    assert!(got.description.is_none());
}

#[test]
fn update_skill_description_backfills() {
    let (_dir, store) = make_store();
    let skill = make_skill("d3", "D3", "/central/d3", 1);
    store.upsert_skill(&skill).unwrap();

    assert!(store
        .get_skill_by_id("d3")
        .unwrap()
        .unwrap()
        .description
        .is_none());

    store
        .update_skill_description("d3", Some("backfilled"))
        .unwrap();
    assert_eq!(
        store
            .get_skill_by_id("d3")
            .unwrap()
            .unwrap()
            .description
            .as_deref(),
        Some("backfilled")
    );
}

#[test]
fn error_context_includes_db_path() {
    let store = SkillStore::new(PathBuf::from("/this/path/should/not/exist/test.db"));
    let err = store.ensure_schema().unwrap_err();
    let msg = format!("{:#}", err);
    assert!(msg.contains("failed to open db at"), "{msg}");
}


================================================
FILE: src-tauri/src/core/tests/skills_search.rs
================================================
use mockito::Matcher;

use super::search_skills_online_inner;

fn json_response() -> String {
    r#"{
  "skills": [
    {
      "name": "react-expert",
      "installs": 203000,
      "source": "vercel-labs/agent-skills"
    },
    {
      "name": "vue-master",
      "installs": 57000,
      "source": "vuejs/vue-skills"
    }
  ],
  "count": 2
}"#
    .to_string()
}

fn json_empty() -> String {
    r#"{"skills": [], "count": 0}"#.to_string()
}

#[test]
fn parses_search_results() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/api/search")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "react".into()),
            Matcher::UrlEncoded("limit".into(), "20".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_response())
        .create();

    let out = search_skills_online_inner(&server.url(), "react", 20).unwrap();
    assert_eq!(out.len(), 2);
    assert_eq!(out[0].name, "react-expert");
    assert_eq!(out[0].installs, 203000);
    assert_eq!(out[0].source, "vercel-labs/agent-skills");
    assert_eq!(
        out[0].source_url,
        "https://github.com/vercel-labs/agent-skills"
    );
}

#[test]
fn source_url_is_constructed_from_source() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/api/search")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "vue".into()),
            Matcher::UrlEncoded("limit".into(), "5".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_response())
        .create();

    let out = search_skills_online_inner(&server.url(), "vue", 5).unwrap();
    assert_eq!(out[1].source_url, "https://github.com/vuejs/vue-skills");
}

#[test]
fn http_error_returns_error() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/api/search")
        .with_status(500)
        .with_body("internal error")
        .create();

    let err = search_skills_online_inner(&server.url(), "test", 10).unwrap_err();
    let msg = format!("{:#}", err);
    assert!(msg.contains("skills.sh search returned error"), "{}", msg);
}

#[test]
fn empty_results() {
    let mut server = mockito::Server::new();
    let _m = server
        .mock("GET", "/api/search")
        .match_query(Matcher::AllOf(vec![
            Matcher::UrlEncoded("q".into(), "nonexistent".into()),
            Matcher::UrlEncoded("limit".into(), "10".into()),
        ]))
        .with_status(200)
        .with_header("content-type", "application/json")
        .with_body(json_empty())
        .create();

    let out = search_skills_online_inner(&server.url(), "nonexistent", 10).unwrap();
    assert!(out.is_empty());
}


================================================
FILE: src-tauri/src/core/tests/sync_engine.rs
================================================
use std::fs;

use crate::core::sync_engine::{
    copy_dir_recursive, sync_dir_for_tool_with_overwrite, sync_dir_hybrid,
    sync_dir_hybrid_with_overwrite, SyncMode,
};

#[test]
fn copy_dir_recursive_skips_git_dir() {
    let src_dir = tempfile::tempdir().unwrap();
    let dst_dir = tempfile::tempdir().unwrap();

    fs::create_dir_all(src_dir.path().join(".git")).unwrap();
    fs::create_dir_all(src_dir.path().join("sub")).unwrap();
    fs::write(src_dir.path().join("sub/a.txt"), b"ok").unwrap();
    fs::write(src_dir.path().join(".git/secret"), b"no").unwrap();

    copy_dir_recursive(src_dir.path(), dst_dir.path()).unwrap();
    assert!(dst_dir.path().join("sub/a.txt").exists());
    assert!(!dst_dir.path().join(".git").exists());
}

#[test]
fn hybrid_sync_creates_link_and_is_idempotent_when_same_link() {
    let src_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(src_dir.path().join("s")).unwrap();
    fs::write(src_dir.path().join("s/a.txt"), b"ok").unwrap();

    let dst_dir = tempfile::tempdir().unwrap();
    let target = dst_dir.path().join("t");

    let out = sync_dir_hybrid(src_dir.path(), &target).unwrap();
    assert!(matches!(
        out.mode_used,
        SyncMode::Symlink | SyncMode::Junction | SyncMode::Copy
    ));

    if let Ok(link) = fs::read_link(&target) {
        assert_eq!(link, src_dir.path());
        let out2 = sync_dir_hybrid(src_dir.path(), &target).unwrap();
        assert!(matches!(out2.mode_used, SyncMode::Symlink));
    }
}

#[test]
fn hybrid_sync_with_overwrite_replaces_existing() {
    let src_dir = tempfile::tempdir().unwrap();
    fs::write(src_dir.path().join("a.txt"), b"src").unwrap();

    let dst_dir = tempfile::tempdir().unwrap();
    let target = dst_dir.path().join("t");
    fs::create_dir_all(&target).unwrap();
    fs::write(target.join("old.txt"), b"old").unwrap();

    let err = sync_dir_hybrid_with_overwrite(src_dir.path(), &target, false).unwrap_err();
    assert!(format!("{:#}", err).contains("target already exists"));

    let out = sync_dir_hybrid_with_overwrite(src_dir.path(), &target, true).unwrap();
    assert!(out.replaced);
}

#[test]
fn cursor_sync_forces_copy() {
    let src_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(src_dir.path().join("s")).unwrap();
    fs::write(src_dir.path().join("s/a.txt"), b"ok").unwrap();

    let dst_dir = tempfile::tempdir().unwrap();
    let target = dst_dir.path().join("t");

    let out = sync_dir_for_tool_with_overwrite("cursor", src_dir.path(), &target, false).unwrap();
    assert!(matches!(out.mode_used, SyncMode::Copy));
    assert!(target.join("s/a.txt").exists());
    assert_eq!(fs::read(target.join("s/a.txt")).unwrap(), b"ok");
}

#[cfg(unix)]
#[test]
fn copy_overwrite_replaces_broken_symlink_target() {
    use std::os::unix::fs::symlink;

    let src_dir = tempfile::tempdir().unwrap();
    fs::create_dir_all(src_dir.path().join("s")).unwrap();
    fs::write(src_dir.path().join("s/a.txt"), b"ok").unwrap();

    let dst_dir = tempfile::tempdir().unwrap();
    let target = dst_dir.path().join("t");

    // Create a broken symlink at the target path.
    symlink(dst_dir.path().join("missing"), &target).unwrap();

    let out = crate::core::sync_engine::sync_dir_copy_with_overwrite(src_dir.path(), &target, true)
        .unwrap();

    assert!(matches!(out.mode_used, SyncMode::Copy));
    assert!(target.join("s/a.txt").exists());
    assert_eq!(fs::read(target.join("s/a.txt")).unwrap(), b"ok");
}


================================================
FILE: src-tauri/src/core/tests/temp_cleanup.rs
================================================
use std::fs;
use std::time::Duration;

use super::{cleanup_old_git_temp_dirs_in, mark_temp_dir};

#[test]
fn cleanup_removes_only_marked_prefixed_dirs() {
    let dir = tempfile::tempdir().unwrap();
    let cache = dir.path();

    let d1 = cache.join("skills-hub-git-1");
    let d2 = cache.join("skills-hub-git-2");
    let d3 = cache.join("other-3");

    fs::create_dir_all(&d1).unwrap();
    fs::create_dir_all(&d2).unwrap();
    fs::create_dir_all(&d3).unwrap();

    mark_temp_dir(&d1).unwrap();
    mark_temp_dir(&d3).unwrap();

    let removed = cleanup_old_git_temp_dirs_in(cache, Duration::from_secs(0)).unwrap();
    assert_eq!(removed, 1);
    assert!(!d1.exists());
    assert!(d2.exists(), "未标记的不应删除");
    assert!(d3.exists(), "前缀不匹配的不应删除");
}


================================================
FILE: src-tauri/src/core/tests/tool_adapters.rs
================================================
use std::fs;

use crate::core::tool_adapters::{
    adapter_by_key, adapters_sharing_project_skills_dir, adapters_sharing_skills_dir,
    project_relative_skills_dir, resolve_project_path, scan_tool_dir, supports_project_scope,
    ToolAdapter, ToolId,
};

#[test]
fn adapter_by_key_finds_known_tool() {
    let a = adapter_by_key("codex").unwrap();
    assert_eq!(a.id, ToolId::Codex);
}

#[test]
fn adapter_by_key_finds_new_tools() {
    assert!(adapter_by_key("kimi_cli").is_some());
    assert!(adapter_by_key("augment").is_some());
    assert!(adapter_by_key("openclaw").is_some());
    assert!(adapter_by_key("command_code").is_some());
    assert!(adapter_by_key("qwen_code").is_some());
    assert!(adapter_by_key("hermes_agent").is_some());
}

#[test]
fn adapters_sharing_skills_dir_groups_amp_and_kimi() {
    let amp = adapter_by_key("amp").unwrap();
    let group = adapters_sharing_skills_dir(&amp);
    let keys: std::collections::HashSet<&'static str> =
        group.into_iter().map(|a| a.id.as_key()).collect();
    assert!(keys.contains("amp"));
    assert!(keys.contains("kimi_cli"));
}

#[test]
fn project_relative_skills_dir_maps_supported_agents() {
    let shared_agents = [
        ("cursor", ".agents/skills"),
        ("codex", ".agents/skills"),
        ("opencode", ".agents/skills"),
        ("gemini_cli", ".agents/skills"),
        ("github_copilot", ".agents/skills"),
        ("amp", ".agents/skills"),
        ("kimi_cli", ".agents/skills"),
        ("antigravity", ".agents/skills"),
        ("cline", ".agents/skills"),
    ];

    for (key, expected) in shared_agents {
        let adapter = adapter_by_key(key).unwrap();
        assert_eq!(project_relative_skills_dir(&adapter), expected, "{key}");
        assert!(supports_project_scope(&adapter), "{key}");
    }

    let claude = adapter_by_key("claude_code").unwrap();
    assert_eq!(project_relative_skills_dir(&claude), ".claude/skills");

    let openclaw = adapter_by_key("openclaw").unwrap();
    assert_eq!(project_relative_skills_dir(&openclaw), "skills");

    let windsurf = adapter_by_key("windsurf").unwrap();
    assert_eq!(project_relative_skills_dir(&windsurf), ".windsurf/skills");

    let qwen = adapter_by_key("qwen_code").unwrap();
    assert_eq!(project_relative_skills_dir(&qwen), ".qwen/skills");

    let hermes = adapter_by_key("hermes_agent").unwrap();
    assert_eq!(project_relative_skills_dir(&hermes), ".hermes/skills");
    assert!(!supports_project_scope(&hermes));
}

#[test]
fn project_path_resolution_uses_project_specific_mapping() {
    let dir = tempfile::tempdir().unwrap();
    let amp = adapter_by_key("amp").unwrap();
    let opencode = adapter_by_key("opencode").unwrap();
    let openclaw = adapter_by_key("openclaw").unwrap();

    assert_eq!(
        resolve_project_path(&amp, dir.path()).unwrap(),
        dir.path().join(".agents/skills")
    );
    assert_eq!(
        resolve_project_path(&opencode, dir.path()).unwrap(),
        dir.path().join(".agents/skills")
    );
    assert_eq!(
        resolve_project_path(&openclaw, dir.path()).unwrap(),
        dir.path().join("skills")
    );
}

#[test]
fn adapters_sharing_project_skills_dir_groups_agents_tools() {
    let cursor = adapter_by_key("cursor").unwrap();
    let group = adapters_sharing_project_skills_dir(&cursor);
    let keys: std::collections::HashSet<&'static str> =
        group.into_iter().map(|a| a.id.as_key()).collect();

    assert!(keys.contains("cursor"));
    assert!(keys.contains("codex"));
    assert!(keys.contains("opencode"));
    assert!(keys.contains("gemini_cli"));
    assert!(keys.contains("github_copilot"));
    assert!(keys.contains("amp"));
    assert!(keys.contains("kimi_cli"));
    assert!(keys.contains("antigravity"));
    assert!(keys.contains("cline"));
    assert!(!keys.contains("claude_code"));
    assert!(!keys.contains("windsurf"));
}

#[test]
fn scan_tool_dir_skips_codex_system_and_includes_symlink_dir() {
    let dir = tempfile::tempdir().unwrap();

    fs::create_dir_all(dir.path().join("a")).unwrap();
    fs::create_dir_all(dir.path().join(".system")).unwrap();
    fs::write(dir.path().join("not-a-dir"), b"x").unwrap();

    #[cfg(unix)]
    {
        std::os::unix::fs::symlink(dir.path().join("a"), dir.path().join("link-a")).unwrap();
    }

    let tool = ToolAdapter {
        id: ToolId::Codex,
        display_name: "Codex",
        relative_skills_dir: "ignored",
        relative_detect_dir: "ignored",
    };

    let out = scan_tool_dir(&tool, dir.path()).unwrap();
    let names: Vec<String> = out.iter().map(|s| s.name.clone()).collect();

    assert!(names.contains(&"a".to_string()));
    assert!(!names.contains(&".system".to_string()));

    #[cfg(unix)]
    {
        let link = out.iter().find(|s| s.name == "link-a").unwrap();
        assert!(link.is_link);
        assert!(link.link_target.is_some());
    }
}

#[test]
fn scan_tool_dir_skips_app_support_path() {
    let dir = tempfile::tempdir().unwrap();
    let root = dir
        .path()
        .join("Library/Application Support/com.tauri.dev/skills");
    std::fs::create_dir_all(root.join("foo")).unwrap();

    let tool = ToolAdapter {
        id: ToolId::Cursor,
        display_name: "Cursor",
        relative_skills_dir: "ignored",
        relative_detect_dir: "ignored",
    };

    let out = scan_tool_dir(&tool, &root).unwrap();
    assert!(out.is_empty());
}


================================================
FILE: src-tauri/src/core/tool_adapters/mod.rs
================================================
use std::path::{Path, PathBuf};

use anyhow::{Context, Result};

#[derive(Clone, Debug, PartialEq, Eq)]
pub enum ToolId {
    Cursor,
    ClaudeCode,
    Codex,
    OpenCode,
    Antigravity,
    Amp,
    KimiCli,
    Augment,
    OpenClaw,
    Copaw,
    Cline,
    CodeBuddy,
    CommandCode,
    Continue,
    Crush,
    Junie,
    IflowCli,
    KiroCli,
    Kode,
    McpJam,
    MistralVibe,
    Mux,
    OpenClaude,
    OpenHands,
    Pi,
    Qoder,
    QoderWork,
    QwenCode,
    Trae,
    TraeCn,
    Zencoder,
    Neovate,
    Pochi,
    AdaL,
    KiloCode,
    RooCode,
    Goose,
    GeminiCli,
    GithubCopilot,
    Clawdbot,
    Droid,
    Windsurf,
    Moltbot,
    HermesAgent,
}

impl ToolId {
    pub fn as_key(&self) -> &'static str {
        match self {
            ToolId::Cursor => "cursor",
            ToolId::ClaudeCode => "claude_code",
            ToolId::Codex => "codex",
            ToolId::OpenCode => "opencode",
            ToolId::Antigravity => "antigravity",
            ToolId::Amp => "amp",
            ToolId::KimiCli => "kimi_cli",
            ToolId::Augment => "augment",
            ToolId::OpenClaw => "openclaw",
            ToolId::Copaw => "copaw",
            ToolId::Cline => "cline",
            ToolId::CodeBuddy => "codebuddy",
            ToolId::CommandCode => "command_code",
            ToolId::Continue => "continue",
            ToolId::Crush => "crush",
            ToolId::Junie => "junie",
            ToolId::IflowCli => "iflow_cli",
            ToolId::KiroCli => "kiro_cli",
            ToolId::Kode => "kode",
            ToolId::McpJam => "mcpjam",
            ToolId::MistralVibe => "mistral_vibe",
            ToolId::Mux => "mux",
            ToolId::OpenClaude => "openclaude",
            ToolId::OpenHands => "openhands",
            ToolId::Pi => "pi",
            ToolId::Qoder => "qoder",
            ToolId::QoderWork => "qoderwork",
            ToolId::QwenCode => "qwen_code",
            ToolId::Trae => "trae",
            ToolId::TraeCn => "trae_cn",
            ToolId::Zencoder => "zencoder",
            ToolId::Neovate => "neovate",
            ToolId::Pochi => "pochi",
            ToolId::AdaL => "adal",
            ToolId::KiloCode => "kilo_code",
            ToolId::RooCode => "roo_code",
            ToolId::Goose => "goose",
            ToolId::GeminiCli => "gemini_cli",
            ToolId::GithubCopilot => "github_copilot",
            ToolId::Clawdbot => "clawdbot",
            ToolId::Droid => "droid",
            ToolId::Windsurf => "windsurf",
            ToolId::Moltbot => "moltbot",
            ToolId::HermesAgent => "hermes_agent",
        }
    }
}

#[derive(Clone, Debug)]
pub struct ToolAdapter {
    pub id: ToolId,
    pub display_name: &'static str,
    /// Global skill directory under user home (aligned with add-skill docs).
    pub relative_skills_dir: &'static str,
    /// Directory used to detect whether the tool is installed (aligned with add-skill docs).
    pub relative_detect_dir: &'static str,
}

#[derive(Clone, Debug)]
pub struct DetectedSkill {
    pub tool: ToolId,
    pub name: String,
    pub path: PathBuf,
    pub is_link: bool,
    pub link_target: Option<PathBuf>,
}

pub fn default_tool_adapters() -> Vec<ToolAdapter> {
    vec![
        ToolAdapter {
            id: ToolId::Cursor,
            display_name: "Cursor",
            relative_skills_dir: ".cursor/skills",
            relative_detect_dir: ".cursor",
        },
        ToolAdapter {
            id: ToolId::ClaudeCode,
            display_name: "Claude Code",
            relative_skills_dir: ".claude/skills",
            relative_detect_dir: ".claude",
        },
        ToolAdapter {
            id: ToolId::Codex,
            display_name: "Codex",
            relative_skills_dir: ".codex/skills",
            relative_detect_dir: ".codex",
        },
        ToolAdapter {
            id: ToolId::OpenCode,
            display_name: "OpenCode",
            // add-skill global path: ~/.config/opencode/skills/
            relative_skills_dir: ".config/opencode/skills",
            relative_detect_dir: ".config/opencode",
        },
        ToolAdapter {
            id: ToolId::Antigravity,
            display_name: "Antigravity",
            // add-skill global path: ~/.gemini/antigravity/skills/
            relative_skills_dir: ".gemini/antigravity/skills",
            relative_detect_dir: ".gemini/antigravity",
        },
        ToolAdapter {
            id: ToolId::Amp,
            display_name: "Amp",
            // add-skill global path: ~/.config/agents/skills/
            relative_skills_dir: ".config/agents/skills",
            relative_detect_dir: ".config/agents",
        },
        ToolAdapter {
            id: ToolId::KimiCli,
            display_name: "Kimi Code CLI",
            // add-skill global path: ~/.config/agents/skills/
            // NOTE: Shares the same skills directory with Amp.
            relative_skills_dir: ".config/agents/skills",
            relative_detect_dir: ".config/agents",
        },
        ToolAdapter {
            id: ToolId::Augment,
            display_name: "Augment",
            // add-skill global path: ~/.augment/skills/
            relative_skills_dir: ".augment/skills",
            relative_detect_dir: ".augment",
        },
        ToolAdapter {
            id: ToolId::OpenClaw,
            display_name: "OpenClaw",
            // add-skill global path: ~/.openclaw/skills/
            relative_skills_dir: ".openclaw/skills",
            relative_detect_dir: ".openclaw",
        },
        ToolAdapter {
            id: ToolId::Copaw,
            display_name: "Copaw",
            // add-skill global path: ~/.copaw/skill_pool/
            relative_skills_dir: ".copaw/skill_pool",
            relative_detect_dir: ".copaw",
        },
        ToolAdapter {
            id: ToolId::Cline,
            display_name: "Cline",
            // add-skill global path: ~/.agents/skills/
            relative_skills_dir: ".agents/skills",
            relative_detect_dir: ".agents",
        },
        ToolAdapter {
            id: ToolId::CodeBuddy,
            display_name: "CodeBuddy",
            // add-skill global path: ~/.codebuddy/skills/
            relative_skills_dir: ".codebuddy/skills",
            relative_detect_dir: ".codebuddy",
        },
        ToolAdapter {
            id: ToolId::CommandCode,
            display_name: "Command Code",
            // add-skill global path: ~/.commandcode/skills/
            relative_skills_dir: ".commandcode/skills",
            relative_detect_dir: ".commandcode",
        },
        ToolAdapter {
            id: ToolId::Continue,
            display_name: "Continue",
            // add-skill global path: ~/.continue/skills/
            relative_skills_dir: ".continue/skills",
            relative_detect_dir: ".continue",
        },
        ToolAdapter {
            id: ToolId::Crush,
            display_name: "Crush",
            // add-skill global path: ~/.config/crush/skills/
            relative_skills_dir: ".config/crush/skills",
            relative_detect_dir: ".config/crush",
        },
        ToolAdapter {
            id: ToolId::Junie,
            display_name: "Junie",
            // add-skill global path: ~/.junie/skills/
            relative_skills_dir: ".junie/skills",
            relative_detect_dir: ".junie",
        },
        ToolAdapter {
            id: ToolId::IflowCli,
            display_name: "iFlow CLI",
            // add-skill global path: ~/.iflow/skills/
            relative_skills_dir: ".iflow/skills",
            relative_detect_dir: ".iflow",
        },
        ToolAdapter {
            id: ToolId::KiroCli,
            display_name: "Kiro CLI",
            // add-skill global path: ~/.kiro/skills/
            relative_skills_dir: ".kiro/skills",
            relative_detect_dir: ".kiro",
        },
        ToolAdapter {
            id: ToolId::Kode,
            display_name: "Kode",
            // add-skill global path: ~/.kode/skills/
            relative_skills_dir: ".kode/skills",
            relative_detect_dir: ".kode",
        },
        ToolAdapter {
            id: ToolId::McpJam,
            display_name: "MCPJam",
            // add-skill global path: ~/.mcpjam/skills/
            relative_skills_dir: ".mcpjam/skills",
            relative_detect_dir: ".mcpjam",
        },
        ToolAdapter {
            id: ToolId::MistralVibe,
            display_name: "Mistral Vibe",
            // add-skill global path: ~/.vibe/skills/
            relative_skills_dir: ".vibe/skills",
            relative_detect_dir: ".vibe",
        },
        ToolAdapter {
            id: ToolId::Mux,
            display_name: "Mux",
            // add-skill global path: ~/.mux/skills/
            relative_skills_dir: ".mux/skills",
            relative_detect_dir: ".mux",
        },
        ToolAdapter {
            id: ToolId::OpenClaude,
            display_name: "OpenClaude IDE",
            // add-skill global path: ~/.openclaude/skills/
            relative_skills_dir: ".openclaude/skills",
            relative_detect_dir: ".openclaude",
        },
        ToolAdapter {
            id: ToolId::OpenHands,
            display_name: "OpenHands",
            // add-skill global path: ~/.openhands/skills/
            relative_skills_dir: ".openhands/skills",
            relative_detect_dir: ".openhands",
        },
        ToolAdapter {
            id: ToolId::Pi,
            display_name: "Pi",
            // add-skill global path: ~/.pi/agent/skills/
            relative_skills_dir: ".pi/agent/skills",
            relative_detect_dir: ".pi",
        },
        ToolAdapter {
            id: ToolId::Qoder,
            display_name: "Qoder",
            // add-skill global path: ~/.qoder/skills/
            relative_skills_dir: ".qoder/skills",
            relative_detect_dir: ".qoder",
        },
        ToolAdapter {
            id: ToolId::QoderWork,
            display_name: "QoderWork",
            // add-skill global path: ~/.qoderwork/skills/
            relative_skills_dir: ".qoderwork/skills",
            relative_detect_dir: ".qoderwork",
        },
        ToolAdapter {
            id: ToolId::QwenCode,
            display_name: "Qwen Code",
            // add-skill global path: ~/.qwen/skills/
            relative_skills_dir: ".qwen/skills",
            relative_detect_dir: ".qwen",
        },
        ToolAdapter {
            id: ToolId::Trae,
            display_name: "Trae",
            // add-skill global path: ~/.trae/skills/
            relative_skills_dir: ".trae/skills",
            relative_detect_dir: ".trae",
        },
        ToolAdapter {
            id: ToolId::TraeCn,
            display_name: "Trae CN",
            // add-skill global path: ~/.trae-cn/skills/
            relative_skills_dir: ".trae-cn/skills",
            relative_detect_dir: ".trae-cn",
        },
        ToolAdapter {
            id: ToolId::Zencoder,
            display_name: "Zencoder",
            // add-skill global path: ~/.zencoder/skills/
            relative_skills_dir: ".zencoder/skills",
            relative_detect_dir: ".zencoder",
        },
        ToolAdapter {
            id: ToolId::Neovate,
            display_name: "Neovate",
            // add-skill global path: ~/.neovate/skills/
            relative_skills_dir: ".neovate/skills",
            relative_detect_dir: ".neovate",
        },
        ToolAdapter {
            id: ToolId::Pochi,
            display_name: "Pochi",
            // add-skill global path: ~/.pochi/skills/
            relative_skills_dir: ".pochi/skills",
            relative_detect_dir: ".pochi",
        },
        ToolAdapter {
            id: ToolId::AdaL,
            display_name: "AdaL",
            // add-skill global path: ~/.adal/skills/
            relative_skills_dir: ".adal/skills",
            relative_detect_dir: ".adal",
        },
        ToolAdapter {
            id: ToolId::KiloCode,
            display_name: "Kilo Code",
            // add-skill global path: ~/.kilocode/skills/
            relative_skills_dir: ".kilocode/skills",
            relative_detect_dir: ".kilocode",
        },
        ToolAdapter {
            id: ToolId::RooCode,
            display_name: "Roo Code",
            // add-skill global path: ~/.roo/skills/
            relative_skills_dir: ".roo/skills",
            relative_detect_dir: ".roo",
        },
        ToolAdapter {
            id: ToolId::Goose,
            display_name: "Goose",
            // add-skill global path: ~/.config/goose/skills/
            relative_skills_dir: ".config/goose/skills",
            relative_detect_dir: ".config/goose",
        },
        ToolAdapter {
            id: ToolId::GeminiCli,
            display_name: "Gemini CLI",
            // add-skill global path: ~/.gemini/skills/
            relative_skills_dir: ".gemini/skills",
            relative_detect_dir: ".gemini",
        },
        ToolAdapter {
            id: ToolId::GithubCopilot,
            display_name: "GitHub Copilot",
            // add-skill global path: ~/.copilot/skills/
            relative_skills_dir: ".copilot/skills",
            relative_detect_dir: ".copilot",
        },
        ToolAdapter {
            id: ToolId::Clawdbot,
            display_name: "Clawdbot",
            // add-skill global path: ~/.clawdbot/skills/
            relative_skills_dir: ".clawdbot/skills",
            relative_detect_dir: ".clawdbot",
        },
        ToolAdapter {
            id: ToolId::Droid,
            display_name: "Droid",
            // add-skill global path: ~/.factory/skills/
            relative_skills_dir: ".factory/skills",
            relative_detect_dir: ".factory",
        },
        ToolAdapter {
            id: ToolId::Windsurf,
            display_name: "Windsurf",
            // add-skill global path: ~/.codeium/windsurf/skills/
            relative_skills_dir: ".codeium/windsurf/skills",
            relative_detect_dir: ".codeium/windsurf",
        },
        ToolAdapter {
            id: ToolId::Moltbot,
            display_name: "MoltBot",
            // add-skill global path: ~/.moltbot/skills/
            relative_skills_dir: ".moltbot/skills",
            relative_detect_dir: ".moltbot",
        },
        ToolAdapter {
            id: ToolId::HermesAgent,
            display_name: "Hermes Agent",
            // Hermes stores managed skills under HERMES_HOME/skills; default HERMES_HOME is ~/.hermes.
            relative_skills_dir: ".hermes/skills",
            relative_detect_dir: ".hermes",
        },
    ]
}

/// Tools can share the same global skills directory (e.g. Amp and Kimi Code CLI).
/// Use this to coordinate UI warnings and avoid duplicate filesystem operations.
pub fn adapters_sharing_skills_dir(adapter: &ToolAdapter) -> Vec<ToolAdapter> {
    default_tool_adapters()
        .into_iter()
        .filter(|a| a.relative_skills_dir == adapter.relative_skills_dir)
        .collect()
}

pub fn adapters_sharing_project_skills_dir(adapter: &ToolAdapter) -> Vec<ToolAdapter> {
    let relative = project_relative_skills_dir(adapter);
    default_tool_adapters()
        .into_iter()
        .filter(|a| project_relative_skills_dir(a) == relative)
        .collect()
}

pub fn adapter_by_key(key: &str) -> Option<ToolAdapter> {
    default_tool_adapters()
        .into_iter()
        .find(|adapter| adapter.id.as_key() == key)
}

pub fn resolve_default_path(adapter: &ToolAdapter) -> Result<PathBuf> {
    let home = dirs::home_dir().context("failed to resolve home directory")?;
    Ok(home.join(adapter.relative_skills_dir))
}

pub fn resolve_project_path(adapter: &ToolAdapter, project_root: &Path) -> Result<PathBuf> {
    Ok(project_root.join(project_relative_skills_dir(adapter)))
}

pub fn supports_project_scope(adapter: &ToolAdapter) -> bool {
    adapter.id != ToolId::HermesAgent
}

pub fn project_relative_skills_dir(adapter: &ToolAdapter) -> &'static str {
    match adapter.id {
        ToolId::Amp | ToolId::KimiCli => ".agents/skills",
        ToolId::Antigravity => ".agents/skills",
        ToolId::Augment => ".augment/skills",
        ToolId::ClaudeCode => ".claude/skills",
        ToolId::OpenClaw => "skills",
        ToolId::Cline => ".agents/skills",
        ToolId::CodeBuddy => ".codebuddy/skills",
        ToolId::Codex => ".agents/skills",
        ToolId::CommandCode => ".commandcode/skills",
        ToolId::Continue => ".continue/skills",
        ToolId::Crush => ".crush/skills",
        ToolId::Cursor => ".agents/skills",
        ToolId::Droid => ".factory/skills",
        ToolId::GeminiCli => ".agents/skills",
        ToolId::GithubCopilot => ".agents/skills",
        ToolId::Goose => ".goose/skills",
        ToolId::Junie => ".junie/skills",
        ToolId::IflowCli => ".iflow/skills",
        ToolId::KiloCode => ".kilocode/skills",
        ToolId::KiroCli => ".kiro/skills",
        ToolId::Kode => ".kode/skills",
        ToolId::McpJam => ".mcpjam/skills",
        ToolId::MistralVibe => ".vibe/skills",
        ToolId::Mux => ".mux/skills",
        ToolId::OpenCode => ".agents/skills",
        ToolId::OpenHands => ".openhands/skills",
        ToolId::Pi => ".pi/skills",
        ToolId::Qoder => ".qoder/skills",
        ToolId::QwenCode => ".qwen/skills",
        ToolId::RooCode => ".roo/skills",
        ToolId::Trae | ToolId::TraeCn => ".trae/skills",
        ToolId::Windsurf => ".windsurf/skills",
        ToolId::Zencoder => ".zencoder/skills",
        ToolId::Neovate => ".neovate/skills",
        ToolId::Pochi => ".pochi/skills",
        ToolId::AdaL => ".adal/skills",
        ToolId::Copaw
        | ToolId::OpenClaude
        | ToolId::QoderWork
        | ToolId::Clawdbot
        | ToolId::Moltbot
        | ToolId::HermesAgent => adapter.relative_skills_dir,
    }
}

pub fn resolve_detect_path(adapter: &ToolAdapter) -> Result<PathBuf> {
    let home = dirs::home_dir().context("failed to resolve home directory")?;
    Ok(home.join(adapter.relative_detect_dir))
}

pub fn is_tool_installed(adapter: &ToolAdapter) -> Result<bool> {
    Ok(resolve_detect_path(adapter)?.exists())
}

pub fn scan_tool_dir(tool: &ToolAdapter, dir: &Path) -> Result<Vec<DetectedSkill>> {
    let mut results = Vec::new();
    if !dir.exists() {
        return Ok(results);
    }

    let ignore_hint = "Application Support/com.tauri.dev/skills";

    for entry in std::fs::read_dir(dir).with_context(|| format!("read dir {:?}", dir))? {
        let entry = entry?;
        let path = entry.path();
        let file_type = entry.file_type()?;
        let is_dir = file_type.is_dir() || (file_type.is_symlink() && path.is_dir());
        if !is_dir {
            continue;
        }

        let name = entry.file_name().to_string_lossy().to_string();
        if tool.id == ToolId::Codex && name == ".system" {
            continue;
        }
        let (is_link, link_target) = detect_link(&path);
        if path.to_string_lossy().contains(ignore_hint)
            || link_target
                .as_ref()
                .map(|p| p.to_string_lossy().contains(ignore_hint))
                .unwrap_or(false)
        {
            continue;
        }
        results.push(DetectedSkill {
            tool: tool.id.clone(),
            name,
            path,
            is_link,
            link_target,
        });
    }

    Ok(results)
}

fn detect_link(path: &Path) -> (bool, Option<PathBuf>) {
    match std::fs::symlink_metadata(path) {
        Ok(metadata) if metadata.file_type().is_symlink() => {
            let target = std::fs::read_link(path).ok();
            (true, target)
        }
        _ => {
            let target = std::fs::read_link(path).ok();
            if target.is_some() {
                (true, target)
            } else {
                (false, None)
            }
        }
    }
}

#[cfg(test)]
#[path = "../tests/tool_adapters.rs"]
mod tests;


================================================
FILE: src-tauri/src/lib.rs
================================================
mod commands;
mod core;

use std::sync::Arc;

use core::cancel_token::CancelToken;
use core::skill_store::{default_db_path, migrate_legacy_db_if_needed, SkillStore};
use tauri::Manager;
use tauri_plugin_log::{Target, TargetKind};

#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_dialog::init())
        .plugin(tauri_plugin_opener::init())
        .plugin(tauri_plugin_updater::Builder::new().build())
        .setup(|app| {
            app.handle().plugin(
                tauri_plugin_log::Builder::default()
                    .level(log::LevelFilter::Info)
                    .targets([
                        Target::new(TargetKind::LogDir { file_name: None }),
                        #[cfg(desktop)]
                        Target::new(TargetKind::Stdout),
                    ])
                    .build(),
            )?;

            let db_path = default_db_path(app.handle()).map_err(tauri::Error::from)?;
            migrate_legacy_db_if_needed(&db_path).map_err(tauri::Error::from)?;
            let store = SkillStore::new(db_path);
            store.ensure_schema().map_err(tauri::Error::from)?;
            app.manage(store.clone());
            app.manage(Arc::new(CancelToken::new()));

            // Backfill description for skills that were installed before V2 schema.
            core::installer::backfill_skill_descriptions(&store);

            // Best-effort cleanup of our own old git temp directories.
            // Safety:
            // - Only deletes directories that match prefix `skills-hub-git-*`
            // - And contain our marker file `.skills-hub-git-temp`
            // - And are older than the max age.
            let handle = app.handle().clone();
            let store_for_cleanup = store.clone();
            tauri::async_runtime::spawn(async move {
                let removed = core::temp_cleanup::cleanup_old_git_temp_dirs(
                    &handle,
                    std::time::Duration::from_secs(24 * 60 * 60),
                )
                .unwrap_or(0);
                if removed > 0 {
                    log::info!("cleaned up {} old git temp dirs", removed);
                }

                let cleanup_days =
                    core::cache_cleanup::get_git_cache_cleanup_days(&store_for_cleanup);
                if cleanup_days > 0 {
                    let max_age =
                        std::time::Duration::from_secs(cleanup_days as u64 * 24 * 60 * 60);
                    let removed =
                        core::cache_cleanup::cleanup_git_cache_dirs(&handle, max_age).unwrap_or(0);
                    if removed > 0 {
                        log::info!("cleaned up {} git cache dirs", removed);
                    }
                }
            });

            Ok(())
        })
        .invoke_handler(tauri::generate_handler![
            commands::get_central_repo_path,
            commands::set_central_repo_path,
            commands::get_recent_projects,
            commands::save_recent_project,
            commands::get_tool_status,
            commands::get_git_cache_cleanup_days,
            commands::get_git_cache_ttl_secs,
            commands::set_git_cache_cleanup_days,
            commands::set_git_cache_ttl_secs,
            commands::clear_git_cache_now,
            commands::get_onboarding_plan,
            commands::install_local,
            commands::list_local_skills_cmd,
            commands::install_local_selection,
            commands::install_git,
            commands::list_git_skills_cmd,
            commands::install_git_selection,
            commands::sync_skill_dir,
            commands::sync_skill_to_tool,
            commands::unsync_skill_from_tool,
            commands::update_managed_skill,
            commands::search_github,
            commands::get_github_token,
            commands::set_github_token,
            commands::import_existing_skill,
            commands::get_managed_skills,
            commands::get_tags,
            commands::create_tag,
            commands::rename_tag,
            commands::delete_tag,
            commands::get_skill_tags,
            commands::set_skill_tags,
            commands::get_untagged_skill_ids,
            commands::delete_managed_skill,
            commands::get_featured_skills,
            commands::search_skills_online,
            commands::list_skill_files,
            commands::read_skill_file,
            commands::cancel_current_operation
        ])
        .on_window_event(|window, event| {
            if let tauri::WindowEvent::CloseRequested { api, .. } = event {
                api.prevent_close();
                let _ = window.hide();
            }
        })
        .build(tauri::generate_context!())
        .expect("error while running tauri application")
        .run(|app, event| {
            if matches!(event, tauri::RunEvent::Resumed) {
                if let Some(window) = app.get_webview_window("main") {
                    let _ = window.show();
                    let _ = window.set_focus();
                }
            }
        });
}


================================================
FILE: src-tauri/src/main.rs
================================================
// Prevents additional console window on Windows in release, DO NOT REMOVE!!
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]

fn main() {
    app_lib::run();
}


================================================
FILE: src-tauri/tauri.conf.json
================================================
{
  "$schema": "../node_modules/@tauri-apps/cli/config.schema.json",
  "productName": "Skills Hub",
  "version": "0.6.0",
  "identifier": "com.qufei1993.skillshub",
  "build": {
    "frontendDist": "../dist",
    "devUrl": "http://localhost:5173",
    "beforeDevCommand": "npm run dev",
    "beforeBuildCommand": "npm run build"
  },
  "app": {
    "windows": [
      {
        "title": "Skills Hub",
        "width": 960,
        "height": 680,
        "resizable": true,
        "fullscreen": false
      }
    ],
    "security": {
      "csp": null
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "createUpdaterArtifacts": true,
    "icon": [
      "icons/32x32.png",
      "icons/128x128.png",
      "icons/128x128@2x.png",
      "icons/icon.icns",
      "icons/icon.ico"
    ]
  },
  "plugins": {
    "updater": {
      "active": true,
      "dialog": false,
      "endpoints": [
        "https://github.com/qufei1993/skills-hub/releases/latest/download/updater.json"
      ],
      "pubkey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IEI1QjEyQ0U0RkM5NjZCMjQKUldRa2E1Yjg1Q3l4dFM0TGl4N3k3KytFalRiajhFZmo4QkE5ek5HVXM1MjRDZWVORWhibnR6Vk8K"
    }
  }
}


================================================
FILE: tsconfig.app.json
================================================
{
  "compilerOptions": {
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
    "target": "ES2023",
    "useDefineForClassFields": true,
    "lib": ["ES2023", "DOM", "DOM.Iterable"],
    "module": "ESNext",
    "types": ["vite/client"],
    "skipLibCheck": true,

    /* Bundler mode */
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "moduleDetection": "force",
    "noEmit": true,
    "jsx": "react-jsx",

    /* Linting */
    "strict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "erasableSyntaxOnly": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedSideEffectImports": true
  },
  "include": ["src"]
}


================================================
FILE: tsconfig.json
================================================
{
  "files": [],
  "references": [
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.node.json" }
  ]
}


================================================
FILE: tsconfig.node.json
================================================
{
  "compilerOptions": {
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
    "target": "ES2023",
    "lib": ["ES2023"],
    "module": "ESNext",
    "types": ["node"],
    "skipLibCheck": true,

    /* Bundler mode */
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "moduleDetection": "force",
    "noEmit": true,

    /* Linting */
    "strict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "erasableSyntaxOnly": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedSideEffectImports": true
  },
  "include": ["vite.config.ts"]
}


================================================
FILE: vite.config.ts
================================================
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import tailwindcss from '@tailwindcss/vite'

// https://vite.dev/config/
export default defineConfig({
  plugins: [react(), tailwindcss()],
  server: {
    port: 5173,
    strictPort: true,
  },
})