dbs-bridge

Original：🇨🇳 Chinese

Translated

1 scripts

Agent Infrastructure: Bridge any skill or directory of skill collections to Claude Code (~/.claude/skills) and Codex (~/.codex/skills). Supports skills in the dbskill repository as well as absolute paths to external skills. Connect source directories via symlinks, with both ends synchronized when the source directory is modified. Supports batch bridging by skill name, relative path, absolute path, or skills directory, as well as unbridging and checking bridge status. Triggers: /dbs-bridge, /bridge, "bridge this skill", "bridge this skills directory", "connect this skill to Claude Code and Codex", "make this skill callable by both Claude and Codex", "unbridge", "check bridge status" Bridge any skill folder or directory of skill folders to Claude Code and Codex using symlinks. Supports dbskill skills and external skill directories. Use when the user wants one or many skills callable from both agents, or wants to unlink/check bridge status. Trigger: /dbs-bridge, /bridge, "bridge this skill", "bridge this skills directory", "make this skill available to Claude Code and Codex", "unlink this skill", "check bridge status"

8installs

Sourcedontbesilent2025/dbskill

Added on2026-07-04

NPX Install

npx skill4agent add dontbesilent2025/dbskill dbs-bridge

SKILL.md Content (Chinese)

View Translation Comparison →

dbs-bridge: Cross-Agent Skill Bridging

Bridge any source skill directory containing

SKILL.md

, or a collection directory with multiple skill subdirectories, to both:

```
~/.claude/skills/<skill-name>
```
```
~/.codex/skills/<skill-name>
```

This allows both Claude Code and Codex to call the skill from the same source directory. Changes to the source directory will automatically sync to both ends. The source directory can be within the dbskill repository, in an external project, a local directory outside

~/.claude/skills

, an iCloud directory, or other workspaces.

Core Principles

Use only symlinks. Do not copy skill files to avoid version divergence between the two ends.
Source directories can be anywhere. Bridged directories only point to the source directory.
Never overwrite real directories. If a real directory with the same name already exists at the target location, stop and report it, letting the user handle it manually.
Unbridge only removes symlinks. When canceling the bridge, only remove the links under
```
~/.claude/skills
```
and
```
~/.codex/skills
```
, do not delete the source directory.
Prioritize script execution. Use the skill's built-in script
```
scripts/bridge-skill.sh
```
instead of writing bridge commands on the spot.

Identify the Source Skill

Users 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

Determine priority as follows:

If the user explicitly provides an absolute path, use that path directly.
If the user provides a relative path, first resolve it against the current working directory, then against the dbskill repository root directory.
If the user only provides a skill name, first check for a directory with the same name in the current working directory, then check
```
skills/<name>
```
in the dbskill repository.
If the user only says "this skill", use the skill just created, renamed, or discussed in the current conversation.
If still uncertain, check the most recently modified skills in the current working directory and the repository's
```
skills/
```
directory.

If still unable to determine, only ask:

Which skill to bridge? Provide the skill name or path.

The source directory must meet one of the following conditions:

The directory itself contains
```
SKILL.md
```
;
The first-level subdirectories of the directory contain multiple
```
SKILL.md
```
files, for batch bridging.

Execute Bridging

Run in the dbskill repository root directory:

bash

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

Examples:

bash

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"

Return the two link results from the script output to the user after execution.

Check Status

When the user asks "Is the bridge ready?" or "Check bridge status", run:

bash

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

The output should indicate where each end (Claude Code and Codex) points to.

Cancel Bridging

When the user says "unbridge", "remove bridge", or "unlink", run:

bash

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

After unbridging, inform the user: The source skill has not been deleted, only the symlinks at both ends have been removed.

Output Specifications

After successful bridging, report briefly:

markdown

Bridged `<skill-name>`:

- Claude Code: `~/.claude/skills/<skill-name>` -> `<source-path>`
- Codex: `~/.codex/skills/<skill-name>` -> `<source-path>`

If a real directory with the same name exists:

markdown

Did not overwrite `<target-path>` because it is already a real directory. Please manually confirm if this directory can be moved first.

Self-Check

Confirm the following before each execution:

The source directory exists;
The source directory contains
```
SKILL.md
```
, or its first-level subdirectories contain
```
SKILL.md
```
;
External paths must use absolute paths or be resolvable from the current working directory;
If the target location exists, it must be a symlink to allow updates;
Do not delete the source directory;
Do not copy
```
skills/dbs-bridge
```
itself to both ends, only use symlinks.

dbs-bridge

NPX Install

Tags

SKILL.md Content (Chinese)

dbs-bridge: Cross-Agent Skill Bridging

Core Principles

Identify the Source Skill

Execute Bridging

Check Status

Cancel Bridging

Output Specifications

Self-Check