Communitygithub.com

zhoy0409-debug/scholarflow-skills

Zhoy의 ScholarFlow Skills: 문헌 검토, 학술 작성, 그림, 생물정보학 및 연구 결과물을 위한 재사용 가능한 에이전트 스킬입니다.

scholarflow-skills란 무엇인가요?

이 스킬은 문헌 검토, 학술 작성, 그림, 생물정보학 및 연구 결과물 작업을 위한 재사용 가능한 에이전트 스킬 모음입니다. 특히 PDF 처리에 초점을 맞추어, 레이아웃과 시각적 요소가 중요한 PDF를 읽거나 검토할 때 사용하고, `reportlab`을 사용하여 PDF를 프로그래밍 방식으로 생성하며, `pdfplumber`나 `pypdf`와 같은 도구로 텍스트 추출을 수행합니다. 주요 워크플로는 페이지를 PNG로 렌더링하여 시각적으로 검토하고, `pdftoppm`을 통해 확인하며, 최종 결과물의 정렬, 간격, 가독성을 보장합니다. `uv`를 선호하는 종속성 관리 방식을 따르며, `tmp/pdfs/`와 `output/pdf/` 디렉토리를 사용하여 중간 및 최종 파일을 체계적으로 관리합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

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

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

문서

PDF 스킬

사용 시기

  • 레이아웃과 시각적 요소가 중요한 PDF 콘텐츠를 읽거나 검토할 때
  • 신뢰할 수 있는 형식으로 PDF를 프로그래밍 방식으로 생성할 때
  • 전달 전 최종 렌더링을 확인할 때

워크플로

  1. 시각적 검토 선호: PDF 페이지를 PNG로 렌더링하여 검사합니다.
    • pdftoppm을 사용 가능하다면 사용합니다.
    • 사용할 수 없는 경우 Poppler를 설치하거나 사용자에게 로컬에서 출력을 검토하도록 요청합니다.
  2. 새 문서를 생성할 때는 reportlab을 사용하여 PDF를 생성합니다.
  3. 텍스트 추출 및 빠른 확인에는 pdfplumber(또는 pypdf)를 사용합니다. 레이아웃 정확성을 위해 의존하지 마십시오.
  4. 의미 있는 업데이트 후에는 페이지를 다시 렌더링하고 정렬, 간격 및 가독성을 확인합니다.

임시 및 출력 파일 규칙

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

종속성 (누락 시 설치)

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

Python 패키지:

uv pip install reportlab pdfplumber pypdf

uv를 사용할 수 없는 경우:

python3 -m pip install reportlab pdfplumber pypdf

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

# macOS (Homebrew)
brew install poppler

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

이 환경에서 설치가 불가능한 경우, 누락된 종속성이 무엇인지와 로컬에서 설치하는 방법을 사용자에게 알려주십시오.

환경

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

렌더링 명령어

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

품질 기대 사항

  • 세련된 시각적 디자인 유지: 일관된 타이포그래피, 간격, 여백 및 섹션 계층 구조.
  • 렌더링 문제 방지: 잘린 텍스트, 겹치는 요소, 깨진 표, 검은 사각형 또는 읽을 수 없는 글리프.
  • 차트, 표 및 이미지는 선명하고 정렬되어 있으며 명확하게 레이블이 지정되어야 합니다.
  • ASCII 하이픈만 사용하십시오. U+2011(줄 바꿈 없는 하이픈) 및 기타 유니코드 대시를 피하십시오.
  • 인용 및 참조는 사람이 읽을 수 있어야 합니다. 도구 토큰 또는 플레이스홀더 문자열을 남기지 마십시오.

최종 확인

  • 최신 PNG 검사에서 시각적 또는 형식 결함이 0개임을 확인할 때까지 전달하지 마십시오.
  • 머리글/바닥글, 페이지 번호 및 섹션 전환이 정돈되어 있는지 확인합니다.
  • 중간 파일을 정리하거나 최종 승인 후 제거합니다.

관련 스킬