Agent skill

Figma Annotation Guide

by mohitagw15856 in mohitagw15856/pm-claude-skills

Generate structured developer handoff annotations for a Figma screen or component.

MITAuto-check passedFrontend & Design

Install Figma Annotation Guide

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill figma-annotation-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills figma-annotation-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/figma-annotation-guide .claude/skills/figma-annotation-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
figma-annotation-guide
GitHub stars
1.4k
Token cost
~1k tokens
SKILL.md length
457 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Generate structured developer handoff annotations for a Figma screen or component.

  • Works in 7 steps: Screen/Component Overview → Interaction Annotations → State Inventory → …
  • Asked to write Figma annotations
  • SKILL.md covers Required Inputs, Programmatic Helper, Output Structure and Quality Checks, plus 2 more sections
  • Calls npx

What it does

Figma Annotation Guide is an agent skill from mohitagw15856/pm-claude-skills. Generate structured developer handoff annotations for a Figma screen or component. Use when asked to write Figma annotations, create dev handoff notes, document a Figma design for developers, or write specs for a screen. Produces a complete annotation set covering interactions, states, spacing, accessibility, and edge cases.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Accessibility. It works with Figma. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to write Figma annotations
  • Create dev handoff notes
  • Document a Figma design for developers
  • Write specs for a screen

Example prompts

  • “/figma-annotation-guide”

Requirements

  • Node.js

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Screen/Component Overview
  2. Interaction Annotations
  3. State Inventory
  4. Spacing and Layout Notes
  5. Content and Copy Rules
  6. Accessibility Annotations
  7. Edge Cases and Developer Questions

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Figma Annotation Guide loads about 1k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 457 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 457 words, ~1,012 tokens.

