Claude Cursor Skill

design-engineering

Load when reviewing UI code, designing a component or page layout, picking an easing curve or transition pattern, deciding whether something should animate at all, choosing an avatar/typography/color system, building an OKLCH palette or fixing contrast, writing UI copy or error m

LLM Mart · 0 points · 31 views 105 listing impressions 0 install-command copies
Download AgentsORG-design-engineering-skills_design-engineering-dbbe43b.zip · 544 KB

Install

skills CLI npx skills add https://github.com/AgentsORG/design-engineering/tree/main/skills/design-engineering
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install agentsorg-design-engineering@llmmart
Git git clone https://github.com/AgentsORG/design-engineering.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole agentsorg/design-engineering collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

design-engineering

One skill, one entry: /design-engineering [verb] [target]. Everything below is reachable from it. The body is the Map of Content: follow a [[wikilink]] only when the job needs it. A [[name]] is the file references/**/name.md (names are unique), and paths such as scripts/ are relative to this skill's folder.

Dispatch — read this first, every time

Look at what the user typed after /design-engineering. Claude Code passes it as ARGUMENTS:; other hosts pass the rest of the message. Then:

  1. The first word is a verb in the table (or one of its aliases): open that command file and follow it exactly. Pass the remaining words on as its target.
  2. The arguments are a plain request ("why does this card feel flat"): run [[skill-router]]. It resolves the contract, classifies the phase and names one or two owners. Then follow [[routing-table]] to the entry node.
  3. No arguments, and the conversation already holds a design request: treat that request as rule 2.
  4. No arguments and no request: show the table below as a menu, lead with the 2–3 verbs that fit what is in front of you (a diff → review, a .design file → tokens, a video file → film review, launch week → ship), and wait. Never auto-run a verb.

For a screen built from scratch, run the verbs in the order of the screen loop in [[stacking-chains]]: one or two at a time, looking at the screen between them ([[directing-agents]]). 5. If two verbs fit, ask once. If none fits and the job is not design (backend logic, data, build tooling), say no skill applies.

Verb Aliases Does Command file
review review-ui, critique A UI code review as a Before / After / Why table; change-scoped for a diff [[cmd-review]]
polish finish The screen works but feels unfinished: states, optical details, fixes applied [[cmd-polish]]
motion motion-audit, animate Should it move? Then timing, easing, springs and transitions with concrete values; remove, opportunities or audit (writes plans) [[cmd-motion]]
mobile native-feel Makes a web app feel native on a phone: the symptom, a one-line fix and why, and what needs a real device [[cmd-mobile]]
break worst-case, break-ui Breaks the UI with realistic worst-case data, reports what broke and stops [[cmd-break]]
tells unslop, scan-ai-tells AI-default tells in UI, code or copy, as a deletion list [[cmd-tells]]
a11y accessibility An evidence-only accessibility audit tied to WCAG 2.2 criteria [[cmd-a11y]]
tokens contract, apply-design-md Find the .design / DESIGN.md and thread its tokens through the UI [[cmd-tokens]]
sound sound-pass Which moments earn a sound, one family, generated, wired, mapped [[cmd-sound]]
svg svg-create, svg-animate create, animate or sticker: an SVG on tokens, or one that moves [[cmd-svg]]
ship prep, prod, launch A whole-app production pass across every lane: fix, verify, and list what needs a device or a human [[cmd-ship]]
film film-review, video plan a launch film from its register, review a render, or formats [[cmd-film]]
stage faux-ui, demo, bento, product-shot still, demo, bento or review: faux product UI for a landing page, feature card or docs hero, framed first, filmed and checked frame by frame [[cmd-stage]]
diagram · options · pick · name · which · agentation · pov variants, library, vocab, route, agentation-fix, fork-pov Draw or not; three directions behind a picker (riff, tune, mix, keep); one library for a task; the exact word; who owns a job; the annotation fix loop; fork taste or log a gotcha [[cmd-small]]
help menu, ? This table, with the 2–3 verbs that fit now —

The command files are indexed in [[MOC-commands]]. Every verb applies [[gotchas]] and [[pov]], and both outrank the graph's defaults. A project's .design outranks both ([[using-design-file]]). Keep the posture the verb names: a judge verb reports and never edits unless asked. Where the host ships this skill's subagents (the Claude Code plugin), a command file may be handed to its subagent as the brief. Each command file is the whole procedure on its own, so nothing needs the plugin.

Philosophy — when, where, and why polish matters

How to think about taste, delight, and the difference between marketing and product UI.

  • [[MOC-philosophy]] → [[taste-is-trained]], [[unseen-details-compound]], [[beauty-is-leverage]], [[delight-impact-curve]], [[feeling-right]], [[marketing-vs-product-ui]], [[states-are-the-work]], [[data-is-content]], [[dependency-discipline]], [[pointing-beats-describing]], [[articulate-precisely]]

Motion — when something should move, and how

The largest cluster. Animation is the most overused tool in modern UI; this cluster tells you when not to animate as much as when to.

  • [[MOC-motion]] → [[animation-decision-framework]], [[easing-curves]], [[duration-table]], [[spring-animations]], [[transform-opacity-only]], [[performance-discipline]], [[transform-mastery]], [[clip-path-tricks]], [[never-scale-from-zero]], [[gesture-momentum]], [[stagger-choreography]], [[prefers-reduced-motion]], [[fly-not-teleport]], [[responsive-feedback]], [[sonner-principles]], [[debugging-animations]], [[lerp-breathing]], [[morphing-icons]], [[shared-letter-morph]], [[hover-default-imperative]], [[tray-rules]], [[css-conventions]], [[frame-rate-independence]], [[animated-hit-testing]], [[animation-removal-hazards]], [[momentum-projection]], [[react-native-motion]]

Transition techniques — Jakub Antalik's catalog

A subset of motion focused on canonical transitions for common UI archetypes. Where the Motion MOC teaches principles, these nodes teach implementation. From transitions.dev.

  • [[cross-blur-transitions]] — Pair opacity 0↔1 with filter: blur(2px) ↔ 0 to mask imperfect crossfades.
  • [[compose-subtract-asymmetry]] — Enter with more properties than exit. Disappearance feels soft, not reversed.
  • [[distance-falloff-propagation]] — Per-element lift via lift * pow(falloff, distance) for grouped hover.
  • [[multi-segment-shake]] — Form-error shake at 0%, 28.57%, 57.14%, 78.57%, 100% over 280ms.

