Communitygithub.com

ulasalyesil/personal-website-v2

기존 표면을 하위 계층 결정과 대조하여 감사하고, 어휘, 객체 일관성, 완전성, 피드백, 계층 구조, 접근성에 대한 표면 결정 인벤토리를 생성합니다.

personal-website-v2란 무엇인가요?

이 스킬은 UI/UX 설계의 '표면 계층'(surface layer)을 체계적으로 감사(audit)하고 결정 인벤토리(decision inventory)를 생성하는 프레임워크입니다. 사용자가 실제로 마주하는 모든 요소(단어, 소리, 시각, 물리적 어포던스 등)가 하위 계층(개념 모델, 브레드보드, 상호작용 흐름)에서 내려진 결정을 충실히 반영하는지 검증합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 도우미 환경에서 활용되며, 에이전트가 '개념 모델의 어휘와 객체 일관성', '브레드보드의 모든 어포던스 존재 여부', '정서적 등록(emotional register)', '피드백 및 오류 메시지의 완전성', '시각적 계층 구조', '접근성'을 코드 또는 디자인 단계에서 점검하도록 안내합니다. 또한 표면에서 발견된 문제가 실제로는 더 깊은 계층(예: 상호작용 흐름 설계)의 문제인지 진단하여 수정 방향을 제시합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-surface

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/layers-surface

프레임워크 맥락을 위해 /layers-intro가 로드되었다고 가정합니다.

표면 계층은 아래 계층에서 결정된 모든 것이 사람이 실제로 마주하는 형태(단어, 소리, 시각, 물리적 어포던스, 움직임, 피드백)가 되는 곳입니다. 이는 가장 매체 특정적인 계층이지만, 가장 중요한 결정은 매체와 관계없이 보편적으로 적용됩니다. 즉, 표면이 화면, 음성 인터페이스, 물리적 장치 또는 서비스 접점이든 상관없습니다.

표면 위반은 종종 더 깊은 문제의 증상입니다. 이 스킬은 표면에서 수정할 수 있는 문제와 하위 계층을 다시 검토해야 하는 문제를 구분합니다.

이 계층이 내려야 할 결정:

  • 표면이 개념 모델의 어휘와 객체를 존중하는가?
  • 브레드보드의 모든 어포던스가 존재하는가? 그리고 그 뒤에 모델이 없는 표면 콘텐츠는 없는가?
  • 표면이 사용자가 수행하는 작업에 맞는 올바른 정서적 등록을 전달하는가?
  • 사용자는 무슨 일이 일어났는지, 진행 중인 것은 무엇인지, 무엇이 잘못되었는지 어떻게 알 수 있는가?
  • 가장 두드러지는 것은 무엇이며, 그래야 하는가?
  • 모든 정보가 필요로 하는 사용자에게 접근 가능한가?

방법:

방법시기
실제 매체에서 직접 작업(코드, 프로덕션 UI)실제 상호작용에 대한 실제 피드백이 필요할 때. 목업에서 보이는 모습과 실제 사용 시 동작 간의 차이를 피합니다.
고충실도 목업(Figma 등)레이아웃, 시각적 계층 구조, 시각적 형태 탐색 — 특히 새로운 패턴이나 이해관계자 조정을 위해.
디자인 시스템 / 컴포넌트 라이브러리제품에 확립된 컴포넌트와 토큰이 있을 때. 표면 결정은 시스템을 확장해야 하며, 모순되어서는 안 됩니다.
스타일 타일레이아웃을 결정하지 않고 초기에 시각적 언어를 확립. 초기 톤 조정을 위해 하이파이보다 빠릅니다.
프로토타입상호작용 동작(전환, 피드백 타이밍, 흐름) 테스트 — 정적 목업이 전달할 수 없는 것.
카피 우선언어가 주요 디자인 자료일 때 — 메시징, 온보딩, 오류 상태. 컨테이너를 디자인하기 전에 카피를 작성합니다.

품질 신호 — 좋은 표면 결정이 어떤 모습인가:

  • 모든 용어가 개념 모델의 보편적 언어(ubiquitous language)와 일치합니다.
  • 모든 객체가 맥락에 따라 일관된 표현을 가지며, 변형체(shapeshifter)나 가려진(masked) 형태가 아닙니다.
  • 브레드보드의 모든 어포던스가 존재하며, 모든 표면 요소에는 그 뒤에 모델이 있습니다.
  • 정서적 등록이 사용자 니즈의 정서적 및 사회적 작업과 일치합니다.
  • 오류 메시지는 세 가지를 수행합니다: 진단(무슨 일이 일어났는지), 설명(왜), 복구(다음에 무엇을 해야 하는지). "문제가 발생했습니다"는 세 가지 모두 실패합니다.
  • 두드러짐(prominence)은 중요성을 반영합니다 — 흐름이 사용자에게 주목하도록 요구하는 것이 두드러지는 것입니다.
  • 접근성 결정은 명시적으로 이루어지며, 기본값으로 남겨지지 않습니다.

