Light-skills
무엇인가
Light Skills는 연구·공모전·혁신 프로젝트를 모호한 착상에서 검사 가능한 산출물로 옮기는 전 과정을 규율하는 스킬 묶음이다. 규율 대상은 문헌·데이터·로그·논문 원문을 먼저 읽고 다음 단계를 판단하는 순서, 사실·DOI·링크·저널 규칙·소프트웨어 버전을 추측하지 않는 표기, 논문图·데이터图·실험图의 프로그램 생성, 그리고 착수·독창성·증거 강도·투고 목표·추가 투입을 사람이 확정하는 결정 지점이다.
어떻게 동작하나
각 스킬은 저장소 skills/ 아래 디렉터리로 존재하고 SKILL.md를 진입 파일로 둔다. scripts/bootstrap_agent_skills.py가 이 디렉터리를 대상 에이전트의 규약 경로로 복사하거나 생성하며, Claude Code의 경우 프로젝트 수준은 $REPO\.claude\skills\, 전역 수준은 $HOME\.claude\skills다. 발동은 별도 슬래시 명령이 아니라 에이전트가 작업 중 해당 스킬의 SKILL.md를 로드하는 방식이고, --check-only 플래그로 설치 상태를 검사한다. 규칙 내용에는 선행 읽기, unknown 표기, 도구 부재 시 UNAVAILABLE 표시, 사용자 확인 노드가 포함된다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 단일 CLAUDE.md에 모든 지침을 몰아넣는 방식과 구조가 다르다. 단일 규칙 파일은 전 작업에 같은 지침을 상시 적용하지만, 이 팩은 스킬을 주제별로 분리해 해당 작업에서 필요한 SKILL.md만 로드되게 한다. 또한 LaTeX 도구나 R이 없을 때 성공한 척하지 않고 UNAVAILABLE로 표시하거나 Python 대체 여부를 사용자에게 되묻는 실패 표기 절차를 규칙으로 고정한다.
어떻게 쓰나
설치 절차는 저장소를 클론한 뒤 PYTHONUTF8을 설정하고 부트스트랩 스크립트를 대상별로 실행하는 것이다. Claude Code 프로젝트 수준은 python scripts\bootstrap_agent_skills.py --targets claude --mode auto --force, 전역 수준은 .\skills\* 를 $HOME\.claude\skills\ 로 복사한다. 설치 후 --check-only로 검증하고, 현재 작업 상태에 맞는 prompt를 골라 에이전트에 붙여 첫 작업을 시작한다.
전제와 한계
전제는 Git과 Python 3.10+이며, 논문 조판에는 MiKTeX 등 latexmk·pdfLaTeX·XeLaTeX·LuaLaTeX·BibTeX·Biber, ggplot2 图에는 R과 ggplot2·scales가 필요하다. 부트스트랩 대상은 Claude Code 외에 Codex(.agents/skills)와 OpenCode(.opencode/skills)로 나뉘어 있고, 공개판은 MCP나 로컬 데이터베이스를 요구하지 않으며 최신 정보는 작업 현장에서 확인한다. 도구가 없는 환경에서는 해당 스킬이 UNAVAILABLE로 남고 자동으로 대체 실행되지 않는다.