Noi1r/beamer-skill

What it solves

Beamer Skill은 AI 코딩 어시스턴트가 Beamer LaTeX를 사용하여 학술 발표 자료를 생성, 컴파일 및 개선할 수 있는 구조화된 프레임워크를를 제공합니다. 이는 AI가 생성한 슬라이드가 너무 밀집되어 있거나, 교육적 구조가 부족하거나, 엄격한 학술적 서식 및 시각적 표준(예: 넘침 방지 및 색맹 친화적 대비 보장)을 충족하지 못하는 일반적인 문제를 해결합니다.

How it works

이 프로젝트는 Claude Code, OpenAI Codex CLI, Cursor, GitHub Copilot과 같은 다양한 AI 도구에 통합할 수 있는 일련의 특화된 지침 파일(skills)을 제공합니다. 이러한 지침은 AI를 다음과 같은 다단계 라이프사이클로 안내합니다:

1. Creation: 자료 분석 및 구조 계획에서 초안 작성 및 품질 루프까지 이어지는 협업 프로세스입니다.
2. Compilation: 진단 기능이 포함된 3-pass XeLaTeX 및 bibtex 프로세스입니다.
3. Review & Audit: 교정, 시각적 레이아웃 감사(박스 넘침 감지), 교육적 검증(13가지 패턴 사용), 그리고 TikZ 다이어그램 검토를 위한 특화된 작업입니다.
4. Verification: 임계값(예: 90/100)에 도달할 때까지 문제에 대해 점수를 차감하는 수치적 품질 점수 시스템입니다.

또한 pdf-mcp와 통합하여 연구 논문에서 그림을 직접 추출하여 슬라이드에 포함할 수 있습니다.

Who it’s for

발표를 위해 LaTeX를 사용하며, AI를 활용하여 연구 논문을 고품질의 교육적으로 타당한 Beamer 슬라이드 덱으로 변환하고자 하는 연구자, 학자 및 학생들입니다.

Highlights

• Pedagogical Guardrails: "모티베이션(motivation) 후 형식주의(formalism)" 원칙과 엄격한 콘텐츠 밀도 제한(예: 슬라이드당 최대 7개 불렛 포인트)을 강제합니다.
• Visual Quality Control: Beamer 박스 넘침을 감지하고 색맹 친화적 팔레트를 위해 WCAG AA 대비율을 강제합니다.
• Technical Precision: 하드코딩된 근사치를 피하기 위해 TikZ 다이어그램에 extbackslash pgfmathsetmacro 사용을 의무화합니다.
• Cross-Platform Support: Claude Code, Antigravity, Codex CLI, VS Code 확장 프로그램(Copilot, Cline, Cursor)과 호환됩니다.
• Figure Extraction: LaTeX에서 직접 사용하기 위해 소스 PDF에서 그림을 추출할 수 있는 기능입니다.
• PowerPoint Hand-off: Codex Presentations를 통해 검증된 Beamer 덱을 편집 가능한 PowerPoint 파일로 전환하는 문서화된 워크플로우를 제공합니다.