사용 가이드로 건너뛰기
Design Token Audit작성자 owl-listener

Design Token Audit 스킬.

기존 디자인 토큰을 우회하거나 일관성 없이 사용하는 위치를 찾습니다.

  • 토큰 감사
  • 마이그레이션
소스 검토 · design-token-auditSKILL.md
작업 기존 디자인 토큰을 우회하거나 일관성 없이 사용하는 위치를 찾습니다. 결과물 토큰 도입 현황과 관찰 범위를 설명하는 감사 요약. 시작 전 확인 원문은 최초 토큰 정의를 별도의 design-token 스킬로 안내합니다.
편집 요약 · 소스 검토일 2026-11-02 · 생성된 예제가 아닙니다

01 기능 소개

기존 디자인 토큰을 우회하거나 일관성 없이 사용하는 위치를 찾습니다

디자인 파일과 코드의 토큰 적용 범위, 불일치와 빈틈을 감사하고 우선순위가 있는 마이그레이션 계획을 만드세요.

소스 기반 워크플로실행 벤치마크 아님

작업 방식

Design Token Audit는 제품이 기존 토큰 시스템을 사용하는 방식을 살펴봅니다. 하드코딩된 색상, 간격 및 기타 시각적 값을 찾고 올바른 토큰 계층을 사용하는지 확인하며 중복되거나 사용 중단된 토큰을 식별합니다. 팀이 마이그레이션할 수 있는 구체적인 불일치 목록을 만드는 것이 목적입니다.

원문은 적용 범위, 일관성과 빈틈을 구분합니다. 어떤 값은 토큰을 우회하거나 잘못된 시맨틱 역할을 사용할 수 있고, 현재 시스템이 다루지 않는 정당한 요구를 드러낼 수도 있습니다. 이를 구분하면 정리 과정에서 모든 리터럴 값을 단순히 가장 비슷해 보이는 토큰으로 무작정 바꾸는 일을 막을 수 있습니다.

예상 산출물

  • 토큰 도입 현황과 관찰 범위를 설명하는 감사 요약.
  • 하드코딩된 값과 권장 대체 토큰을 분류한 목록.
  • 누락된 토큰에 대한 권고와 우선순위 마이그레이션 계획.
예시 브리프 보기

브리프에서 검토까지

  1. 01
    시각적 값 목록화

    관련 디자인 파일과 구현 코드를 모두 읽습니다. 색상, 간격, 타이포그래피 및 기타 속성을 추출해 비교 가능한 분류로 묶습니다.

  2. 02
    현재 시스템에 값 매핑

    사용 현황을 기존 토큰 및 계층에 매핑합니다. 하드코딩된 값, 일관성 없는 역할, 중복 정의와 사용 중단된 토큰 참조를 표시합니다.

  3. 03
    빈틈과 이탈 구분

    부적절한 대체를 강요하는 대신 새 토큰이 필요할 수 있는 사례를 식별합니다. 빈도와 영향에 따라 순위를 정하고 영향이 큰 색상 및 간격 문제부터 다룹니다.

  4. 04
    마이그레이션 계획

    실행 가능한 대체 목록과 권고를 작성합니다. 이후 감사에서 같은 범위로 도입률을 비교할 수 있도록 확인 범위를 명시합니다.

02 활용 상황

언제 사용하면 좋을까요

원문은 최초 토큰 정의를 별도의 design-token 스킬로 안내합니다.

적합한 경우

  • 시스템은 있으나 사용이 어긋날 때컴포넌트가 합의된 토큰 기반을 점점 더 우회하는 경우입니다.
  • 마이그레이션에 근거가 필요할 때리터럴 값이나 사용 중단된 이름을 바꾸기 전에 우선순위가 있는 매핑이 필요한 경우입니다.

확인할 한계

  • 기존 기반원문은 최초 토큰 정의를 별도의 design-token 스킬로 안내합니다.
  • 측정된 적용 범위도입률에는 명확한 검사 범위와 분모가 필요합니다. 일부 검색을 전체 제품 적용 범위로 볼 수는 없습니다.

준비할 입력

  • 토큰 정의현재 전역, 시맨틱 및 컴포넌트 수준의 값을 제공합니다.
  • 구현 범위감사할 코드와 디자인 파일을 명시합니다.
  • 알려진 마이그레이션팀이 이미 승인한 사용 중단 이름이나 대체 지침을 포함합니다.

