Communitygithub.com

AlessandroFare/fluxychat

Refactoring UI 원칙(Wathan & Schoger)을 기반으로 제한된 간격/타이포그래피/색상/그림자 스케일, 무게와 색상(크기가 아님)을 통한 시각적 계층, 그리고 모의 광원을 통한 깊이감을 활용하여 사용자 인터페이스를 설계하고 개선합니다. 웹, 앱, 대시보드, 랜딩 페이지, 컴포넌트 등 UI를 구축하거나 스타일링할 때, 폰트 크기, 간격, 색상, 그림자, 테두리 반경을 선택할 때, 색상 팔레트나 디자인 토큰을 설계할 때, 그리고 누군가 UI가 "어색하다", "아마추어처럼 보인다", "지저분하다/밋밋하다/미완성처럼 느껴진다"고 말하거나 "이걸 더 좋게 만들어 달라"고 요청할 때 사용하세요.

fluxychat란 무엇인가요?

이 스킬은 Steve Schoger와 Adam Wathan의 책 "Refactoring UI"에 나온 구체적이고 실용적인 규칙들을 AI 에이전트(Claude Code, Cursor, Codex 등)가 UI 설계 및 개선 작업에 직접 적용할 수 있도록 체계화한 것입니다. 시각적 디자인을 재능이 아닌 반복 가능한 결정 시스템과 기술의 집합으로 정의하며, 아마추어 같은 UI의 가장 큰 원인인 일회성 값(ad-hoc values) 선택을 방지하기 위해 엄격한 스케일 기반 디자인을 강조합니다. 간격(4, 8, 12, 16…), 타이포그래피(12, 14, 16…), 폰트 두께(400/500, 600/700), 색상(단계별 8-10개 색조), 그림자(5단계 높이), 행간 및 행 길이, 테두리 반경 등 모든 디자인 요소에 대해 미리 정의된 제한된 값 목록을 제공하여, 일관성과 작업 속도를 높입니다. 또한 시각적 계층 구축을 위한 실질적인 기술(크기보다 무게와 색상으로 강조, 최대 3가지 텍스트 색상, 레이블 최소화, 액션 버튼의 계층별 스타일링)과 9가지 하드 룰(회색 배경 위 회색 텍스트 금지, em 사용 금지 등)을 포함하며, CSS 사용자 정의 속성 파일, 진단 방법, 심화 기술 등 참고 자료를 통해 실제 코드와 함께 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/refactoring-ui-skill-main

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

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

문서

Refactoring UI

시각적 디자인은 재능이 아닙니다. 그것은 한 번만 결정하는 소수의 시스템과 계층을 만드는 소수의 기술로 이루어집니다. 이 스킬이 바로 그 시스템과 그 기술입니다.

아마추어 같은 UI의 가장 큰 원인은 임시방편으로 값을 선택하는 것입니다. — 여기는 17px, 저기는 #3B82F6, 호버 상태는 lighten(5%). 항상 스케일에서 디자인하세요.


시스템 — 이것들을 사용하세요, 새로 유도하지 마세요

이 목록들에서 선택하세요. 목록에 없는 값을 절대 새로 만들지 마세요.

간격과 크기

기본 16px, 그것의 인수와 배수로 구성:

4  8  12  16  24  32  48  64  96  128  192  256  384  512  640  768

작은 쪽은 촘촘하고, 큰 쪽은 넓게 퍼집니다. 인접한 두 값은 약 25% 이상 차이가 나서는 안 됩니다 — 그래야 선택이 명확해집니다. 선형적인 "4의 배수" 스케일은 실패합니다: 120px와 124px 사이에서 결정하는 데 도움이 되지 않습니다.

마진, 패딩, 너비, 높이, 아이콘 크기, 테두리 너비 등 모든 공간적인 것에 사용하세요. 비활성 상태, 오버레이, 호버 틴트를 위해 소수의 불투명도 값(예: .05 .1 .2 .4 .6 .8)도 고정하세요. 매번 슬라이더로 눈대중하는 대신 말이죠. 다른 스케일과 같은 논리입니다: 한 번 결정하고, 모든 곳에 재사용하세요.

타입 스케일

12  14  16  18  20  24  30  36  48  60  72

비율(4:5, 2:3, 황금비)로 만든 모듈러 스케일이 아닙니다. 그런 것들은 브라우저마다 일관되지 않게 반올림되는 분수 픽셀 값을 생성하고 인터페이스 밀도에 비해 너무 듬성듬성합니다. — 직접 고른 값들이 느낌에 따라 선택되므로 승리합니다.

