Skip to content

docs: brand vs product register awareness#29

Open
adelaidasofia wants to merge 2 commits into
Leonxlnx:mainfrom
adelaidasofia:proposal-register-awareness
Open

docs: brand vs product register awareness#29
adelaidasofia wants to merge 2 commits into
Leonxlnx:mainfrom
adelaidasofia:proposal-register-awareness

Conversation

@adelaidasofia
Copy link
Copy Markdown

Summary

Adds docs/REGISTER_AWARENESS.md — a single documentation file that names the brand-vs-product register distinction that emerges after running the skills against both brand surfaces (landing pages, campaign pages) and product surfaces (dashboards, admin tools).

Pure documentation addition. No skill content changed, no existing behavior altered.

Motivation

The taste-skill bundle is genuinely useful. After applying the skills across multiple project types, one pattern emerges worth surfacing in the docs: many rules read as brand-register defaults when they're applied uniformly to every project. Concretely:

  • Inter banned for premium contexts. In a marketing surface that's the right call; in a product UI (dashboard, admin panel) Inter is the common cross-platform default and system fonts are legitimate.
  • Fluid clamp() typography. Brand-shaped. Product UIs are viewed at consistent DPI, and a fluid h1 that shrinks in a sidebar looks worse than a fixed-rem scale.
  • Asymmetric / Cinematic Centered / Editorial Split layouts. Brand-shaped. Product UIs lean on predictable grids because consistency is an affordance.
  • Pseudo-system labels (e.g. SECTION 04) are generally right to skip, but a real ops dashboard has legitimate operator labels and small mono metadata. "Skip unless truly necessary" sometimes gets misread as "always skip."

What this PR contains

One new file at docs/REGISTER_AWARENESS.md with:

  • The two registers defined (brand = design IS the product; product = design SERVES the product)
  • A swap-list of ~14 rules that genuinely diverge between the two
  • A per-skill register-fit table mapping the current bundle to each register (most skills are brand-default; minimalist-skill is closest to product; output-skill is register-agnostic)
  • Two proposed shapes for surfacing register at the skill level — a top-level dial (REGISTER: brand) alongside the existing three, OR per-skill frontmatter — without committing to either
  • Cross-references to pbakaus/impeccable (Apache 2.0, derives from Anthropic's frontend-design) which uses the register split as its primary structuring decision, and to kylezantos/design-motion-principles for the Frequency Gate that reads cleanly across both registers

What this PR does NOT contain

  • No changes to any skills/*/SKILL.md files
  • No new skill added (the doc proposes where a future product-ui-taste skill would fit, but doesn't ship one)
  • No README changes (happy to add a "See also" link if you want it)
  • No build / config / install-script changes

Reviewer notes

  • The doc is meant to give callers and contributors a shared vocabulary, not to force a refactor. The existing bundle keeps working as-is for brand work.
  • Both proposed register shapes are backward-compatible — default = brand = current behavior.
  • If you'd rather close this and reuse the framing differently (e.g. integrate into the main README, or split into a smaller note), happy to revise.

Thank you for the work on this skill.

Surfaces the brand-vs-product register distinction that emerges after
running the existing skills against both brand surfaces (landing pages,
campaign pages) and product surfaces (dashboards, admin, tools).

Names the rules that genuinely swap between registers (Inter font,
system font stack, fluid clamp() vs fixed rem, layout patterns, motion
duration, image stock source, navigation patterns, component states),
provides a per-skill register-fit table for the current bundle, and
proposes two clean shapes for surfacing register at the skill level —
either as a top-level dial or as per-skill frontmatter.

Pure documentation addition. No skill content changed, no existing
behavior altered. Cross-references pbakaus/impeccable (Apache 2.0,
derived from Anthropic's frontend-design) for adjacent prior art on
the register split.
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 86ca4a9d9b

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread docs/REGISTER_AWARENESS.md Outdated
| Skill | Default fit | Notes |
|---|---|---|
| `design-taste-frontend` | Brand | The default all-rounder; reads brand-leaning when applied to dashboards |
| `gpt-tasteskill` | Brand | Stricter brand-grade output |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the GPT skill install name in register-fit table

This row uses gpt-tasteskill (folder name), but the callable skill name is gpt-taste (skills/gpt-tasteskill/SKILL.md has name: gpt-taste, and README’s install table also documents --skill gpt-taste). In this table the other entries are largely presented as skill names, so this mismatch can cause users to copy the wrong identifier when selecting a register-aligned skill.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in f32ed6b. Changed gpt-tasteskill to gpt-taste in the register-fit table to match the callable name in SKILL.md and the README install table.

…l) in register-fit table

Address Codex bot review comment: REGISTER_AWARENESS.md table had 'gpt-tasteskill' (the
folder name) where 'gpt-taste' (the SKILL.md name: field, matching README install table)
is the correct callable identifier.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant