ss-learn — Design Lesson Capture
A StyleSeed skill that converts a human-approved UI design correction into a privacy-minimized local rule candidate, with explicit review and opt-in share steps.
Design & UIAdvanced★ 967⑂ 89AI score 8/10Last updated: Oct 1, 2026
What it does
- Turns one human-approved design correction into a generalized candidate rule (problem, intervention, rationale, appliesWhen, avoidWhen, evidence).
- Initializes
.styleseed/learning/with sharing and raw-material collection disabled; no network calls. - Validates out identifying data: project names, URLs, paths, emails, code snippets, prompts, screenshots, colors, font names, component names.
- Records an explicit human accept/reject decision; only accepted candidates can be packaged for
team-registryorcommunity-candidate. - Provides a separate one-time MCP read grant bound to the package hash, so retries fail closed.
- Forces honest evidence: unmeasured scores or visual checks must be
null/not-run.
Who it's for
- Teams running a StyleSeed-based design system who want to accumulate reusable rules.
- Agencies and contractors that must never ship client code or brand assets outward.
- Teams that want knowledge captured by human approval rather than agent self-learning.
Examples
- A reviewer agrees that "moving the modal's primary button raised completion rate" →
capturegeneralizes it into a candidate record. - Show the full candidate to the user, then run
review --decision accepted --attestation APPROVE_LOCAL_REVIEWto lock the decision. - Package with
prepare-share --purpose team-registry, and only after a second explicit approval rungrant-mcp-readto expose it once.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/bitjaru/styleseed/HEAD/extensions/learning/skills/ss-learn/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the extensions/learning/skills/ss-learn folder from the GitHub repo bitjaru/styleseed into my ~/.claude/skills/ss-learn/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/bitjaru/styleseed.git /tmp/styleseed && mkdir -p ~/.claude/skills && cp -r /tmp/styleseed/extensions/learning/skills/ss-learn ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Confirm Node.js (18+ recommended) and git are installed:
node -v,git --version. - Clone the repo:
git clone https://github.com/bitjaru/styleseed.git - Copy the skill into Claude's skills folder:
mkdir -p ~/.claude/skills && cp -r styleseed/extensions/learning/skills/ss-learn ~/.claude/skills/ - Verify
scripts/learning.mjs,references/privacy-contract.md, andreferences/candidate.schema.jsonexist under~/.claude/skills/ss-learn/. - Restart Claude Code and test with a request like "use ss-learn to record this design lesson".
- From your project root, run
node ~/.claude/skills/ss-learn/scripts/learning.mjs init --project-root .. - Read
references/privacy-contract.mdfirst, and only share or grant MCP access after explicit user consent.
View source on GitHub ↗License: MIT