Melvynx/saveit.now / .agents/skills/ns-ui
ns-ui
VerifiedRoute NowStack Mobile UI work to the right design/build skill while enforcing a clear, user-first UX bar. Use for any "build/design/redesign/polish the UI" request on the mobile app, web app, landing, or admin — when the surface or the right skill is underspecified.
UI - NowStack Mobile
The routing skill for any UI work in this repo. Pick the right specialist skill for the surface, but the UX bar below is non-negotiable and applies no matter which skill you route to. A screen that looks good but is unclear, cramped, or breaks platform conventions does not pass.
Mandatory First Step
Read the rule file(s) for the surface you'll touch before editing:
- Mobile (
mobile-app/**):.agents/rules/mobile-app.md+.agents/skills/ns-init-project/references/theming.md - Web / landing / admin (
web-app/**):.agents/rules/web-app.md - Either surface:
.agents/rules/typescript-and-code-style.md
Then identify the surface (mobile vs web), the task type (new screen, redesign, single component, polish, copy, brand art), and read at least 3 existing files — a similar screen, its caller, and an imported components/ui/ primitive — before writing anything new.
The UX Bar (non-negotiable — enforce on every route)
Whatever skill builds the UI, the result MUST satisfy all of these:
- Clarity first. One primary action per screen, obvious at a glance. The user should never wonder "what do I do here?" Reduce choices; don't decorate.
- Visual hierarchy. Size, weight, spacing, and color encode importance. Generous whitespace. No wall-of-controls; group related things.
- Reuse the system. Use existing
components/ui/primitives and the CVA Button/Text/Card before inventing screen-local styling. Match the surrounding code's idioms. - One source of truth for color. Mobile themed surfaces come from
mobile-app/lib/theme.tsvia semantic tokens (bg-background,text-foreground,bg-brand) oruseTheme().colorsfor native APIs — never inline a themed hex. Web uses the design tokens, not one-off Tailwind colors. - States are designed, not afterthoughts. Handle empty, loading, error, and success. No raw spinners where a skeleton or message belongs.
- Touch & keyboard ergonomics (mobile). Tap targets ≥44pt. Any screen with a
TextInputkeeps inputs and the submit button above the keyboard (KeyboardAvoidingViewon the outer/bottom-panel container — see.agents/rules/mobile-app.md). - Platform-native feel. Respect iOS/Android conventions (native tabs, sheets, SF Symbols on iOS). Don't fight the OS surface.
- Accessible & legible. Sufficient contrast in both themes, no text overflow/truncation at small widths, readable type scale, labels on icon-only controls.
- Copy is part of the UI. Microcopy is plain, specific, and action-oriented. No jargon, no dead-end errors.
- No default decoration. Avoid gradients/orbs/emojis unless explicitly requested (per repo style rules).
If a routed skill's output violates any of these, fix it before reporting done.
Route To A Specific Skill
Mobile (Expo Router / React Native)
- Native screen, navigation, layout, animation, native tabs, Liquid Glass, Expo Symbols:
building-native-ui - Real native components (
@expo/uiSwiftUI/Compose) — grouped settings forms, native sheets, pickers, sliders, menus where RN components fall short:expo-ui - RN performance, lists, animation correctness, native-module UI patterns:
vercel-react-native-skills - In-context dialog, bottom sheet, drawer, modal form (instead of a new route):
mobile-dialog-sheets - Apply a named mobile visual style:
use-mobile-style - App icon, splash, onboarding/brand art:
ns-images
Web (TanStack Start / shadcn / Tailwind v4)
- shadcn components, registries, composition, fixing/styling shadcn UI:
shadcn - Polished production web pages, dashboards, React components, visual redesigns:
frontend-design - Apply a named web visual style (ios-app, linear, stripe, vercel-simple, …):
use-style - Public landing page refresh/redesign:
ns-web-landing-page
Either surface — design quality & UX
- Deep UI/UX review, polish, hierarchy, accessibility, motion, redesign critique:
impeccable - General frontend design guidelines / heuristics:
web-design-guidelines - Make a bland/awkward interface feel better:
make-interfaces-feel-better - Improve unclear copy, labels, error messages, microcopy:
clarify
If a specific skill clearly matches, invoke it (it carries the deep know-how) — then return here to validate the result against The UX Bar. If none matches (a small, well-understood change), build it directly while honoring the bar and repo rules.
Repo Constraints
- Mobile lives in
mobile-app/, web inweb-app/. There is noadmin-web/landing-web— admin is/admininsideweb-app. - Keep Expo Router route groups (
(app),(auth),(flow)) in hrefs; bottom bar isNativeTabs(don't set itsbackgroundColor). /adminstays dense and operational (no marketing cards); dev affordances use yellow, admin-only affordances use orange.- Public web routes must render without Convex env.
- Path aliases:
@/*inside app folders,@convex/*for backend,@site-configfor shared config. No new barrelindex.ts.
Default Verification
Mobile changes:
cd mobile-app && npx tsc --noEmit && npm run lint
Then verify on the Simulator with the /ns-ios-verification skill (never computer-use).
Web changes:
cd web-app && npm run typecheck
cd web-app && npm run build # for route/config changes
Then verify routes with the /dev-browser skill at a desktop and a mobile viewport.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |