styleseed
GitHubStyleSeed 是 UI 构建与审查的统一入口 Skill，通过路由机制引导至具体工作流。支持界面搭建、设计审核、渲染验证及样式调整，强调保留项目设计决策并基于注册表解析工件，确保开发流程规范。
Trigger Scenarios
Install
npx skills add bitjaru/styleseed --skill styleseed -g -y
SKILL.md
Frontmatter
{
"name": "styleseed",
"description": "Build, improve, or inspect UI with StyleSeed. Preserves project design choices and routes setup, layout, tokens, review, rendered verification, and updates through one entry point."
}
StyleSeed
Use the user's goal to choose one first workflow below. This is the only registered core skill; the 22 workflows and their executable dependencies ship inside this directory. Read only the selected workflow, then references needed for that task.
Registry-first artifact boundary
When .styleseed/project.json and .styleseed/artifacts/index.json exist, resolve the requested
artifact first. Read its .styleseed/bundles/<artifact-id>.md and manifest. A partial or invalid
registry is an error; never fall back to the global legacy bundle. Legacy projects may use
.styleseed/effective-rules.md only when no registry exists.
Before the first workflow in a project/task session, follow the update preflight.
Working contract
- Preserve approved project design choices. Support expert judgment; a score is not human acceptance.
- Resolve the current artifact first. For multiple plausible artifacts, ask one bounded clarification question.
- Never fan out to run every workflow. Choose exactly one first workflow; it may call the required gates.
- Honor the user's authorized scope. Audit, score, verify, and status requests do not authorize edits. Workflow metadata records the intended tool/scope boundary even though it is not host registration metadata.
- Paths in workflow files are relative to those files. Resolve installed scripts from this skill's actual directory, never assume a particular agent folder or download a missing sibling skill.
- In older instructions,
/ss-build,$ss-build, and otherss-*names mean the corresponding internal workflow. Readworkflows/<name>/WORKFLOW.md; do not invoke an unregistered skill. Users may sayStyleSeed build,$styleseed build, or the old workflow name in natural language. - Learning is an optional extension, not part of the core install. Only for explicit learning capture,
use separately installed
ss-learn; if absent, report that dependency and never auto-install it.
Choose exactly one first workflow
| Request | Read |
|---|---|
| Build or redesign a screen, page, or component | build |
| First setup or missing design lock | setup |
| Explore creative directions; direction not yet selected | studio |
| Use screenshot, URL, Figma export, or existing UI as a reference | reference |
| What is wrong with this screen; UX critique | audit |
| Review implementation against project design rules | review |
| Score implementation or run code/evidence gates | score |
| Inspect rendered output, screenshot, or spacing in pixels | verify |
| Change spacing/density or another single design axis | dial |
| Apply an aesthetic profile | restyle |
| Brand color, semantic palette, or design tokens | tokens |
| Named animation or motion treatment | motion |
| Specifically scaffold a page | page |
| Specifically generate a reusable component | component |
| Compose existing primitives into a UI pattern | pattern |
| Accessibility audit and requested fixes | a11y |
| Quick design lint | lint |
| Navigation and user flows | flow |
| UX microcopy | copy |
| Loading, empty, success, or error states | feedback |
| Update installation or consolidate old skill entries | update |
| Compile rules, inspect local install/bundle/evidence health | resolve |
For status-only requests use resolve's read-only scripts/styleseed-doctor.mjs; do not update,
recompile, or visually inspect instead. For vague requests infer the first step from project state
and the user's goal; ask only when an unresolved choice materially changes the work.
Version History
-
f608e46
Current 2026-10-18 23:20
新增会话预检和严格新鲜度门控；重构技能以暴露自包含的 StyleSeed 入口，修复合并期间的提供者检查问题。
-
4447574
2026-09-22 05:56
新增原则：强调协助编码代理重复专家设计决策而非替代权威；新增ss-setup、ss-reference等具体路由规则；强化注册表优先的工件边界处理。
-
4a9b894
2026-09-09 00:20
新增只读项目医生功能和合约持久化检查
- bfd06d8 2026-08-19 16:29
