insightflo/edu-deck-skills / edu-deck
edu-deck
FlaggedEntry skill for education deck requests. Use FIRST when the user wants 교육자료, 강의 자료, 교육용 슬라이드, 직원 교육 덱, or a training series (예: "○○ 교육자료 만들어줘", "사내 교육 시리즈 만들어", "여러 편으로 나눠 교육 자료"). 판별 후 단일 발행(주제 하나, 파일 하나)이면 edu-deck-solo 경로를, 여러 편 시리즈·진도 관리·허브가 필요하면 edu-deck-series 경로를 탄다. 애매하면 사용자에게 한 번 묻는다. 덱 제작 절차는 이 스킬에 없고 각 하위 스킬에 있다.
distribution/USAGE.md
View on GitHub# 실행 안내
## 1. 작업 경로
가족형 ZIP은 압축 해제 폴더, 단일 루트 ZIP은 `edu-deck/bundle/`로 이동한 상태를 아래 명령의 기준으로 삼습니다. `python3`는 해당 환경의 Python 3 실행 명령으로 바꿀 수 있습니다. 공백이 있는 경로는 따옴표로 감쌉니다. 자동 스킬 등록 없이도 에이전트에게 원본 `edu-deck/SKILL.md`를 읽게 할 수 있습니다.
```sh
python3 edu-deck/shared/scripts/env_check.py
```
이 명령은 네트워크 접속을 시도하며 종료 코드가 항상 0입니다. 각 항목의 결과를 읽으세요. 실제 화면 검사 가능 여부는 최종 검사기의 브라우저 실행으로 판단합니다.
## 2. 의존성
- **초기화·조립**: Python 3와 ZIP 내부 파일. Python 3.11에서 확인했습니다.
- **전체 HTML 검사**: `beautifulsoup4`(모듈 `bs4`), `lxml`, `Pillow`(모듈 `PIL`), `playwright`, 실제 실행 가능한 Chromium 또는 Chrome.
- **출처 확인**: 자료·네트워크 접근. PDF는 `pypdf` 또는 `pdftotext` 등 원본 스킬이 허용하는 경로.
설치가 필요하면 먼저 승인을 받으세요. 승인 후 격리 환경에서 사용할 수 있는 일반적인 명령 예시는 다음과 같습니다. 이 명령을 이미 실행했다고 간주하지 마세요. 브라우저 설치는 다운로드·디스크 사용이 발생하며 OS 라이브러리 또는 관리자의 도움이 필요할 수 있습니다.
```sh
python3 -m pip install beautifulsoup4 lxml Pillow playwright
python3 -m playwright install chromium
```
네트워크·설치가 제한된 환경에서는 실행할 수 있는 단계만 수행하고 나머지를 미실행으로 보고합니다. Python 실행만 가능하면 조립은 할 수 있어도 화면 검사는 못 할 수 있습니다.
## 3. 단일 덱
먼저 `edu-deck-solo/SKILL.md`의 요청 정리·조사·구성 절차를 따르고, 사용자가 요청하면 구성안을 승인받습니다. 아래는 명령 형태의 예시이며 교육 내용을 자동으로 완성하는 명령이 아닙니다. 새 작업 폴더를 사용하세요.
새 덱은 만들기 전에 팩 경로와 legacy 경로 중 하나를 정합니다(기본값 없음). 강제 조건(기존 덱 편집, 사용자 지정, 팩에 없는 조각)이 없으면 요청을 보고 판단하고, 애매하면 사용자에게 한 번 묻습니다. 한 덱에 두 경로를 섞을 수 없습니다. 팩으로 정해지면 먼저 `python3 shared/scripts/pack_router.py --title "<제목>" --outcomes "<교육 뒤 할 수 있어야 하는 것>" --audience "<청중>"` 으로 디자인 후보 3종·추천·학습 흐름을 받고, 시안에서 골라 아래 init으로 뼈대를 만듭니다. 같은 주제를 다르게 다시 만들려면 `--seed`를 바꾸고, 최근 쓴 디자인은 `--recent`로 넘겨 반복을 줄입니다.
legacy 경로로 정해지면 `deck.json` 에 `title`·`output` 을 쓰고 `shared/assets/snippets/` 와 `shared/references/layouts.md` 를 참고해 `src/NN-이름.html` 을 직접 작성합니다. 이 경로에서도 `deck.json` 에 `theme`(classic 포함 9종)과 `arc`(6종)를 쓰고, 표지는 주제에 맞게 직접 설계하는 것이 기본입니다(계약: `shared/references/layouts.md` "표지 직접 설계 계약"). 못 만들 때만 `01-cover*.html` 카탈로그 변형 7종으로 폴백해 덱마다 다른 얼굴을 만듭니다 — `python3 shared/scripts/tone_router.py --title "…" --outcomes "…" --audience "…"` 가 추천을 계산하며, 아무것도 쓰지 않으면 기존과 같은 모양입니다.
```sh
python3 edu-deck/shared/scripts/resource_packs.py init ./my-deck --design editorial --flow problem --title "교육 제목"
```
생성된 `deck.json`과 `src/`를 실제 조사 내용으로 작성합니다. legacy 경로도 `deck.json`을 쓴 뒤부터는 같습니다. 제목·본문·도식·발표자 노트·평가 문제 등 원본 스킬의 기준을 충족해야 합니다. 초기 뼈대만 조립해 완성본으로 전달하지 마세요.
```sh
python3 edu-deck/shared/scripts/build_deck.py ./my-deck
python3 edu-deck/shared/scripts/check_deck.py ./my-deck/deck.html --json ./my-deck/check.json
```
결과 파일명은 `deck.json` 설정과 조립기 출력으로 확인하고, 다르면 검사 명령의 경로를 그 파일로 바꿉니다. 출처 검사·전체 화면/상호작용 점검 등 원본 스킬이 요구하는 나머지 검사도 수행합니다. `--no-render`는 전체 화면 검증을 대체하지 않습니다.
## 4. 시리즈
`edu-deck-series/SKILL.md`와 연결된 참조를 읽어 `series.json`과 편별 폴더를 작성하고 각 편을 검사합니다. 임의의 manifest 구조를 추측하지 마세요. 준비된 시리즈 작업 폴더를 조립합니다.
```sh
python3 edu-deck-series/scripts/build_series.py ./my-series --hub map --out ./my-series/portal.html
python3 edu-deck-series/scripts/check_series.py ./my-series/portal.html
```
`map`, `shelf`, `list` 목차를 지원합니다. 필수 포털 템플릿은 `edu-deck-series/dev/portal_template.html`에 포함됩니다. 개발 도구가 아니라 조립에 필요한 런타임 입력이므로 지우지 마세요.
## 5. 결과 전달
생성 HTML, 실제 검사 결과, 출처 확인 상태, 미실행 항목을 구분해 전달합니다. 첨부 ZIP을 읽을 수 없거나 Python이 없으면 초안·실행 안내까지만 제공하세요. 브라우저 검사가 막혔으면 HTML을 전달하더라도 **화면 검증 미완료**라고 밝혀야 합니다. 서비스 업로드·설치·외부 발행은 별도 승인 대상입니다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |