- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add bitjaru/styleseed --skill ss-learn -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add bitjaru/styleseed --skill ss-learn -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add bitjaru/styleseed --skill ss-learn -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add bitjaru/styleseed --skill ss-learn -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/bitjaru/styleseed/tree/HEAD/extensions/learning/skills/ss-learnFrom the publisher
ss-learn turns a specific human-approved correction into a generalized candidate rule. It
does not train a model, scrape a repository, or upload telemetry. The CLI is local-only. An
optional plugin MCP bridge can expose one exact package to its connected client/model only after a
separate one-time human grant.
Read references/privacy-contract.md before using this skill.
null or not-run; never infer.STYLESEED.md instead.After explicit user approval:
node <installed-ss-learn>/scripts/learning.mjs init --project-root .
This creates .styleseed/learning/config.json with sharing disabled and all raw-material
collection disabled. It performs no network request.
Use references/candidate.schema.json. Generalize the lesson:
Do not include project names, URLs, paths, emails, source snippets, prompts, screenshots, colors, font names, or component names. Then capture it:
node <installed-ss-learn>/scripts/learning.mjs capture \
--project-root . \
--input /path/to/candidate.json
The CLI validates maintained context IDs, exact fields, privacy patterns, and evidence honesty.
It writes an immutable draft ID under .styleseed/learning/candidates/.
Show the full candidate to the user. Only after their explicit accept/reject decision run:
node <installed-ss-learn>/scripts/learning.mjs review \
--project-root . \
--id <candidate-id> \
--decision accepted \
--reviewer <local-alias> \
--reason "<why this generalizes>" \
--attestation APPROVE_LOCAL_REVIEW
Use --decision rejected for a counterexample. Never accept on the user's behalf. A candidate is
content-addressed and receives one final local decision; revise the source lesson and capture a new
candidate instead of rewriting an accepted or rejected record.
Only an accepted candidate can be packaged. Show the sanitized payload and ask separately whether
the user approves export for team-registry or community-candidate:
node <installed-ss-learn>/scripts/learning.mjs prepare-share \
--project-root . \
--id <candidate-id> \
--purpose team-registry \
--attestation APPROVE_LOCAL_EXPORT
This writes .styleseed/learning/share/<id>.<purpose>.json. It strips reviewer identity and local
paths, binds the payload to the engine revision, and records a content hash. It does not send
the file anywhere.
Only when the user separately approves exposing the prepared package to the connected MCP client and its model, run:
node <installed-ss-learn>/scripts/learning.mjs grant-mcp-read \
--project-root . \
--package .styleseed/learning/share/<package.json> \
--attestation APPROVE_MCP_READ
The grant is bound to the package hash and accepted local review. The MCP bridge consumes it before returning the package, so retries fail closed. This is client/model exposure even though the MCP server itself performs no network request. Never describe it as remaining local after consumption.
A share package is evidence, not a StyleSeed rule. Central or team promotion requires multiple independent projects, counterexamples, accessibility and grammar regression checks, benchmark evidence, and named maintainer approval. Never edit core rules automatically from local learning.
Report separately:
Capture a human-approved UI design lesson as a privacy-minimized local StyleSeed candidate, review it, and prepare an opt-in share package without transmitting project code, prompts, screenshots, or b
---name: ss-learndescription: Capture a human-approved UI design lesson as a privacy-minimized local StyleSeed candidate, review it, and…---# extensions/learning/skills/ss-learn/SKILL.mdOverview
Capture a human-approved UI design lesson as a privacy-minimized local StyleSeed candidate, review it, and prepare an opt-in share package without transmitting project code, prompts, screenshots, or brand data. Use when a person asks StyleSeed to remember, learn from, generalize, review, or prepare a reusable rule from an accepted design correction.
FAQ
Download extensions/learning/skills/ss-learn/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/bitjaru/styleseed.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.