agentleFS
insightfloinsightflo/edu-deck-skills/consulting-deck/SKILL.md

consulting-deck

Skill7 starsChanged 2 days agoApache-2.0View on GitHub

Use when the user wants a consulting-style presentation deck as single-file HTML — 컨설팅 덱, 전략 보고 자료, 경영진 보고, 이사회 자료, 제안서, 입찰 제안서, 피치덱, IR 덱, 사업 계획 발표자료, 전략 수립 보고, 진단 보고서, IT 전략/비용 최적화 보고 (예: \"IT 비용 최적화 전략 12장짜리 경영진 보고 덱으로 만들어줘\", \"AI 전환 전략 제안서\", \"이사회 보고 자료 만들어\"). 듣는 사람이 배우는 교육 자료는 이 스킬이 아니라 edu-deck 스킬로 간다. 산출물은 1920×1080 단계 공개 HTML 한 파일(PPTX 생성·변환은 하지 않는다).

3 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions3 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 3

    1. zairuilab/consulting-deck★ 25same name
    2. BotTony329/consulting-deck-skill★ 1same name
    3. jsuchet/jonathan-skills-lab★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository7 other files it gives its agents.

The file

Files
SKILL.md

consulting-deck: 주제 → 근거 → 주장 → 권고 (컨설팅 덱 전용)

의사결정자를 설득해 결정과 실행을 이끄는 단일 HTML 덱을 만든다. 교육 덱(edu-deck)이 학습을 지원한다면 이 덱은 의사결정과 실행을 지원한다 — 결론이 앞서고, 모든 수치에 근거가 따르고, 권고로 닫는다.

결과물은 파일 하나다. 발표 셸·모션 엔진·빌드·검사는 edu-deck과 같은 것을 쓴다(<base> = 이 스킬과 같이 설치된 edu-deck 스킬의 shared/ 폴더). 외부 글꼴·이미지·스크립트 없이 어디서나 열린다. 키보드로 넘기고(→ 한 단계씩), N 발표자 노트, F 전체 화면, P 인쇄 자료. 확인 문제·자습 모드 같은 학습 장치는 교육 전용이라 기본적으로 쓰지 않는다.

진입 판별 (edu-deck과의 경계)

  • 이 스킬: 듣는 사람이 무언가를 결정하거나 승인하도록 만드는 덱 — 전략·진단·제안·심사·권고·보고. "제안서, 전략 수립, 경영진 보고, 이사회 자료, 피치/IR" 신호.
  • edu-deck: 듣는 사람이 무언가를 배우도록 만드는 덱 — 교육·훈련·매뉴얼·워크숍. edu-deck 스킬의 "대상 밖" 안내를 받으면 이 스킬로 온다.
  • 둘 다 섞였거나 애매하면 한 번만 묻는다: "이 자료는 결정을 받는 용도인가요, 배우는 용도인가요?" 답이 없으면 요청 문구의 목적 동사(보고·제안·승인 vs 교육·연수)로 정하고 보고에 근거를 남긴다.
  • 한 장짜리 설명 페이지·보도자료·포스터는 이 스킬이 아니다. PPTX 파일 요청은 거절하고 단일 HTML 대안을 제안한다.

저작 형태 — 요청 정리 때 한 번 정한다

형태언제스토리라인
문제해결형결정이 걸린 과제 — 진입 여부, 투자 심사, 전환 승인문제 정의 → 이슈 트리 → 가설 → 근거 → 권고. references/storyline.md 전체 절차
자료종합형자료를 충실하게 종합해 보여주는 과제 — 시장 동향 브리핑, 연간 리뷰요약 중심 서사(What–So what–Now what). 가설 트리를 강요하지 않는다

형태는 brief에 한 줄로 남긴다(형태: 문제해결형 (근거: …)). 혼합이면 장 그룹마다 어느 형태인지 표시한다.

기본값 (사용자가 따로 말하지 않으면)

항목기본값
청중의사결정자(경영진·이사회·사업부장)
분량요청에 따름. 없으면 10~15장(과제 §8 데모 참고)
밀도발표 겸 읽기(Reading-first 기본, 발표자가 있으면 Speaker-led — references/consulting-design.md)
작업 폴더${EDU_DECK_OUTPUT_DIR:-./outputs}/consulting-deck/<YYYYMMDD>-<영문-slug>/
결과 파일<작업 폴더>/<주제>-컨설팅덱.html
중간 확인없음(구성안 승인을 원하면 사용자가 말한다)

작업 순서

1단계 시작 전 — flint 감지(최초 1회): python3 <이 스킬>/charts/flint_env.py check를 실행한다. exit 0이면 넘어간다. 미설치(exit 1)이고 상태 파일의 installAsked가 false면 한 번만 묻는다 — "차트 도구 flint(MIT, Microsoft)를 함께 설치할까요? (~/.edu-deck/flint, 약 55MB)" → 답을 flint_env.py state set installAsked true·state set useFlint …로 기록하고 이후 재질문하지 않는다. 거절·node 없음(exit 2)이어도 진행한다(기본 엔진 chart_gen이 있으므로 차질 없음).

1. 요청 정리 → brief.md

  • 의사결정 질문 1개를 문장으로 못 박는다("시장을 분석해라" → "X 세그먼트 진입 여부와 조건은"). 결정 주체·기한·범위 내외·성공 기준·제약을 적는다.
  • 저작 형태(위 표)를 정한다. 청중·발표 상황(회의실 발표인지 혼자 읽는 보고인지)을 적는다.
  • 조직 고유 정보가 꼭 필요하면 한 번에 묶어 한 번만 묻고, 답이 없으면 가정을 brief에 남긴다.

2. 근거 조사 → research.md + evidence.json

  • 근거 원장 evidence.json을 작업 폴더에 만들고 조사와 함께 채운다 — 출처(source)와 주장(claim)을 ID로 연결하고, 원본 값·계산 방법·가정/사실 구분을 남긴다. 형식과 규칙: references/evidence.md.
  • 공개 자료를 쓸 때의 인용·복제 경계: references/reference-sources.md.
  • 확인 안 된 수치는 화면에 못 쓴다. 대안은 두 가지다 — 검증된 공개 자료를 찾거나, 가상 데이터로 만들고 표기한다.

3. 스토리라인 → storyline.md

  • 통치 사상(전체 주장 한 문장) → 서사 뼈대 → 장별 주장형 제목 표를 짠다. 절차·테스트: references/storyline.md.
  • 통과 조건: 제목만 순서대로 읽으면 짧은 경영 메모처럼 읽힌다. Exec Summary는 본문이 다 정해진 뒤 마지막에 쓴다(본문과 불일치 금지).

4. 차트 모델 → charts/*.json → src 조각 생성

  • 엔진 선택(덱당 1회): 스토리라인에 수치 비교·추세·구성·분포를 뒷받침하는 근거가 있으면 "차트 포함"으로 판단한다. 포함이고 flint가 설치돼 있으면(flint_env exit 0) useFlintAsked가 false일 때 한 번 묻는다 — "이번 덱 차트를 flint로 그릴까요?(유형 39종·테마 / 아니면 chart_gen 15종)". 답은 deck.json의 "charts": {"engine": "flint"|"chart_gen"|"mixed", "asked": true}에 기록하고 이후 재질문하지 않는다(덱별 기록은 매번 쓴다). 차트가 없으면 묻지 않는다.
  • 화면에 들어가는 모든 분석 차트는 생성기로 만든다 — 수치를 조각 HTML에 직접 타이핑하지 않는다. 기본은 chart_gen.mjs(15종, 스키마 charts/schema.md); flint 선택 시 flint_gen.mjs(39종·테마, 스키마 charts/flint-schema.md, 모델은 NN-이름.flint.json). 혼합 허용 — 한 덱의 기본은 선택 엔진, 특수 유형만 다른 엔진으로 보충한다. 질문→차트 선택과 5층 구조: references/analytical-charts.md.
node <이 스킬>/charts/chart_gen.mjs  --in <작업 폴더>/charts/NN-이름.json       -o <작업 폴더>/src/NN-이름.html
node <이 스킬>/charts/flint_gen.mjs --in <작업 폴더>/charts/NN-이름.flint.json -o <작업 폴더>/src/NN-이름.html
  • flint 계약: 정적 SVG 전용(인터랙티브·image-charts 경로 없음). 생성은 flint_gen.mjs — flint-chart-mcp는 저작 시각 확인용 선택이지 파이프라인이 아니다. 색·폰트는 charts/flint-theme.json의 theme 키로만(모델 임의 hex 금지 — 팔레트 게이트가 차단). flint가 없는 머신에서 regen하면 flint 조각이 FAIL로 보고된다 — 조용히 chart_gen으로 대체하지 않고 사용자에게 알린다. 마크별 순차 등장이 필요한 차트는 chart_gen을 쓴다.
  • 데이터 계산·합계·출처·가상 표기는 모델이 검증한다(expectTotal·source·synthetic). 재생성 검사: python3 <이 스킬>/charts/regen.py --check <작업 폴더>(.json/.flint.json 확장자 디스패치).

5. 슬라이드 저작 → src/

  • 장마다 역할(정의/주장/증명/비교/결정/동원)에 맞는 배치를 고른다 — 카탈로그: references/consulting-layouts.md(고정 템플릿이 아니라 목적별 후보다).
  • 재료 사용 4방식(그대로·변형·조합·새로 설계)과 저작 권한은 <base>/references/authoring.md가 그대로 적용된다. 조각·아키타입·도식 문법은 <base>/references/를, 컨설팅 특화 배치·톤은 references/consulting-design.md를 따른다.
  • 컨설팅 덱은 팩 경로를 쓰지 않는다. deck.json에 title·output만 쓰고 src/를 직접 저작한다. 테마는 덱 로컬 src/*.css(consult.css 계열 — consulting-deck/assets/consult.css를 복사해 쓴다)로 준다. IT 아키텍처·전환 장은 Architecture Kit(<base>/references/architecture.md)을 그대로 결합할 수 있다.
  • 노트는 장마다 실제 발표 근거로 쓴다(자동 진행 금지). 계약(data-step/add/only/lit/until·.chk·aside.notes)은 교육 덱과 동일하게 보호한다.

6. 조립·검사·심미 리뷰

python3 <base>/scripts/build_deck.py <작업 폴더>
python3 <base>/scripts/check_deck.py <작업 폴더>/<결과 파일> --sheets <작업 폴더>/qa --json <작업 폴더>/qa/check.json
python3 <이 스킬>/checks/check_consulting.py <작업 폴더>     # 컨설팅 게이트(논리·데이터·근거 대조)
python3 <base>/scripts/capture_deck.py <작업 폴더>/<결과 파일> <작업 폴더>/qa/shots   # 전 장 최종 상태 캡처(공용 도구)
  • 게이트의 기준·자동 검사와 사람 승인의 구분: references/quality-gates.md.
  • 1920×1080 캡처를 직접 본다(표지·핵심 장·차트 장). 모션은 단계·재방문·인쇄·reduced-motion을 확인한다.
  • 심미 리뷰(의무): 자동 검사 통과는 심미 품질의 증거가 아니다. 완성 덱은 반드시 공통 크리틱 계약 <base>/references/design-critique.md(6단계 절차·9항목·Blocker/Major/Minor)로 독립 검수를 통과한다 — 저작 에이전트가 아니라 시각 판단 기능이 있는 에이전트(이 환경: agy/gemini-4-argon)가 캡처를 보고 진단한다. 컨설팅 특화(펌 대비·방향 시안 3안)는 references/design-review.md. Blocker→Major 순으로 반영하고 재평가 받는다. 자기 결과물 자체 평가로 갈음하지 않는다.

7. 보고

  • 결과 경로·장 수·형태·청중·서사 뼈대 한 줄. 사용한 출처 수와 가상 데이터 항목.
  • 검사 결과(check_deck·check_consulting·regen --check RESULT 줄). 못 한 검사는 이유와 함께.
  • 자동 검사 통과와 컨설팅 품질 승인은 별개로 보고한다. 품질 게이트(논리·데이터·시각·실행)의 사람 판단 항목은 직접 보고한다.
  • 확인 필요 목록: 가정한 조직 정보·기준일이 지난 수치·가상 데이터 위치.

빌드 경로 (파일 구조)

<작업 폴더>/
  deck.json            # title·output (+ theme 있으면 legacy 테마와 병합)
  brief.md  research.md  storyline.md  evidence.json
  charts/NN-*.json     # 차트 선언 모델(원본 데이터·계산·출처)
  src/NN-이름.html      # 장 조각(차트 장은 chart_gen이 굽는다)
  src/consult.css      # 덱 로컬 테마(assets/consult.css 계열 복사·변형)
  qa/                  # 검사 결과·캡처

반드시 지킬 것

  • 근거 없는 수치·인용을 화면에 쓰지 않는다. 근거를 못 찾으면 가상 데이터로 만들고 표기한다(evidence.md).
  • 장 제목은 주장이다. 토픽 명사형 제목으로 끝내지 않는다.
  • 차트 수치는 charts 모델에만 산다 — 슬라이드 조각·제목·Exec Summary의 수치가 모델과 일치해야 한다(check_consulting이 대조한다).
  • 가정·추정·전망을 실적·사실처럼 쓰지 않는다. 화면에 구분 표기를 남긴다.
  • 펌 보고서의 문장·레이아웃·로고·차트를 복제하지 않는다(reference-sources.md). 배운 패턴은 우리 문법으로 재작성한다.
  • 검사를 통과시키려고 검사 스크립트·기준을 고치지 않는다. 고칠 것은 슬라이드와 모델이다.
  • 공유 자산(edu-deck/shared/)은 수정하지 않는다. 컨설팅 전용 도구는 이 스킬 폴더 안에 둔다.

파일 안내

파일언제 읽나
references/storyline.md3단계: 저작 형태 분기·문제 정의·이슈 트리·통치 사상·서사 뼈대·주장형 제목·Exec Summary
<base>/references/design-critique.md6단계: 공통 심미 크리틱 — 6단계 절차·9항목·Blocker/Major/Minor·캡처 도구·크리틱 에이전트 호출
references/design-review.md6단계: 컨설팅 특화 심미 리뷰 — 펌 대비 언어화·방향 시안 3안 비교·재평가
references/evidence.md2·4단계: evidence.json 원장·증거 유형·가정/사실 구분·가상 데이터 표기·계산 검증
references/consulting-layouts.md5단계: 19 유형 배치 카탈로그(목적·수용량·만드는 법)와 선택 규칙
references/analytical-charts.md4단계: 질문 기반 차트 선택·5층 구조·주석·색·출처 블록·모션
references/consulting-design.md5단계: 4가지 시각 방향·타이포·밀도(Speaker-led/Reading-first)·펌 패턴의 번역·consult.css
references/quality-gates.md6·7단계: 논리·데이터·시각·실행 게이트 — 자동 검사와 품질 승인의 구분
references/reference-sources.md2단계 및 인용 시: 오픈소스 이식 내역·펌 분석 근거·차단 기록·복제 경계
charts/schema.md4단계: 차트 모델 문법의 원본(타입별 데이터 계약·검증 규칙)
charts/flint-schema.md4단계: flint 차트 모델 문법(engine·theme 화이트리스트·금지 필드·chart_gen 선택 안내)
charts/flint_env.py1단계 전·4단계: flint 설치 감지(check)·핀 설치(install)·질문 이력(state)
charts/flint_gen.mjs4단계: flint 정적 SVG → 슬라이드 조각 생성기(--check 재생성·팔레트 허용목록)
charts/flint-theme.json4단계: flint 테마 SSOT(consult·consult-tech — consult.css 토큰값·팔레트 허용목록)
<base>/references/authoring.md저작 권한·재료 4방식·검사와 품질의 구분 — 교육 덱과 동일 적용
<base>/references/design.md·DESIGN_TOKENS.md·MOTION_LIBRARY.md5단계: 공통 판단 기준·토큰·모션(컨설팅 문서는 이 위에 특화만 얹는다)
<base>/references/architecture.md기술 아키텍처·전환 장 결합 시(Architecture Kit)

개념 출처: 이 스킬의 서사·차트·게이트 체계는 zairuilab/consulting-deck(Apache-2.0, d25dd54)과 McKinsey Vizro(Apache-2.0, 146b932)의 개념을 한국어로 재작성한 것이다. 내역: references/reference-sources.md.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.