단위: px 또는 rem만 사용하세요. 절대 em을 사용하지 마세요. em은 현재 폰트 크기에 상대적이므로, 1.25em 부모 안의 .875em은 17.5px로 계산됩니다 — 스케일에 없는 값입니다. 스케일이 조용히 사라집니다.

폰트 두께

두 가지 무게면 충분합니다:

  • 400 또는 500 — 본문 및 대부분의 UI 텍스트
  • 600 또는 700 — 강조된 모든 것

UI에서 400 미만은 사용하지 마세요. 덜 강조하려면 더 밝은 색상이나 더 작은 크기를 사용하세요 — 절대 더 가벼운 무게를 사용하지 마세요.

색상

다섯 가지 견본 팔레트 생성기가 제공하는 것보다 훨씬 더 많은 색상이 필요합니다.

  • 회색: 8–10 단계. UI의 거의 모든 것은 회색입니다 — 텍스트, 배경, 패널, 테두리, 폼 컨트롤. 서너 단계로는 항상 부족합니다. 매우 어두운 회색에서 시작하고, 진정한 검정은 피하세요 (진정한 검정은 부자연스러워 보입니다).
  • 기본 색상: 5–10 단계, 하나 또는 두 개의 기본 색상.
  • 강조 색상: 각각 5–10 단계 — 파괴적인 빨강, 경고 노랑, 긍정적인 초록, 그리고 제품이 구별해야 하는 다른 것들(차트 시리즈, 캘린더 이벤트, 태그). 복잡한 UI의 경우 10가지 색상 × 5–10 단계가 일반적입니다.

이름을 100(가장 밝음) → 900(가장 어두움)으로 지정하고, 기본은 500입니다.

이 순서로 스케일을 구축하세요: 먼저 500을 고르세요(기본/강조 색상의 경우 버튼 배경으로 작동하는 색조여야 합니다). 그런 다음 가장자리를 찾으세요 — 900은 보통 텍스트 색상이고, 100은 배경 틴트입니다; 경고 컴포넌트는 둘 다 사용하므로, 하나를 디자인하고 두 값을 읽어내세요. 그런 다음 700과 300을 이웃 간의 완벽한 타협점으로 채우고, 같은 방식으로 800 600 400 200을 채우세요.

색상을 16진수가 아닌 HSL로 작성하세요. hsl(220, 95%, 34%)와 hsl(220, 65%, 61%)는 시각적으로 관련되어 있지만, #03369E와 #507DD7는 그렇지 않습니다.

런타임에 lighten() / darken()으로 색조를 생성하지 마세요. 그렇게 하면 35개의 약간 다른 파란색이 생깁니다.

그림자 — 다섯 가지 높이

0 1px 3px  hsla(0,0%,0%,.2)   /* 거의 떠 있지 않음 — 버튼 */
0 4px 6px  hsla(0,0%,0%,.2)   /* 드롭다운 */
0 5px 15px hsla(0,0%,0%,.2)
0 10px 24px hsla(0,0%,0%,.2)
0 15px 35px hsla(0,0%,0%,.2)  /* 모달 */

이것이 z축의 어디에 위치하는가? 를 물어서 선택하고, 어떤 그림자가 예뻐 보이는가? 로 선택하지 마세요. 사용자에게 더 가까울수록 = 더 많은 주의를 받습니다. :active에서 버튼의 그림자를 줄이면 눌린 느낌이 들고, 드래그 재정렬을 위해 선택되었을 때 목록 항목의 그림자를 키우면 반대 효과가 납니다 — "이제 형제들 위에 있다"고 읽히며 드래그 어포던스 자체로도 작용합니다.

이 다섯 가지가 기본이며 모든 곳에서 괜찮습니다. references/techniques.md는 동일한 스케일의 정제된 두 부분 버전을 제공합니다 — 병렬이지만 동일하지 않은 값입니다(상단 단계가 더 무겁습니다). 디자인에서 그림자가 두드러질 때 사용하세요; 그렇지 않을 때는 이것들을 사용하세요. 하나의 프로젝트에서 둘을 혼합하지 마세요.

행간과 행 길이

행간은 폰트 크기에 반비례하고, 줄 너비에 비례합니다:

  • 작은 텍스트 / 넓은 컬럼 → 1.5 ~ 2
  • 큰 헤드라인 → 1이면 충분함

