@r1z4x/tezgah 1.9.2 → 1.13.0

package/skills/analyze-app/SKILL.md

@@ -1,18 +1,23 @@
 ---
 name: analyze-app
 description: >
-  Analyze a running web or mobile app from its structured accessibility / DOM /
-  native view tree, and from screenshots of the rendered screen. Use when a task
-  must drive,
-  inspect, or verify a running application - walk a flow, read the UI, check the
-  console, network or device logs, or confirm behavior end to end - rather than
-  only read its source. Covers a real browser (Playwright MCP), an iOS Simulator
-  or Android emulator (Mobile MCP), and optional web diagnostics (Chrome
-  DevTools MCP). Not for judging the whole product - use `product-analysis`.
+  Use when verifying a running app: walk a flow, UI, console; uygulamayı aç,
+  çalıştır, ekran, tarayıcı, durumlar. Not for strategy - use
+  `product-analysis`.
 ---
 
 # analyze-app
 
+## When to use
+
+Analyze a running web or mobile app from its structured accessibility / DOM /
+native view tree, and from screenshots of the rendered screen. Use when a task
+must drive, inspect, or verify a running application - walk a flow, read the UI,
+check the console, network or device logs, or confirm behavior end to end -
+rather than only read its source. Covers a real browser (Playwright MCP), an iOS
+Simulator or Android emulator (Mobile MCP), and optional web diagnostics (Chrome
+DevTools MCP). Not for judging the whole product - use `product-analysis`.
+
 Drive the running app through its accessibility tree. The tree answers structure;
 the rendered image answers hierarchy, rhythm, colour and feel - so a screenshot is
 taken whenever a claim needs those, and for what the tree cannot represent at all
@@ -87,7 +92,7 @@ lines that carry the controls. So after the snapshot, and before reading it:
 
 1. **Flatten and keep it**: save the `browser_snapshot` result (or the flattened
    text of one) to a file.
-2. **Triage**: `tezgah-triage --select FILE --task "what this pass is looking
+2. **Triage**: `~/.config/tezgah/bin/tezgah-triage --select FILE --task "what this pass is looking
    for"` sends the tree's repeating units - a row, a table cell, a control on its
    own - and the task in one batched judgement, and prints the line ids under the
    selected units with their original `ref=` values, the unselected count and the
@@ -96,7 +101,7 @@ lines that carry the controls. So after the snapshot, and before reading it:
    when the task is "is anything wrong on this screen at all" - a selection cannot
    answer a question it was not asked.
 
-For one component, `tezgah-triage --states FILE --component "#12"` asks one
+For one component, `~/.config/tezgah/bin/tezgah-triage --states FILE --component "#12"` asks one
 judgement per state over that component's subtree - the interactive pair `focus`
 and `active` arrives as one three-way answer (`neither` / `focus` / `pressed`)
 inside that same call, measured better than two separate questions - covering
@@ -119,7 +124,7 @@ judge from what the tree and the screen actually show, and say what you read. Wh
 the printed selection is most of the screen, the task names a control every row
 repeats and the triage bought coverage rather than skipping - the tool says so
 itself, and reading the snapshot directly is then the cheaper move. With no
-credential, or with the `judge-off` switch on, `tezgah-triage` prints why and
+credential, or with the `judge-off` switch on, `~/.config/tezgah/bin/tezgah-triage` prints why and
 exits 1: read the snapshot directly, the way the loop reads it today, and say the
 triage was unavailable.
 
@@ -138,7 +143,7 @@ path; keep image tokens out of the context.
 
 ## Measurement for design-contract
 
-`tezgah-design check` judges a measurement, and this loop is what writes it:
+`~/.config/tezgah/bin/tezgah-design check` judges a measurement, and this loop is what writes it:
 `.tezgah/design/measurement.json`, one entry per component the repository's
 `.tezgah/design-contract.md` lists. Read the computed styles with `browser_evaluate`,
 one selector per component:

package/skills/design-contract/SKILL.md

@@ -1,17 +1,22 @@
 ---
 name: design-contract
 description: >
-  The artifact shape of a repository's design contract - the colour roles, the
-  type scale, the spacing unit and its rhythm, the component inventory, and the
-  state set every interactive control and every data view owes - and the rule
-  that derives it from the repository's own tokens.
-  Use when a UI or component turn needs a design floor, tokens, a state set or
-  a named `tezgah-design` check. Not for reading or driving the running app -
-  use `analyze-app`.
+  Use when building or reviewing UI: design system, design floor, tokens,
+  component states; tasarım sistemi, arayüz, renk. Not for a live app - use
+  `analyze-app`.
 ---
 
 # design-contract
 
+## When to use
+
+The artifact shape of a repository's design contract - the colour roles, the
+type scale, the spacing unit and its rhythm, the component inventory, and the
+state set every interactive control and every data view owes - and the rule that
+derives it from the repository's own tokens. Use when a UI or component turn
+needs a design floor, tokens, a state set or a named `~/.config/tezgah/bin/tezgah-design` check. Not
+for reading or driving the running app - use `analyze-app`.
+
 This skill owns ONE thing: the shape of `.tezgah/design-contract.md`, the
 per-repo floor a UI turn is judged against, and the derivation rule that fills it
 when the repository never had a design system. The reading of the running app is
