Chart SelectorSAFE

An agent skill published by revfactory.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: chart-selector
description: "데이터 유형과 분석 목적에 따라 최적의 차트 유형을 선택하는 방법론. '차트 추천', '시각화 유형 선택', '그래프 종류', '대시보드 시각화 설계' 등 데이터 시각화 설계 시 사용한다. 단, D3.js/Chart.js 코드 작성, Tableau/PowerBI 조작은 이 스킬의 범위가 아니다."
---

# Chart Selector — 데이터 시각화 차트 선택 가이드

dashboard-builder의 시각화 설계를 강화하는 스킬.

## 대상 에이전트

- **dashboard-builder** — 데이터에 맞는 최적 차트를 선택한다
- **kpi-designer** — 지표 표현 방식을 결정한다

## 차트 선택 의사결정 트리

```
질문 1: 무엇을 보여주려는가?

├── 비교 → 질문 2a
│   ├── 항목 간 비교 → 가로 막대 / 세로 막대
│   ├── 시간에 따른 비교 → 선 그래프 / 영역 그래프
│   └── 부분-전체 비교 → 누적 막대 / 파이(5개 이하)
│
├── 추세 → 선 그래프 / 영역 그래프
│   ├── 단일 지표 → 선 그래프
│   ├── 여러 지표 → 다중 선 (최대 5개)
│   └── 범위 표시 → 영역 그래프
│
├── 분포 → 히스토그램 / 박스플롯
│   ├── 단일 변수 → 히스토그램
│   ├── 그룹별 비교 → 박스플롯
│   └── 2변수 관계 → 산점도
│
├── 구성 → 파이 / 도넛 / 트리맵
│   ├── 2-5개 항목 → 파이/도넛
│   ├── 6개 이상 → 트리맵
│   └── 시간별 구성 변화 → 100% 누적 영역
│
└── 관계 → 산점도 / 버블 / 히트맵
    ├── 2변수 → 산점도
    ├── 3변수 → 버블 차트
    └── 매트릭스 → 히트맵
```

## 차트 유형별 상세 가이드

### 숫자 카드 (KPI Card)
```
용도: 핵심 지표 한눈에 표시
적합: 단일 숫자 + 변화율
요소: 현재값, 전기 대비 변화, 트렌드 스파크라인
규칙:
- 대시보드 상단 배치
- 3-6개가 적정
- 색상: 증가=초록, 감소=빨강 (비용은 반대)
```

### 선 그래프 (Line Chart)
```
용도: 시간에 따른 추세
적합: 연속 데이터, 시계열
규칙:
- 선 최대 5개 (초과 시 하이라이트+회색)
- Y축 0부터 시작 (비율 제외)
- 데이터 포인트 10+ 시 마커 숨김
- 주석으로 이벤트 표시 (프로모션, 장애 등)
```

### 막대 그래프 (Bar Chart)
```
용도: 항목 간 비교
적합: 범주형 데이터
규칙:
- 세로: 시간축 비교 (월별, 주별)
- 가로: 항목 비교 (제품별, 지역별) — 레이블 가독성
- 정렬: 크기순 정렬 (시간 제외)
- 색상: 동일 색상, 하이라이트만 강조색
```

### 파이/도넛 (Pie/Donut)
```
용도: 부분-전체 비율
적합: 2-5개 카테고리
금지:
- 6개 이상 → 트리맵/가로 막대 사용
- 유사한 비율 → 비교 불가, 막대 사용
- 3D 파이 → 절대 사용 금지
규칙:
- 12시부터 시계방향
- 가장 큰 항목 먼저
- "기타" 항목은 마지막
```

### 히트맵 (Heatmap)
```
용도: 2차원 매트릭스의 강도 표현
적합: 시간×카테고리, 상관관계 매트릭스
규칙:
- 단일 색상 그라데이션 (순차)
- 발산 데이터는 중심 기준 2색
- 셀에 수치 표시 (가독성 확보)
```

### 테이블 (Table)
```
용도: 정확한 수치 제공
적합: 다수 측정값, 비교 상세
규칙:
- 정렬 가능 컬럼
- 조건부 서식 (상위/하위 강조)
- 스파크라인 컬럼 추가 가능
- 10-20행이 적정 (페이지네이션)
```

## 색상 팔레트 가이드

### 순차 (Sequential) — 크기/강도 표현
```
낮음 ──────────────── 높음
#F7FBFF → #6BAED6 → #08306B (파란)
```

### 발산 (Diverging) — 기준점 중심 양방향
```
음수 ──── 0 ──── 양수
#D73027 → #FFFFBF → #1A9850 (빨강-노랑-초록)
```

### 범주 (Categorical) — 구분
```
최대 8색: 너무 많으면 패턴/레이블 보조
접근성: 색맹 안전 팔레트 사용 (viridis, ColorBrewer)
```

## 대시보드 레이아웃 원칙

```
1. F-패턴: 좌→우, 위→아래 읽기 흐름
2. 중요도 순: 핵심 KPI 상단, 상세 하단
3. 그룹핑: 관련 차트 근접 배치
4. 여백: 차트 간 충분한 간격
5. 반응형: 모바일 2열, 데스크톱 3-4열
6. 인터랙션: 필터→드릴다운→상세 순서

레이아웃 그리드:
┌─────────┬─────────┬─────────┬─────────┐
│  KPI 1  │  KPI 2  │  KPI 3  │  KPI 4  │  ← 요약
├─────────┴────┬────┴─────────┤─────────┤
│  추세 차트   │  비교 차트    │  구성   │  ← 분석
├──────────────┴──────────────┴─────────┤
│           상세 테이블                   │  ← 상세
└───────────────────────────────────────┘
```

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.