행 길이: 45–75자, 즉 max-width: 20em–35em. 이것은 주변 컨테이너가 더 넓더라도 단락에 적용됩니다 — 하나의 콘텐츠 영역에 혼합된 너비는 덜 정돈된 것이 아니라 더 정돈되어 보입니다.

(em은 여기서 올바릅니다 — 측정값이 감싸는 텍스트에 따라 조정되어야 합니다. "절대 em" 규칙은 타입 스케일에 한정되며, em이 중첩을 통해 누적됩니다. 이것을 "수정"하지 마세요.)

테두리 반경

하나를 고르고 일관되게 유지하세요. 작은 반경 = 중립적입니다. 큰 반경 = 장난기 있습니다. 없음 = 진지함/격식 있습니다. 하나의 인터페이스에서 각진 모서리와 둥근 모서리를 섞으면 항상 더 나빠 보입니다.


절차

1. 레이아웃이 아닌 기능부터 시작하세요. "앱"을 디자인하지 마세요 — 제품에 무엇이 있는지 알기 전에 상단 탐색과 사이드바 사이에서 결정할 수 없습니다. 실제 기능 하나(검색 양식, 메시지 작성기)를 디자인하고, 껍데기가 생겨나게 두세요.

2. 세부 사항은 나중에. 초기에는 서체, 그림자, 아이콘을 무시하세요. 먼저 그레이스케일로 작업하세요 — 계층이 색상보다는 간격, 대비, 크기에서 나오도록 강제합니다. 레이아웃이 작동하면 색상을 추가하세요.

3. 낮은 충실도에 과도하게 투자하지 마세요. 스케치, 와이어프레임, 목업은 일회용입니다 — 아무도 앱의 정적인 그림을 사용할 수 없습니다. 그것들은 아이디어를 탐구하기 위해 존재합니다; 결정이 내려지면 버리고 실제 제품을 만드세요.

4. 가장 작은 유용한 버전을 디자인하고, 그런 다음 빌드하세요. 짧은 디자인→코드 주기로 작업하세요. 아직 구축할 준비가 되지 않은 기능을 암시하지 마세요 — 아직 출시할 수 없는 첨부 파일 영역이 있는 댓글 상자는 전체 기능을 차단합니다. 있으면 좋은 것들은 나중에 디자인됩니다.

5. 제거를 통해 선택하세요. 스케일에서 값을 선택할 때: 올바르다고 생각되는 값을 추측한 다음, 양쪽 이웃과 비교하세요. 두 개는 분명히 틀릴 것입니다. 외부 옵션이 이기면, 그것을 새로운 중간값으로 삼아 비교를 다시 실행하세요.

6. 너무 많은 흰 공간으로 시작하고 제거하세요. 공간을 추가하여 나빠 보이지 않을 때까지 하는 것은 최소한을 제공합니다. 넉넉하게 시작하고 다듬는 것이 올바른 양을 제공합니다. 빽빽한 UI(대시보드)는 합법적입니다 — 하지만 기본값이 아니라 의도적인 결정으로서요.

7. 캔버스를 줄이세요. 1400px 아트보드에서 디자인된 작은 컴포넌트는 공간이 채워져야 하므로 넓게 퍼지는 경향이 있습니다. 약 400px에서 시작하여 먼저 모바일 레이아웃을 디자인하세요. 제약 조건이 실제로 존재하는 곳에서 말이죠 — 그런 다음 큰 화면으로 가져와서 진정으로 비좁다고 느껴지는 것만 완화하세요. 예상보다 변경 사항이 적을 것입니다.


계층 — 가장 많은 작업을 수행하는 기술

화면의 모든 것은 피라미드에 있습니다: 기본, 보조, 3차. 모든 것이 경쟁하면 UI는 소음으로 읽힙니다. 이것이 디자인을 "디자인된" 것처럼 보이게 만드는 것입니다 — 스타일링이 아니라요.

크기가 전부는 아닙니다. 폰트 크기에만 의존하면 기본 콘텐츠가 너무 커지고 보조 콘텐츠가 너무 작아집니다. 대신 무게 와 색상 을 사용하여 강조를 전달하고 크기는 합리적으로 유지하세요.

최대 세 가지 텍스트 색상:

  • 어두운 색 — 기본 콘텐츠
  • 회색 — 보조 콘텐츠
  • 더 밝은 회색 — 3차 콘텐츠(각주, 저작권)

