SYuan03/Skill-Anything

Any source (PDF, video, web, audio, text) to interactive learning package with quizzes, flashcards and spaced repetition. One command, 12-section study guide.

Skill‑Anything

무엇인가요 – PDF, 동영상, 웹 페이지, 일반 텍스트 파일, 오디오, 또는 코드 리포지토리와 같은 어떤 종류의 자료도 구조화된 학습 팩 으로 변환하는 Python CLI / 라이브러리입니다. 팩에는 12섹션 학습 가이드, 퀴즈, 플래시카드, 연습문제, 용어집, 개념도 이미지, 그리고 선택적으로 AI 에이전트 스킬 (SKILL.md) 이 포함됩니다. 이는 Claude Code, Cursor, Codex 등의 도구에서 사용할 수 있습니다.

왜 중요한가요 – 인간의 학습은 수동적인 독서에 약합니다. Skill‑Anything 은 교사들이 일반적으로 수동으로 수행하는 모든 프로세스를 자동화합니다: 요약, 핵심 개념 추출, 활성 재인(recall) 항목 생성, 학습 경로 구성. 이 모든 작업은 LLM 호출(OpenAI 호환 API)을 통해 이루어지며, 팩이 생성된 후에는 완전히 오프라인으로 실행할 수 있습니다.

핵심 기능 (README에 설명됨)

소스 무관 인게스터(Source-agnostic ingestion) – PDF(アウトラ인 인식), 웹 페이지, 유튜브/동영상 자막, 오디오(Whisper), 일반 텍스트, 또는 전체 Git 리포지토리.
섹션 인식 맵-리듀스 파이프라인 – 각 섹션은 병렬로 요약된 후, 글로벌 리듀스 단계에서 최종 가이드가 생성됩니다. 동시성은 기본 6으로 설정되며, 사용자 정의 가능.
캐싱 – 프롬프트 + 모델 + 버전의 SHA-256 해시를 디스크에 저장; 동일한 LLM 호출은 반복 실행 시 건너뜁니다.
이중 모델 라우팅 – 각 섹션의 "맵" 호출에는 빠른 모델, 최종 "리듀스"에는 더 지능적인 모델 사용.
12섹션 출력 – 요약, 개념도, 개요, 상세 노트, 핵심 개념, 용어집, 체크리스트, 핵심 포인트, 퀴즈, 플래시카드, 연습문제.
다양한 내보내기 형식 –
- --format all → 학습 가이드, YAML 팩, 오프라인 웹사이트, Anki TSV, SKILL.md 번들.
- --format web → 단일 자가 포함 index.html (CDN 없음, 오프라인 작동 가능).
- --format anki → Anki 임포트용 UTF-8 TSV, HTML 필드 및 태그 포함.
- --format skill → AI 에이전트용 SKILL.md, 자산, 참조, 스크립트 포함 디렉터리.
인용문 인식 생성 (v0.4.1) – 모든 퀴즈/플래시카드/연습문제에는 원본 텍스트와 검증된 정확한 인용문이 포함됩니다.
CLI 유틸리티 – sa audit (CI 스타일 검증), sa share (웹 번들을 압축하여 전송), sa lint (스킬 패키지 검증), 인터랙티브 sa quiz 및 sa review 명령어.
확장 가능한 구성 – 환경 변수로 API 기지, 모델 이름, 동시성, 캐시 제어 등을 설정 가능.

일반 워크플로우

# 1️⃣ 설치 (편집 가능한 개발 버전 또는 PyPI에서)
pip install skill-anything[all]   # 또는 리포지토리 복제 후 pip install -e .[all,dev]

# 2️⃣ LLM 자격 증명 설정
cp .env.example .env && nano .env   # API_KEY, API_BASE, 모델 이름 설정

# 3️⃣ 어떤 소스에서든 팩 생성
sa pdf textbook.pdf --format all          # PDF → 전체 팩 + 웹 + Anki + 스킬
sa repo https://github.com/openai/openai-python --format study
sa video https://youtu.be/… --format web

# 4️⃣ 출력물 공유 또는 사용
sa share output/textbook.yaml               # index.html + ZIP 생성
sa export output/textbook.yaml --format anki # Anki 임포트용 TSV
sa export output/textbook.yaml --format skill # AI-에이전트 대응 SKILL.md 번들

# 5️⃣ 로컬에서 상호작용
sa quiz output/textbook.yaml                # 인터랙티브 퀴즈 (6가지 유형)
sa review output/textbook.yaml              # 플래시카드 간격 반복 모드

누구에게 유용할까?

학생 및 자기학습자 – 강의 동영상이나 교과서 챕터를 퀴즈와 플래시카드가 포함된 즉시 학습 가능한 가이드로 변환.
팀 리더 (신입 채용 온보딩용) – 코드 리포지토리를 sa repo에 넣어 온보딩 팩(용어집, 개념, 연습문제)과 코드베이스에 대한 질문에 답할 수 있는 AI 에이전트 스킬을 생성.
교육자 및 콘텐츠 제작자 – 기존 자료에서 빠르게 학습 자료를 생성하고 Anki나 정적 웹사이트로 내보내 배포 가능.
AI 도구 개발자 – SKILL.md 내보내기를 활용해 에이전트에게 특정 도메인용 구조화된 지식 기반을 제공.

설치 및 요구 사항

Python 3.10 이상.
특정 소스 유형용 선택적 확장 (pdf, video, web, audio).
최고 품질을 위해 OpenAI 호환 API 키 필요; 키 없이도 룰 기반 생성으로 대체 가능.
PyPI에서 설치:
```
pip install skill-anything[all]
```
또는 리포지토리 복제 후 개발용으로 편집 가능 모드로 설치.

라이선스

MIT – 허용적인 오픈소스 라이선스.