figma-use-figjam
This skill helps agents use Figma's use_figma MCP tool in the FigJam context. Can be used alongside figma-use which has foundational context for using the use_figma tool.
- License 许可
- MIT
- 最近更新
- 2026-09-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- figma-use-figjam
- description
- This skill helps agents use Figma's use_figma MCP tool in the FigJam context. Can be used alongside figma-use which has foundational context for using the use_figma tool.
- disable-model-invocation
- false
02 资源文件 13
- 参考文档references/batch-modify.md7.2 KB
- 参考文档references/create-code-block.md2.7 KB
- 参考文档references/create-connector.md11.3 KB
- 参考文档references/create-label.md11.6 KB
- 参考文档references/create-section.md7.5 KB
- 参考文档references/create-shape-with-text.md15.6 KB
- 参考文档references/create-sticky.md10.3 KB
- 参考文档references/create-table.md13.1 KB
- 参考文档references/create-text.md18.1 KB
- 参考文档references/edit-text.md11.8 KB
- 参考文档references/figjam-colors.md9.0 KB
- 参考文档references/plan-board-content.md16.8 KB
- 参考文档references/position-figjam-nodes.md3.8 KB
03 SKILL.md 正文
use_figma — Figma Plugin API Skill for FigJam
This skill contains FigJam-specific context for the use_figma MCP tool. The figma-use skill provides foundational context for plugin API execution via MCP as well as the full Figma plugin API for more advanced use-cases that are not described here.
Always include figma-use-figjam in the comma-separated skillNames parameter when calling use_figma for FigJam operations. If this skill was loaded via an MCP resource, you MUST prefix the name with resource: (e.g. resource:figma-use-figjam). This is a logging parameter used to track skill usage — it does not affect execution.
FigJam URL is
figma.com/board/.... Do NOT callfigma.createPage()in FigJam — it throwsTypeError: figma.createPage no such property 'createPage' on the figma global object.createPage()is a Design-file API only (figma.com/design/...). FigJam files have a single implicit page; organize content with sections instead (see create-section).
Inspecting FigJam Files
get_figjam is the inspection tool for FigJam files. It returns the full node tree as XML, including IDs of pages, sections, stickies, connectors, and other nodes you need to reference in subsequent use_figma calls.
- Use
get_figjamupfront before writing anyuse_figmacode that needs to reference existing nodes (page IDs, section IDs, etc.). Don't try to discover IDs by running an inspection script —console.logoutput fromuse_figmais not returned to the agent (see figma-use Critical Rule #4). Only thereturnvalue comes back. get_metadatadoes NOT work on FigJam files — it is design-mode only and will fail immediately with "unsupported for FigJam files".get_screenshotrequires a validnodeId— passing an empty nodeId returns "invalid nodeId" error. Get IDs fromget_figjamfirst.- If you forgot to
returnan ID from a previoususe_figmacall and need it now, callget_figjamrather than re-running an inspection script.
Loading Reference Docs Efficiently
Load only the references your task needs — but when you do need to load multiple, issue all reads in a single parallel tool-call batch, not sequentially across turns. For a typical board-creation task, that means a single message containing reads for plan-board-content plus the 3-4 specific node-type references you'll use.
Deferred Tools — Batch-Load Schemas
The Figma MCP tools (use_figma, get_figjam, get_screenshot, get_metadata, create_new_file, whoami) often appear as deferred tools that require ToolSearch to load their schemas before they can be called. Load all schemas in a single ToolSearch call using the select: syntax instead of one call per tool:
ToolSearch query="select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file"
Six sequential ToolSearch calls is six round trips before any work happens. One batched call is one round trip.
Text Mutations — Canonical Recipe
Every FigJam text mutation (sticky/shape/label/table cell/connector text, standalone text nodes) follows the same recipe as Design files: load font → await → mutate → return affected IDs. Skipping the load throws Cannot write to node with unloaded font "<family> <style>". See figma-use → gotchas.md → Canonical text-edit recipe. FigJam-specific note: sublayer defaults vary (sticky → Inter Medium, shape → Inter Medium, connector → invalid until set), so always load from node.text.fontName rather than hardcoding { family: 'Inter', style: 'Regular' }.
Adding Images to a FigJam Board
upload_assets is the ONLY supported way to add images to a FigJam file. Do NOT use figma.createImage() or figma.createImageAsync() from inside use_figma — they are unsupported as image-upload entry points in FigJam. Call upload_assets with the FigJam fileKey; the tool returns single-use upload URLs that you POST raw image bytes to, and the image is committed and placed automatically. Pass nodeId (with count: 1) to attach the upload to an existing FigJam node as a fill; omit nodeId to drop the image onto the board as a new layer.
For the full request/response shape, see figma-use → api-reference.md → Images.
Reference Docs
- plan-board-content - Read this for any board content request — board template, retro, brainstorm, ice breaker, meeting board, scaffold
- Covers planning of generated board content, including sequential outline, sections, intents, and hierarchical text
- Delegates to other references for specific API details
- create-section — Create and configure FigJam sections (sizing, naming, colors, content visibility, organizing nodes, column layouts)
- create-sticky — Create and configure FigJam sticky notes (colors, sizing, text, author visibility, batch creation)
- create-connector — Create and configure FigJam connectors (endpoints, arrows, line types, labels, colors, diagram wiring)
- create-text — Create and configure FigJam text nodes (font loading, preset fonts and colors, sizing, lists, mind map operations)
- position-figjam-nodes — Position, size, and reparent nodes on the canvas (including within sections)
- create-shape-with-text — Create and configure FigJam shapes with embedded text (shape types, color presets, sizing to fit text, diagram layouts)
- create-code-block — Create and configure FigJam code block nodes (languages, syntax highlighting, positioning, embedding in sections)
- create-table — Create and configure FigJam tables (rows, columns, cell text, color presets, resizing)
- edit-text — Edit existing text nodes (font loading, styled ranges, find/replace, FigJam Charcoal default color)
- create-label — Create and configure FigJam label nodes (small numbered/lettered circle callout markers, sequences, positioning)
- batch-modify — Patterns for modifying many existing nodes at once (bulk style changes, repositioning, property updates)
- figjam-colors — Canonical FigJam color palettes for every node type (sticky, section, connector, shape, label) plus the
hex/255notation rule and theh()helper
04 同仓库更多 Skills
skill-installer
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
skill-creator
Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.
review-agent
Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.
plugin-creator
Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.
openai-docs
Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.
imagegen
Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.