@@ -95,6 +100,36 @@ opens. Field names and prose stay English.
 }
 ```
 
+## Hallmark's `design.md`, and which floor wins
+
+`hallmark` (vendored, see its `SKILL.md`) builds new pages and locks its system
+into a root `design.md`: genre, shape, theme, a `:root` token block in OKLCH,
+controls and motion. That file is a second floor, so the contract reads it first:
+when `design.md` or `DESIGN.md` sits at the repository root, `derive` takes its
+palette (converted to the hex `check` compares) and the font roles, stamps
+`source: design-md`, and ignores a token file beside it. The state set, the
+component inventory, the WCAG floors and the evidence requirement are never
+Hallmark's: they are ours.
+
+The contract's `precedence` block is the only tie-break, and `check` refuses an
+ambiguous one (exit 2) rather than let a reader decide:
+
+- `ours` - states, components, evidence, facts. A Hallmark waiver, a `copy:
+  verbatim` stamp or a theme cannot relax them.
+- `theirs` - material and motion character, which this contract does not judge.
+- `shared` - contrast, focus-visible, reduced-motion, tap-target: the same intent
+  on both sides, our numbers and their shapes, so no tie-break is needed.
+- `verbatim: "style"` - the user's own words excuse a style gate and never a
+  fabricated fact.
+
+The Hallmark half of the check is `tezgah-design slop --repo . [--render]
+[--measured FILE]`. It runs the vendored gate list and writes
+`.tezgah/design/slop.json`. It exits 1 on a Floor FAIL, and it exits 1 when a
+contract exists but no measurement judged a component, because then our half is
+unjudged. It reports `render: not run: …` when the render tier could not start,
+and that is never clean: the render-only gates stay unjudged. The union lives in
+that verb, so the Stop rule counts one verdict that covers both floors.
+
 ## The state set
 
 Every interactive control owes all of `states.interactive`; every data view owes

package/skills/design-contract/data-views.md

@@ -80,7 +80,7 @@ finding the reviewer names, since `check` does not require them.
   https://www.carbondesignsystem.com/data-visualization/dashboards
 - Carbon Design System, Empty states,
   https://www.carbondesignsystem.com/building-blocks/core/patterns/empty-states
-- The design library: [colour-independence](../design-library/adaptive-interfaces/skills/colour-independence/SKILL.md)
+- The design library: [colour-independence](../design-library/adaptive-interfaces/skills/colour-independence/ENTRY.md)
   ("Always test charts in greyscale") and
-  [simplified-views](../design-library/adaptive-interfaces/skills/simplified-views/SKILL.md)
+  [simplified-views](../design-library/adaptive-interfaces/skills/simplified-views/ENTRY.md)
   (its Dashboard Simplification patterns: a default of three to five key metrics).

package/skills/design-library/EVALS.md

@@ -29,7 +29,7 @@ Must-contain line is met and no Must-not line is triggered.
 
 **Why this case** - upstream's touch-target body said exactly this; it is the one
 body `SOURCE` records as adapted
-(`inclusive-interaction/skills/touch-target-design/SKILL.md`). An answer that
+(`inclusive-interaction/skills/touch-target-design/ENTRY.md`). An answer that
 parrots the library without the correction fails on the first Must-not line.
 
 ---

package/skills/design-library/INDEX.md

@@ -6,54 +6,54 @@ file is the routing surface, and every line is short enough for a router line.
 
 ## cognitive-accessibility
 
-adaptive-personalisation - help and onboarding adapted to the person - cognitive-accessibility/skills/adaptive-personalisation/SKILL.md
-assess-load - a load map of a multi-step process - cognitive-accessibility/skills/assess-load/SKILL.md
-cognitive-load-assessment - a cognitive-load assessment - cognitive-accessibility/skills/cognitive-load-assessment/SKILL.md
-contextual-help-design - help content, tooltips and support flows - cognitive-accessibility/skills/contextual-help-design/SKILL.md
-error-prevention-recovery - error prevention and recovery flows - cognitive-accessibility/skills/error-prevention-recovery/SKILL.md
-focus-attention-design - focus support and distraction reduction - cognitive-accessibility/skills/focus-attention-design/SKILL.md
-memory-load-reduction - working-memory demand removed from a flow - cognitive-accessibility/skills/memory-load-reduction/SKILL.md
-plain-language-design - content written or reviewed in plain language - cognitive-accessibility/skills/plain-language-design/SKILL.md
-review - a cognitive accessibility review of a screen or flow - cognitive-accessibility/skills/review/SKILL.md
-simplify - simplified content and interactions - cognitive-accessibility/skills/simplify/SKILL.md
-wayfinding-navigation - navigation and information architecture - cognitive-accessibility/skills/wayfinding-navigation/SKILL.md
+adaptive-personalisation - help and onboarding adapted to the person - cognitive-accessibility/skills/adaptive-personalisation/ENTRY.md
+assess-load - a load map of a multi-step process - cognitive-accessibility/skills/assess-load/ENTRY.md
+cognitive-load-assessment - a cognitive-load assessment - cognitive-accessibility/skills/cognitive-load-assessment/ENTRY.md
+contextual-help-design - help content, tooltips and support flows - cognitive-accessibility/skills/contextual-help-design/ENTRY.md
+error-prevention-recovery - error prevention and recovery flows - cognitive-accessibility/skills/error-prevention-recovery/ENTRY.md
+focus-attention-design - focus support and distraction reduction - cognitive-accessibility/skills/focus-attention-design/ENTRY.md
+memory-load-reduction - working-memory demand removed from a flow - cognitive-accessibility/skills/memory-load-reduction/ENTRY.md
+plain-language-design - content written or reviewed in plain language - cognitive-accessibility/skills/plain-language-design/ENTRY.md
+review - a cognitive accessibility review of a screen or flow - cognitive-accessibility/skills/review/ENTRY.md
+simplify - simplified content and interactions - cognitive-accessibility/skills/simplify/ENTRY.md
+wayfinding-navigation - navigation and information architecture - cognitive-accessibility/skills/wayfinding-navigation/ENTRY.md
 
 ## adaptive-interfaces
 
-colour-independence - an interface where colour is never the only signal - adaptive-interfaces/skills/colour-independence/SKILL.md
-flexible-typography - a type system that scales with the reader - adaptive-interfaces/skills/flexible-typography/SKILL.md
-information-density - a density the user can adjust - adaptive-interfaces/skills/information-density/SKILL.md
-preference-audit - an audit of motion, contrast and text-scale respect - adaptive-interfaces/skills/preference-audit/SKILL.md
-responsive-accessibility - a layout accessible at any size or zoom - adaptive-interfaces/skills/responsive-accessibility/SKILL.md
-responsive-review - a review of a layout across devices and zoom - adaptive-interfaces/skills/responsive-review/SKILL.md
-simplified-views - a reduced-complexity view of an interface - adaptive-interfaces/skills/simplified-views/SKILL.md
-specify - adaptive behaviour specified for a component - adaptive-interfaces/skills/specify/SKILL.md
-user-preference-respect - system preference detection and response - adaptive-interfaces/skills/user-preference-respect/SKILL.md
+colour-independence - an interface where colour is never the only signal - adaptive-interfaces/skills/colour-independence/ENTRY.md
+flexible-typography - a type system that scales with the reader - adaptive-interfaces/skills/flexible-typography/ENTRY.md
+information-density - a density the user can adjust - adaptive-interfaces/skills/information-density/ENTRY.md
+preference-audit - an audit of motion, contrast and text-scale respect - adaptive-interfaces/skills/preference-audit/ENTRY.md
+responsive-accessibility - a layout accessible at any size or zoom - adaptive-interfaces/skills/responsive-accessibility/ENTRY.md
+responsive-review - a review of a layout across devices and zoom - adaptive-interfaces/skills/responsive-review/ENTRY.md
+simplified-views - a reduced-complexity view of an interface - adaptive-interfaces/skills/simplified-views/ENTRY.md
+specify - adaptive behaviour specified for a component - adaptive-interfaces/skills/specify/ENTRY.md
+user-preference-respect - system preference detection and response - adaptive-interfaces/skills/user-preference-respect/ENTRY.md
 
 ## inclusive-interaction
 
-audit - a multi-modal interaction audit - inclusive-interaction/skills/audit/SKILL.md
-design-flow - an interaction flow with inclusive input and output - inclusive-interaction/skills/design-flow/SKILL.md
-feedback-and-status - feedback that works across sight, sound and touch - inclusive-interaction/skills/feedback-and-status/SKILL.md
-gesture-alternatives - non-gesture alternatives to a gesture - inclusive-interaction/skills/gesture-alternatives/SKILL.md
-keyboard-navigation - keyboard navigation and focus management - inclusive-interaction/skills/keyboard-navigation/SKILL.md
-keyboard-review - a keyboard and focus review - inclusive-interaction/skills/keyboard-review/SKILL.md
-motion-sensitivity - motion that respects vestibular and seizure limits - inclusive-interaction/skills/motion-sensitivity/SKILL.md
-multi-modal-input - several input methods for one interface - inclusive-interaction/skills/multi-modal-input/SKILL.md
-touch-target-design - target sizes and spacing that are forgiving - inclusive-interaction/skills/touch-target-design/SKILL.md
-voice-interaction - a voice interface for diverse speech - inclusive-interaction/skills/voice-interaction/SKILL.md
+audit - a multi-modal interaction audit - inclusive-interaction/skills/audit/ENTRY.md
+design-flow - an interaction flow with inclusive input and output - inclusive-interaction/skills/design-flow/ENTRY.md
+feedback-and-status - feedback that works across sight, sound and touch - inclusive-interaction/skills/feedback-and-status/ENTRY.md
+gesture-alternatives - non-gesture alternatives to a gesture - inclusive-interaction/skills/gesture-alternatives/ENTRY.md
+keyboard-navigation - keyboard navigation and focus management - inclusive-interaction/skills/keyboard-navigation/ENTRY.md
+keyboard-review - a keyboard and focus review - inclusive-interaction/skills/keyboard-review/ENTRY.md
+motion-sensitivity - motion that respects vestibular and seizure limits - inclusive-interaction/skills/motion-sensitivity/ENTRY.md
+multi-modal-input - several input methods for one interface - inclusive-interaction/skills/multi-modal-input/ENTRY.md
+touch-target-design - target sizes and spacing that are forgiving - inclusive-interaction/skills/touch-target-design/ENTRY.md
+voice-interaction - a voice interface for diverse speech - inclusive-interaction/skills/voice-interaction/ENTRY.md
 
 ## visual-critique
 
-critique-affordance - an affordance critique, rated per finding - visual-critique/skills/critique-affordance/SKILL.md
-critique-brand-consistency - a critique against the brand's tokens - visual-critique/skills/critique-brand-consistency/SKILL.md
-critique-color - a colour critique: contrast, palette, meaning - visual-critique/skills/critique-color/SKILL.md
-critique-composition - a composition critique: balance, whitespace, rhythm - visual-critique/skills/critique-composition/SKILL.md
-critique-information-density - a density critique: load and priority - visual-critique/skills/critique-information-density/SKILL.md
-critique-typography - a typography critique: scale, readability, tokens - visual-critique/skills/critique-typography/SKILL.md
-critique-visual-hierarchy - a hierarchy critique: entry point, eye flow - visual-critique/skills/critique-visual-hierarchy/SKILL.md
+critique-affordance - an affordance critique, rated per finding - visual-critique/skills/critique-affordance/ENTRY.md
+critique-brand-consistency - a critique against the brand's tokens - visual-critique/skills/critique-brand-consistency/ENTRY.md
+critique-color - a colour critique: contrast, palette, meaning - visual-critique/skills/critique-color/ENTRY.md
+critique-composition - a composition critique: balance, whitespace, rhythm - visual-critique/skills/critique-composition/ENTRY.md
+critique-information-density - a density critique: load and priority - visual-critique/skills/critique-information-density/ENTRY.md
+critique-typography - a typography critique: scale, readability, tokens - visual-critique/skills/critique-typography/ENTRY.md
+critique-visual-hierarchy - a hierarchy critique: entry point, eye flow - visual-critique/skills/critique-visual-hierarchy/ENTRY.md
 
 ## design-research
 
-behavioural-analytics - funnel reading that rules out tracking artefacts - design-research/skills/behavioural-analytics/SKILL.md
-qual-quant-triangulation - a study reconciling the data with what users say - design-research/skills/qual-quant-triangulation/SKILL.md
+behavioural-analytics - funnel reading that rules out tracking artefacts - design-research/skills/behavioural-analytics/ENTRY.md
+qual-quant-triangulation - a study reconciling the data with what users say - design-research/skills/qual-quant-triangulation/ENTRY.md

package/skills/design-library/SKILL.md

@@ -1,20 +1,26 @@
 ---
 name: design-library
 description: >
-  The vendored MC Dean design/UX library - cognitive accessibility, adaptive
-  interfaces, visual-critique vocabulary and behavioural analytics - read one
-  entry at a time from its own index. Use when a UI or product turn needs a
-  cognitive-load, inclusive-interaction or visual-critique method tezgah has no
-  counterpart for.
+  Use when a UI needs a cognitive-load or visual-critique method; bilişsel yük,
+  görsel hiyerarşi, erişilebilirlik. Not for tokens - use `design-contract`.
 ---
 
 # design-library
 
-Thirty-nine `SKILL.md` from two Owl-Listener repositories, vendored into this
-repository at pinned revisions (both MIT, `9a6930c` and `6e0740f`) and kept at
-the upstream path, so a path here is the path there. `SOURCE` records the
-revisions, the per-file sha256 and the two bodies this copy adapted; `NOTICE`
-records the licence.
+## When to use
+
+The vendored MC Dean design/UX library - cognitive accessibility, adaptive
+interfaces, visual-critique vocabulary and behavioural analytics - read one
+entry at a time from its own index. Use when a UI or product turn needs a
+cognitive-load, inclusive-interaction or visual-critique method tezgah has no
+counterpart for.
+
+Thirty-nine upstream `SKILL.md` from two Owl-Listener repositories, vendored into
+this repository at pinned revisions (both MIT, `9a6930c` and `6e0740f`) and kept
+at the upstream path as `ENTRY.md`, so a host that lists every `SKILL.md` below
+its skills directory does not list them; otherwise a path here is the path
+there. `SOURCE` records the revisions, the per-file sha256 and the two bodies
+this copy adapted; `NOTICE` records the licence.
 
 Tezgah owns the design floor: `design-contract` is the artifact shape a
 repository's tokens and states are read into, and `bin/tezgah-design` is the
@@ -26,9 +32,9 @@ comprehension, and how to critique a rendered screen dimension by dimension.
 
 1. **`INDEX.md`** - one line per entry: `name - what it makes - path`. Read the
    line that matches the work in hand.
-2. **the entry's `SKILL.md`** - the file the line names, e.g.
-   `inclusive-interaction/skills/touch-target-design/SKILL.md`. That is the
-   upstream body.
+2. **the entry's `ENTRY.md`** - the file the line names, e.g.
+   `inclusive-interaction/skills/touch-target-design/ENTRY.md`. That is the
+   upstream body, upstream's `SKILL.md` renamed.
 
 `EVALS.md` holds the three trap cases this library is scored against.
 

package/skills/design-library/SOURCE

@@ -3,7 +3,7 @@
 The vendored MC Dean design/UX subset, taken from two Owl-Listener repositories
 at a pinned revision, both MIT. The entry point `skills/design-library/SKILL.md`,
 `INDEX.md`, `EVALS.md` and this file are tezgah's own and are not part of the
-manifest; the 39 `SKILL.md` below are.
+manifest; the 39 `ENTRY.md` below are.
 
 - `inclusive-design-skills` -
   https://github.com/Owl-Listener/inclusive-design-skills at revision
@@ -29,59 +29,61 @@ git -C designer-skills checkout 9a6930cf84a822eb458624bd11c61aac5bbdf224
 ## What is vendored
 
 39 `SKILL.md` at the upstream path, under the plugin directory they ship in, so a
-path here is the path there and a re-vendor is a file-for-file diff. The manifest
+path here is the path there and a re-vendor is a file-for-file diff. One rename:
+each entry file is `ENTRY.md` here, bytes unchanged, so a host that lists every
+`SKILL.md` below its skills directory (codex, Cursor) does not list it. The manifest
 is this table, and `tests/test_skills.py` holds the tree to it: every listed file
 is hashed, a listed file that is missing fails, a body that no longer matches its
 hash fails, and a directory beside them that the table does not name fails.
 
 | file | upstream repo | sha256 | note |
 |---|---|---|---|
-| `adaptive-interfaces/skills/colour-independence/SKILL.md` | `inclusive-design-skills` | `4a24e41dabfbcdd144514c3894fe14972822974cd799352adb2c0d85f01df6bd` | byte-for-byte |
-| `adaptive-interfaces/skills/flexible-typography/SKILL.md` | `inclusive-design-skills` | `60ed6308b9434bcb50cbe4c4bad17cb6efa8841b14dbbcfb52ba35bd630374fc` | byte-for-byte |
-| `adaptive-interfaces/skills/information-density/SKILL.md` | `inclusive-design-skills` | `31611ebe01db6af2d2673cdd587523dd149ee08c48f4f85ca19653a3539199f8` | byte-for-byte |
-| `adaptive-interfaces/skills/preference-audit/SKILL.md` | `inclusive-design-skills` | `5e91232273076c90671ffdd2d3ecdba165312ad293f5132aa7f0b159d413d630` | byte-for-byte |
-| `adaptive-interfaces/skills/responsive-accessibility/SKILL.md` | `inclusive-design-skills` | `0c233392a42591100a3f85f068cc387a8347e5b7e228ceb646a5f9618892d025` | byte-for-byte |
-| `adaptive-interfaces/skills/responsive-review/SKILL.md` | `inclusive-design-skills` | `3290eb820d790351a19f8642c95d54a367e1bc5ba19a96884981215ff9f12748` | byte-for-byte |
-| `adaptive-interfaces/skills/simplified-views/SKILL.md` | `inclusive-design-skills` | `03b85a7a36f0fbec4c647e38a0c7627ae45949c2cd7898078705ff284dc6918a` | byte-for-byte |
-| `adaptive-interfaces/skills/specify/SKILL.md` | `inclusive-design-skills` | `f2e5e52e8e2c01af686f1ef4bfae64dc3b9d591fcb3ea42218e4ce77c5f55dd1` | byte-for-byte |
-| `adaptive-interfaces/skills/user-preference-respect/SKILL.md` | `inclusive-design-skills` | `003da44c4cd9ed6826657bf2651b7f8adb5961065cec1ed24d1984bd4dded452` | byte-for-byte |
-| `cognitive-accessibility/skills/adaptive-personalisation/SKILL.md` | `inclusive-design-skills` | `b1363f70ed3ecbc2e1a43be0fbc9b8350794472acdd6069b956d3a23b159f6b0` | adapted - `name` matches its directory (upstream shipped the sibling skill's name) |
-| `cognitive-accessibility/skills/assess-load/SKILL.md` | `inclusive-design-skills` | `ffe5cd3891358b729c2298756df8d91dbbfc538ab698e72cce257202c1f17863` | byte-for-byte |
-| `cognitive-accessibility/skills/cognitive-load-assessment/SKILL.md` | `inclusive-design-skills` | `666c74971ba790ec81bb86bdaee8362bed791423386021e90eb1d6fd1c9a56cb` | byte-for-byte |
-| `cognitive-accessibility/skills/contextual-help-design/SKILL.md` | `inclusive-design-skills` | `ca49b0b26c01d58dd80fa841cfcb42a55f431cbe3ea6459183bba9c44d6a4626` | byte-for-byte |
-| `cognitive-accessibility/skills/error-prevention-recovery/SKILL.md` | `inclusive-design-skills` | `34f51f51b2bad8b9ac76e23a66a05c82066bf0225abe951d7fa744797885dfa7` | byte-for-byte |
-| `cognitive-accessibility/skills/focus-attention-design/SKILL.md` | `inclusive-design-skills` | `604c83463a3bcdcd0609f4aa366d421122312d29574db3046672e00d8b955ad5` | byte-for-byte |
-| `cognitive-accessibility/skills/memory-load-reduction/SKILL.md` | `inclusive-design-skills` | `9f44acc844d2cab57d77fa011a3e737b8f53e06aba2b315ed9154ac4ce29d5c3` | byte-for-byte |
-| `cognitive-accessibility/skills/plain-language-design/SKILL.md` | `inclusive-design-skills` | `26564e0c388dcf83dbd0d271edb99dbabbd43d41349d080b190ed4bd94910acd` | byte-for-byte |
-| `cognitive-accessibility/skills/review/SKILL.md` | `inclusive-design-skills` | `dc88c60db982dc46939862e5e913efbf69caafd025457d69c4394fbeaea2b22f` | byte-for-byte |
-| `cognitive-accessibility/skills/simplify/SKILL.md` | `inclusive-design-skills` | `a75b7f6361c23d8720591d12b1c70f10d5c25da7c660e0243b818f7587aea1db` | byte-for-byte |
-| `cognitive-accessibility/skills/wayfinding-navigation/SKILL.md` | `inclusive-design-skills` | `a58fb18487238841e93edee2f2548e5c94e710d7dcf76f1a1797a319725a8892` | byte-for-byte |
-| `design-research/skills/behavioural-analytics/SKILL.md` | `designer-skills` | `fe675689031efec6cdd8ad1c138b869efa703453a248bb3addd5a257eed9dc71` | byte-for-byte |
-| `design-research/skills/qual-quant-triangulation/SKILL.md` | `designer-skills` | `5a46dbc020d25526acc7ad62c300b47fa2f64d83f6efa11281eb1731e892768a` | byte-for-byte |
-| `inclusive-interaction/skills/audit/SKILL.md` | `inclusive-design-skills` | `398f7edade2297ecab75854fa5da1879f3838c42ccf786e490bf7d8e22569d69` | byte-for-byte |
-| `inclusive-interaction/skills/design-flow/SKILL.md` | `inclusive-design-skills` | `47685797189f104d8d7b7daf70456013162582b23ca92556b5e49eb0ca60fa3a` | byte-for-byte |
-| `inclusive-interaction/skills/feedback-and-status/SKILL.md` | `inclusive-design-skills` | `17264f4a3c64f3f92c22fe98d15f9ac2bcd3374b78e0d4b6c40bfe6c83ce193e` | byte-for-byte |
-| `inclusive-interaction/skills/gesture-alternatives/SKILL.md` | `inclusive-design-skills` | `a30ec9e35f143ffa6de5585b985c7683b1e1fc4116c23ff55dacf7ac01430c44` | byte-for-byte |
-| `inclusive-interaction/skills/keyboard-navigation/SKILL.md` | `inclusive-design-skills` | `44ad1cc578cf8ed3287c8dfea1cb91f1fe663480d41afa4b87272c8a28dbc240` | byte-for-byte |
-| `inclusive-interaction/skills/keyboard-review/SKILL.md` | `inclusive-design-skills` | `4dcf4b716523a3a698062242da62aef1c43b6bdd865499be51b9e28fe4634b9e` | byte-for-byte |
-| `inclusive-interaction/skills/motion-sensitivity/SKILL.md` | `inclusive-design-skills` | `5faddb723f51e31f2780320703ec67ba0eb555b633cbdbf3afc702d9df04c7b9` | byte-for-byte |
-| `inclusive-interaction/skills/multi-modal-input/SKILL.md` | `inclusive-design-skills` | `f45997b13701e4d97857ab3768cdbf045ceabab0527959f04fa2d3481d754c1d` | byte-for-byte |
-| `inclusive-interaction/skills/touch-target-design/SKILL.md` | `inclusive-design-skills` | `176d6438b40fa95dcd1fe24f5ec43d6c2a0436f4f5aaa542ec85844366f73ffc` | adapted - the AA touch floor corrected to 24x24 (SC 2.5.8); 44x44 keeps the AAA floor it is (SC 2.5.5) and the platform guidance |
-| `inclusive-interaction/skills/voice-interaction/SKILL.md` | `inclusive-design-skills` | `091bbbaed8dd0ca90a961e9caa78dd0a4da5b233dc2d976164b46f03e92a9a80` | byte-for-byte |
-| `visual-critique/skills/critique-affordance/SKILL.md` | `designer-skills` | `8ba4f17b694eff6f25f0025cf7f75459d4f92e2130d60ffc369cf4a94b6375cb` | byte-for-byte |
-| `visual-critique/skills/critique-brand-consistency/SKILL.md` | `designer-skills` | `3e0babf21656878969d02a3f147d4e958770023e7768ac2084cb4d2b5f1cc7c0` | byte-for-byte |
-| `visual-critique/skills/critique-color/SKILL.md` | `designer-skills` | `ffa4652b75236dd1dced9636e532a102ba416e4253251cb74370c824d540bb88` | byte-for-byte |
-| `visual-critique/skills/critique-composition/SKILL.md` | `designer-skills` | `ab3f4b50153a1e7fe0deebf8e7e68c0643c2fdbaad1c7a0e7b8223e137182b83` | byte-for-byte |
-| `visual-critique/skills/critique-information-density/SKILL.md` | `designer-skills` | `e992bfbdef6a3919a24e5c91d0e9518395d16cabd4b308c3e3bbe34ee3ac0443` | byte-for-byte |
-| `visual-critique/skills/critique-typography/SKILL.md` | `designer-skills` | `eb15ce57ba98186ed30fc3ce8df6167fc73668a24160e4d3e23b9925f7beae63` | byte-for-byte |
-| `visual-critique/skills/critique-visual-hierarchy/SKILL.md` | `designer-skills` | `e9c210156b5cd6c049922c0ca2ab65dbed96bc3c2d2bfaa0b4b1ea47c89ec4b1` | byte-for-byte |
+| `adaptive-interfaces/skills/colour-independence/ENTRY.md` | `inclusive-design-skills` | `4a24e41dabfbcdd144514c3894fe14972822974cd799352adb2c0d85f01df6bd` | byte-for-byte |
+| `adaptive-interfaces/skills/flexible-typography/ENTRY.md` | `inclusive-design-skills` | `60ed6308b9434bcb50cbe4c4bad17cb6efa8841b14dbbcfb52ba35bd630374fc` | byte-for-byte |
+| `adaptive-interfaces/skills/information-density/ENTRY.md` | `inclusive-design-skills` | `31611ebe01db6af2d2673cdd587523dd149ee08c48f4f85ca19653a3539199f8` | byte-for-byte |
+| `adaptive-interfaces/skills/preference-audit/ENTRY.md` | `inclusive-design-skills` | `5e91232273076c90671ffdd2d3ecdba165312ad293f5132aa7f0b159d413d630` | byte-for-byte |
+| `adaptive-interfaces/skills/responsive-accessibility/ENTRY.md` | `inclusive-design-skills` | `0c233392a42591100a3f85f068cc387a8347e5b7e228ceb646a5f9618892d025` | byte-for-byte |
+| `adaptive-interfaces/skills/responsive-review/ENTRY.md` | `inclusive-design-skills` | `3290eb820d790351a19f8642c95d54a367e1bc5ba19a96884981215ff9f12748` | byte-for-byte |
+| `adaptive-interfaces/skills/simplified-views/ENTRY.md` | `inclusive-design-skills` | `03b85a7a36f0fbec4c647e38a0c7627ae45949c2cd7898078705ff284dc6918a` | byte-for-byte |
+| `adaptive-interfaces/skills/specify/ENTRY.md` | `inclusive-design-skills` | `f2e5e52e8e2c01af686f1ef4bfae64dc3b9d591fcb3ea42218e4ce77c5f55dd1` | byte-for-byte |
+| `adaptive-interfaces/skills/user-preference-respect/ENTRY.md` | `inclusive-design-skills` | `003da44c4cd9ed6826657bf2651b7f8adb5961065cec1ed24d1984bd4dded452` | byte-for-byte |
+| `cognitive-accessibility/skills/adaptive-personalisation/ENTRY.md` | `inclusive-design-skills` | `b1363f70ed3ecbc2e1a43be0fbc9b8350794472acdd6069b956d3a23b159f6b0` | adapted - `name` matches its directory (upstream shipped the sibling skill's name) |
+| `cognitive-accessibility/skills/assess-load/ENTRY.md` | `inclusive-design-skills` | `ffe5cd3891358b729c2298756df8d91dbbfc538ab698e72cce257202c1f17863` | byte-for-byte |
+| `cognitive-accessibility/skills/cognitive-load-assessment/ENTRY.md` | `inclusive-design-skills` | `666c74971ba790ec81bb86bdaee8362bed791423386021e90eb1d6fd1c9a56cb` | byte-for-byte |
+| `cognitive-accessibility/skills/contextual-help-design/ENTRY.md` | `inclusive-design-skills` | `ca49b0b26c01d58dd80fa841cfcb42a55f431cbe3ea6459183bba9c44d6a4626` | byte-for-byte |
+| `cognitive-accessibility/skills/error-prevention-recovery/ENTRY.md` | `inclusive-design-skills` | `34f51f51b2bad8b9ac76e23a66a05c82066bf0225abe951d7fa744797885dfa7` | byte-for-byte |
+| `cognitive-accessibility/skills/focus-attention-design/ENTRY.md` | `inclusive-design-skills` | `604c83463a3bcdcd0609f4aa366d421122312d29574db3046672e00d8b955ad5` | byte-for-byte |
+| `cognitive-accessibility/skills/memory-load-reduction/ENTRY.md` | `inclusive-design-skills` | `9f44acc844d2cab57d77fa011a3e737b8f53e06aba2b315ed9154ac4ce29d5c3` | byte-for-byte |
+| `cognitive-accessibility/skills/plain-language-design/ENTRY.md` | `inclusive-design-skills` | `26564e0c388dcf83dbd0d271edb99dbabbd43d41349d080b190ed4bd94910acd` | byte-for-byte |
+| `cognitive-accessibility/skills/review/ENTRY.md` | `inclusive-design-skills` | `dc88c60db982dc46939862e5e913efbf69caafd025457d69c4394fbeaea2b22f` | byte-for-byte |
+| `cognitive-accessibility/skills/simplify/ENTRY.md` | `inclusive-design-skills` | `a75b7f6361c23d8720591d12b1c70f10d5c25da7c660e0243b818f7587aea1db` | byte-for-byte |
+| `cognitive-accessibility/skills/wayfinding-navigation/ENTRY.md` | `inclusive-design-skills` | `a58fb18487238841e93edee2f2548e5c94e710d7dcf76f1a1797a319725a8892` | byte-for-byte |
+| `design-research/skills/behavioural-analytics/ENTRY.md` | `designer-skills` | `fe675689031efec6cdd8ad1c138b869efa703453a248bb3addd5a257eed9dc71` | byte-for-byte |
+| `design-research/skills/qual-quant-triangulation/ENTRY.md` | `designer-skills` | `5a46dbc020d25526acc7ad62c300b47fa2f64d83f6efa11281eb1731e892768a` | byte-for-byte |
+| `inclusive-interaction/skills/audit/ENTRY.md` | `inclusive-design-skills` | `398f7edade2297ecab75854fa5da1879f3838c42ccf786e490bf7d8e22569d69` | byte-for-byte |
+| `inclusive-interaction/skills/design-flow/ENTRY.md` | `inclusive-design-skills` | `47685797189f104d8d7b7daf70456013162582b23ca92556b5e49eb0ca60fa3a` | byte-for-byte |
+| `inclusive-interaction/skills/feedback-and-status/ENTRY.md` | `inclusive-design-skills` | `17264f4a3c64f3f92c22fe98d15f9ac2bcd3374b78e0d4b6c40bfe6c83ce193e` | byte-for-byte |
+| `inclusive-interaction/skills/gesture-alternatives/ENTRY.md` | `inclusive-design-skills` | `a30ec9e35f143ffa6de5585b985c7683b1e1fc4116c23ff55dacf7ac01430c44` | byte-for-byte |
+| `inclusive-interaction/skills/keyboard-navigation/ENTRY.md` | `inclusive-design-skills` | `44ad1cc578cf8ed3287c8dfea1cb91f1fe663480d41afa4b87272c8a28dbc240` | byte-for-byte |
+| `inclusive-interaction/skills/keyboard-review/ENTRY.md` | `inclusive-design-skills` | `4dcf4b716523a3a698062242da62aef1c43b6bdd865499be51b9e28fe4634b9e` | byte-for-byte |
+| `inclusive-interaction/skills/motion-sensitivity/ENTRY.md` | `inclusive-design-skills` | `5faddb723f51e31f2780320703ec67ba0eb555b633cbdbf3afc702d9df04c7b9` | byte-for-byte |
+| `inclusive-interaction/skills/multi-modal-input/ENTRY.md` | `inclusive-design-skills` | `f45997b13701e4d97857ab3768cdbf045ceabab0527959f04fa2d3481d754c1d` | byte-for-byte |
+| `inclusive-interaction/skills/touch-target-design/ENTRY.md` | `inclusive-design-skills` | `176d6438b40fa95dcd1fe24f5ec43d6c2a0436f4f5aaa542ec85844366f73ffc` | adapted - the AA touch floor corrected to 24x24 (SC 2.5.8); 44x44 keeps the AAA floor it is (SC 2.5.5) and the platform guidance |
+| `inclusive-interaction/skills/voice-interaction/ENTRY.md` | `inclusive-design-skills` | `091bbbaed8dd0ca90a961e9caa78dd0a4da5b233dc2d976164b46f03e92a9a80` | byte-for-byte |
+| `visual-critique/skills/critique-affordance/ENTRY.md` | `designer-skills` | `8ba4f17b694eff6f25f0025cf7f75459d4f92e2130d60ffc369cf4a94b6375cb` | byte-for-byte |
+| `visual-critique/skills/critique-brand-consistency/ENTRY.md` | `designer-skills` | `3e0babf21656878969d02a3f147d4e958770023e7768ac2084cb4d2b5f1cc7c0` | byte-for-byte |
+| `visual-critique/skills/critique-color/ENTRY.md` | `designer-skills` | `ffa4652b75236dd1dced9636e532a102ba416e4253251cb74370c824d540bb88` | byte-for-byte |
+| `visual-critique/skills/critique-composition/ENTRY.md` | `designer-skills` | `ab3f4b50153a1e7fe0deebf8e7e68c0643c2fdbaad1c7a0e7b8223e137182b83` | byte-for-byte |
+| `visual-critique/skills/critique-information-density/ENTRY.md` | `designer-skills` | `e992bfbdef6a3919a24e5c91d0e9518395d16cabd4b308c3e3bbe34ee3ac0443` | byte-for-byte |
+| `visual-critique/skills/critique-typography/ENTRY.md` | `designer-skills` | `eb15ce57ba98186ed30fc3ce8df6167fc73668a24160e4d3e23b9925f7beae63` | byte-for-byte |
+| `visual-critique/skills/critique-visual-hierarchy/ENTRY.md` | `designer-skills` | `e9c210156b5cd6c049922c0ca2ab65dbed96bc3c2d2bfaa0b4b1ea47c89ec4b1` | byte-for-byte |
 
 ## The two adaptations
 
 Every adopted body is byte-for-byte upstream except these two, and each keeps its
 upstream bytes everywhere else:
 
-1. `inclusive-interaction/skills/touch-target-design/SKILL.md`, in "Minimum
+1. `inclusive-interaction/skills/touch-target-design/ENTRY.md`, in "Minimum
    Sizes", says the touch floor is `44x44 CSS pixels (WCAG 2.2 Level AA)`. That
    pairs a size with the wrong level: WCAG 2.2 SC 2.5.8 Target Size (Minimum) is
    Level AA at 24x24 CSS px, and SC 2.5.5 Target Size (Enhanced) is Level AAA at
@@ -91,7 +93,7 @@ upstream bytes everywhere else:
    24`, citing SC 2.5.8 - so the vendored copy and the checker now agree. The
    file's other 44x44 mentions (its touch checklist, the Material
    recommendation) state no level and are kept as upstream wrote them.
