style-learning
Skill0 starsChanged 42 days agoMITView on GitHub
Turn references and feedback into explicit, editable style rules: import a reference prompt/file (kept verbatim) and write its normalized interpretation (style spec, tokens, caption variants, editing/audio constraints with units, components, validation checklist, conflict rules, corrections); maintain project PREFERENCES.md with explicit vs tentative entries; promote to workspace defaults only on "save this as my default".
In this repository19 other files it gives its agents.
- analyzeSkill
- audioSkill
- captionsSkill
- clipSkill
- creator-editSkill
- designSkill
- directorSkill
- doctorSkill
- editSkill
- exportSkill
- graphicsSkill
- ingestSkill
- luxury-techSkill
- previewSkill
- quality-checkSkill
- reframeSkill
- reviseSkill
- studioSkill
- transcribeSkill
The file
Files
Style learning
Rules: ${CLAUDE_PLUGIN_ROOT}/references/rules.md · CLI: ${CLAUDE_PLUGIN_ROOT}/references/cli.md.
ss = "${CLAUDE_PLUGIN_ROOT}/bin/shorts-studio". Input: $ARGUMENTS
0. Engine check
The commands below run the Shorts Studio engine. Installed as the Claude Code plugin it is already
present and shorts-studio is on the Bash PATH. If shorts-studio doctor is not found (for example,
this skill was added with npx skills add), ask the user before installing anything, then:
- Claude Code:
/plugin marketplace add bloxy-studios/shorts-studio→/plugin install shorts-studio@shorts-studio. - Other agents:
git clone --depth 1 https://github.com/bloxy-studios/shorts-studio ~/.shorts-studio/engineand read every${CLAUDE_PLUGIN_ROOT}path below as~/.shorts-studio/engine.
Then run shorts-studio doctor --setup once (project-local runtime; never sudo or global installs).
Steps
- Reference file:
ss prefs import <project> <file> [--name house-style]keeps the original underbrief/references/and creates<name>.interpretation.md. Read the original fully, then fill every section of the interpretation — readable spec, tokens + caption variants, constraints with units and tolerances, reusable components, validation checklist, conflict-resolution rules, and technical corrections with reasons (keep the author's intent understandable). - Encode it: a brand preset (
designskill:ss preset create … --set …) and, for rules the presets cannot express, explicit preferences. - Preferences:
ss prefs add <project> "Captions never cover faces" --area captions. Inferences from one choice are--tentative(project only).--default(workspace) only when the user explicitly says to save it as their default.ss prefs list <project>shows both levels. - The director brief picks up explicit preferences as project rules (precedence: current instruction → preset + saved overrides → brief → defaults).
Completion check
The original reference is stored unmodified, its interpretation has no empty section, and every saved preference is labelled explicit or tentative with its scope.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

