Compile references into a design grammar
SkillMediaCompile 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Compile references into a design grammar skill
What this skill tells your AI
The instructions your AI receives, as published by bitjaru/styleseed in skills/ss-reference/SKILL.md and read by ahel’s review.
Registry-first artifact boundary
When .styleseed/project.json and .styleseed/artifacts/index.json exist, resolve the requested artifact ID first, then read only .styleseed/bundles/<artifact-id>.md and .styleseed/manifests/<artifact-id>.json. Never fall back to the global legacy bundle for a registry project. Legacy projects may use .styleseed/effective-rules.md only when no registry exists.
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.mdunder.styleseed/rulesets/<slug>/. - Update
STYLESEED.mdto selectreference:<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-verifyif 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.mdor publish it as built-in. - Core invariants and accessibility remain non-negotiable.
Signals
- GitHub stars
- 949
- Forks
- 88
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
ss-reference- Source
- github.com/bitjaru/styleseed