Back to skills
extension
Category: Development & EngineeringNo API key required

markdowntown-frontend

Frontend UX and design system guidance for markdowntown. Use when changing UI, layout, styling, typography, motion, or Tailwind classes, especially for Workbench, Atlas, and Library surfaces.

personAuthor: jakexiaohubgithub

markdowntown-frontend

Core workflow

  1. Identify the surface (Home, Atlas, Workbench, Library, Detail, Translate).
  2. Check design constraints and lint rules before editing styles.
  3. Apply changes with existing component patterns and tokens.
  4. Validate responsive layout and run lint/test commands.

Guardrails

  • Avoid raw hex colors (lint: pnpm lint:hex).
  • Avoid Tailwind neutral palette (lint: pnpm lint:neutrals).
  • Prefer existing spacing/typography tokens and component primitives.
  • Keep motion subtle and aligned with UX guidance.

References

  • docs/DESIGN_SYSTEM.md
  • docs/design/motion-responsive.md
  • docs/design/sitewide-ui-audit.md
  • docs/ux/primary-flow-spec.md
  • codex/skills/markdowntown-frontend/references/design-system.md
  • codex/skills/markdowntown-frontend/references/ui-ux.md