reportme

name	reportme
description	Turn a topic or your own materials into a single self-contained, interactive HTML report — top tabs, clickable reference drawers, dense tables, comparison heatmaps, inline SVG diagrams, in-page search, a light/dark/system theme toggle, and a mobile-collapsible subtab panel — written in the user's language, quality-checked by a multi-agent review plus a bundled structural-consistency validator script. The output is ONE HTML file that opens directly from disk (all CSS/JS/data inline) — no server, no build step; local-first by default, with optional GitHub Pages publishing (explicit `publish` request only) and multilingual variants as per-language files linked by a static language switcher (≤3 languages recommended). Detects topic and language, proposes a tab/section structure that fits the report, and (if the user already has data) renders it into the design instead of researching. Includes per-language proofreading (strictest for Korean) and optional SVG diagrams. Use for requests like "/reportme", "make a report", "build an interactive report / dashboard from this", "turn this analysis into a report", or in Korean "보고서 만들어줘", "인터랙티브 리포트로 만들어줘", "이 자료를 보고서로", "탭·드로어 있는 보고서".
license	MIT
compatibility	Claude Code(권장) 또는 셸 실행이 가능한 에이전트. 리서치 시 네트워크(공식 문서 조회) 필요. 기본 흐름은 배포·`git`/`gh` 불필요 — 산출물은 로컬 단일 HTML 파일. 선택 기능 `publish`(GitHub Pages 게시)를 쓸 때만 `git`·`gh`(로그인) 필요. 대화형 질문 UI·멀티에이전트 오케스트레이션이 없는 환경에서는 옵션을 텍스트로 받고 검증이 단독 검토로 낮아질 수 있다.
metadata	{"version":"0.4.1","author":"beret21"}

Report Me — 단일 파일 인터랙티브 보고서 제작 스킬

주제(TOPIC) 또는 사용자가 가진 자료를 받아, 단일 자립형 HTML 보고서 1개를 만드는 스킬이다. 상단 탭·클릭 참조 드로어·밀집 표·비교 히트맵·인라인 SVG·페이지 내 검색을 갖춘 인터랙티브 보고서로, CSS·JS·데이터가 전부 파일 안에 인라인돼 있어 디스크에서 바로 열리고 서버·빌드·배포가 필요 없다. /reportme 로 호출하거나 "보고서 만들어줘" 같은 요청에 자동으로 동작한다.

TeachMe(핸드북 스킬)와의 차이: TeachMe는 다중 파일 학습 핸드북을 GitHub Pages에 출판한다. ReportMe는 단일 파일 보고서를 만들며 기본은 배포하지 않는다(로컬 파일로 전달·공유). 사용자가 publish를 요청하면 그 단일 파일(들)을 TeachMe와 같은 방식(비공개 저장소 + 공개 Pages, docs/)으로 게시할 수 있다(§12.5). 디자인은 상단 탭 + 우측 참조 드로어의 밀집 보고서 스타일이다.

구조는 flat부터 계층까지: 기본은 상단 탭(flat)이고, 필요하면 한 탭 안을 중첩 서브탭(2단계)으로 나누거나 HTML5 <details> 아코디언으로 접을 수 있다(§8-A). 페이지 내 검색은 숨은 서브탭·접힌 아코디언 안의 일치도 찾아 자동으로 펼친다.

명령 규격 — /reportme [서브커맨드] [옵션] "<주제 또는 자료 설명>"

$ARGUMENTS를 다음 규칙으로 해석한다. 첫 토큰이 알려진 서브커맨드면 그것으로, 아니면 new로 간주하고 나머지를 주제/자료로 본다.

서브커맨드

