Agent Skills Bridge (v3.0)

Universal cross-agent skills index. Discovers skill directories from 36 AI coding agents on your machine, builds a unified searchable index, detects duplicates, and recommends the best version — all from original paths, no copying.

Core Principle: Index, Don't Copy

Don't move other agents' skills into your own library. Build a unified index, load on demand from the original path, done.

What's New in v3.0

Supported Agents (37)

Based on the Agent Skills open standard:

Each agent has standard roots (global path) and discover patterns (project-level path) defined in config.json.## Configuration

config.json

Path: agent-skills-bridge/config.json

{
  "version": "3.0.0",
  "standard": {
    "name": "Agent Skills Open Standard",
    "url": "https://github.com/scotttrinh/skills"
  },
  "search_roots": {
    "home": ["${HOME}", "${USERPROFILE}"],
    "config": ["${HOME}/.config", "${APPDATA}"],
    "local": ["${HOME}/.local", "${LOCALAPPDATA}"]
  },
  "tools": {
    "claude-code": {
      "label": "Claude Code",
      "roots": ["${HOME}/.claude/skills"],
      "fallback": ["${HOME}/.claude/plugins"],
      "priority": 1,
      "discover": [".claude/skills"]
    },
    // ... 36 more agents
  },
  "domain_keywords": { ... }
}

Environment Variables

Path Validation (3-tier)

1. roots: Check configured roots paths first
2. fallback: Try fallback paths if roots don't exist
3. discover: Auto-search under search_roots using discover patterns

Discovered paths are saved back to config.json automatically.

Workflow

DISCOVER → VALIDATE → SCAN → INDEX → DEDUP → CACHE → SEARCH → MATCH → LOAD → EXECUTE

Quick Start

# Validate which agents are installed on your machine
python scripts/build_index.py --validate

# Auto-discover agent paths and update config
python scripts/build_index.py --discover

# Build the full index (scan all agent skill dirs)
python scripts/build_index.py --print

# Search for skills by keyword
python scripts/build_index.py --search "code review"

# Search within a specific agent
python scripts/build_index.py --search "patent" --tool claude-code

# List all skills from a specific agent
python scripts/build_index.py --list --tool cursor

# Show duplicate analysis (which skills exist across multiple agents)
python scripts/build_index.py --duplicates

Dedup Analysis

Quality Scoring (7 dimensions)

When to call recommended version

1. Prefer [推荐] version: highest quality score
2. Call non-recommended only when: recommended version lacks a feature you need, or its agent isn't available in current environment
3. Don't re-read: after reading recommended version, skip duplicates

Integration Criteria

Not every good skill should be copied. Only integrate when ALL conditions are met:

Task Matching

Migration Guide

To a new machine

1. Copy the agent-skills-bridge/ directory to the new machine
2. Run python scripts/build_index.py --discover — auto-detects installed agents
3. Check python scripts/build_index.py --validate — see which agents were found
4. Build python scripts/build_index.py --print — generate the index
5. Optional: manually edit config.json if an agent is installed in a non-standard location

Share with others

1. Package the agent-skills-bridge/ directory (exclude skills_index.json — it's a machine-specific cache)
2. The bundled config.json uses ${HOME} env vars — auto-adapts to any machine
3. Recipient runs --discover to find their installed agents

Notes

1. Index, not copy: the purpose is unified search + on-demand loading, not skill migration
2. Read-only: never modify other agents' skill files
3. Skills are documents: SKILL.md files are AI behavioral instructions, not executables
4. Script safety: evaluate scripts/ in skills before running (read source, check for destructive ops)
5. Encoding: some older SKILL.md files may use GBK encoding; the parser falls back to GBK/latin-1
6. Graceful degradation: missing agent directories are skipped, don't affect others
7. No hardcoded paths: all paths managed via config.json, code uses only env vars