Agent Skills › bitjaru/styleseed › ss-reference

ss-reference

GitHub

将截图、URL或Figma等设计参考编译为项目本地的UI设计语法规则。通过证据分析、矛盾解决和自动化验证,生成可复用的样式规则集,确保品牌一致性与无障碍标准。

skills/ss-reference/SKILL.md bitjaru/styleseed

Trigger Scenarios

用户提供设计参考素材(截图、链接、Figma导出) 需要基于现有UI生成标准化设计语法

Install

npx skills add bitjaru/styleseed --skill ss-reference -g -y
More Options

Use without installing

npx skills use bitjaru/styleseed@ss-reference

指定 Agent (Claude Code)

npx skills add bitjaru/styleseed --skill ss-reference -a claude-code -g -y

安装 repo 全部 skill

npx skills add bitjaru/styleseed --all -g -y

预览 repo 内 skill

npx skills add bitjaru/styleseed --list

SKILL.md

Frontmatter
{
    "name": "ss-reference",
    "description": "Compile screenshots, URLs, Figma exports, or an existing UI into a project-local output grammar. Use when the user supplies a design reference 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

  1. 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.
  2. 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.
  3. Observe and measure the twelve axes. Every rule cites evidence IDs and a confidence level.
  4. Resolve contradictions instead of averaging them. Explain any material choice briefly.
  5. Choose the nearest built-in fallback grammar and adapter, then compile the project artifacts required by REFERENCE-COMPILER.md under .styleseed/rulesets/<slug>/.
  6. Select reference:<slug> in the chosen artifact's project-owned configuration for registry projects; only when neither registry file exists, update the legacy STYLESEED.md. Preserve bounded brand choices. A partial or invalid registry is an error, not a fallback.
  7. Validate transfer: apply the grammar to one representative screen not present in the source set, run /ss-score, then /ss-verify if renderable. Within the authorized validation scope, fix and repeat until passing or three correction passes per gate, counting delegated passes. Do not reset the budget by switching skills; report actual scores and unresolved failures.
  8. 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.

Version History

  • 4447574 Current 2026-09-22 05:57

    优化技能描述以节省上下文预算;强化注册表优先的工件边界逻辑;新增严格的验证与纠错流程,禁止随意重置预算。

  • bfd06d8 2026-08-19 16:29

    新增artifact-bound StyleSeed验证功能

  • c414969 2026-08-13 14:13

Same Skill Collection

engine/.claude/skills/ss-a11y/SKILL.md
engine/.claude/skills/ss-audit/SKILL.md
engine/.claude/skills/ss-build/SKILL.md
engine/.claude/skills/ss-component/SKILL.md
engine/.claude/skills/ss-copy/SKILL.md
engine/.claude/skills/ss-dial/SKILL.md
engine/.claude/skills/ss-feedback/SKILL.md
engine/.claude/skills/ss-flow/SKILL.md
engine/.claude/skills/ss-learn/SKILL.md
engine/.claude/skills/ss-lint/SKILL.md
engine/.claude/skills/ss-motion/SKILL.md
engine/.claude/skills/ss-page/SKILL.md
engine/.claude/skills/ss-pattern/SKILL.md
engine/.claude/skills/ss-reference/SKILL.md
engine/.claude/skills/ss-resolve/SKILL.md
engine/.claude/skills/ss-restyle/SKILL.md
engine/.claude/skills/ss-review/SKILL.md
engine/.claude/skills/ss-score/SKILL.md
engine/.claude/skills/ss-setup/SKILL.md
engine/.claude/skills/ss-studio/SKILL.md
engine/.claude/skills/ss-tokens/SKILL.md
engine/.claude/skills/ss-verify/SKILL.md
engine/.claude/skills/styleseed/SKILL.md
extensions/learning/skills/ss-learn/SKILL.md
skills/ss-a11y/SKILL.md
skills/ss-audit/SKILL.md
skills/ss-build/SKILL.md
skills/ss-component/SKILL.md
skills/ss-copy/SKILL.md
skills/ss-dial/SKILL.md
skills/ss-feedback/SKILL.md
skills/ss-flow/SKILL.md
skills/ss-learn/SKILL.md
skills/ss-lint/SKILL.md
skills/ss-motion/SKILL.md
skills/ss-page/SKILL.md
skills/ss-pattern/SKILL.md
skills/ss-resolve/SKILL.md
skills/ss-restyle/SKILL.md
skills/ss-review/SKILL.md
skills/ss-score/SKILL.md
skills/ss-setup/SKILL.md
skills/ss-studio/SKILL.md
skills/ss-tokens/SKILL.md
skills/ss-verify/SKILL.md
skills/styleseed-design-review/SKILL.md
skills/styleseed/SKILL.md
engine/.claude/skills/ss-update/SKILL.md
skills/ss-update/SKILL.md

Metadata

Files
0
Version
4447574
Hash
383f8d2a
Indexed
2026-08-13 14:13

Home - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-27 06:07
浙ICP备14020137号-1