genoffice
무엇인가
genoffice는 오피스 문서 파일을 다루는 작업에서 에이전트가 따를 절차를 정의하는 스킬 묶음이다. 규율 대상은 로컬 디스크에 있는 실제 OOXML 바이너리를 읽고, 수정하고, 다른 형식으로 변환하는 흐름 전체다. 문서 내용을 텍스트로 뽑아 요약하는 작업이 아니라, 파일 자체를 열어 편집 결과를 원본 포맷으로 되돌려 저장하는 작업을 규율한다.
어떻게 동작하나
스킬은 SKILL.md 형식의 규칙 파일로 배포되며, 에이전트의 스킬 경로에 배치되면 문서 관련 요청에서 로드된다. 규칙의 핵심은 genoffice CLI를 호출하는 명령 패턴, 포맷별 처리 절차, 편집 범위 제한이다. 편집하지 않은 부분은 바이트 단위로 보존하고 수정된 블록만 다시 쓰는 규칙, 스프레드시트에는 계산된 값을 붙여 넣지 않고 살아 있는 수식을 남기는 규칙, 변환은 PDF→Word/Excel/PowerPoint, Markdown→Word, HTML→Word 경로를 온디바이스에서 수행하는 규칙이 포함된다.
무엇과 다른가
프롬프트에 "docx 파일 만들어줘"라고 직접 지시하거나 에이전트가 즉석에서 문서 라이브러리를 골라 쓰는 방식과 다르다. genoffice는 자체 Rust .xlsx 엔진과 PDFium 기반 PDF 편집기를 CLI 표면으로 노출하고, 스킬은 그 표면의 사용법만 규율한다. 결과물이 Word·Excel·PowerPoint에서 계속 열리는지를 기준으로 삼기 때문에, 형식 호환성을 에이전트의 판단에 맡기지 않는다.
어떻게 쓰나
macOS, Windows, Linux용 데스크톱 앱을 설치하면 genoffice CLI와 스킬이 함께 제공된다. 스킬 파일을 Claude Code 등 사용 중인 에이전트의 스킬 디렉터리에 두고, 문서 생성·변환·편집을 요청하면 CLI 호출로 이어진다. 창을 열지 않고도 동작하며, 앱을 띄워 같은 파일을 이어서 편집할 수 있다. 설치 명령과 요구 사항은 저장소의 Download·CLI 항목에 정리되어 있다.
전제와 한계
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Windsurf에서 쓸 수 있다. AI 호출은 사용자가 지정한 제공자 키(Claude, OpenAI, Gemini, DeepSeek 등 OpenAI 호환 엔드포인트 포함) 또는 Genspark 로그인을 전제로 하며, 로컬 서버도 지정할 수 있다. 스킬 자체는 문서 편집 로직을 담지 않고 CLI에 위임하므로, CLI가 설치되지 않은 환경에서는 동작하지 않는다. 파일 열기·편집·저장·변환은 로컬에서 처리되고 AI 호출만 외부로 나간다.