Download SKILL.mdSave it as .claude/skills/figma-annotation-guide/SKILL.md (or your agent's skills folder).
name
figma-annotation-guide
description
Generate structured developer handoff annotations for a Figma screen or component. Use when asked to write Figma annotations, create dev handoff notes, document a Figma design for developers, or write specs for a screen. Produces a complete annotation set covering interactions, states, spacing, accessibility, and edge cases.

Figma Annotation Guide Skill

Produces a complete set of developer handoff annotations for a Figma screen or component — the notes that turn a visual design into a buildable spec.

Required Inputs

  • Screen or component description (describe or summarise what was designed)
  • Platform (iOS / Android / Web / React Native)
  • Interaction type (static / interactive / animated / form)
  • Developer audience (mobile / frontend / full-stack)

Programmatic Helper

Contrast ratios cannot be eyeballed. The AA line sits at 4.5:1, and #777777 on white is 4.478 (fails) while #767676 is 4.54 (passes) — no amount of looking at a screenshot separates those. Compute them:

bash
npx --yes notugly fix "#8ab4f8" "#ffffff"     # ratio, APCA, and the nearest passing colour
npx --yes notugly onepager <url> --out review.html   # every pairing, printable
npx --yes notugly vision                      # which colours merge for colour-blind viewers

notugly fix returns the ratio, the APCA lightness contrast, and the closest colour to the one already chosen that passes — same hue, same chroma. Paste those numbers into the tables below rather than estimating them.

Deterministic, zero dependencies, and no model call — so it costs nothing to run and gives the same answer every time.

Contrast annotations should carry the computed ratio and the target, e.g. "4.52:1 — passes AA for body text". An annotation that says "check contrast" is a task, not an annotation.

Output Structure

1. Screen/Component Overview

Name, purpose, entry points, exit points.

2. Interaction Annotations

[Element name]

  • Default state: [Visual description]
  • On tap/click: [Exact action — API call, state change, navigation]
  • Loading state: [Description]
  • Success state: [What happens after]
  • Error state: [What error looks like and user options]
  • Disabled condition: [When and why]
3. State Inventory
ElementStates Required
[Element]Default, Hover, Active, Disabled, Loading, Error, Empty

Flag missing designs: "Warning: Error state not designed — needed before build"

4. Spacing and Layout Notes

Fixed vs fluid elements, scroll behaviour, breakpoints, safe areas.

Show full SKILL.md (189 more words)Show less
5. Content and Copy Rules

Character limits, dynamic vs static content, truncation rules, empty states.

6. Accessibility Annotations

Touch targets, screen reader labels, focus order, colour contrast, motion preferences.

7. Edge Cases and Developer Questions
  • [Unresolved question for developer to flag]

Quality Checks

  • Every interactive element has all states defined
  • State inventory flags missing designs
  • Accessibility covers touch targets and screen reader labels
  • Empty states specified
  • Edge cases listed as actionable questions

Anti-Patterns

  • Do not annotate only the happy path — error states, loading states, and empty states must all be documented
  • Do not use vague spacing descriptions like "some padding" — specify exact pixel values or token names
  • Do not skip accessibility annotations — focus order, ARIA labels, and colour contrast ratios must be included
  • Do not leave interaction behaviour undescribed — every interactive element needs a documented response
  • Do not produce annotations without edge cases — developers need to know what happens at boundaries

Example Trigger Phrases

  • "Write dev annotations for this Figma screen"
  • "Create developer handoff notes for [screen/component]"
  • "Document this design for the engineering team"
  • "Write the Figma spec for [feature]"
  • "What should I annotate before handing off this design?"

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/figma-annotation-guide of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Figma Annotation Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Figma Annotation Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Figma Annotation Guide this skillmohitagw15856/pm-claude-skills1.4k—~1kAutomated safety check: PassMIT
Extract DesignManavarya09/design-extract4.2k—~786Automated safety check: NotesMIT
Material Design 3 UI/UX Guideskydashnet/material-design-3-ui-skill138—~3kAutomated safety check: PassMIT
Bdgszymdzum/browser-debugger-cli172—~3.3kAutomated safety check: NotesMIT
Connect Component To Figmadequelabs/cauldron129—~2kAutomated safety check: PassMPL-2.0
AI Component Descriptionmurphytrueman/design-system-ops206—~4.7kAutomated safety check: PassMIT

Similar skills

  • Extract Design

    Manavarya09/design-extract

    Extract the full design language from any website URL. An agent skill from Manavarya09/design-extract.

    4.2k GitHub stars~786 tokensUpdated 2 days ago
    Frontend & DesignAuto-check: notes
  • Material Design 3 UI/UX Guide

    skydashnet/material-design-3-ui-skill

    Guides designing, reviewing or implementing interfaces that follow Google's Material Design 3 system: semantic tokens, component states, adaptive layout and accessibility.

    138 GitHub stars~3k tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Bdg

    szymdzum/browser-debugger-cli

    Use bdg CLI to drive and debug a real Chrome via Chrome DevTools Protocol - navigate, click, fill and submit forms, check what an action changed (navigation, new messages, pending requests), inspect…

    172 GitHub stars~3.3k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Connect Component To Figma

    dequelabs/cauldron

    Add a Figma Code Connect (.figma.tsx) file for a Cauldron React component.

    129 GitHub stars~2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • AI Component Description

    murphytrueman/design-system-ops

    Write a six-section prose description (purpose, props, anti-patterns, composition, accessibility, examples) for a Figma component's description field so LLMs read it via MCP.

    206 GitHub stars~4.7k tokensUpdated 16 days ago
    Frontend & DesignAuto-check passed
  • Figma

    sundial-org/awesome-openclaw-skills

    Professional Figma design analysis and asset export. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~1.7k tokensUpdated 7 mo ago
    Frontend & DesignAuto-check: notes

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Figma Annotation Guide

What does Figma Annotation Guide do?

Generate structured developer handoff annotations for a Figma screen or component. Figma Annotation Guide is an agent skill from mohitagw15856/pm-claude-skills. Generate structured developer handoff annotations for a Figma screen or component.

When should I use Figma Annotation Guide?

Figma Annotation Guide fits situations like: asked to write Figma annotations; create dev handoff notes; document a Figma design for developers; write specs for a screen.

How do I install Figma Annotation Guide in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill figma-annotation-guide -a claude-code`. Or copy the skill folder (skills/figma-annotation-guide in mohitagw15856/pm-claude-skills) into .claude/skills/figma-annotation-guide in your project. Claude Code loads it when a task matches its description.

How do I install Figma Annotation Guide in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill figma-annotation-guide -a codex`. Or copy the skill folder (skills/figma-annotation-guide in mohitagw15856/pm-claude-skills) into .agents/skills/figma-annotation-guide in your project. Codex loads it when a task matches its description.

Can I use Figma Annotation Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill figma-annotation-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/figma-annotation-guide, .gemini/skills/figma-annotation-guide, .github/skills/figma-annotation-guide and .opencode/skills/figma-annotation-guide in your project.

What does Figma Annotation Guide need to run?

Going by SKILL.md and its folder, Figma Annotation Guide needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Figma Annotation Guide access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Figma Annotation Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Figma Annotation Guide use?

Figma Annotation Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Figma Annotation Guide use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Figma Annotation Guide?

Skills that share tags, products or a category with Figma Annotation Guide: Extract Design (Manavarya09/design-extract, 4.2k stars), Material Design 3 UI/UX Guide (skydashnet/material-design-3-ui-skill, 138 stars), Bdg (szymdzum/browser-debugger-cli, 172 stars) and Connect Component To Figma (dequelabs/cauldron, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Figma Annotation Guide?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.