agentleFS
sukirman1901sukirman1901/frontend-expert/skills/fidelity/SKILL.md

fidelity

Skill9 starsChanged 2 months agoMITView on GitHub

Spec vs implementation fidelity — Figma/Dev Mode/screenshot compare, spacing tolerance, token remap, close-enough rules. Use when matching a design file, "pixel perfect", "mirip Figma", design QA, or /design with a provided mock.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    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
  1. Distinctive:

    When a design source exists (Figma, screenshot, Spec), compare build to source and close gaps — without inventing a parallel visual system.

    line 13
  2. Very specific:

    No design source (blank-canvas → design-direction only)

    line 24

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Design Fidelity

Overview

When a design source exists (Figma, screenshot, Spec), compare build to source and close gaps — without inventing a parallel visual system. Prefer project tokens over copying raw hex from the file.

When to use

  • User provides Figma / mock / screenshot and wants implementation match
  • Design QA / “pixel perfect” / “mirip desain”
  • /design audit when a reference image or file is available
  • Remapping Dev Mode values onto the project token scale

When to skip

  • No design source (blank-canvas → design-direction only)
  • Pure copy/token tweak with no layout compare
  • User waived fidelity (“approximate is fine”)

Workflow

  1. Source — note file/frame/screenshot; capture key frames at target breakpoints
  2. Structure first — layout model, hierarchy, type ladder, Auto Layout Fill/Hug (responsive) before pixel nits
  3. Token remap — map Figma fills/strokes/radii/type to project tokens (or scored preset). Do not paste foreign hex into production CSS unless the project has no system and the tree allows it
  4. Compare — spacing, type size/weight, radius, alignment, states (hover/focus if specified)
  5. Tolerance — see checklist; flag only meaningful deltas
  6. Report — Before/After or Spec vs Build table; mark remaining intentional differences

Close-enough rules (do not bikeshed)

PropertyUsually OKFix
Spacing±4px on dense chrome>8px section rhythm drift
Type sizeNearest token stepWrong weight / wrong role (title vs body)
RadiusNearest tokenMixing 3+ one-off radii
ColorToken semantic matchOff-token brand / purple slop
AlignmentOptical nudgeBroken grid / uneven columns

Never claim “100% pixel perfect” without side-by-side evidence.

Checklist

  • Design source identified (link / frame / screenshot)
  • Hierarchy + Auto Layout sizing mapped before polish
  • Colors/type/radius remapped to tokens (or explicit waiver)
  • Primary breakpoints compared (at least phone + desktop when layout differs)
  • States covered if in spec (default / hover / disabled / error)
  • Remaining deltas listed (intentional vs TODO)

Depth

Full compare workflow: references/fidelity.md.
Layout map: references/responsive.md (Auto Layout ↔ CSS).
Audit persona: design-reviewer.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.