Communitygithub.com

husheng-web/personal-website-skills

기존 모션 시스템을 기반으로 포트폴리오 UI 모션을 검토하거나 구현합니다. 축소 모션, 키보드, 성능, 반응형 제약 조건을 포함합니다.

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

이 스킬은 포트폴리오 웹사이트에서 UI 모션(움직임)을 검토하거나 구현할 때 사용됩니다. 모션은 계층 구조, 방향성, 피드백, 시퀀스, 연속성을 명확히 하는 경우에만 사용해야 합니다. 이 스킬은 프로젝트의 기존 모션 규칙, 토큰 소스, 모션 프리미티브를 먼저 분석하고 재사용하도록 안내합니다. 또한, 축소 모션 설정, 키보드 접근성, 성능, 반응형 레이아웃 등 다양한 제약 조건에서도 정상 동작하는지 검증하도록 돕습니다. 개발자는 이 스킬을 통해 일관된 모션 시스템을 유지하고, 불필요한 애니메이션을 방지하며, 모든 사용자에게 최적의 경험을 제공할 수 있습니다. 주로 Claude Code와 같은 AI 에이전트에서 포트폴리오 웹사이트 개발 및 QA 용도로 활용됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/husheng-web/personal-website-skills/tree/HEAD/skills/portfolio-motion-qa

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

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

문서

포트폴리오 모션 QA

계층 구조, 방향성, 피드백, 시퀀스, 연속성을 명확히 하는 경우에만 모션을 사용합니다.

먼저 검사하기

프로젝트의 모션 규칙, 토큰 소스, 기존 모션 프리미티브를 읽으십시오. 독립적인 스케일이나 새로운 애니메이션 라이브러리를 추가하는 대신 그 의미와 지속 시간을 재사용하십시오.

결정 규칙

  • 애니메이션이 명확한 이점을 제공하지 않는 한 읽기 우선 콘텐츠는 정적으로 유지하십시오.
  • opacity와 transform을 선호하고, 레이아웃 애니메이션, 앰비언트 루프, 스크롤 하이재킹, 문자 지연(staggering), transition: all을 피하십시오.
  • 모션을 선택 사항으로 유지하십시오: 축소 모션(reduced-motion)은 즉시 해결되고 키보드 조작은 애니메이션을 기다리지 않습니다.
  • hover와 focus가 동등한 상태 변화를 생성하는지 확인하고, 모바일에서 포인터 동작에 의존하지 마십시오.

검증

가능한 경우 일반 모션, 축소 모션 상태, 키보드 포커스, 데스크톱/모바일 레이아웃, 재생/종료 동작을 테스트하십시오. 각 모션 선택의 이유, 사용된 토큰/프리미티브, 그리고 문서화된 프로젝트 결정이 필요한 편차를 보고하십시오.

Individual skills in this repo

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

관련 스킬