AGENT SKILL

figma-preflight

Read-only preflight for an authorized Figma write: correct live target, applicable DS/API context, states and single-writer lock; also supports requested flow-graph audits.

适用职业设计师
License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
figma-preflight
license
MIT
metadata
{ "author": "Thiago Xikota", "version": "1.2.0" }
description
Read-only preflight for an authorized Figma write: correct live target, applicable DS/API context, states and single-writer lock; also supports requested flow-graph audits.
compatibility
Gate for writes through figma-console-mcp (figma_execute, Desktop Bridge plugin in Figma Desktop) or through the official Figma MCP server (use_figma, Full seat, not validated by this repo). The file lock script needs Python 3 (standard library only). Reads the figma-canon skill. The optional local evidence script of figma-bridge-doctor is macOS only.

02 资源文件 5

03 SKILL.md 正文

Figma preflight

Read-only gate before an authorized canvas write. It returns clear preconditions or concrete gaps and never mutates the canvas. Read-only inspection does not require write approval. A gate pass or lock is not user consent; apply authorization already present in the task without asking again.

Preconditions for the affected scope

  • Live connection and correct file: figma-console figma_get_status with a probe and correct pairing, or the available official MCP identity + metadata path. Local process/port output alone cannot prove pairing.
  • Precise target id/selection and fresh structure. Resolve ambiguity only when it affects the target; valid metadata in context can be reused.
  • Styled writes resolve the relevant variables/styles; new UI searches existing components/icons and app assets before inventing geometry. Report unrelated DS debt instead of turning a local edit into a file-wide cleanup.
  • Read applicable canon/API details for this operation. Plan the product states and flow outcomes it actually affects; no universal manual bundle or required mental pass count.
  • Claim the file lock using this skill’s scripts/figma_lock.py, with explicit agent/task identity. Same-file single writer remains the invariant. A conflict, missing/broken lock script or uncertain owner keeps writes blocked. Never release another task's lock, override autonomously on "disjoint pages", or use an empty process snapshot as permission to bypass.

gate-checks.md explains tool alternatives, targets, variables, reuse and states when a check needs detail. file-lock.md documents the existing TTL lock CLI and release rules. Release only your exact agent/task lock in cleanup/finally. An explicit user exception must name what is waived; it does not waive every gate, fix missing access or authorize another task's lock release by analogy.

Execution and proof

For partial errors/timeouts, read the canvas before retrying. Verify the property actually changed, not an unchanged proxy; preserve existing work and guard null nodes/live edits. write-verification.md contains the fragile Plugin API cases. Do not invent support for a tool/API.

New-screen or requested graph audit uses flow-audit.md: entry, destinations, orphan/dead/broken edges and semantic mismatch. An audit never creates a missing screen or rewires a valid flow on inference alone. Report the target, clear/gap status and evidence briefly; a tiny write does not require a ceremonial eight-row stamp or repeated user confirmation.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k