fix-design-system-finding

Fix design-system integration issues in Figma by replacing instances and binding tokens.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/codesour-design/gravity --skill fix-design-system-finding-codesour-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-design-system-finding
Source: https://github.com/codesour-design/gravity/tree/main/.agents/skills/fix-design-system-finding
Command: npx skills add https://github.com/codesour-design/gravity --skill fix-design-system-finding-codesour-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps designers and AI agents correct specific design-system violations in Figma without expanding the work into unnecessary screen-wide refactors.

Core Features & Use Cases

  • Targeted Design-System Fixes: Resolve individual findings such as missing shared components, incorrect variants, local overrides, and unbound design tokens.
  • Controlled Figma Editing Workflow: Inspect affected nodes, validate compatibility, apply minimal changes, and confirm the original issue is resolved.
  • Use Case: When a design audit identifies a custom button that should use a shared component, use this Skill to safely replace or align the component while preserving layout behavior.

Quick Start

Use the fix-design-system-finding skill to correct this specific Figma design-system audit finding while keeping the change limited to the affected node.

Frequently Asked Questions about fix-design-system-finding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a missing shared component in a Figma design system audit?

To fix a missing shared component in a Figma design system audit, you replace the incorrect local instance with the shared component while preserving layout behavior and keeping changes limited to the affected node.

What is the best way to bind unbound design tokens in Figma components?

Binding unbound design tokens in Figma components involves inspecting the affected nodes, validating compatibility, applying minimal-scope edits to bind the tokens, and verifying the original finding is resolved.

Can I correct Figma variant alignment issues without refactoring the entire screen?

Yes, you can correct Figma variant alignment issues without refactoring the entire screen by applying targeted minimal-scope edits to the affected component and verifying the design-system compliance check passes.

How do I remove local overrides from Figma components to ensure design system compliance?

Removing local overrides from Figma components requires inspecting the affected node, validating compatibility with the shared component, applying minimal changes to align variants, and confirming the finding is resolved.

Does targeted Figma remediation preserve existing layout behavior when replacing instances?

Targeted Figma remediation preserves existing layout behavior when replacing instances by validating compatibility before applying minimal-scope edits, ensuring the design-system integration issue is fixed without unnecessary screen-wide refactors.

When should I use a controlled Figma editing workflow for design system fixes?

You should use a controlled Figma editing workflow for design system fixes when an audit identifies specific violations like incorrect variants or unbound tokens, requiring minimal-scope edits and post-change verification.