세 가지 모두 실제 본문 크기의 텍스트를 전달하므로 모두 4.5:1 대비가 필요합니다. "더 밝은 회색"은 여전히 기준을 충족하는 가장 밝은 색조를 의미합니다 — 9단계 램프의 중간쯤, 창백한 쪽이 아닙니다. 창백한 색조는 비활성 상태와 큰 텍스트에만 사용됩니다.

덜 강조함으로써 강조하세요. 중요한 요소가 눈에 띄지 않고 추가할 것이 남지 않았을 때, 대신 경쟁하는 요소를 부드럽게 하세요. 비활성 탐색 항목을 흐리게 하고, 사이드바의 배경색을 낮춰 기본 콘텐츠가 앞으로 나오게 하세요.

액션: 의미론이 아닌 계층별로 스타일을 지정하세요.

  • 기본 → 단색, 높은 대비. 보통 페이지당 정확히 하나.
  • 보조 → 외곽선 또는 낮은 대비 배경.
  • 3차 → 링크처럼 스타일 지정.

파괴적 ≠ 크고 빨간 버튼. "삭제"가 페이지의 기본 동작이 아니라면 3차 처리를 하세요 — 그런 다음 확인 대화상자 내부에서는 크고 빨간 기본 버튼으로 만드세요, 거기서는 진정으로 기본 동작이기 때문입니다.

레이블은 최후의 수단입니다. 레이블: 값은 모든 데이터에 동일한 가중치를 부여합니다. 대부분의 데이터는 형식($19.99, 이메일 주소) 또는 컨텍스트로 스스로를 식별합니다. 레이블이 진정으로 필요한 경우, 값을 접으세요("재고: 12" 대신 "12개 남음"), 또는 시각적으로 보조 콘텐츠로 추가하세요. 예외: 사용자가 레이블을 위해 스캔하는 사양 시트 스타일 페이지에서는 대신 레이블을 강조하세요.

무게와 대비의 균형을 맞추세요. 단색 아이콘은 시각적으로 무거워서 옆의 텍스트를 압도할 것입니다 — 색상을 부드럽게 하여 보상하세요. 반대로도 작동합니다: 부드러운 색상에서 1px 테두리가 너무 미묘하지만 어둡게 하면 너무 강해질 때, 부드러운 색상을 유지하고 2px로 가세요. 낮은 대비를 고치려면 무게를 추가하고, 과도한 무게를 고치려면 대비를 줄이세요.

시각적 계층 ≠ 문서 계층. 의미론적 마크업과 시각적 무게는 별개의 결정입니다. 섹션 제목은 보통 레이블이지 헤드라인이 아닙니다 — 16px의 h1도 괜찮으며, 때로는 콘텐츠가 스스로 말하기 때문에 제목이 완전히 시각적으로 숨겨져야 합니다.


하드 규칙