Sound — when an interface should be heard, and how

The sense the web forgot. Product UI is silent by default; a launch video is the reverse. This cluster decides which, designs one material family, syncs it to motion, and generates the files — ElevenLabs on demand, or open-weight / procedural / CC0 without a key.

  • [[MOC-sound]] → [[sound-decision-framework]], [[sound-motion-sync]], [[sound-palette]], [[sound-spec]], [[sound-playback-web]], [[sound-generation-elevenlabs]], [[sound-generation-open-source]], [[launch-video-sound]], [[launch-video-music]], [[sound-from-motion]], [[designed-sfx-anatomy]], [[earshot-reconciliation]], [[sound-licensing]]

Launch video — planning, cutting, scoring and reviewing a launch film

A rendered film is its own surface: name the register, time the beats, set the words and the UI demo, make the seams and cuts, place the sound, review against the register. HyperFrames builds; this cluster decides the register, beats, words and sound, and [[hyperframes-reconciliation]] settles seams inside a HyperFrames project.

  • [[MOC-launch-video]] → [[launch-video-registers]], [[launch-video-structure]], [[launch-video-type]], [[launch-video-ui-demo]], [[launch-video-motion]], [[launch-video-seams]], [[launch-video-cuts]], [[launch-video-review]], [[hyperframes-reconciliation]], [[launch-video-formats]], [[cinetic-reconciliation]], [[scenario-kinetic-reconciliation]], [[film-as-function-of-time]]

Faux UI — product shots, cursor demos and bento grids

A believable product, simplified to what the viewer needs, framed with intent, every motion caused, then filmed and checked frame by frame. Stageshow builds it when installed ([[stageshow-reconciliation]]); a demo inside a rendered film belongs to Launch video.

  • [[MOC-faux-ui]] → [[product-shot-framing]], [[faux-ui-restraint]], [[demo-story-and-loops]], [[demo-cursor-and-touch]], [[bento-grids]], [[demo-rehearsal]], [[stageshow-reconciliation]]

SVG — creating, animating, morphing, and vectorizing

The only image format that is also an interface. Author it on the token system, move it with the engine its home allows, morph it by the command-count rule, and turn flat clips into editable mascots.

  • [[MOC-svg]] → [[svg-creation]], [[svg-animation]], [[svg-path-morphing]], [[video-to-vector-pipeline]], [[isometric-stickers]], [[fun-isometric-reconciliation]]

Diagrams — figures, canvases, and whether to draw at all

A diagram is the costliest way to say something. Decide whether a picture earns its place and who touches it next. Then draw a finished figure (Cathryn Lavery's diagram-design) or edit a live canvas (tldraw's Desktop skill or MCP app). Map the project's contract onto the figure, and review it by the connector rules.

  • [[MOC-diagram]] → [[diagram-decision]], [[diagram-craft]], [[diagram-design-reconciliation]], [[tldraw-canvas]]

Typography — humanizing text

The font defaults of the AI era are tells. Better choices and the rules around them.

  • [[MOC-typography]] → [[typography-humanity]], [[line-length-tracking]], [[type-scale-and-rhythm]], [[line-behavior]], [[opentype-features-and-axes]]

Surface — color, shadow, radius, dark mode, imperfection

The "background" choices that most decks of guidelines skip. They're load-bearing for feel.

  • [[MOC-surface]] → [[color-monochromatic]], [[color-scales-oklch]], [[dark-mode]], [[shadows-whisper]], [[depth-and-nesting]], [[border-radius]], [[visual-imperfection]], [[contrast-and-color-scheme]], [[z-index-strategy]], [[color-token-tiers]], [[palette-step-roles]], [[gradient-interpolation]], [[translucent-materials]], [[oklch-gamut-and-migration]]

Layout — page-level grids, viewports, sticky chrome, URL-as-state, marketing surfaces

The container, not the component. Marketing especially benefits from custom-per-viewport thinking; product apps benefit from URL-driven state.

  • [[MOC-layout]] → [[viewport-custom-design]], [[sticky-and-scroll-tells]], [[url-as-state]], [[marketing-surface-rules]], [[page-frame]], [[scroll-anchoring]], [[grouping-by-space]], [[growth-and-overflow]], [[logical-properties-rtl]], [[information-architecture]], [[mobile-platform-layer]], [[share-and-crawl-metadata]]

Components — buttons, hovers, states, cards, forms, avatars, icons, a11y, copy, APIs

The atoms users actually touch. Their behavior is where craft lives.

  • [[MOC-components]] → [[hover-states-subtle]], [[empty-loading-states]], [[icon-systems]], [[cards-design]], [[forms-validation]], [[forms-behavior]], [[touch-and-focus]], [[ui-polish-pass]], [[component-api-design]], [[avatar-systems]], [[interaction-personality]], [[accessibility-baseline]], [[optimistic-updates]], [[copy-voice]], [[dashboard-tells]], [[screen-reader-announcements]], [[keyboard-patterns]], [[wcag-thresholds]], [[strings-and-locale]], [[destructive-actions]], [[sonner-usage]], [[presence-signals]], [[drawing-toolbar]]

Anti-patterns — what AI-generated UI gives away

What looks "AI default" and what to do instead. High-value because it's about deletion, not addition.

  • [[MOC-anti-patterns]] → [[ai-default-tells]], [[unslop-pass]], [[content-authenticity]], [[copy-tells]], [[code-tells]], [[screenshot-critique]], [[leftovers-and-leaks]]

Meta — review format, design.md, Agentation, evals, per-installer files