03 핵심 결정

중요한 판단 기준

  1. 구체적인 대체

    발견 사항에서 하드코딩된 값을 제안 토큰 이름과 연결합니다.

  2. 빈틈 식별

    정당하게 필요한 역할의 누락을 우발적인 이탈과 구분합니다.

  3. 반복 가능한 후속 점검

    범위가 정해진 감사는 시간에 따른 도입 현황 추적의 기반이 됩니다.

04 예시 브리프

목적을 좁힌 요청으로 시작하세요

아래 예시 브리프는 테스트되지 않았습니다. 사용하기 전에 스킬의 설정을 확인하세요.

소스와 설정 확인

현재 전역, 시맨틱 및 컴포넌트 수준의 값을 제공합니다.

업스트림 소스 파일
https://github.com/owl-listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/designer-toolkit/skills/design-token-audit/SKILL.md

아래 참고 링크에서 원본 사용 지침을 확인할 수 있습니다. 사용 전에 리포지터리의 설정 요건을 확인하세요. 설치 명령어가 아닙니다.

결과물 하나부터 시작

스킬을 실행하기 전에 이 브리프의 범위, 소스 자료, 제약 조건을 상황에 맞게 조정하세요.

예시 브리프
보고 화면과 공용 컴포넌트에 design-token-audit를 사용해 주세요. 현재 토큰 정의와 해당 디자인 명세를 읽으세요. 색상, 간격과 타이포그래피 값을 목록화하고 각 발견 사항을 하드코딩된 값, 잘못된 시맨틱 토큰, 사용 중단된 토큰 또는 누락된 역할로 분류하세요. 기존 토큰이 적합할 때만 정확한 대체를 제안하세요. 반복되고 영향이 큰 항목을 우선해 영향 위치를 포함한 마이그레이션 목록을 만드세요. 검사 범위와 적용률 계산 방법을 명시하세요. 이번에는 실제 대체를 적용하지 말고 감사만 수행하세요.

결과 확인

실제 출력을 다음의 관찰 가능한 기준과 비교해 확인하세요.

  • 발견 사항에 실제 사용 위치와 관련 토큰 분류가 명시되어 있습니다.
  • 제안 대체가 단순한 값의 일치가 아닌 시맨틱 역할에 맞습니다.
  • 적용 범위에 관한 설명에 범위와 집계 방법이 포함됩니다.

OpenDesign은 코딩 에이전트를 위한 로컬 디자인 작업 공간을 제공합니다. 이 목록은 스킬이 번들로 포함되어 있거나 외부 도구, 자격 증명, 소프트웨어 의존성이 포함되어 있다는 뜻이 아닙니다.

05 출처 및 라이선스

소스와 라이선스

이 페이지는 아래에 링크된 고정 소스 리비전을 설명합니다. 업스트림의 동작과 요구 사항은 바뀔 수 있습니다.

소스 소유자
owl-listener
스킬 파일
SKILL.md
라이선스
MIT
검토한 스냅샷
2026-11-02 · 9a6930cf84a8
편집 소스 요약
기존 디자인 토큰을 우회하거나 일관성 없이 사용하는 위치를 찾습니다.

링크된 소스를 바탕으로 OpenDesign이 작성한 원본 요약입니다. 저장소 스타 수는 특정 시점의 인기 지표일 뿐 스킬 사용량이나 품질 점수가 아닙니다.

06 시작 전 질문

시작 전 궁금한 점

최초 토큰 시스템도 만드나요?

원문은 기존 토큰 감사에 집중하고 최초 정의는 별도 스킬로 안내합니다.

매칭되지 않는 모든 값을 새 토큰으로 만들어야 하나요?

감사는 빈틈과 불일치를 구분하고 사용 사례가 누락된 역할을 드러낼 때 새 토큰을 권장합니다.

코드뿐 아니라 디자인 파일도 다루나요?

네. 원문은 명세와 구현의 차이를 드러내기 위해 둘 다 감사할 것을 권장합니다.

OpenDesign

작업 요청과 디자인 결과물을 한곳에 모으세요.

브리프, 소스 자료, 디자인 작업을 로컬 작업 공간에 함께 보관하세요. 워크플로에 추가하기 전에 스킬 자체의 설정을 확인하세요.

업스트림 소스 파일
https://github.com/owl-listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/designer-toolkit/skills/design-token-audit/SKILL.md