using-bridge

A workflow guide for Bridge, a compiler-based system that turns structured design descriptions into Figma designs and maintains a design system. It defines which Bridge command or workflow to use for each request.

In plain words
What is it for?
Use it when working with Bridge commands, Figma designs, design systems, or the Bridge compiler. It routes requests such as making a design, fixing one, setting up the system, shipping it, or checking workflow status.
Why use it?
It keeps design changes within the compiler and shared design tokens instead of relying on raw Figma API code or manually chosen primitive values. It also requires verification before shipping.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/noemuch/bridge/using-bridge
Any agent
npx skills add noemuch/bridge --skill using-bridge
Clone the repo
git clone --depth 1 https://github.com/noemuch/bridge

Made for: Claude Code, Codex.

Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,337 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00059 $0.01337
Opus 5 $0.00030 $0.00668
Sonnet 5 $0.00012 $0.00267
Haiku 4.5 $0.00006 $0.00134

Measured 2d ago against content hash e7860135f7a4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

using-bridge scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/using-bridge/SKILL.md · 126 lines

How it starts

The opening of the file, as written. The whole thing — 126 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Using Bridge

Bridge is a compiler-driven design workflow for generating Figma designs and maintaining a design system via Claude Code. The compiler (at lib/compiler/compile.ts) enforces all 26 Figma Plugin API rules, so Claude NEVER writes raw Plugin API code and NEVER hardcodes primitive values.

This skill is force-loaded at every SessionStart via hooks/session-start. Its job is to establish the discipline before any action skill runs. It is deliberately small (~400 tokens) to keep the fixed per-session cost low.


Command Map

User intent (keywords) Route to
"make", "design", "create", "build", "generate", "new component", "new screen" generating-figma-design
"fix", "correct", "learn", "diff", "what changed", "I adjusted" learning-from-corrections
"done", "ship", "ship it", "finish", "complete" shipping-and-archiving
"setup", "setup bridge", "extract", "extract DS", "onboard", "initialize", "bootstrap" extracting-design-system
"drop", "abandon", "cancel" inline Drop Procedure (this skill)
"status", "what's next", "workflow" inline status logic (this skill)

Drop Procedure (inline)

drop is handled inline here — it is small enough not to warrant its own skill. Invoke when the user says "drop", "abandon", or "cancel".

  1. Confirm. Ask: "Sure you want to drop {name}?"
  2. Capture learnings. If a snapshot exists, offer to run fix first to capture corrections before archiving.
  3. Document drop reason. Append a drop: block to the CSpec with date, reason, and learnings.
  4. Archive. Move specs/active/{name}.cspec.yamlspecs/dropped/{name}.cspec.yaml. Move the snapshot JSON too if it exists.
  5. Update history. Append {ISO date} | {name} | DROPPED | {reason} to specs/history.log.
  6. Cleanup. Remove /tmp/bridge-scene-{name}.json if present.

Read the full file on GitHub · 126 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 126 lines · 59 tokens per session scan A e7860135f7a4

Subscribe to this mod's changes

using-bridge is a skill published in the GitHub repository noemuch/bridge (156 stars, last pushed 3mo ago), licensed MIT. It adds 59 tokens to every session and 1,337 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

work-with-design-systems

Inspect, build, or extend Figma design systems — and optionally sync them to code. Two modes in one skill: inspect mode (read-only audits with WCAG checks, component scoring, detached instance detection, handoff docs) and build mode (creating components with variable bindings, slot-based composition, structured…

natdexterra/work-with-design-systems · 260 tokens

system-pitch

Write a design system investment pitch with a business case and ROI framing. Trigger when someone says: pitch the design system, make the case for the system, sell this to leadership, justify the investment, business case for design systems, why should we invest in a design system, or anything about building an…

murphytrueman/design-system-ops · 72 tokens

ai-component-description

Generate AI-optimised text descriptions for components, formatted for Figma's MCP server and LLM consumption. This produces prose descriptions in a six-section format (purpose, props, anti-patterns, composition, accessibility, examples), NOT JSON schemas or structured data files. Trigger when someone says: write…

murphytrueman/design-system-ops · 132 tokens

stakeholder-brief

Write a one-page stakeholder brief translating design system health or status into business language. Trigger when someone says: stakeholder update, exec brief, leadership summary, status report for leadership, system status for non-designers, write a brief for the business, or anything about communicating design…

murphytrueman/design-system-ops · 73 tokens

token-audit

Audit a design system's token definitions for naming violations, missing semantic tiers, and structural debt. This audits how tokens are defined and organised, NOT how they are consumed in code. Trigger when someone says: audit my tokens, token naming review, are my tokens consistent, token health check, review my…

murphytrueman/design-system-ops · 93 tokens

accessibility-per-component

Run an accessibility audit on a specific design system component. Trigger when someone says: accessibility check, a11y audit, WCAG compliance, is this accessible, check accessibility, does this meet WCAG, screen reader support, keyboard navigation check, or anything about auditing the accessibility of a specific…

murphytrueman/design-system-ops · 65 tokens