Community코딩 & 개발github.com

cbrock84/interface-craft

인터페이스의 시각적 및 상호작용 품질을 향상시킵니다 — 레이아웃, 계층, 타이포그래피, 간격, 밀도, 그리고 일반적인 제품과 차별화되는 세부 사항을 다룹니다. 화면이 작동하지만 미완성처럼 보이거나, 레이아웃이 혼잡하거나 임의적으로 느껴지거나, 페이지에 명확한 초점이 없거나, 인터페이스가 단순히 기능적이기보다 신뢰할 수 있어야 할 때 사용하세요.

interface-craft란 무엇인가요?

이 스킬은 인터페이스의 미적 및 사용성 품질을 진단하고 개선하는 데 초점을 맞춥니다. '인터페이스 공예(Interface craft)'는 아이디어는 훌륭하지만 실행이 부족한 인터페이스에서 흔히 발생하는 문제를 해결합니다. 일관되지 않은 간격, 모호한 계층 구조, 부적절한 타이포그래피, 과도한 시각적 표면(borders, shadows, fills) 사용 등이 주요 대상입니다. 이 스킬은 개발자와 디자이너가 특정 CSS 프레임워크나 라이브러리에 국한되지 않고, 모든 웹 또는 앱 인터페이스에 적용 가능한 원칙을 제공합니다. 특히 다크 모드 설계 시 단순 반전이 아닌 별도의 팔레트 정의, 접근성(대비, 키보드 내비게이션, 터치 타겟 크기, reduced-motion)의 중요성을 강조하며, '상태 완성(loading, empty, error, overflow)'과 '밀도 결정'을 통해 미완성된 느낌을 없애는 방법을 구체적으로 제시합니다. 이 스킬은 시각적 수정보다 근본적인 레이아웃 및 정보 계층 문제를 먼저 진단할 것을 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

인터페이스 공예

대부분의 인터페이스는 아이디어에서 실패하지 않습니다. 실행에서 실패합니다 — 거의 일관된 간격, 거의 명확한 계층, 거의 올바른 타이포그래피.

다시 스타일링하기 전에 진단하세요

화면이 무엇을 위한 것인지 물어보세요. 하나의 기본 동작, 많아야 하나의 보조 동작. 기본 동작을 이름 지을 수 없다면 레이아웃 문제는 제품 문제이며 어떤 스타일링도 고칠 수 없습니다.

실제로 품질로 읽히는 것들

계층. 보는 사람이 어떤 내용을 읽기 전에 어디를 봐야 할지 알아야 합니다. 크기, 굵기, 간격 순서로 달성하세요. 색상은 가장 약한 계층 도구이며 가장 남용됩니다.

간격 리듬. 관련 있는 것은 관련 없는 것보다 더 가깝게 배치하며, 간격은 하나의 스케일에서 나와야 합니다. 일관되지 않은 간격은 사람이 느끼지만 이름을 붙일 수 없는 결함입니다. 근접성을 올바르게 맞추면 평범한 레이아웃도 디자인된 것으로 읽힙니다.

타이포그래피. 인터페이스에는 하나의 패밀리, 페이지에는 최대 두 개. 실제 스케일을 설정하고 크기를 임의로 만들지 말고 그 단계를 사용하세요. 본문 텍스트는 편안한 측정값을 원합니다 — 대략 60–75자 — 그리고 줄 높이는 측정값이 넓어짐에 따라 증가합니다.

표면의 절제. 테두리, 그림자, 채움은 모두 요소를 분리합니다. 경계당 하나를 선택하세요. 세 가지를 모두 쌓는 것이 일반 밀도에서 인터페이스가 복잡해 보이는 이유입니다.

정렬. 모든 것은 어떤 것과 정렬됩니다. 아무 것에도 정렬되지 않은 요소는 의도적이더라도 실수로 읽힙니다.

밀도는 결정입니다

정보 밀도가 높은 도구와 마케팅 페이지는 반대의 처리를 원합니다. 이것이 무엇인지 결정하고 확실히 하세요 — 데이터 테이블에 랜딩 페이지 패딩이 있는 불편한 중간 지점은 어느 쪽에도 도움이 되지 않습니다.

상태를 완성하세요

로딩, 빈 상태, 오류, 오버플로우는 제품이 미완성으로 느껴지는 부분입니다. 빈 상태는 디자인 기회입니다; 맥락 없는 스피너는 인정(admission)입니다. 긴 문자열, 긴 목록, 작은 화면은 모두 처리되어야 하며, 바라기만 해서는 안 됩니다.

다크 모드는 팔레트이지, 반전이 아닙니다

밝은 테마를 반전시키면 전형적인 나쁜 다크 모드가 생성됩니다: 순수 검정 배경, 순수 흰색 텍스트, 아무 효과 없는 그림자.

  • 순수 검정 대신 매우 어두운 회색을 사용하고, 순수 흰색 대신 약간 어두운 흰색을 사용하세요. 둘 사이의 최대 대비는 후광(halation)을 유발하며 실제로 읽기에 피곤합니다.
  • 고도(elevation)가 반전됩니다: 밝은 테마에서는 올라간 표면이 그림자를 드리우지만, 어두운 테마에서는 더 밝아집니다. 그림자만으로는 어두운 바탕에서 아무것도 전달하지 못합니다.
  • 흰색에서 잘 작동했던 채도 높은 색상은 어두운 바탕에서 진동합니다(vibrate). 어두운 팔레트용으로 강조 색상을 재사용하지 말고 채도를 낮추고 밝게 하세요.
  • 두 팔레트를 처음부터 토큰 수준에서 함께 정의하세요. 나중에 추가하려면 모든 표면을 감사해야 합니다.

접근성 기준

이것들은 다듬기(polish) 항목이 아닙니다 — 이 기준 미만에서는 일부 사람들이 인터페이스를 전혀 사용할 수 없습니다.

  • 텍스트 대비가 실제 배경에 대해 표준 비율을 충족해야 하며, 이미지 위의 텍스트와 색상이 있는 버튼 내부의 텍스트도 포함됩니다.
  • 색상만으로 의미를 전달하지 마세요. 오류를 나타내는 빨간색 테두리는 텍스트나 아이콘도 함께 있어야 합니다.
  • 모든 상호작용 요소는 키보드로 도달 가능해야 하며, 합리적인 순서로, 눈에 띄는 포커스 상태를 가져야 합니다.
  • 터치 대상은 안정적으로 탭할 수 있을 만큼 충분히 커야 하며, 인접한 대상 사이에 간격이 있어야 합니다.
  • reduced-motion 환경 설정을 존중하세요: 비활성화할 수 없는 애니메이션은 일부 사용자에게 실제 증상을 유발합니다.
  • 실제 의미 요소(semantic elements) — 버튼은 버튼, 제목은 순서대로. 스타일이 적용된 div는 보조 기술에 보이지 않습니다.

절대 하지 말 것

  • 너무 많은 동등한 요소로 인한 계층 문제를 해결하기 위해 시각적 무게를 추가하지 마세요. 대신 제거하세요.
  • 본문 텍스트를 가운데 정렬하지 마세요.
  • 일치하는 포커스 상태 없이 호버 상태를 출시하지 마세요.

Individual skills in this repo

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

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

관련 스킬