When to use
ALWAYS read this skill BEFORE calling figma_execute! This skill contains the correct API syntax, parameter formats, and examples that you MUST follow. Failure to read this will result in syntax errors.
Use this skill whenever you are working with figma-pilot MCP tools to create or modify Figma designs.
Code Execution Mode
figma-pilot uses a code execution mode for maximum efficiency. Instead of 15+ individual tools, you use figma_execute to run JavaScript code with access to all Figma APIs.
Available Tools
| Tool |
Description |
figma_status |
Check connection to Figma plugin (call first) |
figma_execute |
Execute JavaScript with all Figma APIs |
figma_get_api_docs |
Get detailed API documentation |
Quick Example
// figma_execute
// Create a card and modify selection
await figma.create({
type: 'card',
name: 'Welcome Card',
children: [
{ type: 'text', content: 'Hello!', fontSize: 24 }
]
});
const { nodes } = await figma.query({ target: 'selection' });
for (const node of nodes) {
await figma.modify({ target: node.id, fill: '#0066FF' });
}
console.log(`Modified ${nodes.length} elements`);
Benefits
- 90%+ fewer tokens - 3 tools instead of 15+
- Batch operations - Modify many elements in one call
- Data filtering - Filter results before returning to context
- Complex workflows - Loops, conditionals, error handling
API Reference
Read individual rule files for detailed API documentation:
Getting Started
- rules/quick-start.md - Quick start guide and setup requirements
- rules/workflow.md - Recommended agent workflow and operator rules
Core APIs
- rules/status.md -
figma.status() - Check connection
- rules/query.md -
figma.query() - Query elements by ID, name, or selection
Creating Elements
- rules/create.md -
figma.create() - Create elements (frames, text, shapes, semantic types)
- rules/layout.md - Auto-layout configuration and patterns
Modifying Elements
- rules/modify.md -
figma.modify(), figma.delete(), figma.append()
Styling
- rules/effects.md - Shadows, blur, and visual effects
- rules/gradients.md - Gradient fills (linear, radial, angular)
- rules/corner-radius.md - Independent corner radius
- rules/strokes.md - Stroke styling (dash patterns, caps, alignment)
- rules/transforms.md - Rotation and blend modes
- rules/constraints.md - Responsive constraints and min/max sizes
Text
- rules/text.md - Text elements, wrapping, and sizing
- rules/fonts.md - Loading and using custom fonts
Components
- rules/components.md -
figma.listComponents(), figma.instantiate(), figma.toComponent(), figma.createVariants()
Accessibility
- rules/accessibility.md -
figma.accessibility() - WCAG compliance checking and auto-fixing
Design Tokens
- rules/tokens.md -
figma.createToken(), figma.bindToken(), figma.syncTokens()
Export
- rules/export.md -
figma.export() - Export as PNG, SVG, PDF, JPG
Common Patterns
- rules/patterns.md - Cards, navigation bars, page layouts
Reference
- rules/target-specifiers.md - How to target elements (ID, selection, name)
1---2name: figma-pilot3description: REQUIRED reading before using figma_execute. Contains API syntax, parameter formats, and examples. READ rules/*.md files for correct usage.4---56## When to use78**ALWAYS read this skill BEFORE calling figma_execute!** This skill contains the correct API syntax, parameter formats, and examples that you MUST follow. Failure to read this will result in syntax errors.910Use this skill whenever you are working with figma-pilot MCP tools to create or modify Figma designs.1112## Code Execution Mode1314figma-pilot uses a **code execution mode** for maximum efficiency. Instead of 15+ individual tools, you use `figma_execute` to run JavaScript code with access to all Figma APIs.1516### Available Tools1718| Tool | Description |19|------|-------------|20| `figma_status` | Check connection to Figma plugin (call first) |21| `figma_execute` | Execute JavaScript with all Figma APIs |22| `figma_get_api_docs` | Get detailed API documentation |2324### Quick Example2526```javascript27// figma_execute28// Create a card and modify selection29await figma.create({30 type: 'card',31 name: 'Welcome Card',32 children: [33 { type: 'text', content: 'Hello!', fontSize: 24 }34 ]35});3637const { nodes } = await figma.query({ target: 'selection' });38for (const node of nodes) {39 await figma.modify({ target: node.id, fill: '#0066FF' });40}41console.log(`Modified ${nodes.length} elements`);42```4344### Benefits4546- **90%+ fewer tokens** - 3 tools instead of 15+47- **Batch operations** - Modify many elements in one call48- **Data filtering** - Filter results before returning to context49- **Complex workflows** - Loops, conditionals, error handling5051## API Reference5253Read individual rule files for detailed API documentation:5455### Getting Started56- [rules/quick-start.md](rules/quick-start.md) - Quick start guide and setup requirements57- [rules/workflow.md](rules/workflow.md) - Recommended agent workflow and operator rules5859### Core APIs60- [rules/status.md](rules/status.md) - `figma.status()` - Check connection61- [rules/query.md](rules/query.md) - `figma.query()` - Query elements by ID, name, or selection6263### Creating Elements64- [rules/create.md](rules/create.md) - `figma.create()` - Create elements (frames, text, shapes, semantic types)65- [rules/layout.md](rules/layout.md) - Auto-layout configuration and patterns6667### Modifying Elements68- [rules/modify.md](rules/modify.md) - `figma.modify()`, `figma.delete()`, `figma.append()`6970### Styling71- [rules/effects.md](rules/effects.md) - Shadows, blur, and visual effects72- [rules/gradients.md](rules/gradients.md) - Gradient fills (linear, radial, angular)73- [rules/corner-radius.md](rules/corner-radius.md) - Independent corner radius74- [rules/strokes.md](rules/strokes.md) - Stroke styling (dash patterns, caps, alignment)75- [rules/transforms.md](rules/transforms.md) - Rotation and blend modes76- [rules/constraints.md](rules/constraints.md) - Responsive constraints and min/max sizes7778### Text79- [rules/text.md](rules/text.md) - Text elements, wrapping, and sizing80- [rules/fonts.md](rules/fonts.md) - Loading and using custom fonts8182### Components83- [rules/components.md](rules/components.md) - `figma.listComponents()`, `figma.instantiate()`, `figma.toComponent()`, `figma.createVariants()`8485### Accessibility86- [rules/accessibility.md](rules/accessibility.md) - `figma.accessibility()` - WCAG compliance checking and auto-fixing8788### Design Tokens89- [rules/tokens.md](rules/tokens.md) - `figma.createToken()`, `figma.bindToken()`, `figma.syncTokens()`9091### Export92- [rules/export.md](rules/export.md) - `figma.export()` - Export as PNG, SVG, PDF, JPG9394### Common Patterns95- [rules/patterns.md](rules/patterns.md) - Cards, navigation bars, page layouts9697### Reference98- [rules/target-specifiers.md](rules/target-specifiers.md) - How to target elements (ID, selection, name)