Procedural rules and growing files. [[review-format]] is mandatory when doing UI code reviews.

  • [[skill-router]] — What /design-engineering does first: resolve the contract, classify the phase, hand off to one owner — a node, a subagent, or an installed companion (AgentsORG design, impeccable, HyperFrames, ElevenLabs, transitions-dev, shadcn CLI, diagram-design, tldraw, GSAP, better-icons, fun-isometric, Stageshow).
  • [[ship-check]] — The whole-app production pass behind ship: fix rather than report, verified vs needs-hardware, the severity tree, fix order. Baseline in [[production-baseline]].
  • [[directing-agents]] — Steering an agent: friction where judgment matters, a named concept instead of an adjective, one or two passes, fix the system not the screen, the papercut pipeline.
  • [[routing-table]] — Intent → entry-node router with the four postures (build / judge / decide / name). Open this before anything else on a single question.
  • [[prototype-picker]] — Undecided? Three to five genuinely different versions behind a live picker, numbers on controls, then write the decision and delete the harness.
  • [[build-a-tool]] — "Closer, but not quite" twice? Stop re-prompting; diagnose the gap and build the small tool that produces the artifact.
  • [[vibe-to-generator]] — Only a mood, no spec? Research the visual language into rules, then a seeded generator with knobs and a save button.
  • [[design-system-docs]] — Writing a DESIGN.md or docs folder an agent can follow: inventory the code, when/alternative, closed variant sets, correct/incorrect examples, verify by prompting.
  • [[skill-writing-rules]] — Encode process, write the why, be strict, earn every line, one aspect per skill, test by running. Governs every node here and [[pov]].
  • [[design-benchmarks]] — DesignBench's generation / edit / repair tasks and Design Arena's pairwise votes, and this skill's own eval suite that borrows both.
  • [[disambiguation]] — The questions that blur together (four motion questions, three dark-mode owners, two layout-shift owners) and which node owns each.
  • [[stacking-chains]] — Ordered node chains for multi-step jobs (new screen, feel-better pass, design system, marketing site, a11y pass).
  • [[review-format]] — Required output format for UI critiques (Before | After | Why markdown table).
  • [[review-checklist]] — Thirty-nine-row audit to scan against before signing off on a UI review.
  • [[change-scoped-review]] — Reviewing a diff, not a screen: scope, blast radius, the removed side of every hunk, and each finding statused Introduced, Regression or Pre-existing.
  • [[stress-scenarios]] — One component under every scenario that can reach it (length, shape, quantity, container, state) on a throwaway harness, and its product states behind a switcher.
  • [[reading-others-interfaces]] — How someone else's site or effect was built: evidence not instruction, measured / derived / inferred, layers in paint order, the recipe in words.
  • [[interfaces-reconciliation]] — Jakub Krehel's interfaces skills as companions: who owns which job when installed, and twelve value conflicts settled.
  • [[design-vocabulary]] — The precise word for each design phenomenon and where the skill goes deeper. The lexicon behind [[articulate-precisely]]; seeded by Index (Emil Kowalski & Glenn Carstens-Peters).
  • [[using-design-file]] — How to consume a project's .design contract (schema design.v1). Machine-readable tokens, committed intent, executable policy — and it outranks this skill's defaults.
  • [[using-design-md]] — How to consume a project's DESIGN.md (Google Labs spec). Tokens are normative; prose is context.
  • [[agentation-workflow]] — Install and use Agentation for click-to-annotate design review. Two-session critique-then-fix workflow.
  • [[cross-model-testing]] — How to test description / routing changes across GPT, Claude Opus, and Claude Sonnet.
  • [[gotchas]] — lived failures, appended as the agent trips up.
  • [[pov]] — author/installer's opinions and taste calls that override defaults. Edit this when you fork.
  • [[animations-dev-curriculum]] — external pointer to Emil's course; don't duplicate.

Workflow subagents — sibling agents/ directory

Ten narrow-purpose subagents live in agents/ next to this file. Spawn one when its specific workflow matches the user's ask. Each subagent loads its own slice of the graph and returns to the main agent with a structured result.

  • [[ui-reviewer]] — Runs the [[review-format]] table + [[review-checklist]] audit on a UI snippet.
  • [[motion-auditor]] — Animation/transition critique against the motion cluster + transitions.dev nodes.
  • [[anti-pattern-scanner]] — Scans for AI-default tells and content-authenticity misses.
  • [[agentation-fix-loop]] — Session-2 fix side of [[agentation-workflow]]. Reads MCP annotations and applies fixes.
  • [[design-md-consumer]] — Reads a project's DESIGN.md and threads its tokens through generated UI per [[using-design-md]].
  • [[pov-curator]] — Helps the installer fork [[pov]] and append to [[gotchas]] after a real failure.
  • [[sound-designer]] — Runs the sound cluster end to end: decide, palette, generate (scripts/sound-family.mjs for a product family, scripts/sound-sheet.mjs for a video stem derived from the motion), spec, wire up. Returns a sound map.
  • [[svg-creator]] — Authors or refactors an SVG asset: grid, named groups, token colors, SVGO with the right flags, accessible name.
  • [[svg-animator]] — Animates an SVG or builds a vector flipbook from frames (scripts/svg-flipbook.mjs), engine chosen by where the file lives.
  • [[launch-film-analyst]] — Measures a reference launch film or your own render at native fps and returns the [[launch-video-review]] rubric plus a per-film JSON.

See docs/subagents.md in the repo for the full directory and selection guide. Every dispatch verb runs without them.

Identity — SOUL.md

The repo also ships a SOUL.md at root — voice, stance, and taste lineage for any agent operating in this skill. AGENTS.md is the "what/how"; SOUL.md is the "who/why". Read it once per session if your harness doesn't auto-inject it.

Tax check

Every sentence above costs tokens in every session. If you find yourself adding a sentence, ask: would the agent get this wrong without it? If no, delete it. If yes, it belongs in an atomic node, not here.

— HKTITAN, 2026.

