@skilly-hand/skilly-hand 0.29.1 → 0.29.2

package/CHANGELOG.md

@@ -16,6 +16,21 @@ All notable changes to this project are documented in this file.
 ### Removed
 - _None._
 
+## [0.29.2] - 2026-06-20
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.2)
+
+### Added
+- _None._
+
+### Changed
+- Synchronized `figma-mcp-0to1` with the current official Figma MCP tools, Figma Slides workflows, asset transfer, Code Connect context, supported clients, permissions, and rate limits.
+
+### Fixed
+- _None._
+
+### Removed
+- _None._
+
 ## [0.29.1] - 2026-05-23
 [View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.1)
 

package/catalog/skills/figma-mcp-0to1/SKILL.md

@@ -3,10 +3,10 @@ name: "figma-mcp-0to1"
 description: "Guide users from Figma MCP installation and authentication through first canvas creation, with function-level tool coverage and operational recovery patterns."
 skillMetadata:
   author: "skilly-hand"
-  last-edit: "2026-05-09"
+  last-edit: "2026-06-20"
   license: "Apache-2.0"
-  version: "1.0.3"
-  changelog: "Updated Figma MCP guidance for current remote-first docs, supported-client coverage, Figma-provided skills, FigJam write workflows, code-to-canvas support, and access/rate-limit language; affects setup routing, tool selection, prompt assets, and official matrix"
+  version: "1.1.0"
+  changelog: "Synced the official Figma MCP surface for asset transfer, Code Connect context, library discovery, Figma Slides, current Figma-provided skills, and per-minute limits; affects tool routing, canvas workflows, prompts, troubleshooting, and the official matrix"
   auto-invoke: "Installing, configuring, or using Figma MCP from setup through first canvas creation"
   allowed-tools:
     - "Read"
@@ -73,7 +73,8 @@ Choose subskills by intent:
 - Use link-based node targeting for reliable design-context extraction.
 - Keep a clear distinction between read context tools and write/canvas tools.
 - For repeated team workflows, reuse prompts and config snippets from `assets/`, and prefer Figma-provided skills when they exist.
-- Use `figma-use` with `use_figma` for Figma Design writes and `figma-use-figjam` for FigJam writes when those skills are available.
+- Pair `use_figma` with the editor-specific skill: `figma-use` for Design, `figma-use-figjam` for FigJam, or `figma-use-slides` for Slides.
+- Use `download_assets` and `upload_assets` when the task requires asset delivery, non-PNG exports, original images, or cross-file image transfer.
 
 ---
 
@@ -83,9 +84,9 @@ Figma MCP support and skilly-hand installation support are related but not ident
 
 | Coverage | Agents or Clients | Guidance |
 | --- | --- | --- |
-| Figma-supported and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot`, `gemini` | Include concrete setup paths when Figma publishes them; otherwise point to client docs/catalog. |
-| Figma-supported but not skilly-hand-native | Amazon Q, Android Studio, VS Code, Warp, Augment, Factory, Firebender, Kiro, OpenHands, Replit | Mention as Figma-supported clients, but do not add skilly-hand install assumptions. |
-| skilly-hand-supported but not source-backed in current Figma docs | `antigravity`, `windsurf`, `trae` | Keep broad `agentSupport`; document that Figma-specific setup may require client documentation or manual MCP config. |
+| Figma-documented and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot` | Use concrete setup paths where published; Copilot support is currently documented for Copilot CLI write-to-canvas. |
+| Figma-documented but not skilly-hand-native | VS Code, Xcode, Claude Desktop, Warp, Augment, Factory, Firebender | Mention only for the workflows where Figma lists them; do not add skilly-hand install assumptions. |
+| skilly-hand-supported but not source-backed in current Figma docs | `gemini`, `antigravity`, `windsurf`, `trae` | Keep broad `agentSupport`; require verification in the Figma MCP Catalog or client documentation before setup. |
 
 ## Figma-Provided Skills
 
@@ -95,10 +96,11 @@ Prefer Figma-provided skills for workflows they cover:
 | --- | --- |
 | `figma-use` | Foundational Figma Design write-to-canvas workflow for frames, components, variables, styles, and auto layout. |
 | `figma-use-figjam` | Foundational FigJam write workflow for boards, stickies, sections, connectors, shapes, tables, and code blocks. |
-| `figma-create-new-file` | Create blank Figma Design or FigJam files before writing. |
-| `figma-implement-design` | Generate production code from a Figma design URL. |
-| `figma-code-connect-components` | Map published Figma components to code implementations. |
-| `figma-create-design-system-rules` | Generate reusable code-generation rules for a project. |
+| `figma-use-slides` | Foundational Slides write workflow for decks, sections, themes, and speaker notes. |
+| `figma-swiftui` | Translate between Figma designs and SwiftUI in both directions. |
+| `figma-code-connect` | Map published Figma components to code implementations. |
+| `figma-create-new-file` | Create blank Design, FigJam, or Slides files before writing. |
+| `figma-generate-diagram` | Create editable FigJam diagrams from descriptions or source material. |
 | `figma-generate-library` | Example workflow for creating or syncing a Figma design-system library from code. |
 | `figma-generate-design` | Example workflow for building screens/views in Figma from code or a design-system-aware brief. |
 
@@ -133,9 +135,6 @@ claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp
 # Cursor plugin setup
 /add-plugin figma
 
-# Gemini CLI
-# Follow the Figma MCP catalog/client instructions for the Gemini CLI extension.
-
 # Verify catalog integrity in this repository
 npm run catalog:check
 ```

package/catalog/skills/figma-mcp-0to1/agents/canvas-creation-playbook.md

@@ -7,7 +7,7 @@ Deliver a first successful Figma canvas result with low risk and clear verificat
 ## Safe 0-to-1 Workflow
 
 1. **Create or choose file context**
-- New file path: run `whoami` if needed to obtain a plan/team context, then call `create_new_file`.
+- New file path: run `whoami` if needed to confirm identity, then call `create_new_file` for Design, FigJam, or Slides; choose a team or organization if prompted.
 - Existing file path: confirm URL/node target and permissions.
 - Live web UI path: use `generate_figma_design` to capture to a new file, existing file, or clipboard.
 - Make path: use MCP resources from a Figma Make link to fetch project/file context before implementation.
@@ -17,7 +17,7 @@ Deliver a first successful Figma canvas result with low risk and clear verificat
 - If access mismatch appears, stop and fix permissions first.
 
 3. **Read before write**
-- Use `get_libraries` if the Codex Figma plugin exposes it and library scope matters.
+- Use `get_libraries` when library scope matters.
 - Call `search_design_system` to reuse components/variables.
 - Optionally call `get_metadata` for structure baseline.
 
@@ -28,6 +28,7 @@ Deliver a first successful Figma canvas result with low risk and clear verificat
 - Apply one style/token decision.
 - For Figma Design, load or invoke `figma-use` when available.
 - For FigJam, load or invoke `figma-use-figjam` when available, then create or update one small board object such as a sticky, section, connector, shape, table, or code block.
+- For Slides, load or invoke `figma-use-slides` when available, then create or update one slide, section, theme decision, or speaker-note block.
 
 5. **Validate state**
 - Inspect with `get_metadata` or `get_screenshot`.
@@ -51,6 +52,18 @@ Deliver a first successful Figma canvas result with low risk and clear verificat
 2. Use `figma-use-figjam` with `use_figma` for small write steps.
 3. Validate with `get_figjam` or `get_screenshot`.
 
+### Slides deck-first flow
+
+1. Create or choose a Slides file, using `create_new_file` with the Slides editor type for a fresh deck.
+2. Use `figma-use-slides` with `use_figma` for small write steps.
+3. Validate the deck or selected slide with `get_screenshot`.
+
+### Asset-transfer flow
+
+1. Use `download_assets` with the smallest relevant node set; choose raw mode for original source images.
+2. Fetch the returned temporary URLs before they expire.
+3. Deliver the files, or pass them to `upload_assets` to transfer images into another Figma file.
+
 ### Code-to-canvas flow
 
 1. Ask client to start local app capture workflow.

package/catalog/skills/figma-mcp-0to1/agents/install-auth.md

@@ -8,7 +8,7 @@ Get Figma MCP connected and authenticated, with a verified first tool call.
 
 | Mode | Endpoint | Recommended | Notes |
 | --- | --- | --- | --- |
-| Remote | `https://mcp.figma.com/mcp` | Yes | Broadest feature coverage, including write-to-canvas, code-to-canvas, FigJam workflows, diagrams, and file creation. Remote access is documented for all seats/plans, with plan/seat-based limits. |
+| Remote | `https://mcp.figma.com/mcp` | Yes | Broadest feature coverage, including Design, FigJam, Slides, asset transfer, write-to-canvas, code-to-canvas, diagrams, and file creation. Remote access is documented for all seats/plans, with plan/seat-based limits. |
 | Desktop | `http://127.0.0.1:3845/mcp` | Only for local selection-based or special org/enterprise needs | Requires Figma desktop app + Dev Mode desktop MCP toggle; narrower workflow coverage and paid Dev/Full seat access. |
 
 ## Codex Setup
