# 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.

- Skill: `majiayu000/markdowntown-frontend` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/markdowntown-frontend`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/markdowntown-frontend/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/markdowntown-frontend

---


# 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