Files (design-engineering)
  • agents
    • README.md 519 B
      Loading…
  • evals
    • design-bench.jsonl 7.9 KB · in bundle
    • dispatch.jsonl 6.9 KB · in bundle
    • loading.jsonl 10 KB · in bundle
    • progressive-reads.jsonl 19.4 KB · in bundle
    • README.md 3.5 KB
      Loading…
  • references
    • anti-patterns
      • ai-default-tells.md 5.7 KB
        Loading…
      • code-tells.md 4.2 KB
        Loading…
      • content-authenticity.md 4.8 KB
        Loading…
      • copy-tells.md 3.9 KB
        Loading…
      • leftovers-and-leaks.md 3.6 KB
        Loading…
      • MOC-anti-patterns.md 1.9 KB
        Loading…
      • screenshot-critique.md 4 KB
        Loading…
      • unslop-pass.md 4.8 KB
        Loading…
    • commands
      • cmd-a11y.md 1.2 KB
        Loading…
      • cmd-break.md 3.3 KB
        Loading…
      • cmd-film.md 1.9 KB
        Loading…
      • cmd-mobile.md 2.3 KB
        Loading…
      • cmd-motion.md 5.3 KB
        Loading…
      • cmd-polish.md 1.3 KB
        Loading…
      • cmd-review.md 2.4 KB
        Loading…
      • cmd-ship.md 3.9 KB
        Loading…
      • cmd-small.md 2.8 KB
        Loading…
      • cmd-sound.md 1.9 KB
        Loading…
      • cmd-stage.md 2.8 KB
        Loading…
      • cmd-svg.md 1.9 KB
        Loading…
      • cmd-tells.md 1.4 KB
        Loading…
      • cmd-tokens.md 1.8 KB
        Loading…
      • MOC-commands.md 2.5 KB
        Loading…
    • components
      • accessibility-baseline.md 4.6 KB
        Loading…
      • avatar-systems.md 10 KB
        Loading…
      • cards-design.md 3.9 KB
        Loading…
      • component-api-design.md 5.1 KB
        Loading…
      • component-confusables.md 2.9 KB
        Loading…
      • copy-voice.md 4.2 KB
        Loading…
      • dashboard-tells.md 3.5 KB
        Loading…
      • destructive-actions.md 3.4 KB
        Loading…
      • drawing-toolbar.md 3.2 KB
        Loading…
      • empty-loading-states.md 4.2 KB
        Loading…
      • forms-behavior.md 5.2 KB
        Loading…
      • forms-validation.md 4.7 KB
        Loading…
      • hover-states-subtle.md 2.9 KB
        Loading…
      • icon-systems.md 5 KB
        Loading…
      • interaction-personality.md 5.7 KB
        Loading…
      • keyboard-patterns.md 4.5 KB
        Loading…
      • MOC-components.md 5 KB
        Loading…
      • optimistic-updates.md 4 KB
        Loading…
      • presence-signals.md 3.9 KB
        Loading…
      • screen-reader-announcements.md 4.2 KB
        Loading…
      • sonner-usage.md 3.4 KB
        Loading…
      • strings-and-locale.md 4.9 KB
        Loading…
      • touch-and-focus.md 5.3 KB
        Loading…
      • ui-polish-pass.md 4.1 KB
        Loading…
      • wcag-thresholds.md 4.5 KB
        Loading…
    • diagram
      • diagram-craft.md 4.2 KB
        Loading…
      • diagram-decision.md 3.9 KB
        Loading…
      • diagram-design-reconciliation.md 5.3 KB
        Loading…
      • MOC-diagram.md 2.9 KB
        Loading…
      • tldraw-canvas.md 4.9 KB
        Loading…
    • faux-ui
      • bento-grids.md 5.8 KB
        Loading…
      • demo-cursor-and-touch.md 5.2 KB
        Loading…
      • demo-rehearsal.md 5.4 KB
        Loading…
      • demo-story-and-loops.md 6.1 KB
        Loading…
      • faux-ui-restraint.md 6.1 KB
        Loading…
      • MOC-faux-ui.md 2.8 KB
        Loading…
      • product-shot-framing.md 6.5 KB
        Loading…
      • stageshow-reconciliation.md 6.1 KB
        Loading…
    • launch-video
      • cinetic-reconciliation.md 4.9 KB
        Loading…
      • film-as-function-of-time.md 4.5 KB
        Loading…
      • hyperframes-reconciliation.md 10.2 KB
        Loading…
      • launch-video-cuts.md 10.6 KB
        Loading…
      • launch-video-formats.md 4.6 KB
        Loading…
      • launch-video-motion.md 10.7 KB
        Loading…
      • launch-video-registers.md 10.5 KB
        Loading…
      • launch-video-review.md 11.1 KB
        Loading…
      • launch-video-seams.md 12.4 KB
        Loading…
      • launch-video-structure.md 10 KB
        Loading…
      • launch-video-type.md 9.7 KB
        Loading…
      • launch-video-ui-demo.md 10.5 KB
        Loading…
      • MOC-launch-video.md 6.1 KB
        Loading…
      • scenario-kinetic-reconciliation.md 5.4 KB
        Loading…
    • layout
      • grouping-by-space.md 4 KB
        Loading…
      • growth-and-overflow.md 4.6 KB
        Loading…
      • information-architecture.md 3.6 KB
        Loading…
      • logical-properties-rtl.md 3.8 KB
        Loading…
      • marketing-surface-rules.md 5.1 KB
        Loading…
      • mobile-platform-layer.md 4.2 KB
        Loading…
      • MOC-layout.md 2.8 KB
        Loading…
      • page-frame.md 4.2 KB
        Loading…
      • scroll-anchoring.md 3.4 KB
        Loading…
      • share-and-crawl-metadata.md 3.5 KB
        Loading…
      • sticky-and-scroll-tells.md 4.9 KB
        Loading…
      • url-as-state.md 3.3 KB
        Loading…
      • viewport-custom-design.md 4.3 KB
        Loading…
    • meta
      • agentation-workflow.md 6.4 KB
        Loading…
      • build-a-tool.md 5.1 KB
        Loading…
      • change-scoped-review.md 4.5 KB
        Loading…
      • cross-model-testing.md 3.9 KB
        Loading…
      • design-benchmarks.md 4.9 KB
        Loading…
      • design-system-docs.md 4.7 KB
        Loading…
      • design-vocabulary.md 36.4 KB
        Loading…
      • directing-agents.md 3.7 KB
        Loading…
      • disambiguation.md 5.1 KB
        Loading…
      • gotchas.md 15.9 KB
        Loading…
      • interfaces-reconciliation.md 5.7 KB
        Loading…
      • pov.md 17.3 KB
        Loading…
      • production-baseline.md 4 KB
        Loading…
      • prototype-picker.md 6.8 KB
        Loading…
      • reading-others-interfaces.md 4.8 KB
        Loading…
      • review-checklist.md 9.2 KB
        Loading…
      • review-format.md 3.9 KB
        Loading…
      • routing-table.md 11.7 KB
        Loading…
      • ship-check.md 4.6 KB
        Loading…
      • skill-router.md 16.4 KB
        Loading…
      • skill-writing-rules.md 4.1 KB
        Loading…
      • stacking-chains.md 6.1 KB
        Loading…
      • stress-scenarios.md 6.4 KB
        Loading…
      • using-design-file.md 5.9 KB
        Loading…
      • using-design-md.md 5.2 KB
        Loading…
      • vibe-to-generator.md 4.8 KB
        Loading…
    • motion
      • animated-hit-testing.md 3.7 KB
        Loading…
      • animation-decision-framework.md 3.7 KB
        Loading…
      • animation-removal-hazards.md 3.8 KB
        Loading…
      • animations-dev-curriculum.md 2.9 KB
        Loading…
      • clip-path-tricks.md 4.3 KB
        Loading…
      • compose-subtract-asymmetry.md 3 KB
        Loading…
      • cross-blur-transitions.md 2.3 KB
        Loading…
      • css-conventions.md 4.5 KB
        Loading…
      • debugging-animations.md 4.2 KB
        Loading…
      • distance-falloff-propagation.md 3.5 KB
        Loading…
      • duration-table.md 2.9 KB
        Loading…
      • easing-curves.md 3.3 KB
        Loading…
      • fly-not-teleport.md 3.1 KB
        Loading…
      • frame-rate-independence.md 3.7 KB
        Loading…
      • gesture-momentum.md 3.8 KB
        Loading…
      • hover-default-imperative.md 4.4 KB
        Loading…
      • lerp-breathing.md 4.8 KB
        Loading…
      • MOC-motion.md 6.2 KB
        Loading…
      • momentum-projection.md 3.1 KB
        Loading…
      • morphing-icons.md 4.7 KB
        Loading…
      • multi-segment-shake.md 3.1 KB
        Loading…
      • never-scale-from-zero.md 3.5 KB
        Loading…
      • performance-discipline.md 6.3 KB
        Loading…
      • prefers-reduced-motion.md 3.8 KB
        Loading…
      • react-native-motion.md 3.9 KB
        Loading…
      • responsive-feedback.md 3.5 KB
        Loading…
      • shared-letter-morph.md 3.7 KB
        Loading…
      • sonner-principles.md 5.1 KB
        Loading…
      • spring-animations.md 3.7 KB
        Loading…
      • stagger-choreography.md 3.9 KB
        Loading…
      • transform-mastery.md 4.1 KB
        Loading…
      • transform-opacity-only.md 3.1 KB
        Loading…
      • tray-rules.md 4.2 KB
        Loading…
    • philosophy
      • articulate-precisely.md 3.4 KB
        Loading…
      • beauty-is-leverage.md 2.5 KB
        Loading…
      • data-is-content.md 3.6 KB
        Loading…
      • delight-impact-curve.md 2.1 KB
        Loading…
      • dependency-discipline.md 4.7 KB
        Loading…
      • feeling-right.md 2.3 KB
        Loading…
      • marketing-vs-product-ui.md 2.4 KB
        Loading…
      • MOC-philosophy.md 2.3 KB
        Loading…
      • pointing-beats-describing.md 5 KB
        Loading…
      • states-are-the-work.md 3.1 KB
        Loading…
      • taste-is-trained.md 2.1 KB
        Loading…
      • unseen-details-compound.md 2.7 KB
        Loading…
    • sound
      • designed-sfx-anatomy.md 5.6 KB
        Loading…
      • earshot-reconciliation.md 4.4 KB
        Loading…
      • launch-video-music.md 11 KB
        Loading…
      • launch-video-sound.md 11 KB
        Loading…
      • MOC-sound.md 4.7 KB
        Loading…
      • sound-decision-framework.md 4.4 KB
        Loading…
      • sound-from-motion.md 11.1 KB
        Loading…
      • sound-generation-elevenlabs.md 5.2 KB
        Loading…
      • sound-generation-open-source.md 5.3 KB
        Loading…
      • sound-licensing.md 4 KB
        Loading…
      • sound-motion-sync.md 8.2 KB
        Loading…
      • sound-palette.md 4.8 KB
        Loading…
      • sound-playback-web.md 5.2 KB
        Loading…
      • sound-spec.md 4.6 KB
        Loading…
    • surface
      • border-radius.md 2.4 KB
        Loading…
      • color-monochromatic.md 3.2 KB
        Loading…
      • color-scales-oklch.md 4.4 KB
        Loading…
      • color-token-tiers.md 4.3 KB
        Loading…
      • contrast-and-color-scheme.md 5 KB
        Loading…
      • dark-mode.md 3.2 KB
        Loading…
      • depth-and-nesting.md 4 KB
        Loading…
      • gradient-interpolation.md 3.1 KB
        Loading…
      • MOC-surface.md 2.9 KB
        Loading…
      • oklch-gamut-and-migration.md 3 KB
        Loading…
      • palette-step-roles.md 4.6 KB
        Loading…
      • shadows-whisper.md 2.7 KB
        Loading…
      • translucent-materials.md 3.3 KB
        Loading…
      • visual-imperfection.md 4.7 KB
        Loading…
      • z-index-strategy.md 3.3 KB
        Loading…
    • svg
      • fun-isometric-reconciliation.md 4.6 KB
        Loading…
      • isometric-stickers.md 5.2 KB
        Loading…
      • MOC-svg.md 3.3 KB
        Loading…
      • svg-animation.md 4.5 KB
        Loading…
      • svg-creation.md 4.3 KB
        Loading…
      • svg-path-morphing.md 3.5 KB
        Loading…
      • video-to-vector-pipeline.md 4.5 KB
        Loading…
    • typography
      • line-behavior.md 5.4 KB
        Loading…
      • line-length-tracking.md 3.2 KB
        Loading…
      • MOC-typography.md 1.4 KB
        Loading…
      • opentype-features-and-axes.md 3.5 KB
        Loading…
      • type-scale-and-rhythm.md 5.3 KB
        Loading…
      • typography-humanity.md 2.3 KB
        Loading…
  • scripts
    • sound-family.example.json 1.4 KB
      Loading…
    • sound-family.mjs 15.5 KB · in bundle
    • sound-sheet.mjs 32.5 KB · in bundle
    • svg-flipbook.mjs 6 KB · in bundle
  • SKILL.md 19.3 KB
    ---
    name: design-engineering
    description: "Load when reviewing UI code, designing a component or layout, picking an easing curve or transition, deciding whether something should animate or make a sound, choosing typography, color (OKLCH, contrast) or avatars, writing UI copy or errors, auditing for AI-default tells, code tells or a11y misses, making a screen look less generated, consuming DESIGN.md or .design tokens, writing design-system docs, giving Agentation feedback, asking why a UI feels flat or unfinished, judging when delight earns its weight, designing UI sound synced to motion, planning, cutting or reviewing a launch video, building faux product UI (hero demos, feature cards, bento grids), creating or animating SVG (icons, mascots, logo reveals, video-to-vector), drawing a diagram or tldraw canvas, prototyping directions behind a picker, building a tool instead of re-prompting, or choosing which design skill should own a job. Distills Emil Kowalski, Benji Taylor, transitions.dev, guidelines.sh, Vercel, Index, Apple and 47 launch films."
    license: MIT
    compatibility: Agent-agnostic. Pairs with Obsidian as a vault, Agentation for click-to-annotate review, and any coding agent that reads SKILL.md (Claude Code, Cursor, Codex, Windsurf, Aider, Cline, Gemini, 18+ via skills.sh).
    metadata:
      author: HKTITAN
      version: "3.3.1"
      graph: true
      subagents: agents/
      soul: SOUL.md
    ---
    
    # design-engineering
    
    > One skill, one entry: `/design-engineering [verb] [target]`. Everything below is reachable from it. The body is the **Map of Content**: follow a `[[wikilink]]` only when the job needs it. A `[[name]]` is the file `references/**/name.md` (names are unique), and paths such as `scripts/` are relative to this skill's folder.
    
    ## Dispatch — read this first, every time
    
    Look at what the user typed after `/design-engineering`. Claude Code passes it as `ARGUMENTS:`; other hosts pass the rest of the message. Then:
    
    1. **The first word is a verb in the table** (or one of its aliases): open that command file and follow it exactly. Pass the remaining words on as its target.
    2. **The arguments are a plain request** ("why does this card feel flat"): run [[skill-router]]. It resolves the contract, classifies the phase and names one or two owners. Then follow [[routing-table]] to the entry node.
    3. **No arguments, and the conversation already holds a design request:** treat that request as rule 2.
    4. **No arguments and no request:** show the table below as a menu, lead with the 2–3 verbs that fit what is in front of you (a diff → `review`, a `.design` file → `tokens`, a video file → `film review`, launch week → `ship`), and wait. Never auto-run a verb.
    
    For a screen built from scratch, run the verbs in the order of the screen loop in [[stacking-chains]]: one or two at a time, looking at the screen between them ([[directing-agents]]).
    5. If two verbs fit, ask once. If none fits and the job is not design (backend logic, data, build tooling), say no skill applies.
    
    | Verb | Aliases | Does | Command file |
    |---|---|---|---|
    | `review` | `review-ui`, `critique` | A UI code review as a Before / After / Why table; change-scoped for a diff | [[cmd-review]] |
    | `polish` | `finish` | The screen works but feels unfinished: states, optical details, fixes applied | [[cmd-polish]] |
    | `motion` | `motion-audit`, `animate` | Should it move? Then timing, easing, springs and transitions with concrete values; `remove`, `opportunities` or `audit` (writes plans) | [[cmd-motion]] |
    | `mobile` | `native-feel` | Makes a web app feel native on a phone: the symptom, a one-line fix and why, and what needs a real device | [[cmd-mobile]] |
    | `break` | `worst-case`, `break-ui` | Breaks the UI with realistic worst-case data, reports what broke and stops | [[cmd-break]] |
    | `tells` | `unslop`, `scan-ai-tells` | AI-default tells in UI, code or copy, as a deletion list | [[cmd-tells]] |
    | `a11y` | `accessibility` | An evidence-only accessibility audit tied to WCAG 2.2 criteria | [[cmd-a11y]] |
    | `tokens` | `contract`, `apply-design-md` | Find the `.design` / DESIGN.md and thread its tokens through the UI | [[cmd-tokens]] |
    | `sound` | `sound-pass` | Which moments earn a sound, one family, generated, wired, mapped | [[cmd-sound]] |
    | `svg` | `svg-create`, `svg-animate` | `create`, `animate` or `sticker`: an SVG on tokens, or one that moves | [[cmd-svg]] |
    | `ship` | `prep`, `prod`, `launch` | A whole-app production pass across every lane: fix, verify, and list what needs a device or a human | [[cmd-ship]] |
    | `film` | `film-review`, `video` | `plan` a launch film from its register, `review` a render, or `formats` | [[cmd-film]] |
    | `stage` | `faux-ui`, `demo`, `bento`, `product-shot` | `still`, `demo`, `bento` or `review`: faux product UI for a landing page, feature card or docs hero, framed first, filmed and checked frame by frame | [[cmd-stage]] |
    | `diagram` · `options` · `pick` · `name` · `which` · `agentation` · `pov` | `variants`, `library`, `vocab`, `route`, `agentation-fix`, `fork-pov` | Draw or not; three directions behind a picker (`riff`, `tune`, `mix`, `keep`); one library for a task; the exact word; who owns a job; the annotation fix loop; fork taste or log a gotcha | [[cmd-small]] |
    | `help` | `menu`, `?` | This table, with the 2–3 verbs that fit now | — |
    
    The command files are indexed in `[[MOC-commands]]`. Every verb applies [[gotchas]] and [[pov]], and both outrank the graph's defaults. A project's `.design` outranks both ([[using-design-file]]). Keep the posture the verb names: a judge verb reports and never edits unless asked. Where the host ships this skill's subagents (the Claude Code plugin), a command file may be handed to its subagent as the brief. Each command file is the whole procedure on its own, so nothing needs the plugin.
    
    ## Philosophy — when, where, and why polish matters
    
    How to think about taste, delight, and the difference between marketing and product UI.
    
    - `[[MOC-philosophy]]` → [[taste-is-trained]], [[unseen-details-compound]], [[beauty-is-leverage]], [[delight-impact-curve]], [[feeling-right]], [[marketing-vs-product-ui]], [[states-are-the-work]], [[data-is-content]], [[dependency-discipline]], [[pointing-beats-describing]], [[articulate-precisely]]
    
    ## Motion — when something should move, and how
    
    The largest cluster. Animation is the most overused tool in modern UI; this cluster tells you when *not* to animate as much as when to.
    
    - `[[MOC-motion]]` → [[animation-decision-framework]], [[easing-curves]], [[duration-table]], [[spring-animations]], [[transform-opacity-only]], [[performance-discipline]], [[transform-mastery]], [[clip-path-tricks]], [[never-scale-from-zero]], [[gesture-momentum]], [[stagger-choreography]], [[prefers-reduced-motion]], [[fly-not-teleport]], [[responsive-feedback]], [[sonner-principles]], [[debugging-animations]], [[lerp-breathing]], [[morphing-icons]], [[shared-letter-morph]], [[hover-default-imperative]], [[tray-rules]], [[css-conventions]], [[frame-rate-independence]], [[animated-hit-testing]], [[animation-removal-hazards]], [[momentum-projection]], [[react-native-motion]]
    
    ## Transition techniques — Jakub Antalik's catalog
    
    A subset of motion focused on **canonical** transitions for common UI archetypes. Where the Motion MOC teaches principles, these nodes teach implementation. From transitions.dev.
    
    - [[cross-blur-transitions]] — Pair opacity 0↔1 with `filter: blur(2px) ↔ 0` to mask imperfect crossfades.
    - [[compose-subtract-asymmetry]] — Enter with more properties than exit. Disappearance feels soft, not reversed.
    - [[distance-falloff-propagation]] — Per-element lift via `lift * pow(falloff, distance)` for grouped hover.
    - [[multi-segment-shake]] — Form-error shake at 0%, 28.57%, 57.14%, 78.57%, 100% over 280ms.
    
    ## Sound — when an interface should be heard, and how
    
    The sense the web forgot. Product UI is silent by default; a launch video is the reverse. This cluster decides which, designs one material family, syncs it to motion, and generates the files — ElevenLabs on demand, or open-weight / procedural / CC0 without a key.
    
    - `[[MOC-sound]]` → [[sound-decision-framework]], [[sound-motion-sync]], [[sound-palette]], [[sound-spec]], [[sound-playback-web]], [[sound-generation-elevenlabs]], [[sound-generation-open-source]], [[launch-video-sound]], [[launch-video-music]], [[sound-from-motion]], [[designed-sfx-anatomy]], [[earshot-reconciliation]], [[sound-licensing]]
    
    ## Launch video — planning, cutting, scoring and reviewing a launch film
    
    A rendered film is its own surface: name the register, time the beats, set the words and the UI demo, make the seams and cuts, place the sound, review against the register. HyperFrames builds; this cluster decides the register, beats, words and sound, and [[hyperframes-reconciliation]] settles seams inside a HyperFrames project.
    
    - `[[MOC-launch-video]]` → [[launch-video-registers]], [[launch-video-structure]], [[launch-video-type]], [[launch-video-ui-demo]], [[launch-video-motion]], [[launch-video-seams]], [[launch-video-cuts]], [[launch-video-review]], [[hyperframes-reconciliation]], [[launch-video-formats]], [[cinetic-reconciliation]], [[scenario-kinetic-reconciliation]], [[film-as-function-of-time]]
    
    ## Faux UI — product shots, cursor demos and bento grids
    
    A believable product, simplified to what the viewer needs, framed with intent, every motion caused, then filmed and checked frame by frame. Stageshow builds it when installed ([[stageshow-reconciliation]]); a demo inside a rendered film belongs to Launch video.
    
    - `[[MOC-faux-ui]]` → [[product-shot-framing]], [[faux-ui-restraint]], [[demo-story-and-loops]], [[demo-cursor-and-touch]], [[bento-grids]], [[demo-rehearsal]], [[stageshow-reconciliation]]
    
    ## SVG — creating, animating, morphing, and vectorizing
    
    The only image format that is also an interface. Author it on the token system, move it with the engine its home allows, morph it by the command-count rule, and turn flat clips into editable mascots.
    
    - `[[MOC-svg]]` → [[svg-creation]], [[svg-animation]], [[svg-path-morphing]], [[video-to-vector-pipeline]], [[isometric-stickers]], [[fun-isometric-reconciliation]]
    
    ## Diagrams — figures, canvases, and whether to draw at all
    
    A diagram is the costliest way to say something. Decide whether a picture earns its place and who touches it next. Then draw a finished figure (Cathryn Lavery's diagram-design) or edit a live canvas (tldraw's Desktop skill or MCP app). Map the project's contract onto the figure, and review it by the connector rules.
    
    - `[[MOC-diagram]]` → [[diagram-decision]], [[diagram-craft]], [[diagram-design-reconciliation]], [[tldraw-canvas]]
    
    ## Typography — humanizing text
    
    The font defaults of the AI era are tells. Better choices and the rules around them.
    
    - `[[MOC-typography]]` → [[typography-humanity]], [[line-length-tracking]], [[type-scale-and-rhythm]], [[line-behavior]], [[opentype-features-and-axes]]
    
    ## Surface — color, shadow, radius, dark mode, imperfection
    
    The "background" choices that most decks of guidelines skip. They're load-bearing for feel.
    
    - `[[MOC-surface]]` → [[color-monochromatic]], [[color-scales-oklch]], [[dark-mode]], [[shadows-whisper]], [[depth-and-nesting]], [[border-radius]], [[visual-imperfection]], [[contrast-and-color-scheme]], [[z-index-strategy]], [[color-token-tiers]], [[palette-step-roles]], [[gradient-interpolation]], [[translucent-materials]], [[oklch-gamut-and-migration]]
    
    ## Layout — page-level grids, viewports, sticky chrome, URL-as-state, marketing surfaces
    
    The container, not the component. Marketing especially benefits from custom-per-viewport thinking; product apps benefit from URL-driven state.
    
    - `[[MOC-layout]]` → [[viewport-custom-design]], [[sticky-and-scroll-tells]], [[url-as-state]], [[marketing-surface-rules]], [[page-frame]], [[scroll-anchoring]], [[grouping-by-space]], [[growth-and-overflow]], [[logical-properties-rtl]], [[information-architecture]], [[mobile-platform-layer]], [[share-and-crawl-metadata]]
    
    ## Components — buttons, hovers, states, cards, forms, avatars, icons, a11y, copy, APIs
    
    The atoms users actually touch. Their behavior is where craft lives.
    
    - `[[MOC-components]]` → [[hover-states-subtle]], [[empty-loading-states]], [[icon-systems]], [[cards-design]], [[forms-validation]], [[forms-behavior]], [[touch-and-focus]], [[ui-polish-pass]], [[component-api-design]], [[avatar-systems]], [[interaction-personality]], [[accessibility-baseline]], [[optimistic-updates]], [[copy-voice]], [[dashboard-tells]], [[screen-reader-announcements]], [[keyboard-patterns]], [[wcag-thresholds]], [[strings-and-locale]], [[destructive-actions]], [[sonner-usage]], [[presence-signals]], [[drawing-toolbar]]
    
    ## Anti-patterns — what AI-generated UI gives away
    
    What looks "AI default" and what to do instead. High-value because it's about deletion, not addition.
    
    - `[[MOC-anti-patterns]]` → [[ai-default-tells]], [[unslop-pass]], [[content-authenticity]], [[copy-tells]], [[code-tells]], [[screenshot-critique]], [[leftovers-and-leaks]]
    
    ## Meta — review format, design.md, Agentation, evals, per-installer files
    
    Procedural rules and growing files. `[[review-format]]` is mandatory when doing UI code reviews.
    
    - [[skill-router]] — What `/design-engineering` does first: resolve the contract, classify the phase, hand off to one owner — a node, a subagent, or an installed companion (AgentsORG `design`, impeccable, HyperFrames, ElevenLabs, transitions-dev, shadcn CLI, diagram-design, tldraw, GSAP, better-icons, fun-isometric, Stageshow).
    - [[ship-check]] — The whole-app production pass behind `ship`: fix rather than report, verified vs needs-hardware, the severity tree, fix order. Baseline in [[production-baseline]].
    - [[directing-agents]] — Steering an agent: friction where judgment matters, a named concept instead of an adjective, one or two passes, fix the system not the screen, the papercut pipeline.
    - [[routing-table]] — Intent → entry-node router with the four postures (build / judge / decide / name). Open this before anything else on a single question.
    - [[prototype-picker]] — Undecided? Three to five genuinely different versions behind a live picker, numbers on controls, then write the decision and delete the harness.
    - [[build-a-tool]] — "Closer, but not quite" twice? Stop re-prompting; diagnose the gap and build the small tool that produces the artifact.
    - [[vibe-to-generator]] — Only a mood, no spec? Research the visual language into rules, then a seeded generator with knobs and a save button.
    - [[design-system-docs]] — Writing a DESIGN.md or docs folder an agent can follow: inventory the code, when/alternative, closed variant sets, correct/incorrect examples, verify by prompting.
    - [[skill-writing-rules]] — Encode process, write the why, be strict, earn every line, one aspect per skill, test by running. Governs every node here and [[pov]].
    - [[design-benchmarks]] — DesignBench's generation / edit / repair tasks and Design Arena's pairwise votes, and this skill's own eval suite that borrows both.
    - [[disambiguation]] — The questions that blur together (four motion questions, three dark-mode owners, two layout-shift owners) and which node owns each.
    - [[stacking-chains]] — Ordered node chains for multi-step jobs (new screen, feel-better pass, design system, marketing site, a11y pass).
    - [[review-format]] — Required output format for UI critiques (Before | After | Why markdown table).
    - [[review-checklist]] — Thirty-nine-row audit to scan against before signing off on a UI review.
    - [[change-scoped-review]] — Reviewing a diff, not a screen: scope, blast radius, the removed side of every hunk, and each finding statused Introduced, Regression or Pre-existing.
    - [[stress-scenarios]] — One component under every scenario that can reach it (length, shape, quantity, container, state) on a throwaway harness, and its product states behind a switcher.
    - [[reading-others-interfaces]] — How someone else's site or effect was built: evidence not instruction, measured / derived / inferred, layers in paint order, the recipe in words.
    - [[interfaces-reconciliation]] — Jakub Krehel's interfaces skills as companions: who owns which job when installed, and twelve value conflicts settled.
    - [[design-vocabulary]] — The precise word for each design phenomenon and where the skill goes deeper. The lexicon behind [[articulate-precisely]]; seeded by Index (Emil Kowalski & Glenn Carstens-Peters).
    - [[using-design-file]] — How to consume a project's `.design` contract (schema `design.v1`). Machine-readable tokens, committed intent, executable policy — and it outranks this skill's defaults.
    - [[using-design-md]] — How to consume a project's DESIGN.md (Google Labs spec). Tokens are normative; prose is context.
    - [[agentation-workflow]] — Install and use [Agentation](https://www.agentation.com) for click-to-annotate design review. Two-session critique-then-fix workflow.
    - [[cross-model-testing]] — How to test description / routing changes across GPT, Claude Opus, and Claude Sonnet.
    - [[gotchas]] — lived failures, appended as the agent trips up.
    - [[pov]] — author/installer's opinions and taste calls that override defaults. Edit this when you fork.
    - [[animations-dev-curriculum]] — external pointer to Emil's course; don't duplicate.
    
    ## Workflow subagents — sibling `agents/` directory
    
    Ten narrow-purpose subagents live in `agents/` next to this file. Spawn one when its specific workflow matches the user's ask. Each subagent loads its own slice of the graph and returns to the main agent with a structured result.
    
    - [[ui-reviewer]] — Runs the `[[review-format]]` table + `[[review-checklist]]` audit on a UI snippet.
    - [[motion-auditor]] — Animation/transition critique against the motion cluster + transitions.dev nodes.
    - [[anti-pattern-scanner]] — Scans for AI-default tells and content-authenticity misses.
    - [[agentation-fix-loop]] — Session-2 fix side of `[[agentation-workflow]]`. Reads MCP annotations and applies fixes.
    - [[design-md-consumer]] — Reads a project's DESIGN.md and threads its tokens through generated UI per `[[using-design-md]]`.
    - [[pov-curator]] — Helps the installer fork `[[pov]]` and append to `[[gotchas]]` after a real failure.
    - [[sound-designer]] — Runs the sound cluster end to end: decide, palette, generate (`scripts/sound-family.mjs` for a product family, `scripts/sound-sheet.mjs` for a video stem derived from the motion), spec, wire up. Returns a sound map.
    - [[svg-creator]] — Authors or refactors an SVG asset: grid, named groups, token colors, SVGO with the right flags, accessible name.
    - [[svg-animator]] — Animates an SVG or builds a vector flipbook from frames (`scripts/svg-flipbook.mjs`), engine chosen by where the file lives.
    - [[launch-film-analyst]] — Measures a reference launch film or your own render at native fps and returns the [[launch-video-review]] rubric plus a per-film JSON.
    
    See `docs/subagents.md` in the repo for the full directory and selection guide. Every [dispatch](#dispatch--read-this-first-every-time) verb runs without them.
    
    ## Identity — SOUL.md
    
    The repo also ships a [`SOUL.md`](../../SOUL.md) at root — voice, stance, and taste lineage for any agent operating in this skill. AGENTS.md is the "what/how"; SOUL.md is the "who/why". Read it once per session if your harness doesn't auto-inject it.
    
    ## Tax check
    
    Every sentence above costs tokens in every session. If you find yourself adding a sentence, ask: *would the agent get this wrong without it?* If no, delete it. If yes, it belongs in an atomic node, not here.
    
    — HKTITAN, 2026.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.