figma-parity
Skill9 starsChanged todayMITView on GitHub
Compare the Rift DS Figma kit with the library and bring the kit back in step. Inventories both sides (components, variant properties, descriptions, variables and their values, page links, the node map), reports what is missing, out of date or only in Figma, then fixes the Figma side, since the code is the source of truth. Use when asked to check Figma parity, sync the Figma kit, or find what Figma is missing.
In this repository38 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accessibility-auditSkill
- animation-jump-checkSkill
- api-consistencySkill
- chat-qualitySkill
- checkpointSkill
- component-consistency-auditSkill
- component-doc-pageSkill
- content-auditSkill
- dependency-advisorySkill
- design-qaSkill
- dogfoodSkill
- drift-auditSkill
- figma-tokensSkill
- first-deploySkill
- landSkill
- link-rotSkill
- new-backgroundSkill
- new-componentSkill
- new-figma-componentSkill
- new-figma-templateSkill
- new-pageSkill
- new-presetSkill
- new-templateSkill
- new-tokenSkill
- new-validatorSkill
- parkSkill
- pre-deploySkill
- release-postSkill
- releaseSkill
- responsive-sweepSkill
- security-auditSkill
- seo-auditSkill
- shipSkill
- super-shipSkill
- token-auditSkill
- token-renameSkill
- visual-reviewSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 6 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Use when asked to check Figma parity, sync the kit, find what Figma is missing, or after a release that changed components or tokens.
- Distinctive: line 33
Write it to a JSON file in the scratchpad, so the Figma side can be diffed against it.
- Distinctive: line 41
Every finding goes in one of four buckets:
- Distinctive: line 55
Missing or drifted props: add or rename the variant property's options to match the schema, and update the sticker sheet so it still shows …
- Very specific: line 58
Node map: update website/src/data/figma-nodes.json for any frame that moved or was rebuilt, then run node scripts/validate-figma-nodes.mjs.
- Distinctive: line 61
If fixing Figma would mean changing the code (a prop the code should have, a token that looks wrong), do not touch the code.
- Distinctive: line 65
Run the step 2 inventory again and diff it once more: the Missing, Drifted and Convention buckets should be empty.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
figma-parity
Hold the Figma kit to the library. The code is the source of truth: this skill changes Figma and the node map, and never changes a component or a token to match Figma.
When invoked
Use when asked to check Figma parity, sync the kit, find what Figma is missing, or after a release that changed components or tokens. A clean pass is a valid outcome.
Before the first Figma call, do what the new-figma-component skill's "Before the first Figma call" section says (load figma-use, open a session on the kit, never write ids or URLs from memory). Its "The kit's conventions" section is the standard every fix here meets.
Instructions
1. Inventory the code
Read, never hand-copy:
- Components:
src/components/registry.jsonand the widgets insrc/chat/registry.json(name, label, slug, description). - Props: each
website/public/schema/components/<slug>.json, reduced to what a Figma set expresses: the enum props and their values, the boolean state props, the text props a set carries as text properties. - Tokens:
src/tokens/values.json, every semantic token's value per theme and mode, limited to the themes the kit carries as Theme modes and to the categories it binds (colour, radius, spacing, border, type, shadow). - Links:
SITE_URLandSTORYBOOK_URLinscripts/brand.mjs, and the Storybook ids in the deployed Storybook'sindex.json. - The node map:
website/src/data/figma-nodes.json.
Write it to a JSON file in the scratchpad, so the Figma side can be diffed against it.
2. Inventory the kit
One or more read-only use_figma scripts that return JSON, never a mutation: the page list and order; every component set with its page, name, description and variant property definitions; every variable in Theme and Mode with its value per mode; each component page's link-button targets (reaction and label hyperlink); and whether each node id in the map still exists and is the page's wrapper frame. Page through large results rather than one call that times out.
3. Diff and sort
Every finding goes in one of four buckets:
- Missing: a component, prop value, variable or page the code has and the kit lacks.
- Drifted: present in both but different. A variant property's options, a description that no longer matches the registry, a variable whose value differs from
values.jsonin some theme and mode, a link to the wrong URL, a node map entry pointing at a deleted or moved node, a page out of order. - Convention breaks: anything that fails the kit's conventions (a pinned Theme or Mode, a raw colour where a variable belongs, artboards repeated per theme, a text link where the recipe has buttons).
- Figma only: a component, variant or variable the code does not have. Never fix these by deleting: report them for the owner, since they may be work in progress.
Present the counts per bucket and the list before fixing. A fix that rebuilds or deletes anything the owner drew by hand waits for their yes; everything else proceeds.
4. Fix the Figma side
Work bucket by bucket, in small use_figma steps checked with get_screenshot:
- Missing components: build each through the
new-figma-componentskill's instructions, one at a time. - Missing or drifted props: add or rename the variant property's options to match the schema, and update the sticker sheet so it still shows every meaningful combination.
- Missing or drifted variables: hand them to the
figma-tokensskill, which owns how a variable is added, updated, renamed or removed in every mode. - Drifted descriptions and links: rewrite from the registry and the brand constants.
- Node map: update
website/src/data/figma-nodes.jsonfor any frame that moved or was rebuilt, then runnode scripts/validate-figma-nodes.mjs. - Convention breaks: fix in place.
If fixing Figma would mean changing the code (a prop the code should have, a token that looks wrong), do not touch the code. Add it to the report as a question for the owner.
5. Re-check and report
Run the step 2 inventory again and diff it once more: the Missing, Drifted and Convention buckets should be empty. Report what was fixed per bucket, what is left in Figma only, any questions about the code, and the map changes. Nothing is committed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

