dbs-bridge

dbs-bridge: Multi-Agent Skill Bridging

Symlink any skill source directory containing SKILL.md, or a collection directory containing multiple skill subdirectories, to:

• ~/.claude/skills/<skill-name>
• ~/.codex/skills/<skill-name>
• ~/.agents/skills/<skill-name>

Also generate a thin Grok bridge:

• ~/.grok/skills/<skill-name>/SKILL.md

This makes the skill callable from Claude Code, Codex, Doubao Mac App, Trae Solo, Grok, and other agents, all pointing to the same source. Changes to the source directory are automatically reflected everywhere. The source can be inside the dbskill repo, or in an external project, a local directory outside ~/.claude/skills / ~/.codex/skills / ~/.agents/skills / ~/.grok/skills, iCloud, or any other workspace.

---

Core Principles

1. Claude / Codex / generic Agents use symlinks only. No copying of skill files to avoid version divergence.
2. Source directory can be anywhere. Bridge directories only point to the source.
3. Never overwrite real directories. If the target location already has a real directory with the same name, stop and report, asking the user to handle it manually.
4. Grok gets a thin bridge. The Grok bridge must include user_invocable: true and point to the real source.
5. Unlinking only removes derived artifacts. When unbridging, only remove symlinks under ~/.claude/skills, ~/.codex/skills, ~/.agents/skills and the Grok bridge generated by this tool under ~/.grok/skills. Do not delete the source directory.
6. Prefer script execution. Use the bundled script scripts/bridge-skill.sh; do not rewrite bridge commands on the fly.

---

Determine the Source Skill

The user may provide:

• skill name: dbs-hook
• relative path: skills/dbs-hook
• absolute path: /Users/.../dbskill/skills/dbs-hook
• external absolute path: /Users/.../.agents/skills/lark-doc
• skill collection directory: /Users/.../dbskill/skills
• a skill just created or modified in the current context

Resolution priority:

1. If the user explicitly gives an absolute path, use it directly.
2. If the user gives a relative path, resolve it first relative to the current working directory, then relative to the dbskill repo root.
3. If the user gives only a skill name, first look for a directory with that name under the current working directory, then under skills/<name> in the dbskill repo.
4. If the user says "this skill", use the skill most recently created, renamed, or discussed in the current conversation.
5. If still uncertain, check the most recently modified skill under the current working directory and the repo's skills/ directory.
6. If still unable to determine, ask only: 桥接哪个 skill？给我 skill 名称或路径。

The source directory must satisfy one of:

• The directory itself contains SKILL.md;
• One of its immediate subdirectories contains multiple SKILL.md files (for batch bridging).

---

Execute Bridging

Run from the dbskill repo root:

skills/dbs-bridge/scripts/bridge-skill.sh link <skill-name-or-path>

Examples:

skills/dbs-bridge/scripts/bridge-skill.sh link dbs-hook
skills/dbs-bridge/scripts/bridge-skill.sh link skills/dbs-beta-framework-builder
skills/dbs-bridge/scripts/bridge-skill.sh link skills
skills/dbs-bridge/scripts/bridge-skill.sh link "/absolute/path/to/skill"
skills/dbs-bridge/scripts/bridge-skill.sh link "/Users/me/external-skills/my-skill"
skills/dbs-bridge/scripts/bridge-skill.sh link "/Users/me/external-skills"

After execution, report the bridging results for each host from the script output back to the user.

---

Check Status

When the user asks "is it bridged?" or "check bridge status", run:

skills/dbs-bridge/scripts/bridge-skill.sh status <skill-name-or-path>

The output should indicate where each of the four locations (Claude Code, Codex, generic Agents, Grok) points.

---

Unlink

When the user says "unlink" or "cancel bridging", run:

skills/dbs-bridge/scripts/bridge-skill.sh unlink <skill-name-or-path>

After unlinking, inform the user: the source skill was not deleted; only the derived artifacts on each end were removed.

---

Output Format

After bridging, report briefly:

已桥接 `<skill-name>`：

- Claude Code：`~/.claude/skills/<skill-name>` -> `<source-path>`
- Codex：`~/.codex/skills/<skill-name>` -> `<source-path>`
- 通用 Agents：`~/.agents/skills/<skill-name>` -> `<source-path>`
- Grok：`~/.grok/skills/<skill-name>` -> `<source-path>/SKILL.md`

If a real directory with the same name exists:

没有覆盖 `<target-path>`，因为那里已经是一个真实目录。需要你先手动确认这个目录能否移走。

---

Self-Check

Before each execution, verify:

• Source directory exists;
• Source directory contains SKILL.md, or one of its immediate subdirectories contains SKILL.md;
• External paths must be absolute or resolvable from the current working directory;
• If the target location for Claude / Codex / generic Agents already exists, it must be a symlink to allow update;
• If the target location for Grok already exists, it must be a Grok bridge generated by this tool to allow update;
• Do not delete the source directory;
• Do not copy skills/dbs-bridge itself to any end; Grok only gets a thin bridge.

---

Not Sure Which Skill to Use Next?

Enter /dbs.

It will read the current conclusion and route to the most relevant skill.