Communitygithub.com

DOCX 스킬

표, 다이어그램, 페이지 나눔 등 레이아웃이 중요한 DOCX 파일을 읽거나 검토합니다.

DOCX 스킬란 무엇인가요?

이 스킬은 DOCX 문서의 시각적 레이아웃이 중요한 상황에서 사용됩니다. 표, 다이어그램, 페이지 나눔과 같은 요소가 포함된 문서를 읽거나 검토할 때 유용하며, 문서를 편집하거나 최종 전달 전에 시각적 레이아웃을 검증할 때도 활용됩니다. 이 스킬은 주로 Claude Code와 같은 AI 에이전트 플랫폼에서 사용되며, LibreOffice와 Poppler 같은 시스템 도구를 활용하여 DOCX를 PDF로, 다시 PNG 이미지로 변환하여 시각적 검토를 지원합니다. 또한, python-docx 라이브러리를 통해 구조화된 편집(제목, 스타일, 표, 목록)이 가능하며, 렌더링 도구가 없는 경우 텍스트 추출을 통해 레이아웃 위험을 알리는 대체 방안을 제공합니다. 이러한 접근 방식은 개발자와 AI 에이전트 사용자가 문서 품질을 유지하면서 효율적으로 작업할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/openai/skills/doc

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

DOCX 스킬은(는) 무엇을 하나요?

사용 시기

  • 표, 다이어그램, 페이지 나눔 등 레이아웃이 중요한 DOCX 콘텐츠를 읽거나 검토할 때
  • 전문적인 서식으로 DOCX 파일을 생성하거나 편집할 때
  • 전달 전 시각적 레이아웃을 검증할 때

워크플로우

  1. 시각적 검토(레이아웃, 표, 다이어그램)를 우선시합니다.
    • soffice와 pdftoppm을 사용할 수 있으면 DOCX -> PDF -> PNG로 변환합니다.
    • 또는 scripts/render_docx.py(pdf2image 및 Poppler 필요)를 사용합니다.
    • 이러한 도구가 없으면 설치하거나, 사용자에게 로컬에서 렌더링된 페이지를 검토하도록 요청합니다.
  2. 편집 및 구조적 생성(제목, 스타일, 표, 목록)에는 python-docx를 사용합니다.
  3. 의미 있는 변경이 있을 때마다 다시 렌더링하고 페이지를 검사합니다.
  4. 시각적 검토가 불가능하면 python-docx로 텍스트를 추출하여 대체하고 레이아웃 위험을 알립니다.
  5. 중간 출력물을 정리하고 최종 승인 후 정리합니다.

임시 파일 및 출력 규칙

  • 중간 파일에는 tmp/docs/를 사용하고, 작업이 끝나면 삭제합니다.
  • 이 저장소 내에서 작업할 때는 최종 결과물을 output/doc/에 작성합니다.
  • 파일 이름은 안정적이고 설명적으로 유지합니다.

종속성 (누락 시 설치)

종속성 관리를 위해 uv를 선호합니다.

Python 패키지:

uv pip install python-docx pdf2image

uv를 사용할 수 없을 경우:

python3 -m pip install python-docx pdf2image

시스템 도구 (렌더링용):

# macOS (Homebrew)
brew install libreoffice poppler

# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils

이 환경에서 설치가 불가능하면, 누락된 종속성이 무엇인지와 로컬에서 설치하는 방법을 사용자에게 알려줍니다.

환경

필요한 환경 변수는 없습니다.

렌더링 명령어

DOCX -> PDF:

soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX

PDF -> PNG:

pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME

포함된 헬퍼:

python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages

품질 기대치

  • 클라이언트에게 전달할 수 있는 문서를 제공합니다: 일관된 타이포그래피, 간격, 여백 및 명확한 계층 구조.
  • 서식 결함(잘리거나 겹치는 텍스트, 깨진 표, 읽을 수 없는 문자, 기본 템플릿 스타일)을 피합니다.
  • 차트, 표 및 시각 자료는 렌더링된 페이지에서 올바른 정렬로 읽을 수 있어야 합니다.
  • ASCII 하이픈만 사용합니다. U+2011(줄 바꿈 없는 하이픈) 및 기타 유니코드 대시를 피합니다.
  • 인용 및 참조는 사람이 읽을 수 있어야 하며, 도구 토큰이나 자리 표시자 문자열을 남기지 않습니다.

최종 확인

  • 최종 전달 전에 모든 페이지를 100% 확대하여 다시 렌더링하고 검사합니다.
  • 간격, 정렬 또는 페이지 나눔 문제를 수정하고 렌더링 루프를 반복합니다.
  • 사용자가 보관을 요청하지 않는 한 임시 파일이나 중복 렌더링과 같은 잔여물이 없는지 확인합니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