이것들에서 벗어나면 특정하고 인식 가능한 실패가 발생합니다.

  1. 색상 배경 위에 회색 텍스트를 절대 사용하지 마세요. 흰색 위의 회색은 대비를 줄이기 때문에 작동합니다; 색상 위의 회색은 그냥 더러워 보입니다. 불투명도가 줄어든 흰색은 빛바래고 비활성화된 것처럼 보이며, 글리프를 통해 패턴이 보이게 합니다. 배경의 색조를 사용하여 채도와 명도를 조정한 색상을 직접 고르세요.
  2. 타입 스케일에 절대 em을 사용하지 마세요. px 또는 rem.
  3. 런타임에 색조를 절대 생성하지 마세요. 미리 정의하세요.
  4. 확장되면 안 되는 것에 절대 백분율 너비를 사용하지 마세요. 사이드바는 고정 너비를 받습니다; 기본 영역은 유연해집니다. 요소는 max-width를 가지며 화면이 실제로 더 작을 때만 줄어듭니다 — 로그인 카드는 큰 화면보다 중간 화면에서 더 넓어져서는 안 됩니다.
  5. 중단점에 걸쳐 비례적으로 크기를 조정하지 마세요. 큰 요소는 작은 요소보다 더 빠르게 줄어들어야 합니다. 14px 모바일 본문에 있는 2.5em 헤드라인은 35px로 계산됩니다 — 너무 큽니다; 거기서는 20–24px이어야 합니다. 마찬가지로 버튼의 패딩은 버튼이 줄어들수록 비례적으로 더 좁아져야 하며, 폰트 크기와 함께 조정되지 않아야 합니다.
  6. 항상 그룹 주위의 공간이 그룹 내부의 공간보다 더 커야 합니다. 이것은 "어떤 레이블이 어떤 필드에 속하는지", 빽빽한 글머리 기호 목록, 그리고 잘못된 단락에 붙어 있는 것처럼 보이는 제목에 대한 해결책입니다. 모호한 간격은 단지 보기 흉한 것뿐만 아니라 기능적 버그입니다.
  7. 절대 색상을 유일한 신호로 사용하지 마세요. 아이콘, 모양 또는 텍스트 신호를 추가하세요. 차트의 경우 색조(한 색상의 밝음→어두움 음영)보다는 대비로 시리즈를 구별하세요 — 색맹 사용자는 밝기를 안정적으로 읽지만 색조는 그렇지 않습니다.
  8. 최소 대비: 일반 텍스트의 경우 4.5:1. 3:1 허용치는 큰 텍스트에만 적용되며, WCAG는 이를 24px 일반 또는 18.66px 굵게로 정의합니다 — 18px가 아닙니다. 텍스트가 진정으로 그렇게 크지 않다면 4.5:1로 가정하세요. 색상 위의 흰색이 실패하면 반전시키세요: 밝은 색조 위에 어두운 색상 텍스트(references/systems.md 참조). 별도로, 3:1은 텍스트가 아닌 것에도 적용됩니다 (WCAG 1.4.11): 테두리가 컨트롤을 식별하는 유일한 것이라면 — 입력 외곽선, 체크박스 가장자리 — 배경에 대해 3:1이 필요합니다. 단순히 콘텐츠를 나누는 가는 선은 그렇지 않습니다. 이것들은 하나가 아닌 두 개의 다른 토큰입니다.
  9. 아이콘을 의도된 크기에서 멀리 절대 확장하지 마세요. 48px에서 16–24px 아이콘은 투박하고 디테일이 부족해 보입니다. 대신 색상 원 안에 넣으세요.

참고 자료

assets/tokens.css — 위의 모든 것에 대한 완전하고 대비가 확인된 시작 세트를 CSS 사용자 정의 속성으로 제공합니다: 간격, 타입, 두께, 테두리 너비, 고정 불투명도 스케일, 9단계 차가운 회색 램프, 9단계 기본 색상, 세 가지 강조 트리오, 다섯 가지 높이, 의미론적 역할 레이어 (--surface, --text-primary, --action…) 및 해당 역할만 재정의하는 다크 모드 블록. 그것을 복사하고 이 글에서 스케일을 다시 유도하기보다 색조를 재조정하세요. 컴포넌트에서 원시 램프가 아닌 역할을 참조하세요 — 그것이 다크 모드를 작동하게 만드는 것입니다. 모든 텍스트/표면 쌍은 두 모드에서 ≥4.5:1로 확인되었고 모든 기능적 테두리는 ≥3:1입니다; 의도적인 임계값 미만 음영(비활성, 장식용 구분선, 큰 텍스트 전용 단계)은 기준에 의해 제외되며 인라인으로 주석 처리되었습니다.

작업에서 필요할 때 이것들을 로드하세요:

  • references/systems.md — 처음부터 팔레트 구축하기: 기본 색상 선택, 밝고 어두운 끝에서 채도 유지, 색조 회전, 따뜻함/차가움 회색, 그리고 못생긴 색상 없이 대비 비율을 맞추기 위한 두 가지 탈출구.
  • references/diagnose.md — 증상 → 수정 표. 새로 구축하는 것이 아니라 기존 UI를 개선하는 작업일 때 먼저 로드하세요.
  • references/techniques.md — 깊이와 빛 시뮬레이션, 두 부분 그림자, 기준선 정렬, 자간, 기본 컴포넌트 모양에서 벗어나기, 사용자 업로드 이미지 처리.

추가 사항 (추가 참고)

이 스킬은 AlessandroFare/fluxychat 저장소의 모든 참조 파일과 함께 사용하도록 설계되었습니다. 에이전트는 디자인 문제 진단 시 references/diagnose.md를, 첫 번째 팔레트 구축 시 references/systems.md를, 고급 시각적 기법이 필요할 때 references/techniques.md를 참조해야 합니다. 실제 프로젝트에서 가장 빠른 시작을 위해 assets/tokens.css를 복사하여 사용하는 것이 좋습니다.

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

관련 스킬