@@ -36,9 +36,9 @@ Use concrete setup paths for agents that are both Figma-supported and skilly-han
 - Claude Code manual desktop: `claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp`
 - Cursor plugin: `/add-plugin figma`
 - Cursor manual: add the remote or desktop endpoint in MCP settings.
-- Copilot: use the VS Code MCP route and enable GitHub Copilot in the client.
-- Gemini CLI: follow the Figma MCP catalog/client instructions for the Gemini CLI extension.
+- Copilot CLI: follow its current Figma MCP Catalog setup path and verify the requested feature is exposed.
 - VS Code: add HTTP MCP server in `mcp.json` using the remote endpoint.
+- Xcode: use Figma's one-click setup; current docs require Xcode 27 beta.
 
 See exact snippets in [../assets/client-config-snippets.md](../assets/client-config-snippets.md).
 
@@ -46,9 +46,9 @@ See exact snippets in [../assets/client-config-snippets.md](../assets/client-con
 
 | Coverage | Agents or Clients | Guidance |
 | --- | --- | --- |
-| Figma-supported and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot`, `gemini` | Use the commands and setup paths above where documented; otherwise follow the Figma MCP catalog/client docs. |
-| Figma-supported but not skilly-hand-native | Amazon Q, Android Studio, VS Code, Warp, Augment, Factory, Firebender, Kiro, OpenHands, Replit | Follow Figma/client setup docs; do not assume skilly-hand skill install paths. |
-| skilly-hand-supported but not source-backed in current Figma docs | `antigravity`, `windsurf`, `trae` | Keep install support, but verify Figma MCP setup through that client's docs or manual MCP config. |
+| Figma-documented and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot` | Use documented setup paths; verify that the requested feature is supported by the active client. |
+| Figma-documented but not skilly-hand-native | VS Code, Xcode, Claude Desktop, Warp, Augment, Factory, Firebender | Follow Figma/client setup docs; do not assume skilly-hand skill install paths. |
+| skilly-hand-supported but not source-backed in current Figma docs | `gemini`, `antigravity`, `windsurf`, `trae` | Verify inclusion in the Figma MCP Catalog or current client docs before setup. |
 
 ## Verification Checklist
 
@@ -57,8 +57,8 @@ See exact snippets in [../assets/client-config-snippets.md](../assets/client-con
 - Remote: `whoami` (recommended)
 - Desktop-only contexts: `get_metadata` or `get_design_context` on a known node
 3. Confirm the authenticated user has access to the target Figma file.
-4. For write workflows, confirm the authenticated seat can edit the target file.
-5. For Dev seats, confirm the target is a draft or that the workflow does not require edit access outside drafts.
+4. For `use_figma` write workflows, confirm the authenticated user has a Full seat and edit access to the target file.
+5. For code-to-canvas, any seat can create or edit files in drafts; editing an existing file outside drafts requires a Full seat and edit permission.
 
 ## First Prompt After Setup
 

package/catalog/skills/figma-mcp-0to1/agents/tool-function-catalog.md

@@ -7,7 +7,7 @@ Pick the smallest correct Figma MCP function for the task, with predictable inpu
 ## Start Here
 
 1. Read [../references/official-tools-matrix.md](../references/official-tools-matrix.md).
-2. Identify whether task is read, write, FigJam, design-system search, code-connect, diagram, live UI capture, or Make resource context.
+2. Identify whether task is read, write, asset transfer, Slides, FigJam, design-system search, Code Connect, diagram, live UI capture, or Make resource context.
 3. Prefer read-first calls before write calls on unknown files.
 
 ## Selection Rules
@@ -17,27 +17,33 @@ Pick the smallest correct Figma MCP function for the task, with predictable inpu
 - Output too large or structure-first pass: `get_metadata` first, then targeted `get_design_context`.
 - Need variables/tokens only: `get_variable_defs`.
 - Need visual reference: `get_screenshot`.
+- Need deliverable exports, original images, or multi-node/non-PNG output: `download_assets`.
+- Need to place image assets in a Figma file or transfer images across files: `upload_assets` (use with `download_assets` for cross-file transfer).
 - Need FigJam extraction: `get_figjam`.
 - Need FigJam creation/editing: `use_figma` with the `figma-use-figjam` skill when available.
-- Need library discovery in Codex before a scoped search: `get_libraries` if the Codex Figma plugin exposes it.
+- Need library discovery before a scoped search: `get_libraries`.
 - Need design-system discovery before creating: `search_design_system`.
 - Need to write/create/update Figma Design content: `use_figma` (remote write workflow; use `figma-use` skill when available).
 - Need to write/create/update FigJam content: `use_figma` (remote write workflow; use `figma-use-figjam` skill when available).
+- Need to write/create/update Slides content: `use_figma` (remote write workflow; use `figma-use-slides` skill when available).
 - Need first-time live web UI capture: `generate_figma_design`.
-- Need new blank file: `create_new_file` (requires plan/team context such as `planKey` in some clients).
+- Need new blank Design, FigJam, or Slides file: `create_new_file` (the user may need to choose a team or organization).
 - Need Mermaid-to-FigJam: `generate_diagram` (creates its own FigJam file unless an existing FigJam file key is provided).
-- Need code-connect lookup/update: `get_code_connect_map`, `add_code_connect_map`, suggestion/confirm functions.
+- Need Code Connect lookup/update: `get_code_connect_map`, `add_code_connect_map`, suggestion/confirm functions; let the `figma-code-connect` skill invoke `get_context_for_code_connect` when generating templates.
 
 ## Prompting Pattern
 
 Use direct tool-trigger language when selection is ambiguous:
 
 - "Use Figma MCP `get_metadata` first, then `get_design_context` only for the selected child nodes."
-- "Use `get_libraries` if available, then use Figma MCP `search_design_system` for the selected library."
+- "Use Figma MCP `get_libraries`, then `search_design_system` for the selected library."
+- "Use Figma MCP `download_assets` to deliver SVG exports for these nodes."
+- "Transfer these images to the target file using `download_assets` raw mode, then `upload_assets`."
 - "Use Figma MCP `search_design_system` before creating any new component."
 - "Use Figma MCP `generate_figma_design` to capture this live web UI to a new Figma file."
 - "Use Figma MCP `create_new_file`, then `use_figma` to add a first frame and typography style."
 - "Use `figma-use-figjam` with `use_figma` to organize this FigJam board into sections and connectors."
+- "Use `figma-use-slides` with `use_figma` to build this kickoff deck and add speaker notes."
 - "Use MCP resources from this Figma Make link and fetch only the files needed for implementation."
 
 ## Remote/Desktop Caveats

package/catalog/skills/figma-mcp-0to1/agents/troubleshooting-ops.md

@@ -33,7 +33,7 @@ Failure observed?
 1. Validate Figma URL format and node id.
 2. Run `whoami` to verify authenticated account.
 3. Confirm authenticated user belongs to correct plan and has file access.
-4. For write-to-canvas, confirm the user has edit access; Dev seats are read-only outside drafts.
+4. For `use_figma`, confirm the user has a Full seat and edit access; current write-to-canvas docs describe Dev seats as read-only.
 
 ### Rate limiting
 
@@ -42,7 +42,8 @@ Failure observed?
 - Dev/Full seats on Professional or Organization plans have higher daily usage.
 - Enterprise Dev/Full seats have the highest documented daily usage.
 - Officially documented exempt tools include `add_code_connect_map`, `generate_figma_design`, and `whoami`.
-- `use_figma` write tools may be documented outside standard read limits, but still require correct seat and edit permissions.
+- Professional Dev/Full seats allow up to 10 read calls per minute, Organization 15, and Enterprise 20.
+- Write tools are exempt from read rate limits, but still require correct seat and edit permissions.
 - Use smaller selections and fewer repeated reads.
 - Prefer `get_metadata` preflight before broad `get_design_context`.
 - Batch intent into fewer, targeted calls.
@@ -50,7 +51,7 @@ Failure observed?
 ### Missing expected tools
 
 - Official Figma MCP tools may not be exposed by every client plugin surface.
-- Client-specific helpers, such as Codex `get_libraries`, are not official substitutes for every client.
+- Official tools may still be absent from a particular client surface; verify the active tool list before choosing a fallback.
 - Prefer a documented fallback rather than forcing an unavailable tool.
 
 ### Write step errors
@@ -58,7 +59,9 @@ Failure observed?
 - Do not immediately retry the exact same large request.
 - Split into smaller write actions.
 - Verify partial outcomes using read tools before next step.
-- For `create_new_file`, ensure a plan/team context is available.
+- For `create_new_file`, handle the team or organization choice when the account belongs to multiple plans.
+- For Slides writes, use `figma-use-slides` rather than Design or FigJam assumptions.
+- `use_figma` currently has no image/video asset support; use `upload_assets` for supported image uploads instead.
 - For `generate_diagram`, do not pre-create a blank FigJam file unless adding to an existing file is the explicit goal.
 - For FigJam writes, use `figma-use-figjam` guidance where available instead of generic Figma Design assumptions.
 
@@ -66,6 +69,7 @@ Failure observed?
 
 - Figma-hosted image URLs returned by MCP can expire.
 - Refresh the design context to get new URLs, or download/save assets into the project and reference local files for durable implementation.
+- URLs returned by `download_assets` are also temporary; fetch them promptly before delivery or `upload_assets` transfer.
 
 ## Scoped Retry Pattern
 

package/catalog/skills/figma-mcp-0to1/assets/client-config-snippets.md

@@ -90,10 +90,6 @@ claude mcp list
 /add-plugin figma
 ```
 
-## Gemini CLI
-
-Use the Figma MCP catalog/client instructions for the Gemini CLI extension. Figma currently lists Gemini CLI as a supported client for remote and desktop setup.
-
 ## Cursor MCP config (desktop)
 
 ```json
@@ -120,7 +116,6 @@ Use the Figma MCP catalog/client instructions for the Gemini CLI extension. Figm
 
 ## Agent Coverage Notes
 
-- Figma-supported and skilly-hand-supported: `codex`, `claude`, `cursor`, `copilot`.
-- Figma-supported and skilly-hand-supported via client docs/catalog: `gemini`.
-- Figma-supported but not skilly-hand-native: Amazon Q, Android Studio, VS Code, Warp, Augment, Factory, Firebender, Kiro, OpenHands, Replit.
-- skilly-hand-supported but not source-backed in current Figma docs: `antigravity`, `windsurf`, `trae`.
+- Figma-documented and skilly-hand-supported: `codex`, `claude`, `cursor`, `copilot`.
+- Figma-documented but not skilly-hand-native: VS Code, Xcode, Claude Desktop, Warp, Augment, Factory, Firebender.
+- skilly-hand-supported but not source-backed in current Figma docs: `gemini`, `antigravity`, `windsurf`, `trae`.

package/catalog/skills/figma-mcp-0to1/assets/prompt-recipes.md

@@ -17,13 +17,19 @@
 
 ## Design-System and Code Connect
 
-- "Use `get_libraries` if available, then search only the relevant design libraries."
+- "Use `get_libraries`, then search only the relevant design libraries."
 - "Use `search_design_system` to find an existing card and button component before creating anything new."
 - "Use `search_design_system` to find primary color, typography, and spacing variables."
 - "Use `get_code_connect_map` for this node and show mapped source locations."
 - "Use `add_code_connect_map` to map this Figma node to my component path."
 - "Use `get_code_connect_suggestions`, then confirm mappings with `send_code_connect_mappings` if the suggestions are correct."
-- "Use `figma-create-design-system-rules` to generate project rules before implementing designs from Figma."
+- "Use the `figma-code-connect` skill to inspect and connect these published components."
+
+## Asset Transfer
+
+- "Use `download_assets` to export these nodes as SVG and PDF deliverables."
+- "Use `download_assets` raw mode to retrieve the original uploaded images."
+- "Copy the images from this file into the target file using `download_assets` followed by `upload_assets`."
 
 ## First Canvas Creation
 
@@ -49,13 +55,21 @@
 - "Use `figma-use-figjam` with `use_figma` to organize this FigJam board into sections with stickies and connectors."
 - "Use `use_figma` to update this architecture diagram with a new service."
 
+## Figma Slides
+
+- "Use `create_new_file` to create a Figma Slides deck named 'Q3 Review'."
+- "Use `figma-use-slides` with `use_figma` to build a five-slide kickoff deck with speaker notes."
+- "Use `get_screenshot` to verify the title slide and agenda slide."
+
 ## Figma Skills
 
 - "Use `figma-use` for this Figma Design write-to-canvas task."
 - "Use `figma-use-figjam` for this FigJam board update."
+- "Use `figma-use-slides` for this Figma Slides deck update."
+- "Use `figma-swiftui` to implement this design in SwiftUI or push these SwiftUI views into Figma."
+- "Use `figma-generate-diagram` to turn this architecture description into an editable FigJam diagram."
 - "Use `figma-generate-design` to build this app screen in Figma using the connected design system."
 - "Use `figma-generate-library` to create or sync a Figma design-system library from this codebase."
-- "Use `figma-implement-design` to turn this Figma frame URL into production code."
 
 ## Agent Coverage
 
@@ -67,5 +81,6 @@
 - "I got a permission error. Use `whoami` and tell me what to check next."
 - "I am rate-limited. Switch to a staged workflow with fewer `get_design_context` calls."
 - "This client does not expose `get_screenshot`. Choose the closest supported verification path."
-- "My `create_new_file` call failed. Check whether a plan key or team context is missing."
+- "My `create_new_file` call failed. Check whether I need to choose a team or organization."
 - "Images from the MCP response expired. Refresh the design context or save the assets locally."
+- "The `download_assets` URLs expired. Run the scoped export again and fetch the returned URLs immediately."

package/catalog/skills/figma-mcp-0to1/manifest.json

@@ -10,10 +10,10 @@
   "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
-    "last-edit": "2026-05-09",
+    "last-edit": "2026-06-20",
     "license": "Apache-2.0",
-    "version": "1.0.3",
-    "changelog": "Updated Figma MCP guidance for current remote-first docs, supported-client coverage, Figma-provided skills, FigJam write workflows, code-to-canvas support, and access/rate-limit language; affects setup routing, tool selection, prompt assets, and official matrix",
+    "version": "1.1.0",
+    "changelog": "Synced the official Figma MCP surface for asset transfer, Code Connect context, library discovery, Figma Slides, current Figma-provided skills, and per-minute limits; affects tool routing, canvas workflows, prompts, troubleshooting, and the official matrix",
     "auto-invoke": "Installing, configuring, or using Figma MCP from setup through first canvas creation",
     "allowed-modes": [
       "install-auth",

package/catalog/skills/figma-mcp-0to1/references/official-tools-matrix.md

@@ -1,27 +1,30 @@
-# Official Figma MCP Tools Matrix (As of 2026-05-09)
+# Official Figma MCP Tools Matrix (As of 2026-06-20)
 
-This matrix tracks the official Figma MCP tool/function set in current Figma documentation. Treat it as the source of truth for official tool names, supported file types, and remote-only status. Client-specific helpers are listed separately.
+This matrix tracks the official Figma MCP tool/function set in current Figma documentation. Treat it as the source of truth for official tool names, supported file types, and remote-only status.
 
 ## Coverage Matrix
 
 | Tool | Primary Purpose | Typical Input | Supported File Types | Availability Notes |
 | --- | --- | --- | --- | --- |
+| `download_assets` | Download rendered exports and original source images | Up to 20 node IDs and optional export settings | Figma Design, FigJam, Figma Slides | Remote-only; returns temporary URLs; use for delivery, non-PNG formats, full-resolution exports, or cross-file transfer. |
+| `upload_assets` | Upload supported image assets to a file or node | PNG, JPG, GIF, or WebP URLs/files | Figma Design, FigJam, Figma Slides | Remote-only; maximum 10 MB per asset; uploads to a node fill or creates image-filled frames. |
 | `generate_figma_design` | Generate editable design layers from live web UI | URL/local app capture context | Figma Design output | Remote-only; select clients only; can output to new file, existing file, or clipboard; exempt from standard read limits. |
 | `get_design_context` | Fetch rich design context for implementation | Figma URL or `fileKey` + `nodeId` | Figma Design, Figma Make | Read tool; remote server requires link-based node targeting; desktop can use selection-based prompts. |
 | `get_variable_defs` | Retrieve variable/token definitions | `fileKey` + `nodeId` | Figma Design | Best for token-only extraction. |
 | `get_code_connect_map` | Read existing Code Connect mappings | `fileKey` + `nodeId` | Figma Design | Use to inspect mapping before updates. |
 | `add_code_connect_map` | Add mapping from node to code component | `fileKey`, `nodeId`, source details | Figma Design | Write-style utility; exempt from read rate limits in docs. |
-| `get_screenshot` | Render node screenshot for visual verification | `fileKey` + `nodeId` | Figma Design, FigJam | Useful verification after write steps and for preserving visual fidelity. |
-| `create_design_system_rules` | Generate design-system rules prompt/scaffold | Framework/language context | No file context required | Use to enforce repeatable design-system workflows. |
+| `get_context_for_code_connect` | Fetch component metadata for Code Connect template generation | Figma component context | Figma Design | Remote-only; prompted by Figma and intended for the `figma-code-connect` skill, not direct user invocation. |
+| `get_screenshot` | Render node screenshot for visual verification | `fileKey` + `nodeId` | Figma Design, FigJam, Figma Slides | Use for visual inspection; prefer `download_assets` for delivery, multiple nodes, other formats, or original images. |
 | `get_metadata` | Sparse XML structure (ids, names, hierarchy, bounds) | Selection or `fileKey` + `nodeId` | Figma Design | Preferred preflight for large contexts. |
 | `get_figjam` | Fetch FigJam metadata (and node visuals) | `fileKey` + `nodeId` | FigJam | FigJam-specific extraction. |
 | `generate_diagram` | Create FigJam diagram from Mermaid or natural language intent | Diagram description or Mermaid syntax | No file context required | Remote-only; supports flowchart, gantt, state, sequence, architecture, and ERD workflows. |
 | `whoami` | Show authenticated Figma identity, plans, and seat types | None | No file context required | Remote-only in official docs; exempt from read rate limits. |
 | `get_code_connect_suggestions` | Suggest candidate node-to-code mappings | File context + repo context | Figma Design | Usually part of Code Connect workflows. |
 | `send_code_connect_mappings` | Confirm/persist mapping suggestions | Suggestions payload | Figma Design | Follow-up action after suggestion generation. |
-| `use_figma` | General-purpose write/edit/delete/inspect via Plugin API workflow | Task instructions and file context | Figma Design, FigJam | Remote-only; default direct write/update path; use `figma-use` for Figma Design and `figma-use-figjam` for FigJam when available. |
+| `get_libraries` | List subscribed and available design libraries | Figma file context | Figma Design | Remote-only; use with `search_design_system` for scoped reuse. |
+| `use_figma` | General-purpose write/edit/delete/inspect via Plugin API workflow | Task instructions and file context | Figma Design, FigJam, Figma Slides | Remote-only; pair with `figma-use`, `figma-use-figjam`, or `figma-use-slides` for the active editor. |
 | `search_design_system` | Search libraries for components, variables, styles | Query text and optional type narrowing | Figma Design | Remote-only; use before creating new artifacts when design-system reuse is relevant. |
-| `create_new_file` | Create new blank Design or FigJam file | File name, file type, plan context | No file context required | Remote-only; creates files in drafts or a project; requires plan/team context in some clients. |
+| `create_new_file` | Create new blank Design, FigJam, or Slides file | File name, file type, plan context | No file context required | Remote-only; creates files in drafts and may ask which team or organization to use. |
 
 ## Figma Make Resources
 
@@ -35,30 +38,23 @@ Figma documents these skills as the preferred guidance layer for common MCP work
 | --- | --- |
 | `figma-use` | Foundational Figma Design write-to-canvas workflow. |
 | `figma-use-figjam` | Foundational FigJam write workflow. |
-| `figma-code-connect-components` | Connect published Figma components to code implementations. |
-| `figma-create-design-system-rules` | Generate project rules for design-to-code workflows. |
-| `figma-create-new-file` | Create blank Design or FigJam files. |
-| `figma-implement-design` | Translate a Figma design URL into production code. |
+| `figma-use-slides` | Foundational Figma Slides write workflow. |
+| `figma-swiftui` | Translate between Figma designs and SwiftUI in both directions. |
+| `figma-code-connect` | Connect published Figma components to code implementations. |
+| `figma-create-new-file` | Create blank Design, FigJam, or Slides files. |
+| `figma-generate-diagram` | Generate editable FigJam diagrams from descriptions or source material. |
 | `figma-generate-library` | Example workflow for generating or syncing a design-system library. |
 | `figma-generate-design` | Example workflow for building screens/views from a design system. |
 
-## Codex Plugin Helpers
-
-The Codex Figma plugin may expose helper tools beyond the current official tools page. Keep these documented as client-specific helpers:
-
-| Helper | Purpose | Notes |
-| --- | --- | --- |
-| `get_libraries` | List libraries associated with a Figma file | Use before scoped `search_design_system`; not listed on the official Figma tools page as of this matrix date. |
-
 Some official Figma MCP tools may not be exposed by every client plugin surface. Prefer the active client's tool list over assumptions when executing.
 
 ## Client and Agent Coverage
 
 | Coverage | Agents or Clients | Guidance |
 | --- | --- | --- |
-| Figma-supported and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot`, `gemini` | Include concrete setup paths where documented; otherwise point to the Figma MCP catalog/client docs. |
-| Figma-supported but not skilly-hand-native | Amazon Q, Android Studio, VS Code, Warp, Augment, Factory, Firebender, Kiro, OpenHands, Replit | Mention as Figma-supported clients; do not add skilly-hand install assumptions. |
-| skilly-hand-supported but not source-backed in current Figma docs | `antigravity`, `windsurf`, `trae` | Keep broad install support; advise manual MCP/client docs for Figma-specific setup. |
+| Figma-documented and skilly-hand-supported | `codex`, `claude`, `cursor`, `copilot` | Use published setup paths; Copilot is currently listed for Copilot CLI write-to-canvas. |
+| Figma-documented but not skilly-hand-native | VS Code, Xcode, Claude Desktop, Warp, Augment, Factory, Firebender | Mention only for workflows where Figma lists them; do not add skilly-hand install assumptions. |
+| skilly-hand-supported but not source-backed in current Figma docs | `gemini`, `antigravity`, `windsurf`, `trae` | Verify the Figma MCP Catalog or current client docs before recommending setup. |
 
 ## Rate-Limit Notes (Official)
 
@@ -66,9 +62,11 @@ Some official Figma MCP tools may not be exposed by every client plugin surface.
 - Remote server access is documented for all seats/plans, but practical usage is governed by seat/plan limits.
 - Desktop server access is documented for Dev or Full seats on paid plans.
 - Starter plan or View/Collab seats: up to 6 tool calls per month.
-- Professional or Organization with Dev/Full seat: up to 200 tool calls per day.
-- Enterprise with Dev/Full seat: up to 600 tool calls per day.
-- Dev seats only have read-only access outside drafts for write-to-canvas workflows.
+- Professional with Dev/Full seat: up to 200 tool calls per day and 10 per minute.
+- Organization with Dev/Full seat: up to 200 tool calls per day and 15 per minute.
+- Enterprise with Dev/Full seat: up to 600 tool calls per day and 20 per minute.
+- Current write-to-canvas docs require a Full seat for `use_figma`; Dev seats are described as read-only.
+- Code-to-canvas can create or edit draft files with any seat; existing files outside drafts require a Full seat and edit permission.
 - Officially documented exempt tools include:
 - `add_code_connect_map`
 - `generate_figma_design`
@@ -78,12 +76,13 @@ Some official Figma MCP tools may not be exposed by every client plugin surface.
 
 1. Start with `whoami` when authentication or permissions are uncertain.
 2. Use `get_metadata` before `get_design_context` for large files.
-3. Use `get_libraries` where available, then `search_design_system` for scoped design-system reuse.
+3. Use `get_libraries`, then `search_design_system` for scoped design-system reuse.
 4. Use `generate_figma_design` for first-time live web UI capture.
-5. Use `use_figma` for direct Figma Design or FigJam writes and updates.
+5. Use `use_figma` for direct Figma Design, FigJam, or Slides writes and updates.
 6. Keep `use_figma` calls small and validate after each step.
 7. Use `get_screenshot` as final visual verification after edits when available.
-8. Use `figma-use-figjam` rather than Figma Design assumptions for FigJam board edits.
+8. Use the editor-specific skill for writes: `figma-use`, `figma-use-figjam`, or `figma-use-slides`.
+9. Use `download_assets` and `upload_assets` for asset delivery or cross-file image transfer; returned download URLs are temporary.
 
 ## Sources
 
@@ -94,6 +93,6 @@ Some official Figma MCP tools may not be exposed by every client plugin surface.
 - https://developers.figma.com/docs/figma-mcp-server/write-to-canvas/
 - https://developers.figma.com/docs/figma-mcp-server/code-to-canvas/
 - https://developers.figma.com/docs/figma-mcp-server/bringing-make-context-to-your-agent/
-- https://developers.figma.com/docs/figma-mcp-server/plans-access-and-permissions/
+- https://developers.figma.com/docs/figma-mcp-server/rate-limits-access/
 - https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server
 - https://help.figma.com/hc/en-us/articles/39166810751895-Figma-skills-for-MCP

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/skilly-hand",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "repository": {

package/packages/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/catalog",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "private": true,
   "type": "module"
 }

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/cli",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "private": true,
   "type": "module",
   "bin": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/core",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "private": true,
   "type": "module"
 }

package/packages/detectors/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/detectors",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "private": true,
   "type": "module"
 }