open-design/skills
Vedank Vansia ee3ca5f4f0
refine typography-hierarchy craft docs — clarify edge cases and make lint measurable (#979)
* add typography-hierarchy and typography-hierarchy-editorial craft rules

Adds two layered craft files extending typography.md:

- typography-hierarchy.md: core hierarchy contract, vectors, failure modes,
  controlled violations, and lint checklist
- typography-hierarchy-editorial.md: editorial pacing, dramatic scale jumps,
  whitespace hierarchy, display tracking overrides, and editorial-specific lint

Both files are registered in craft/README.md with guidance on when to require them.
Includes a new editorial stack example showing the layered opt-in pattern.

Validation:
- pnpm guard: PASSED
- Universal craft knowledge (not brand-specific)
- Stable slugs: typography-hierarchy, typography-hierarchy-editorial
- No new dependencies or breaking changes

Passes craft additions lane per code-review-guidelines.md.

* wire typography base into editorial skills craft stack

All three editorial skills now require the complete layered stack:
  [typography, typography-hierarchy, typography-hierarchy-editorial, rtl-and-bidi]

The new hierarchy files (typography-hierarchy.md, typography-hierarchy-editorial.md)
explicitly extend typography.md and depend on its base contract (scale ranges,
tracking values, line-height guidance, weight system). Without typography in
requires[], the hierarchy rules arrive at runtime without their foundational
contracts, making them incomplete.

Skills updated:
- skills/blog-post/SKILL.md
- skills/docs-page/SKILL.md
- skills/digital-eguide/SKILL.md

This completes the craft injection for the editorial stack as documented in
craft/README.md and ensures both base typography and hierarchy extensions load
together at runtime.

* refine craft docs for clarity and edge cases

Address P2/P3 reviewer feedback:

- typography-hierarchy-editorial.md §4: Add script-aware exception for Arabic/Hebrew/Persian
  tracking (cursive joining breaks with negative letter-spacing; use scale/space instead)

- typography-hierarchy.md Controlled violations: Add concrete safeguards for 'information
  flow remains intact' (reading order, proximity grouping, single primary, quick scanability)

- typography-hierarchy-editorial.md §2 Whitespace: Qualify 'no divider' rule to allow
  separators for publication identity, not just space alone

- typography-hierarchy-editorial.md Anti-patterns: Add docs-page carve-out for 'UI chrome'
  (functional controls in code/API blocks are OK; decorative badges belong outside measure)

- typography-hierarchy-editorial.md Lint: Make checks measurable — display/deck ratio >=1.5x,
  section spacing ratio rules (one gap >=1.5x baseline, another <=1.2x), separator identity
  check, and explicit guidance markers for auditability

* address P1/P2/P3 reviewer feedback: RTL conflicts, script accuracy, tracking scope, measurability

P1 — RTL physical-direction conflicts:
  - typography-hierarchy-editorial.md: Change 'ragged right' to 'text-align: start with
    ragged inline-end' for RTL compatibility
  - Separators in RTL: Add note on logical directions (inline-start/inline-end)
  - skills/digital-eguide/SKILL.md: Replace 'cover left, spread right' with
    'inline-start/inline-end' and 'pinned right-side' with 'pinned to inline-end'

P2 — Script-group accuracy:
  - Split script groups correctly: Arabic/Persian/Urdu cursive-joining (letter-spacing 0);
    Hebrew is RTL but not cursive-joining

P2 — Tracking exception scope:
  - Extend script exception to pull-quote tracking row (was only on display)
  - Mark both as Latin-only with joining-script carve-out

P2 — Primary-count inconsistency:
  - Clarify 'one at a time per visual region' with explicit long-form pacing resets note

P3 — Measurable lint:
  - Replace vague 'meaningfully larger' with >=1.5x baseline rhythm OR one token scale step

P3 — Orphaned reference:
  - Fix cross-ref to 'typography.md §letter-spacing' (was §display tracking)

P3 — Markdown typo:
  - Fix backtick nesting in '1.6–1.7' line-height range

* fix: RTL logical 'ragged' wording; make digital-eguide pull-quote script-aware; align section-separators lint with prose

* fix(P2): include Persian/Urdu in pull-quote script exception; remove 'space' from section-separators lint

* fix: align pull-quote bullet indentation in digital-eguide SKILL.md

* fix: align digital-eguide pull-quote bullet nesting

* fix: use logical pull-quote alignment wording in editorial craft
2026-05-09 08:13:35 +08:00
..
audio-jingle Add live artifacts and Composio connector catalog (#381) 2026-05-05 16:42:11 +08:00
blog-post add typography-hierarchy and typography-hierarchy-editorial craft rules (#975) 2026-05-09 02:15:33 +08:00
clinical-case-report feat(skills): add clinical-case-report skill (#581) 2026-05-08 22:36:37 +08:00
critique Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
dashboard craft: add laws-of-ux guidance 2026-05-07 20:02:26 +08:00
dating-web feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
dcf-valuation feat: agent-callable research command and /search (#615) 2026-05-08 10:33:44 +08:00
design-brief feat: add design-brief skill with structured I-Lang input format (#184) 2026-05-01 23:11:38 +08:00
digital-eguide refine typography-hierarchy craft docs — clarify edge cases and make lint measurable (#979) 2026-05-09 08:13:35 +08:00
docs-page add typography-hierarchy and typography-hierarchy-editorial craft rules (#975) 2026-05-09 02:15:33 +08:00
email-marketing feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
eng-runbook Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
finance-report craft: add rtl-and-bidi so OD artifacts don't break for Arabic / Hebrew / Persian users (#595) 2026-05-06 12:43:48 +08:00
flowai-live-dashboard-template add FlowAI live dashboard template skill (#801) 2026-05-07 19:07:45 +08:00
gamified-app feat(craft): animation-discipline module + opt-ins on mobile-app, mobile-onboarding, gamified-app (#515) 2026-05-05 18:32:30 +08:00
github-dashboard feat(skill): add github-dashboard (#666) 2026-05-08 17:21:12 +08:00
guizang-ppt docs: add Brazilian Portuguese (pt-BR) translations (#460) 2026-05-05 09:14:06 +08:00
hatch-pet feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
hr-onboarding feat(craft): accessibility-baseline module + opt-ins on dashboard, hr-onboarding, mobile-onboarding (#587) 2026-05-06 09:18:59 +08:00
html-ppt docs: add Brazilian Portuguese (pt-BR) translations (#460) 2026-05-05 09:14:06 +08:00
html-ppt-course-module feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-dir-key-nav-minimal feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-graphify-dark-graph feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-hermes-cyber-terminal feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-knowledge-arch-blueprint feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-obsidian-claude-gradient feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-pitch-deck feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-presenter-mode-reveal feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-product-launch feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-taste-brutalist feat(skills): add taste-skill-derived web prototype and HTML PPT examples (#358) 2026-05-03 20:31:05 +08:00
html-ppt-taste-editorial feat(skills): add taste-skill-derived web prototype and HTML PPT examples (#358) 2026-05-03 20:31:05 +08:00
html-ppt-tech-sharing feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-testing-safety-alert feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-weekly-report feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-xhs-pastel-card feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-xhs-post feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-xhs-white-editorial feat(skills): integrate lewislulu/html-ppt-skill + 15 per-template Examples cards (#193) 2026-05-02 11:00:44 +08:00
html-ppt-zhangzara-8-bit-orbit feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-biennale-yellow feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-block-frame feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-blue-professional feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-bold-poster feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-broadside feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-capsule feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-cartesian feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-cobalt-grid feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-coral feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-creative-mode feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-daisy-days feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-editorial-tri-tone feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-grove feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-long-table feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-mat feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-monochrome feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-neo-grid-bold feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-peoples-platform feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-pin-and-paper feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-pink-script feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-playful feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-raw-grid feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-retro-windows feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-retro-zine feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-sakura-chroma feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-scatterbrain feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-signal feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-soft-editorial feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-stencil-tablet feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-studio feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
html-ppt-zhangzara-vellum feat(skills): add 32 zhangzara HTML deck templates (#704) 2026-05-08 12:02:59 +08:00
hyperframes feat(skills): teach hyperframes skill the HTML-in-Canvas API (#852) 2026-05-08 11:07:15 +08:00
ib-pitch-book feat: add ib-pitch-book deck skill (Pitch Agent port) (#888) 2026-05-08 17:49:57 +08:00
image-poster Add live artifacts and Composio connector catalog (#381) 2026-05-05 16:42:11 +08:00
invoice Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
kami-deck feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
kami-landing feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
kanban-board craft: add laws-of-ux guidance 2026-05-07 20:02:26 +08:00
last30days feat: agent-callable research command and /search (#615) 2026-05-08 10:33:44 +08:00
live-artifact feat(skills/live-artifact): add 7 example dashboards + contract demo (#716) 2026-05-08 17:38:29 +08:00
live-dashboard add live-dashboard skill (#778) 2026-05-07 18:21:22 +08:00
magazine-poster Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
meeting-notes Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
mobile-app feat(craft): animation-discipline module + opt-ins on mobile-app, mobile-onboarding, gamified-app (#515) 2026-05-05 18:32:30 +08:00
mobile-onboarding craft: add laws-of-ux guidance 2026-05-07 20:02:26 +08:00
motion-frames Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
open-design-landing feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
open-design-landing-deck feat(skills): open-design-landing rename, kami skills, landing OG (#428) 2026-05-04 19:22:46 +08:00
orbit-general feat(skills): add 5 Orbit briefing templates (#671) 2026-05-06 21:39:52 +08:00
orbit-github feat(skills): add 5 Orbit briefing templates (#671) 2026-05-06 21:39:52 +08:00
orbit-gmail feat(skills): add 5 Orbit briefing templates (#671) 2026-05-06 21:39:52 +08:00
orbit-linear feat(skills): add 5 Orbit briefing templates (#671) 2026-05-06 21:39:52 +08:00
orbit-notion feat(skills): add 5 Orbit briefing templates (#671) 2026-05-06 21:39:52 +08:00
pm-spec Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
pptx-html-fidelity-audit feat(pptx-fidelity): broaden script coverage beyond CJK (#308) 2026-05-03 00:53:28 +08:00
pricing-page craft: add laws-of-ux guidance 2026-05-07 20:02:26 +08:00
replit-deck Feat: add replit-deck skill with 8 themes from replit.com/slides (#74) 2026-04-30 11:19:52 +08:00
saas-landing docs: fix stale internal links (#950) 2026-05-08 21:20:25 +08:00
simple-deck Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
social-carousel Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
social-media-dashboard feat(skills): add social-media-dashboard skill + Totality Festival design system (#678) 2026-05-06 21:50:23 +08:00
social-media-matrix-tracker-template add social-media-matrix-tracker template skill (#810) 2026-05-07 21:32:25 +08:00
sprite-animation Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
team-okrs Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
trading-analysis-dashboard-template add trading analysis dashboard template skill (live artifacts) (#824) 2026-05-08 12:08:43 +08:00
tweaks Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
video-shortform Add live artifacts and Composio connector catalog (#381) 2026-05-05 16:42:11 +08:00
waitlist-page add waitlist-page skill (#555) 2026-05-07 17:39:17 +08:00
web-prototype Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
web-prototype-taste-brutalist feat(skills): add taste-skill-derived web prototype and HTML PPT examples (#358) 2026-05-03 20:31:05 +08:00
web-prototype-taste-editorial feat(skills): add taste-skill-derived web prototype and HTML PPT examples (#358) 2026-05-03 20:31:05 +08:00
web-prototype-taste-soft feat(skills): add taste-skill-derived web prototype and HTML PPT examples (#358) 2026-05-03 20:31:05 +08:00
weekly-update Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
wireframe-sketch Refactor project name from "Open Claude Design" to "Open Design" (#1) 2026-04-28 16:03:35 +08:00
x-research feat: agent-callable research command and /search (#615) 2026-05-08 10:33:44 +08:00