Agent Skills
› bitjaru/styleseed
› ss-reference
ss-reference
GitHub将截图、URL或Figma等设计参考编译为项目本地的StyleSeed风格语法，包含证据、令牌和验证流程。
Trigger Scenarios
用户提供UI设计参考素材
需要将视觉设计转化为代码级样式规则
Install
npx skills add bitjaru/styleseed --skill ss-reference -g -y
SKILL.md
Frontmatter
{
"name": "ss-reference",
"description": "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.",
"allowed-tools": "Read, Write, Edit, Grep, Glob, Bash, WebFetch",
"argument-hint": "[reference paths or URLs] [--name slug]"
}
Compile references into a design grammar
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.
Version History
-
bfd06d8
Current 2026-08-19 16:29
新增artifact-bound StyleSeed验证功能
- c414969 2026-08-13 14:13
