feat: add figma-design-audit skill

[sen019]

Summary

Figma-design-audit skill that audits a Figma design against the file's design system and posts inline comments on every violation found

Checks four categories:

• Color variables (fills/strokes not bound to a design system variable)
• Font styles (text not linked to a named text style)
• Numeric variables (padding, gap, and corner radius values not bound to numeric variables)
• Unnecessary nesting (single-child wrappers, pass-through groups, empty containers)

Uses the Figma MCP server (get_variable_defs, get_design_context) to fetch the design system, then posts comments via the Figma REST API with violations

Test plan

• Connect the Figma MCP server and run /figma-design-audit on a design that has known violations — confirm comments appear on the correct design element in Figma
• Run on a fully compliant design — confirm the summary reports zero violations and no comments are posted

Demo Video

https://drive.google.com/file/d/1kzB0FqlwjJY6TJGJj97rCW1FqI9xzbTr/view?usp=sharing

[github-actions]

Skill Evaluator — Tier 1 Results

✅ All checks passed

skills/figma-design-audit

Using CPython 3.11.15 interpreter at: /opt/hostedtoolcache/Python/3.11.15/x64/bin/python3
Creating virtual environment at: .venv
Downloading tiktoken (1.1MiB)
 Downloaded tiktoken
Installed 8 packages in 4ms
=== Skill Evaluation Report ===
Skill: figma-design-audit

--- Tier 1: Deterministic Checks ---
[PASS] SKILL.md exists
[PASS] kebab-case directory
[PASS] YAML frontmatter
[PASS] metadata.json
[PASS] length/efficiency — 2200 tokens. Instruction/code ratio: 5.6.
[PASS] prerequisites — No heavy external prerequisites detected.
[PASS] security patterns — External domains (2): api.figma.com, figma.com | No security section found.

--- Summary ---
Tier 1: 7/7 passed

[vishwasnavadak]

1. update https://github.com/antstackio/skills/blob/main/README.md with the updated list that includes this skill as well and this could also be published to figma plugin ecosystem

[sen019]

@vishwasnavadak I have updated the changes