가이드 세션

이 스킬은 두 부분으로 구성됩니다. 필요한 것을 알려주세요:

  • 감사(Audit) — 기존 표면 작업을 하위 계층 결정과 대조하여 평가합니다(1~5단계).
  • 결정 인벤토리(Decision inventory) — 열린 표면 결정을 처리합니다(6~10단계).

무엇을 가지고 있는지 설명하거나 "안내해 주세요(guide me)"라고 말씀해 주세요.

질문: "이 세션의 작업을 어디에 기록해야 할까요?" (옵션은 /layers-intro 참조)

질문:

  1. 어떤 제품이나 기능을 작업 중인가요?
  2. 어떤 매체인가요 — 화면 UI, 음성/대화형, 물리적, 서비스 접점?
  3. 하위 계층에서 무엇을 가지고 있나요? 개념 모델(객체 + 보편적 언어)? 브레드보드 또는 흐름? 정서적/사회적 작업을 포함한 작업 스토리?

파트 1 — 감사 (Audit)

1단계 — 표면 프레이밍

기존 표면 작업(작동 중인 코드, 배포된 UI, 카피, 시각 디자인)이 존재하나요? 아니면 표면이 아직 시작되지 않았나요? 아직 시작되지 않았다면 파트 2로 건너뛰세요.

2단계 — 어휘 및 언어

개념 모델에서 보편적 언어 목록을 가져옵니다. 디자이너에게 표면 카피(레이블, 제목, 버튼 텍스트, 오류 메시지, 알림, 도움말 텍스트)를 공유하도록 요청하세요.

모든 용어를 확인하세요. 플래그:

  • 직접 위반 — 모델 용어가 잘못되었거나 일관성 없이 사용됨(한 곳에서는 "계정", 다른 곳에서는 "작업 공간")
  • 목록에 없는 용어 — 보편적 언어에 없는 표면의 단어. 모델에 추가할 새 용어인가요, 아니면 표면 노이즈인가요?
  • 톤 불일치 — 기술적으로는 정확하지만 정서적/사회적 작업에 대해 톤이 잘못됨

각 위반에 대해: 표면 수정(카피 다시 쓰기)인가요, 아니면 더 깊은 수정(개념 모델 어휘 업데이트)인가요?

3단계 — 객체 일관성

개념 모델의 각 객체에 대해: 표면의 어디에 나타나나요? 몇 가지 형태로 나타나나요?

  • 변형체(Shapeshifters) — 동일한 객체가 맥락에 따라 현저히 다른 시각적 또는 구조적 형태로 나타남
  • 가려진 객체(Masked objects) — 객체가 사용자가 해당 객체 유형으로 인식할 수 없는 형태로 나타남

각각에 대해: 이것이 표면 결정(일관된 처리 방식 확립)인가요, 아니면 개념 모델 문제(객체의 정체성이 모델에서도 불분명함)인가요?

4단계 — 완전성 확인

브레드보드를 가져옵니다. 각 장소와 어포던스에 대해:

  • 브레드보드의 모든 어포던스가 표면에 존재하나요?
  • 대응하는 브레드보드 요소가 없는 표면 콘텐츠가 있나요?

브레드보드에 없었던 추가 사항은 종종 상호작용 계층 결정이 누락된 것입니다. 이를 플래그로 표시하고 /layers-interaction-flow를 다시 검토할 것을 권장합니다.

5단계 — 정서적 등록

작업 스토리, 특히 정서적 및 사회적 작업으로 돌아갑니다.

"사용자가 여기서 수행하는 정서적 작업은 무엇인가요? 기능적 작업뿐만 아니라 어떻게 느끼고 싶어하는지도 고려하세요." "어떤 사회적 작업이 관련되어 있나요? 사용자가 어떻게 인식되기를 원하나요?"

일반적인 불일치:

  • 표면이 사용자의 작업("동료를 돕습니다")보다 제품의 이점("추천을 받습니다")을 강조함
  • 카피가 사용자의 작업이 관계 중심일 때 상호작용을 거래적으로 프레이밍함
  • 사용자가 안심하거나 자신감을 가져야 할 때 톤이 전문적/임상적으로 느껴짐

