Api registry bridge
Use when Phase 1 Assess or Phase 5 Iterate detects a new API dependency, API config fails, or the user asks to "register this API" or "check the API registry". Consults api-registry plugin; degrades gracefully if plugin is absent. NOT for PRD strategic grounding (use `prd-bridge`) or UI verification (use `ibr-bridge`).From its SKILL.md
npx -y skills add tyroneross/build-loop --skill api-registry-bridgeAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.2 KB, as published. Nobody here has run it
api-registry-bridge (inside build-loop)
Activation
- Assess phase: new API detected in dep diff (new package added to
package.json/requirements.txt) or new vendor-prefixed env key in.env.example. Also runs unconditionally as a cheap doc-freshness check (see §"Phase 1 doc-freshness check"). - Iterate phase: API config attempt fails with 401/403/404/timeout/auth error.
Contract
-
Check
~/.api-registry/registry.dbexists.- If not: log
api-registry not present — skipping source verificationand continue build-loop flow. No failure.
- If not: log
-
Extract service name from failure message or dep diff.
-
Invoke
/api-registry:lookup <name>.- If
found: trueanddeprecated_notespresent: HALT iteration; surface the warning to the user BEFORE retry. - If
stale_warning: true: suggest/api-registry:refresh <name>but don't block. - If
cooldown.install_blocked: true: see §"New-dependency cooldown".
- If
-
If config question remains, invoke
/api-registry:docs <name> <specific config question>.- api-registry answers from its local doc cache first; Context7 is the fallback path only.
-
If lookup returns
found: false: prompt user once per build-loop run to add the service. Don't re-prompt on every iteration.
Phase 1 doc-freshness check
At the start of Phase 1 Assess, after the registry-present check:
- Read
~/.api-registry/staleness.json(written by api-registry's SessionStart hook /staleness.ts --marker).- Absent or unreadable → skip silently.
- If any
stale[]entry names a service relevant to this build (its package appears in the dep manifest, or it is aprotocol-category source and the build touches MCP), the doc is stale (last_checked> 7 days). - Refresh stale docs in-session before planning: for each relevant stale doc, invoke
/api-registry:docs <service> <topic>so the cache is re-verified/re-curated before the plan is drafted. This keeps Phase 2 planning grounded in current docs, not a stale cache. - This is advisory — never blocks the build. Log what was refreshed; route the summary to the run report.
New-dependency cooldown
When Assess detects a newly added third-party package:
/api-registry:lookup <name>returns acooldownblock.- If
cooldown.install_blocked: true(latest version released < 7 days ago, service notauthor_owned):- Surface the
cooldown.reasonto the user. - The
pre_bash_dependency_cooldown.shPreToolUse hook is the enforcement point — it already rewrites/denies fresh installs at the Bash boundary. The registry verdict is the advisory signal that explains why a hook rewrite happened; it does not replace the hook. author_owned: trueservices (the scope(s)/repos configured independencyCooldown.allowlist, plus the user's own projects) are exempt —cooldown.install_blockedis alwaysfalsefor them, matching the hook's allowlist. The default allowlist ships pinned to the maintainer's own npm scope; setdependencyCooldown.allowlistto your own scope(s) so this exemption applies to packages you own rather than the maintainer's.
- Surface the
- The 7-day registry cooldown window and the hook's 7-day install cooldown are deliberately the same number (supply-chain dwell time). If they ever diverge, the hook is authoritative for enforcement; the registry is authoritative for explanation.
What this does NOT do
- Does not modify the registry (except via
/api-registry:docs, which re-curates the cache by design — that is the cache staying fresh, not the bridge mutating registry metadata). - Does not block the build if api-registry is absent.
- Does not fabricate URLs.
- Does not duplicate the cooldown enforcement — that is
pre_bash_dependency_cooldown.sh's job.