명령	하는 일
new "<주제/자료>" (기본)	새 보고서 생성. (자료조사 또는 자료 수집)→구성제안→작성→검증→(SVG)→단일 HTML 산출. new는 생략 가능.
add <tab|subtab|section|accordion|heatmap|figure|ref> ["<내용>"]	기존 보고서에 탭·중첩 서브탭·섹션·아코디언·히트맵·도식·참조 항목 추가.
render <경로|URL>	사용자가 준 자료를 리서치 없이 이 디자인으로 렌더. 파일 경로(MD·JSON·표·CSV 등)든 URL(웹 문서·공개 자료 — 읽기 전용 WebFetch로 수집)이든 전달하면 참조한다.
update [경로]	기존 산출 HTML을 대화식으로 수정·재검증.
open [경로]	산출 HTML을 브라우저로 열어 인터랙션(탭·드로어·검색) 확인.
verify [경로]	scripts/validate_report.py 구조 정합성 점검(§13-0) + 내용 재검수(§6/§7) 또는 렌더 검증(agent-browser/Playwright).
publish [경로]	(선택 — 명시 요청 시에만) 완성 보고서를 GitHub Pages에 게시(§12.5): docs/ 구성 → 시크릿 재스캔 → 계정·플랜 확인 → 비공개 저장소+공개 Pages(무료 계정은 공개 저장소 안내) → 라이브 검증 → README.
help	이 명령 규격을 요약해 보여준다.

플래그(주로 new/render) — 미지정 값은 대화형(또는 텍스트)로 확인: --lang <ko|en|ja|…> · --langs <ko,en[,ja]>(다국어 — 3개 이하 권장·5개 초과 금지, 언어별 파일 + 스위처, §2-C) · --depth <brief|standard|deep>(기본 standard — §2-D 최소 기준: standard = 소스 ≥8·원문 정독 ≥3·사례 ≥1·독자 페르소나 필수. 다국어여도 깊이 축소 금지) · --source <research|data>(리서치 집필 vs 내 자료 렌더 — 미지정 시 자료 유무로 자동 판단) · --tabs <탭 목록> · --out <파일경로>(기본 <PROJECT_DIR>/<slug>.html, publish 계획 시 index.html) · --no-verify(비권장·경고) · --no-svg · (publish 전용) --repo <slug> · --owner <gh계정> · --private|--public.

예: /reportme new "국내 전기차 시장 2026" --lang ko --tabs "개요,시장분석,경쟁구도,부록" 예: /reportme render ./분석자료.md --out ./보고서.html

인자 없이 /reportme만 오면 help처럼 간단 안내 후, 주제/자료를 물어 new 흐름을 시작한다.

안전성 — 전체 권한(full access)으로 써도 되는 이유

이 스킬은 사용자의 파일·콘텐츠를 삭제하지 않는다. 하는 일은 생성·편집뿐이다: 새 HTML 파일 생성, 플레이스홀더 채우기, 기존 산출물 편집. 기본 흐름에는 배포·네트워크 푸시·저장소 생성이 없다(리서치 시 읽기 전용 웹 조회만). git/gh 푸시·저장소 생성은 사용자가 publish를 명시적으로 요청한 경우에만 일어나며, 그때도 시크릿 스캔(§11)·계정 확인(§12.5)을 통과한 정적 HTML만 올린다. 검증 중 만드는 임시파일은 OS 임시 폴더의 스킬 자기 것뿐이다. → 개입 없이 완주하려면 full access가 편하고, 되돌릴 수 없는 파괴가 없다.

시작하면 가장 먼저 할 일

1. 주제/자료(TOPIC 또는 SOURCE_DATA)를 확정받고, 언어(LANG)는 자동 인식한다. 주제·자료는 스킬이 임의로 정하지 않는다. LANG은 사용자가 프롬프팅하는 언어를 자동 인식해 기본값으로 설정하고 가볍게만 확인한다(--lang이 오면 그대로).
2. 콘텐츠 소스를 판단한다(하이브리드). 사용자가 자료(MD·JSON·표·문서)를 이미 줬으면 그걸 렌더(리서치 생략), 없으면 공식 문서 리서치 후 집필. 애매하면 물어본다.
3. 보고서 성격에 맞는 탭/섹션 구성안을 제안하고 승인받는다. 모든 보고서를 같은 탭으로 강요하지 않는다 — 개요/분석/비교/계보·부록 등 내용에 맞게.
4. references/BUILD_GUIDE.md 를 끝까지 읽고 그대로 따른다. 제작·검증·컴포넌트 사용의 모든 절차가 거기 있다.

