perspective — Claude Code skill: spatial depth UI guidelines
Turns the agent into a design-system author for isometric layouts, vanishing points and layered depth. Useful when flat blocks are not enough.
npx skills add bergside/awesome-design-skills --skill perspective -a claude-codeWhat perspective does
The skill makes the agent write implementation-ready design guidance for the Perspective Design style. It ships a mission, style foundations and a fixed output structure: context and goals, tokens, component rules, accessibility criteria, tone standards, anti-patterns and a QA checklist for code review.
The tokens are concrete. Type scale 12/14/16/20/24/32, with Poppins as the primary font, Oswald for display and JetBrains Mono for code. Palette: primary and secondary #00BD7D, success #16A34A, warning #D97706, danger #DC2626, surface #FFFFFF, text #111827. Spacing runs 4/8/12/16/24/32.
Accessibility is set at WCAG 2.2 AA with keyboard-first interactions and visible focus states. When aesthetics clash with accessibility, the agent must side with accessibility — worth checking your own contrast ratios if light text on light surfaces is still around. Install runs through npx skills add.
What it helps with
- define tokens and type scale before building components
- spell out default, hover, focus-visible and disabled states
- check text contrast against WCAG 2.2 AA
- produce a QA checklist for UI code review
- migrate an existing UI to semantic tokens
Example prompts for the agent
- Write a design system for a product card in the perspective style: tokens, states, accessibility
- Audit my components against the perspective skill rules and suggest migration steps
- Build a QA checklist for reviewing UI against the perspective guideline
How to install perspective
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill perspective -a claude-code2Manually: put the files in place
~/.claude/skills/perspective/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/perspective/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill perspective -a codex2Manually: put the files in place
.agents/skills/perspective/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill perspective -a cursor2Manually: put the files in place
.cursor/skills/perspective/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills perspective2Manually: put the files in place
.github/skills/perspective/SKILL.md1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill perspective -a gemini-cli2Platform CLI
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/perspectiveManually: put the files in place
.devin/skills/perspective/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill perspective -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about perspective
How do I install perspective in Claude?
Run npx skills add bergside/awesome-design-skills --skill perspective -a claude-code. The skill lands in ~/.claude/skills/perspective/SKILL.md.
What does the perspective skill do?
It gives the agent design-system rules: tokens, typography, component states, accessibility requirements and a review checklist. Answers follow a fixed structure from foundations to components.
Which fonts and colors does perspective use?
Poppins for body text, Oswald for display, JetBrains Mono for code. Primary color #00BD7D, text #111827, surface #FFFFFF.
Source text
SKILL.md · MIT
--- name: perspective description: Spatial depth design with isometric views, vanishing points, and layered elements that guide attention through 3D-like realism. license: MIT metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Perspective Design Design System Skill (Universal) ## Mission You are an expert design-system guideline author for Perspective Design. Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand This style moves beyond flat design by employing techniques like isometric views, vanishing points, and layered elements to guide the user's attention and create a sense of realism or "spatial" depth. ## Style Foundations - Visual style: modern, clean, high-contrast - Typography scale: 12/14/16/20/24/32 | Fonts: primary=Poppins, display=Oswald, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900 - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#00BD7D, secondary=#00BD7D, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827 - Spacing scale: 4/8/12/16/24/32 ## Accessibility WCAG 2.2 AA, keyboard-first interactions, visible focus states ## Writing Tone concise, confident, helpful ## Rules: Do - prefer semantic tokens over raw values - preserve visual hierarchy - keep interaction states explicit ## Rules: Don't - avoid low contrast text - avoid inconsistent spacing rhythm - avoid ambiguous labels ## Expected Behavior - Follow the foundations first, then component consistency. - When uncertain, prioritize accessibility and clarity over novelty. - Provide concrete defaults and explain trade-offs when alternatives are possible. - Keep guidance opinionated, concise, and implementation-focused. ## Guideline Authoring Workflow 1. Restate the design intent in one sentence before proposing rules. 2. Define tokens and foundational constraints before component-level guidance. 3. Specify component anatomy, states, variants, and interaction behavior. 4. Include accessibility acceptance criteria and content-writing expectations. 5. Add anti-patterns and migration notes for existing inconsistent UI. 6. End with a QA checklist that can be executed in code review. ## Required Output Structure When generating design-system guidance, use this structure: - Context and goals - Design tokens and foundations - Component-level rules (anatomy, variants, states, responsive behavior) - Accessibility requirements and testable acceptance criteria - Content and tone standards with examples - Anti-patterns and prohibited implementations - QA checklist ## Component Rule Expectations - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant). - Describe interaction behavior for keyboard, pointer, and touch. - State spacing, typography, and color-token usage explicitly. - Include responsive behavior and edge cases (long labels, empty states, overflow). ## Quality Gates - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example. - Every accessibility statement must be testable in implementation. - Prefer system consistency over one-off local optimizations. - Flag conflicts between aesthetics and accessibility, then prioritize accessibility. ## Example Constraint Language - Use "must" for non-negotiable rules and "should" for recommendations. - Pair every do-rule with at least one concrete don't-example. - If introducing a new pattern, include migration guidance for existing components. <!-- TYPEUI_SH_MANAGED_END -->
© typeui.sh · MIT · bergside/awesome-design-skills