파트 2 — 결정 인벤토리 (Decision inventory)

6단계 — 피드백 및 오류

각각의 중요한 작업 및 상태 전환에 대해:

  • "사용자가 자신의 작업이 작동했음을 어떻게 알 수 있나요?"
  • "사용자가 무언가 진행 중임을 어떻게 알 수 있나요?"
  • "사용자가 무언가 잘못되었음을 어떻게 알 수 있으며, 어떻게 해야 하는지 어떻게 알 수 있나요?"

오류 메시지는 진단, 설명, 그리고 사용자에게 다음에 무엇을 해야 하는지 알려야 합니다. 세 가지를 모두 충족하지 못하는 모든 오류 상태를 플래그로 표시하세요. 각 격차에 대해 결정을 생성하세요: "[X]를 사용자에게 전달하는 방법을 결정해야 합니다. 옵션은 [Y]입니다."

7단계 — 계층 구조 및 강조

각 주요 장소에 대해:

  • "사용자가 여기서 주목하거나 행동해야 할 가장 중요한 것은 무엇인가요?"
  • "현재 표면이 그 것을 가장 두드러지게 만들고 있나요?"
  • "시각적으로 두드러져서는 안 되는 것이 두드러지고 있나요?"

이는 매체에 구애받지 않는 결정(무엇이 기본이 되어야 하는지)이 먼저이며, 그 다음에 매체 특정적 결정(시각적, 청각적 또는 촉각적으로 기본이 되도록 만드는 방법)이 이어집니다.

8단계 — 접근성

선언된 매체에 대한 관련 고려 사항을 플래그로 표시하세요:

  • 화면 UI: 색상 대비, 텍스트 크기, 터치 대상, 키보드 탐색, 대화형 요소 및 이미지에 대한 스크린 리더 레이블, 흐름 단계 전반의 포커스 관리
  • 음성/대화형: 모든 정보가 구두로 전달됨("왼쪽의 버튼을 클릭하세요" 없음), 시각적 맥락 없이 오류 복구
  • 물리적: 도달 가능성, 촉각적 차별화, 다양한 조명에서의 가시성, 미세 운동 정밀도 없이 작동

접근성 결정 목록을 생성하세요: "[Y] 사용자에게 [X]가 접근 가능하도록 하는 방법을 결정해야 합니다."

9단계 — 일관성

  • 유사한 것들이 유사하게 처리되나요? (동일한 작업이 동일하게 보이고 동작하며, 동일한 객체 유형이 일관되게 표현됨)
  • 다른 것들이 다르게 처리되나요? (기본 vs. 보조, 파괴적 vs. 안전)
  • 이 표면이 해당 매체의 관례를 따르나요? 플랫폼 표준을 위반하는 것은 비용이 드는 결정입니다. 때로는 그만한 가치가 있지만 항상 의도적이어야 합니다.

구분: 내부 불일치(표면 내에서 수정) vs. 관례 위반(의도적 선택 또는 간과 — 결정 필요).

10단계 — 열린 결정

아직 내려야 할 모든 표면 결정의 통합 목록을 생성하세요:

  • 먼저 해결해야 할 교차 계층 문제 — 근본 원인이 하위 계층에 있음; 별도로 나열; 표면이 올바르게 되기 전에 관련 스킬을 다시 검토해야 함
  • 지금 내려야 할 표면 결정 — 결정은 무엇인가? 옵션은 무엇인가? 어떤 제약 조건이 적용되는가(하위 계층, 매체, 브랜드/일관성으로부터)?
  • 연기됨 — 지금은 내릴 필요가 없지만 추적되어야 함

완료

다음을 생성하세요:

  1. 감사 결과 — 어휘 위반, 가려진/변형된 객체, 완전성 격차, 정서적 등록 불일치 — 각각 표면 수정 또는 더 깊은 계층 문제로 분류
  2. 결정 인벤토리 — 모든 열린 표면 결정, 그룹화 및 우선순위 지정
  3. 교차 계층 문제 — 표면이 올바르게 되기 전에 하위 계층에서 해결해야 할 사항
  4. 잘 작동하는 부분 — 이미 잘 내려진 표면 결정; 수정 과정에서 잃지 않도록 주의

마무리: "표면은 사용자가 마주하는 계층입니다. 아래에서 결정된 모든 것이 여기서 존중되거나 훼손됩니다. 개념 모델이나 상호작용 구조에 중요한 변경이 있을 때마다 이 스킬을 다시 검토하세요."

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

관련 스킬