-2. `cognitive-accessibility/skills/adaptive-personalisation/SKILL.md` carries
+2. `cognitive-accessibility/skills/adaptive-personalisation/ENTRY.md` carries
    `name: contextual-help-design`, which does not match its directory: it is the
    duplicate of the sibling `contextual-help-design` skill, body included. A host
    that loads a skill from its directory skips a name that disagrees with it, so

package/skills/feature-audit/SKILL.md

@@ -1,24 +1,30 @@
 ---
 name: feature-audit
 description: >
-  Audit one feature across every layer it is spread over - the surfaces a person
-  uses (a form control, a list or table, a detail view, a filter, a picker, a step
-  flow, a notification), the route that serves it, the authorization that gates
-  it, the service that validates it, and the data that stores it - and produce the
-  matrices that turn a disagreement between those layers into a finding. Use when
-  the task is about one existing feature rather than the whole product: an admin
-  panel, a CRUD screen, a form, a wizard or step flow, a search or picker control,
-  a data table, a bulk action, a permission surface, or a "why does this not work
-  / what is missing here / make this better" ask, and whenever a UI improvement
-  needs a capability the system does not have, or a feature not built yet needs
-  the same matrices as a spec before the build. The unit of analysis is the
-  feature, not the screen: a screen-level review cannot see a capability no
-  surface reaches, a contract field no view renders, or a step whose precondition
-  nothing enforces. Not for the whole product - use `product-analysis`.
+  Use when auditing one feature: admin panel, CRUD screen, form; uçtan uca
+  denetle; wizard, data table, every layer. Not for the product - use
+  `product-analysis`.
 ---
 
 # feature-audit
 
+## When to use
+
+Audit one feature across every layer it is spread over - the surfaces a person
+uses (a form control, a list or table, a detail view, a filter, a picker, a step
+flow, a notification), the route that serves it, the authorization that gates
+it, the service that validates it, and the data that stores it - and produce the
+matrices that turn a disagreement between those layers into a finding. Use when
+the task is about one existing feature rather than the whole product: an admin
+panel, a CRUD screen, a form, a wizard or step flow, a search or picker control,
+a data table, a bulk action, a permission surface, or a "why does this not work
+/ what is missing here / make this better" ask, and whenever a UI improvement
+needs a capability the system does not have, or a feature not built yet needs
+the same matrices as a spec before the build. The unit of analysis is the
+feature, not the screen: a screen-level review cannot see a capability no
+surface reaches, a contract field no view renders, or a step whose precondition
+nothing enforces. Not for the whole product - use `product-analysis`.
+
 A screen review judges what is on the screen. Most of what goes wrong in a real
 feature is not on the screen: it is a disagreement between two layers, or a
 capability that exists on one side only. This skill names the matrices that make

package/skills/hallmark/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hallmark contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.