mcpbeat

Ss Reference

bitjaru/ss-reference

Compile screenshots, URLs, Figma exports, or an existing UI into a project-local StyleSeed output grammar with evidence, tokens, confidence, anti-patterns, and a validation screen. Use when the user supplies a design reference that StyleSeed does not already model.

557 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
866
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/bitjaru/styleseed --skill ss-reference

The instruction itself

3 sections, as written by the author

Compile references into a design grammar

Do not merely imitate the supplied screen. Read PRODUCT-PRINCIPLES.md, RULESETS.md,

ADAPTERS.md, and REFERENCE-COMPILER.md, then execute the compiler pipeline in full.

Workflow

  • Ingest every supplied reference and assign evidence IDs (R1, R2, ...). If a URL can be

rendered, capture it. If an image cannot be seen, stop claiming visual analysis for it.

  • Separate references by surface adapter and job. Do not merge a marketing homepage with an app

dashboard unless the user explicitly wants both languages connected.

  • Observe and measure the twelve axes. Every rule cites evidence IDs and a confidence level.
  • Resolve contradictions instead of averaging them. Explain any material choice briefly.
  • Choose the nearest built-in fallback grammar and adapter, then compile the project artifacts required by

REFERENCE-COMPILER.md under .styleseed/rulesets/<slug>/.

  • Update STYLESEED.md to select reference:<slug> while preserving bounded brand choices.
  • Validate transfer: apply the grammar to one representative screen not present in the source

set, run /ss-score, then /ss-verify if renderable. Fix and repeat to the gate floor.

  • Report what was learned, what remains low-confidence, where the artifacts live, and the

validation result.

Rules

  • Visible evidence before adjectives. “Calm” is not a rule; the spacing, type, color, hierarchy,

and motion decisions that create calm are rules.

  • Never copy protected assets, brand marks, or prose.
  • One reference produces a provisional grammar. Say so and keep confidence low where warranted.
  • The generated grammar is project-local. Do not edit RULESETS.md or publish it as built-in.
  • Core invariants and accessibility remain non-negotiable.

How to use it

Copy the folder

Take bitjaru/ss-reference from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.