← FigmaCONTENT HISTORY

Update to Figma

Snapshot Sep 30, 2026 · 22:45 UTC · version 15.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "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.",
  "included_files": [
    {
      "relative_path": "references/batch-modify.md",
      "size_in_bytes": 7395
    },
    {
      "relative_path": "references/create-code-block.md",
      "size_in_bytes": 2791
    },
    {
      "relative_path": "references/create-connector.md",
      "size_in_bytes": 11595
    },
    {
      "relative_path": "references/create-label.md",
      "size_in_bytes": 11831
    },
    {
      "relative_path": "references/create-section.md",
      "size_in_bytes": 7695
    },
    {
      "relative_path": "references/create-shape-with-text.md",
      "size_in_bytes": 15946
    },
    {
      "relative_path": "references/create-sticky.md",
      "size_in_bytes": 10552
    },
    {
      "relative_path": "references/create-table.md",
      "size_in_bytes": 13457
    },
    {
      "relative_path": "references/create-text.md",
      "size_in_bytes": 18575
    },
    {
      "relative_path": "references/edit-text.md",
      "size_in_bytes": 12174
    },
    {
      "relative_path": "references/figjam-colors.md",
      "size_in_bytes": 9228
    },
    {
      "relative_path": "references/plan-board-content.md",
      "size_in_bytes": 17219
    },
    {
      "relative_path": "references/position-figjam-nodes.md",
      "size_in_bytes": 3920
    }
  ],
  "skill_md_contents": "---\nname: figma-use-figjam\ndescription: \"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.\"\ndisable-model-invocation: false\n---\n\n# use_figma — Figma Plugin API Skill for FigJam\n\nThis skill contains FigJam-specific context for the `use_figma` MCP tool. The [figma-use](../figma-use/SKILL.md) 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.\n\n**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.\n\n> **FigJam URL is `figma.com/board/...`.** Do NOT call `figma.createPage()` in FigJam — it throws `TypeError: 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](references/create-section.md)).\n\n## Inspecting FigJam Files\n\n**`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.\n\n- **Use `get_figjam` upfront** before writing any `use_figma` code that needs to reference existing nodes (page IDs, section IDs, etc.). Don't try to discover IDs by running an inspection script — `console.log` output from `use_figma` is **not returned to the agent** (see [figma-use Critical Rule #4](../figma-use/SKILL.md)). Only the `return` value comes back.\n- **`get_metadata` does NOT work on FigJam files** — it is design-mode only and will fail immediately with \"unsupported for FigJam files\".\n- **`get_screenshot` requires a valid `nodeId`** — passing an empty nodeId returns \"invalid nodeId\" error. Get IDs from `get_figjam` first.\n- If you forgot to `return` an ID from a previous `use_figma` call and need it now, call `get_figjam` rather than re-running an inspection script.\n\n## Loading Reference Docs Efficiently\n\nLoad 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.\n\n## Deferred Tools — Batch-Load Schemas\n\nThe 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:\n\n```\nToolSearch query=\"select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file\"\n```\n\nSix sequential `ToolSearch` calls is six round trips before any work happens. One batched call is one round trip.\n\n## Text Mutations — Canonical Recipe\n\nEvery 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](../figma-use/references/gotchas.md#canonical-text-edit-recipe-font-load--await--mutate--return-ids). 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' }`.\n\n## Adding Images to a FigJam Board\n\n**`upload_assets` is the ONLY supported way to add images to a FigJam file.** 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 `nodeIds` (with one entry per upload) to attach uploads to existing FigJam nodes as fills; omit `nodeIds` to drop the images onto the board as new layers.\n\nFor the full request/response shape, see [figma-use → api-reference.md → Images](../figma-use/references/api-reference.md#images).\n\n## Reference Docs\n\n- [plan-board-content](references/plan-board-content.md) - Read this for any board content request — board template, retro, brainstorm, ice breaker, meeting board, scaffold\n  - Covers planning of generated board content, including sequential outline, sections, intents, and hierarchical text\n  - Delegates to other references for specific API details\n- [create-section](references/create-section.md) — Create and configure FigJam sections (sizing, naming, colors, content visibility, organizing nodes, column layouts)\n- [create-sticky](references/create-sticky.md) — Create and configure FigJam sticky notes (colors, sizing, text, author visibility, batch creation)\n- [create-connector](references/create-connector.md) — Create and configure FigJam connectors (endpoints, arrows, line types, labels, colors, diagram wiring)\n- [create-text](references/create-text.md) — Create and configure FigJam text nodes (font loading, preset fonts and colors, sizing, lists, mind map operations)\n- [position-figjam-nodes](references/position-figjam-nodes.md) — Position, size, and reparent nodes on the canvas (including within sections)\n- [create-shape-with-text](references/create-shape-with-text.md) — Create and configure FigJam shapes with embedded text (shape types, color presets, sizing to fit text, diagram layouts)\n- [create-code-block](references/create-code-block.md) — Create and configure FigJam code block nodes (languages, syntax highlighting, positioning, embedding in sections)\n- [create-table](references/create-table.md) — Create and configure FigJam tables (rows, columns, cell text, color presets, resizing)\n- [edit-text](references/edit-text.md) — Edit existing text nodes (font loading, styled ranges, find/replace, FigJam Charcoal default color)\n- [create-label](references/create-label.md) — Create and configure FigJam label nodes (small numbered/lettered circle callout markers, sequences, positioning)\n- [batch-modify](references/batch-modify.md) — Patterns for modifying many existing nodes at once (bulk style changes, repositioning, property updates)\n- [figjam-colors](references/figjam-colors.md) — Canonical FigJam color palettes for every node type (sticky, section, connector, shape, label) plus the `hex/255` notation rule and the `h()` helper\n"
}

SHA-256: 95e747c82dd97fa3da2fdc59a7d10cf9842712c12be2205b06e17593b3db1286