---
spec_name: "Figma Agent Skills Generator"
description: "A spec for Claude to generate three distinct Figma Agent Skills (.md files) for an agency: a Brand Audit Skill, a UX Writing Linter Skill, and a Design Crit Prep Skill."
version: 1.0
---

## Context

You are an expert in design operations and AI-driven workflows. Your task is to generate the complete, copy-pasteable Markdown content for three separate Figma Agent Skills. Each skill should be self-contained and follow the structure of a name, a description, and a series of tasks for the Figma agent to execute.

The user will save each of these outputs as a separate `.md` file to publish to their Figma team library.

## Skill 1: Brand Audit Skill (`brand-audit.md`)

**Objective:** Create a skill that checks the current Figma page for compliance with the team's design system tokens.

**Instructions:** Generate the Markdown for this skill. It should perform three checks: color tokens, typography tokens, and spacing/grid rules. The output should be a new page in Figma with a summary report and comments on the non-compliant layers.

```markdown
# Brand Audit Skill

> This skill audits the current Figma page against our agency's core brand guidelines. It checks for compliance with color tokens, font tokens, and spacing rules. It will flag any layers that violate these rules and generate a summary report.

## Task 1: Color Token Compliance

- Scan all visible layers on the current page.
- Compare the fill and stroke colors of every shape and text layer against the published `[Brand] Color Tokens` library.
- Flag any layer using a hex code that is not a defined token.
- List the names of non-compliant layers.

## Task 2: Font Token Compliance

- Scan all text layers on the current page.
- Compare the font family, weight, and size against the published `[Brand] Typography Tokens` library.
- Flag any text layer that uses a font style not defined as a token.
- List the names of non-compliant layers and their incorrect font properties.

## Task 3: Spacing and Grid Compliance

- Check for elements positioned off the established 8px grid.
- Measure the padding and margin between major container elements.
- Flag any spacing that is not a multiple of 8px.
- List the names of misaligned layers.

## Output

- Generate a new page in the file named "Brand Audit Report - [Date]".
- On that page, create a simple list summarizing the findings from all tasks.
- For each non-compliant layer found, add a comment directly on that layer in the original page with details of the violation.
```

## Skill 2: UX Writing Linter (`ux-writing-check.md`)

**Objective:** Create a skill that reviews all text layers for common UX writing mistakes.

**Instructions:** Generate the Markdown for this skill. It should check for placeholder text (e.g., "Lorem Ipsum"), passive voice, and overly technical jargon. It should add comments to problematic text layers.

```markdown
# UX Writing Linter Skill

> This skill scans all text layers on the current page for common UX writing issues. It flags placeholder text, passive voice, and a list of forbidden jargon terms.

## Task 1: Find Placeholder Text
- Scan all text layers.
- Flag any layer containing "Lorem ipsum", "[Placeholder]", or similar default text.

## Task 2: Check for Passive Voice
- Analyze sentences in all text layers.
- Flag instances of passive voice construction (e.g., "The button was clicked by the user"). Suggest an active alternative.

## Task 3: Check for Jargon
- Compare text against a predefined list of forbidden terms: "utilize", "leverage", "synergy", "streamline", "robust".
- Flag any layer containing these terms.

## Output
- Do not create a new page.
- For every issue found, add a comment directly on the corresponding text layer with a description of the problem and a suggestion for improvement.
```

## Skill 3: Design Crit Prep (`design-crit-prep.md`)

**Objective:** Create a skill that prepares a Figma file for a design critique session.

**Instructions:** Generate the Markdown for this skill. It should create a new page, add standard frames for context (Goals, Non-Goals, Questions), and prompt the user to fill them in.

```markdown
# Design Crit Prep Skill

> This skill prepares the current file for a design critique. It creates a dedicated page with structured frames to guide the conversation and ensure the feedback session is productive.

## Task 1: Create Crit Page
- Create a new page at the top of the file named "Critique - [Date]".
- Navigate to the new page.

## Task 2: Add Context Frames
- Create three large text blocks with the following headings:
  - "1. Project Goals"
  - "2. What We're NOT Discussing"
  - "3. Specific Questions for the Team"

## Task 3: Add Placeholder Content
- Below each heading, add a placeholder text block prompting the designer to add their content. For example, under "1. Project Goals", add "[Add 1-2 sentences describing the user problem and business objective for this design.]"

## Output
- The final output is the populated "Critique" page, ready for the designer to fill in before the meeting.
```