mikeng-io/agent-skills / skills/bridge-commons
bridge-commons
VerifiedShared contract for all bridge adapters — pre-flight SOP, standardized input/output schemas, artifact format, and status semantics. Read by any bridge or orchestrating skill. Not invocable standalone.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.8 KB |
| SKILL.md | skill md | 30.4 KB |
| tool-discovery.md | markdown | 9.9 KB |
README.md
View on GitHub# Bridge Commons
Shared contract for all bridge adapters in the Deep Skills Suite. Defines the pre-flight SOP, input/output schemas, status semantics, and artifact format that every bridge implements.
## Why This Exists
Each bridge adapter (Claude, Gemini, Codex, OpenCode) connects to a different AI runtime with different CLIs and APIs. Bridge-commons provides the shared layer so orchestrating skills only need to know one schema — not four.
## What It Defines
| Section | Purpose |
|---------|---------|
| Pre-flight SOP | Ordered detection steps every bridge follows before executing |
| Timeout estimation | Scope-based formula, no hardcoded values |
| Input schema | `bridge_input` — the standard contract every bridge accepts |
| Output schema | Common report structure every bridge returns |
| Status semantics | `COMPLETED`, `SKIPPED`, `HALTED`, `ABORTED` and when each applies |
| Artifact format | JSONL event log + Markdown summary in `.outputs/bridges/` |
| Error handling | Exit code patterns, timeout handling, parse failure recovery |
## How Bridges Use This
Each bridge's `SKILL.md` references this document. When an orchestrating skill embeds a bridge's instructions into a Task agent prompt, the bridge follows `bridge-commons` for all shared behavior and only adds its own connection-specific logic on top.
```
bridge-commons ← defines the contract
bridge-claude ← implements it: Task tool → claude CLI → Anthropic API
bridge-gemini ← implements it: gemini CLI → SKIPPED
bridge-codex ← implements it: MCP → codex exec → SKIPPED
bridge-opencode ← implements it: HTTP API → opencode run → SKIPPED
```
## Part of
- Deep Skills Suite
- Consumed by: all bridge adapters, `deep-council`
- Depends on: nothing (this is the base layer)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |