learn-taste

Turn a session's design corrections into rules, with their why, in DESIGN.md, a project skill, or a lint check.

npx skills add https://github.com/emilkowalski/skills --skill learn-taste

Learning Taste

Every correction a user makes is taste the agent didn't have. If it isn't written down, the next session makes the same mistake and the user corrects it again. This skill finds those corrections, turns each one into a rule with its reason, and writes it where the next agent will read it.

It does ONE thing: write rules. It never changes component code, and it never adds a rule the user didn't express.

Hard Rules

  1. Only the user's taste. Every rule traces back to something the user said, edited, or confirmed. Never add a rule because it seems like good practice. That's your taste, and your taste is what the user was correcting.
  2. Never invent a why. If the user gave no reason, propose one marked inferred and get it confirmed before writing. A wrong why is worse than none: the next agent extends the reasoning to cases it doesn't fit.
  3. Propose, then stop. Present every candidate and write only what the user approves. A wrong rule repeats in every future session, exactly like the mistake would have.
  4. A check beats a sentence. If a violation can be found by matching code (a banned value, a raw hex instead of a token, a forbidden property), propose a lint rule, a token restriction, or a test. A check runs every time. A sentence in a long file gets skipped when the agent's context is full.
  5. Write for an agent that wasn't here. No "like we discussed" or "the card from earlier". Name the class of component, the value, the token, the file.

Workflow

Phase 1: Collect corrections

Read the current conversation from the first turn. If the user names earlier sessions and you can read their transcripts (Claude Code stores them as JSONL under ~/.claude/projects/<project>/), read those too.

Explicit corrections are the minority. Look for all five signals:

SignalExampleWhat it tells you
Explicit correction"No, semi-transparent shadow, not a border"The rule, often with the why
Silent editUser changed duration: 400 to 200 in a file you wroteYour default was wrong and their value is the rule. Find these through notices that a file changed outside your edits, or by diffing a file against what you last wrote
Repeated nudge"Smaller." → "Still too big." → "Ok"Your default was off by the total distance. Record where they landed, not the steps
Revert or rejection"Undo that", picking variant B over A, deleting something you addedWhat not to do. The why is usually missing, so it goes to Phase 3's questions
Confirmed non-obvious choice"Yes, keep the icon outside the button"A choice a fresh agent might not repeat. Record it only if a fresh agent would plausibly do otherwise

For each one, capture the user's exact words (or the diff), what you had done, what they wanted instead, and any reason they gave.

Skip what isn't taste: functional bugs, content specific to one screen ("the headline should say Pricing"), and corrections to your understanding of the task.

Completion criterion: every turn has been read, and every correction is listed with its source quote or diff.

Phase 2: Filter

Walk every correction through this tree:

Would a fresh agent building a DIFFERENT component in this repo make the same mistake?
├── No (a one-off: this campaign's color, this page's layout) → Skipped
└── Yes
    ├── Does an existing rule cover it? Check DESIGN.md, CLAUDE.md / AGENTS.md, project skills.
    │   ├── Yes, and it says the same thing → The rule failed. Rewrite it stricter
    │   │   (a number, a token, "never") instead of adding a duplicate.
    │   ├── Yes, and it contradicts → Conflict. Show both; the user picks.
    │   └── No → continue
    ├── Can a violation be found by matching code? → Check candidate.
    │   Keep a one-line rule too, so the why is recorded somewhere.
    └── Did the user say it applies everywhere, not just here? → Ask where their global rules live.
        Otherwise it's a project rule.

Completion criterion: every Phase 1 correction ends as Skipped, Rewrite, Conflict, Check candidate, or a rule to generalize.

Phase 3: Generalize and find the why

Pick the narrowest level that would have prevented the mistake on the next, different component:

LevelExampleVerdict
Instance"The pricing card gets a shadow, not a border"Too narrow: it only protects this card
Class"Raised surfaces (cards, popovers, menus) separate from the background with shadow-raised, never a solid border"Write this
Universal"Never use borders"Too broad: breaks inputs, dividers, tables

If the same correction came up on two or more different components, that's evidence for the class level. If two levels both seem right, ask.

Write the rule strictly: values and token names from this codebase, "always" or "never", no "prefer" or "try to". Use softer wording only when the user framed it as a preference.

Then the why. Use the user's reason, in their words, when they gave one. Otherwise write your best candidate, mark it inferred, and put it in the questions for the user.

Self-test before proposing: read only the rule and its why, then picture the original task. Would an agent that knows nothing else produce what the user wanted? If it could still produce the wrong version, the rule is too vague. Add the value, the token, or the exception.

Completion criterion: every kept rule has a level and a why marked as the user's or inferred.

Phase 4: Decide where it goes

Check candidate?
├── Yes → lint rule, token restriction, or test, plus a one-line rule in DESIGN.md
└── No
    ├── Is DESIGN.md's section for this aspect over ~40 lines, AND relevant to only some tasks
    │   (motion rules don't matter when building a settings form)?
    │   └── Yes → move the whole section into a project skill and leave a one-line pointer in DESIGN.md
    └── Default → DESIGN.md at the repo root, under the matching section:
        Surfaces · Color · Typography · Spacing & layout · Motion · Interaction · Copy

Create DESIGN.md or the section if it's missing.

Make sure it gets read. A DESIGN.md that no agent loads changes nothing. If neither CLAUDE.md nor AGENTS.md points to it, propose adding this line to whichever one the project uses: Before building or changing UI, read DESIGN.md.

Entry format:

## Surfaces

- **Raised surfaces (cards, popovers, menus) use `shadow-raised`, never a solid border.**
  Why: a solid border makes a raised surface look flat and heavy; a semi-transparent shadow separates it from the background and adapts to both themes.
  <!-- 2026-11-12: "no, semi-transparent shadow, not a border" -->

The comment holds the date and the user's words. When a later correction conflicts, it shows which rule is newer and what the user actually said.

Phase 5: Report and stop

Present the report below, then stop.

Phase 6: Write on approval

Write only the approved items. Show the resulting diff of DESIGN.md (and any skill or config file). For a check, implement it and run it across the codebase. If it flags existing code, report the count and ask whether to make it a warning or fix the violations. Never fix them without asking, because that changes component code.

Required Output Format

Rules to add

#You saidRuleWhyWhere
1"no, semi-transparent shadow, not a border"Raised surfaces use shadow-raised, never a solid borderSolid borders look flat and heavy; shadows adapt to both themesDESIGN.md › Surfaces
2Changed duration: 400 → 200 in Dropdown.tsxDropdowns open in 200msinferred: 400ms felt sluggish on a surface opened many times a dayDESIGN.md › Motion

Needs your answer

Each inferred why, each ambiguous generalization level, and each global-or-project question. One line each, with your recommendation.

Conflicts

The existing rule, the new correction, and which one you'd keep.

Make it a check

Each check candidate with its exact implementation (the rule config or test), and what it would flag in the current codebase.

Skipped

One line per skipped correction and why, so the user can override.

Close with: "Say write all or write 1, 3, and answer the questions above."

If the session had no taste corrections, say so in one line. That's a good result, not a failure.

Invocation Variants

InvocationBehavior
/learn-tasteCurrent session, full workflow, stop at the report
/learn-taste <sessions>Also read the named or most recent N session transcripts
write all / write 1, 3Write the approved items from the last report
/learn-taste pruneRead DESIGN.md and propose merges for duplicates, fixes for contradictions, and stricter wording for vague rules. Same propose-then-stop rule

Thêm skills từ emilkowalski

animate
emilkowalski
Xây dựng một hoạt ảnh từ đầu, đưa ra các quyết định theo thứ tự quyết định liệu nó có cảm giác đúng hay không — liệu nó có nên hoạt ảnh không, mục đích gì, công cụ nào, thuộc tính nào, đường cong và thời lượng nào, cách nó ngắt quãng, cách nó thoát. Viết phần triển khai. Sử dụng khi được yêu cầu tạo hoạt ảnh cho một thứ gì đó, thêm chuyển động, làm cho một thành phần trở nên sống động, hoặc xây dựng một chuyển tiếp. Để phê bình chuyển động hiện có, sử dụng review-animations; để kiểm tra toàn bộ mã nguồn, sử dụng improve-animations.
animate-expo
emilkowalski
Tạo hoạt ảnh trong React Native và Expo, đưa ra quyết định theo đúng thứ tự để xác định cảm giác chuyển động — có nên tạo hoạt ảnh hay không, chạy trên luồng nào, dùng thuộc tính nào, dùng spring hay timing, thao tác cử chỉ được chuyển giao ra sao và hoạt ảnh suy giảm như thế nào. Viết phần triển khai bằng Reanimated, Gesture Handler, Expo Router và expo-haptics. Dùng khi tạo hoạt ảnh cho bất kỳ thành phần nào trong ứng dụng Expo, thêm cử chỉ, sheet, chuyển cảnh màn hình, phản hồi khi nhấn hoặc phản hồi xúc giác, hay khắc phục chuyển động bị giật trên thiết bị. Dành cho...
developmentdesign
animation-performance
emilkowalski
Keep web animations inside the frame budget — animate composite-only properties, keep motion off the main thread when the page is busy, and find the cause when an animation drops frames. Use when an animation is janky, choppy, stutters, or drops frames; when choosing which property to animate; when deciding between CSS and JS animation on performance grounds; or when reaching for `will-change` or GPU layers. For choosing easing, duration, or whether to animate at all use animate; for...
developmentdesign
animation-vocabulary
emilkowalski
Từ điển tra ngược giúp chuyển đổi mô tả mơ hồ về một hiệu ứng hoạt hình hoặc chuyển động trên web thành thuật ngữ chính xác ("hiệu ứng nảy khi cửa sổ popover mở ra" → Pop in; "hiệu ứng cuộn đàn hồi kiểu iOS" → Rubber-banding). Sử dụng khi người dùng hỏi "hiệu ứng đó gọi là gì khi…", hoặc mô tả một hiệu ứng chuyển động mà không biết tên của nó và muốn có từ ngữ chính xác để gợi ý cho AI hoặc nhà thiết kế. Dùng để đặt tên cho hiệu ứng, không phải để thiết kế hay xây dựng hiệu ứng.
researchdesigncreative
apple-design
emilkowalski
Cách tiếp cận của Apple về thiết kế giao diện và chuyển động vật lý mượt mà, được chuyển thể cho web. Sử dụng khi xây dựng hoặc đánh giá giao diện điều khiển bằng cử chỉ, hoạt ảnh lò xo, tương tác kéo/vuốt/bảng, động lượng và chuyển tiếp có thể ngắt, vật liệu trong suốt và chiều sâu, kiểu chữ (cỡ chữ quang học, tracking, leading), chế độ giảm chuyển động, hoặc các nền tảng thiết kế (phản hồi, nhất quán không gian, tiết chế) đằng sau giao diện kiểu Apple.
ask-emil
emilkowalski
Hãy hỏi kỹ năng hoặc quy trình nào phù hợp với tình huống của bạn. Một bộ định tuyến cho các kỹ năng trong repo này.
developmentproductivity
ask-sonner
emilkowalski
Hướng dẫn về Sonner, thư viện toast của React — cài đặt và kết nối Toaster, chọn đúng lệnh gọi toast(), toast promise và loading, cập nhật, đóng và duy trì toast, tạo kiểu, chủ đề và biểu tượng, định vị và nhiều toaster. Sử dụng khi làm việc với Sonner hoặc khắc phục sự cố — toast không xuất hiện, xuất hiện hai lần, mất kiểu dáng, bỏ qua lớp Tailwind, nằm sau modal, hoặc không theo chế độ tối.
break-ui
emilkowalski
Thử làm hỏng một phần giao diện bằng cách đưa vào dữ liệu ở trường hợp xấu nhất — tên dài, email không thể ngắt dòng, tên chỉ có một chữ cái, trường bị thiếu, số lượng cực lớn, không có mục nào, nhãn dài, văn bản phi Latin, emoji, số cực lớn — sau đó hiển thị giao diện với công tắc "Demo data / Worst case" và báo cáo mọi thứ bị lỗi, kèm cách khắc phục cho từng lỗi. Dùng khi người dùng yêu cầu kiểm thử sức chịu đựng, làm hỏng hoặc tìm các trường hợp biên trong một thành phần hay màn hình, hoặc yêu cầu "thử trường hợp xấu nhất". Để phê bình thiết kế trực quan, dùng emil-design-eng; để xử lý chuyển động...
testingdesigndevelopment