profile-ui
Skill40 starsChanged 4 days agoApache-2.0View on GitHub
Apply the approved Profile typography, icon and divider design to one named page at a time. Use when asked to "make X match Profile", "use the Profile font sizes", or to restyle a page's headers, section labels, row labels and supporting text to the Profile scale. Maps the page's elements to Profile roles by purpose, applies the verified values from the reference, and reports the mapping with before/after proof. Not for building new components, changing page layout, or editing Profile itself.
In this repository69 other files it gives its agents.
- AGENTS.mdAGENTS.md
- hushh-webapp/AGENTS.mdAGENTS.md
- impeccableSkill
- agent-orchestration-governanceSkill
- analytics-observability-governanceSkill
- animateSkill
- animation-vocabularySkill
- apple-designSkill
- autonomous-rca-governanceSkill
- backend-agents-operonsSkill
- backend-api-contractsSkill
- backend-runtime-governanceSkill
- backendSkill
- brandkitSkill
- client-env-paritySkill
- codex-skill-authoringSkill
- comms-communitySkill
- context-refreshSkill
- contributor-onboardingSkill
- docs-governanceSkill
- emil-design-engSkill
- find-animation-opportunitiesSkill
- founder-brief-curationSkill
- frontend-architectureSkill
- frontend-cache-coherenceSkill
- frontend-design-systemSkill
- frontend-native-surface-mapperSkill
- frontendSkill
- frontend-surface-placementSkill
- future-plannerSkill
- github-contribution-governanceSkill
- hushh-consent-mcpSkill
- hushh-icon-themeSkill
- iam-consent-governanceSkill
- imagegen-frontend-mobileSkill
- imagegen-frontend-webSkill
- improve-animationsSkill
- industrial-brutalist-uiSkill
- kai-test-account-resetSkill
- less-text-karma-jiSkill
- mcp-developer-surfaceSkill
- mobile-nativeSkill
- mobile-parity-auditSkill
- mobile-plugin-contractsSkill
- morphy-axSkill
- one-voice-governanceSkill
- oss-license-governanceSkill
- pdf-artifact-generationSkill
- pick-ui-librarySkill
- pkm-upgrade-rehearsalSkill
- planning-boardSkill
- pr-governance-reviewSkill
- prototypeSkill
- puppy-one-harnessSkill
- quality-contractsSkill
- release-ios-appstoreSkill
- repo-contextSkill
- repo-operationsSkill
- review-animationsSkill
- reviewer-app-testingSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 5 are distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Every measured value (sizes, weights, line heights, tracking, colors, spacing, icon and divider specs) is in …
- Very specific: line 27
Orient: Read the repo instructions, record the current branch and git status (preserve existing edits), and read the target's source and …
- Very specific: line 29
Run cd hushh-webapp && npm run ui:doctor before editing a screen.
- Distinctive: line 33
Map by purpose and hierarchy, not by tag or class: Write the mapping table first (section "Mapping output").
- Very specific: line 38
Flag, do not invent: If a page element has no Profile role (tabs, buttons, inputs, search, chips, tables, numbers, empty states, toasts, …
- Very specific: line 52
Prefer what already exists: the data-slot hooks that SettingsGroup and SettingsRow emit (settings-group-heading, settings-row-title, …
- Very specific: line 76
Never select .profile-home-content, .profile-pane-* or [data-app-side-pane] from another page.
- Very specific: line 78
Never change the default look of SettingsGroup, SettingsRow, SectionLabel, RowLabel or RowDescription, and never edit the --app-side-pane-* …
- Distinctive: line 82
Keep page architecture, routing, APIs, state, content, interactions and layout.
- Distinctive: line 89
Check long content (a 60-character name, a long email, a long description) at 320, 390, 430, 768 and 1280px and at 200% enlargement.
- Very specific: line 94
Check document.documentElement.scrollWidth - clientWidth is 0 and no row clips.
- Distinctive: line 102
Before/after screenshots at the same viewport and state.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
profile-ui
Profile is the visual authority for type hierarchy. This skill carries it to one page per run. Every measured value (sizes, weights, line heights, tracking, colors, spacing, icon and divider specs) is in references/profile-reference.md. Read it first and take every number from it. This file holds none. Keep the reference unchanged unless the user asks for an update, and then re-measure instead of editing by hand.
Invocation
/profile-ui Connect
/profile-ui Connect allThe page is named by the user (name or route). Typography is the default scope. Add all to
include leading icons, chevrons and dividers. One page per run.
Procedure
- Orient. Read the repo instructions, record the current branch and
git status(preserve existing edits), and read the target's source and any owning.voice-action-contract.json. Runcd hushh-webapp && npm run ui:doctorbefore editing a screen. - Measure the "before". Capture the target at 320, 390, 430, 768 and 1280px, plus 200% enlargement, and record the computed font size, weight, line height, tracking and color of each element you will touch.
- Map by purpose and hierarchy, not by tag or class. Write the mapping table first (section "Mapping output"). Use the reference's role table: surface header, header description, identity name and meta, section subtitle, navigation-row label, row description, leading icon, chevron, divider. Pick the home variant for a menu-like list page and the detail variant (reference section 7) for a form or detail page.
- Flag, do not invent. If a page element has no Profile role (tabs, buttons, inputs,
search, chips, tables, numbers, empty states, toasts, long-form body text), leave it
as is and list it as
no Profile role. Never force a match, and never give static text the look of a tappable row label. - Apply once, through shared tokens. See "How to apply" below. No per-page copies of a value.
- Verify, then report (sections below). Do not push, merge or deploy.
How to apply
Cascade authority is the trap (reference section 8). The Profile scale wins through an
@layer base block with !important, because earlier-layer important declarations beat
unlayered ones. A rule written the obvious way loses silently.
- Prefer what already exists: the
data-slothooks thatSettingsGroupandSettingsRowemit (settings-group-heading,settings-row-title,settings-row-description,settings-row-icon,settings-row-chevron), the semantic components incomponents/app-ui/typography.tsx, and the--app-side-pane-*tokens. - Scope by one opt-in attribute on the target page's root,
data-profile-type-scale.grep -n "data-profile-type-scale" hushh-webapp/app/globals.cssfirst. If the block exists, only add the attribute to the page. If not, add the two pieces below, once.- Share the tokens. The
--app-side-pane-*tokens are declared only on the pane and drawer selectors (globals.css:2199-2215), so another page reads them as undefined and its text collapses to the inherited size. Add[data-profile-type-scale]to that selector list. Do not redeclare the values. - One block in
@layer base, after the existing base blocks, using!importantand a four-part selector such as.app-page-shell [data-profile-type-scale] [data-row-layout] [data-slot="settings-row-title"](same shape forsettings-group-headingandsettings-row-description), consuming the tokens.
- Share the tokens. The
- For roles whose Profile values are literals with no token (header, description, identity),
add tokens once, next to the existing
--app-side-pane-*set. Do not rewire Profile's own rules.
Proven on 2026-10-18 in a throwaway harness (a plain list page, comfortable and compact
rows): the opted-in subtree computed exactly the reference group label, row label and row
description values while an untouched sibling kept the app-wide scale. The same block written
unlayered changed nothing, and the layered block without the shared tokens fell back to
the inherited 16px. Re-prove each of these with computed style on the target.
4. Never select .profile-home-content, .profile-pane-* or [data-app-side-pane] from
another page. Those selectors also carry Profile geometry (row geometry, glass cards).
5. Never change the default look of SettingsGroup, SettingsRow, SectionLabel, RowLabel
or RowDescription, and never edit the --app-side-pane-* values: Profile and the Chats
drawer share them. A shared change must be invisible to untargeted pages. Confirm by
grepping every consumer and screenshotting one of them.
6. Keep page architecture, routing, APIs, state, content, interactions and layout. Typography
edits do not move or resize controls other than through natural text wrapping.
7. Where weight 500 or 800 is specified, set it, then report the painted face. Only 400, 600
and 700 ship (550 paints SemiBold, 500 paints Regular).
Resizing and wrapping (required)
- Check long content (a 60-character name, a long email, a long description) at 320, 390, 430, 768 and 1280px and at 200% enlargement.
- Text wraps naturally (
overflow-wrap: anywhere, no clipping, no ellipsis that hides content). Fix a local overflow by changing the container (min-width, wrapping, padding). Never shrink the text to fit and never hide it. - Check
document.documentElement.scrollWidth - clientWidthis 0 and no row clips. - The smallest Profile roles are tiny and low-contrast (reference section 9). Report them for every page, with the 200% result.
Verification
- Computed-style check of every changed role against the reference (the probe in reference
section 10 is a template). Report the painted font face, not just
font-weight. - Before/after screenshots at the same viewport and state. Auth-gated pages cannot be signed in by an
agent; use the signed-in session the user opened, or the repo's fixture pattern
(
e2e/profile-legal-connectors.layout.spec.ts: Vite bundle plus compiledglobals.css). cd hushh-webapp && npm run ui:doctor, thennpm run build:ui-contractsandnpm run verify:ui-contractswhen a screen's imported UI changed, plus the page's own tests andnpx tsc --noEmit/ lint on touched files. Add a test only for a real contract, and extend the nearest existing test file.- Say plainly what was not verified (dark scheme, iOS WebKit, signed-in data).
Mapping output
Return this table before any edit, then again with the result.
| Page element (file:line) | Purpose and hierarchy | Profile role | Applied values (from the reference) | Notes |
Then: changed files, matching before/after screenshots, verification results, unmapped
elements (no Profile role), and open risks. No Co-Authored-By trailer in any commit message.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