이 스킬에 동봉된 자산 (자립형 — 외부 의존 없음)

이 스킬/
├── SKILL.md                       이 파일
├── references/
│   ├── BUILD_GUIDE.md             범용 제작 지시서 (소스판단→제작→검증 전 과정)
│   └── loanword-refinements.md    외래어 순화 판단 지침(한국어 검수 전용, §7)
├── scripts/
│   └── validate_report.py         산출 HTML 정합성 점검 (탭↔패널·ref↔REFS·서브탭 짝·플레이스홀더 잔존·외부 리소스)
└── templates/
    ├── report.html                단일 자립형 보고서 골격 (탭·드로어·히트맵·SVG·검색·테마 토글·모바일 접힘·언어 스위처 전부 인라인)
    └── publish/                   (publish 시에만 사용)
        ├── dot-gitignore          배포 저장소용 — 복사 시 .gitignore로 개명. 시크릿 제외 + 자기 은닉(원격 미노출)
        └── .nojekyll              빈 파일 — GitHub Pages Jekyll 우회

모든 디자인 토큰(라이트/다크 2테마)·레이아웃·인터랙션 JS(탭 전환·참조 드로어·페이지 내 검색·테마 토글·모바일 서브탭 접힘)는 템플릿 한 파일에 이미 내장돼 있다. 새 보고서는 report.html을 복사한 뒤 {{플레이스홀더}}·[설명: …] 부분만 실제 내용으로 채우고, 탭/섹션/참조(REFS) 개수를 조정하면 된다. 산출물에 별도 JS·CSS 파일이 없다(단일 파일 원칙 — 테마도 외부 CSS 분리가 아니라 인라인 토큰 전환). scripts/validate_report.py는 제작·편집 도중 정합성 점검용 개발 도구일 뿐, 산출물에 포함되지 않는다.

작업 흐름 요약 (상세는 BUILD_GUIDE.md)

1. 파라미터 확정 — TOPIC/SOURCE_DATA·LANG은 사용자 입력. 탭/섹션 구성안도 사용자 승인.
2. 콘텐츠 확보 — (리서치) WebSearch/WebFetch로 공식 자료 확인, 버전·수집일 기록. 또는 (렌더) 사용자 자료를 읽어 구조화. 추측 금지.
3. 템플릿 복사 — 이 스킬의 templates/report.html을 PROJECT_DIR/<slug>.html로 복사(BUILD_GUIDE §4).
4. 콘텐츠 작성 — LANG으로 서술(코드·식별자는 영어, 고유명사 원형). 탭·섹션·표·KV·카드·히트맵·참조 칩(REFS)을 내용에 맞게 채움. 데이터는 전부 파일 안에 인라인(외부 fetch 금지 — file://에서 막힘).
5. 품질 검증(필수) — §6 내용 검증 하네스, §7.5 SVG 도식화(선별), §7 언어별 문법·표현 검수(한국어는 가장 엄격).
6. 자체 점검·전달 — §13-0 scripts/validate_report.py로 정합성(짝·잔존) 오류 0 확인 후, open으로 브라우저에서 탭·드로어·검색·테마 토글·모바일 접힘 동작 확인, 작성일 갱신. 파일 1개(다국어면 언어별 파일)를 그대로 전달. 이후 섹션을 옮기거나 수정하면 정합성 스크립트를 재실행한다.
7. (선택) 배포 — 사용자가 publish를 명시적으로 요청한 경우에만 §12.5: docs/ 구성(+동봉 .gitignore/.nojekyll) → 시크릿 재스캔 → gh 계정·플랜 확인 → 비공개 저장소 + 공개 Pages → 라이브 검증 → README 생성.

핵심 원칙: 추측보다 확인(공식 문서/제공 자료에서 확인한 것만), 단일 파일·전부 인라인(외부 리소스·fetch 금지 — 디스크에서 바로 열려야), 검증 후 전달(§6·§7 통과 전 완료 처리 금지).