pdf — Claude Code 스킬

PDF 문서를 다루는 Anthropic 공식 스킬. 텍스트 추출, 병합/분할, 페이지 회전, 워터마크, 폼 필드 채우기, 암호화/복호화 등 PDF 전체 라이프사이클을 처리한다.

pdf는 Anthropic이 공식 배포하는 Claude Code용 문서 처리 스킬(document-skills 묶음의 일부)로, PDF 파일을 읽고 가공하는 전체 라이프사이클을 에이전트가 직접 수행하도록 돕는다. 핵심 기능은 PDF에서 텍스트 추출, 여러 PDF의 병합과 분할, 페이지 회전, 워터마크 삽입, 폼(입력 양식) 필드 채우기, 그리고 암호화·복호화다. 즉 "스캔본/계약서에서 본문만 뽑아오기", "여러 보고서를 한 파일로 합치기", "특정 페이지 범위만 잘라내기", "정해진 양식에 값 채워 제출용 PDF 만들기"처럼 사람이 GUI 도구로 하던 반복 작업을 자연어 지시로 처리할 수 있게 한다.

이 스킬은 별도의 외부 SaaS나 클라우드 변환 서비스에 의존하지 않고, 스킬에 포함된 스크립트와 참조 문서(SKILL.md·reference.md·forms.md 등)를 통해 로컬에서 작업을 안내·실행하는 구조다. 따라서 문서가 외부 서버로 전송되지 않는 로컬 처리를 기본으로 한다는 점이 데이터 민감도가 높은 문서를 다룰 때 장점이 된다. 폼 채우기와 암호화 같은 고급 동작은 forms.md·reference.md에 정리된 절차를 따른다.

누가 쓰면 좋은가: 계약서·인보이스·리포트 등 대량의 PDF를 다루는 운영/백오피스 작업자, 문서 파이프라인을 자동화하려는 개발자, 제출용 양식을 반복 생성해야 하는 팀에 적합하다. 같은 document-skills 묶음의 docx·xlsx·pptx와 함께 쓰면 오피스 문서 전반을 하나의 워크플로로 묶을 수 있다. 정확한 함수·옵션·의존성은 버전에 따라 달라질 수 있으니 설치 후 스킬에 동봉된 공식 문서(SKILL.md/reference.md) 확인을 권장한다.

언제 쓰나

PDF에서 본문 텍스트를 뽑아 분석·요약·검색하려 할 때, 여러 PDF를 병합하거나 특정 페이지만 분할·회전하려 할 때, 워터마크를 넣거나 제출용 양식(폼 필드)을 자동으로 채워야 할 때, PDF에 암호를 걸거나 풀어야 할 때 적합하다. 반복적인 문서 가공을 자연어 지시로 자동화하고 싶고, 문서를 외부 서비스에 올리지 않고 로컬에서 처리하고 싶은 경우에 특히 유용하다.

설치

/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills

Claude Code의 플러그인 마켓플레이스를 통해 document-skills 묶음으로 설치되며(설치 명령은 별도 표시), pdf 단독이 아니라 docx·xlsx·pptx와 함께 들어온다. 설치 후 스킬에 동봉된 스크립트가 의존하는 런타임·라이브러리가 로컬에 갖춰져 있어야 일부 동작(폼 채우기·암호화 등)이 정상 실행된다. 정확한 사용법·함수·옵션은 버전에 따라 달라질 수 있으므로 스킬 폴더의 SKILL.md·reference.md·forms.md 공식 문서 확인을 권장한다.

보안 주의

API 키나 비밀키는 필요하지 않다. 다만 계약서·신분 정보 등 민감한 PDF를 다룰 가능성이 높으므로 처리 대상 파일의 접근 범위에 주의해야 한다. 암호화·복호화 시 사용하는 비밀번호가 명령 기록이나 로그에 평문으로 남지 않도록 관리하고, 복호화는 권한 있는 문서에만 수행한다. 병합·분할·덮어쓰기는 원본 파일을 변경·손실시킬 수 있으니 사본으로 작업하길 권장한다. 또한 PDF 본문·폼 텍스트에 삽입된 지시문이 프롬프트 인젝션으로 작동할 수 있으므로, 추출된 내용을 그대로 신뢰해 실행하지 말고 신뢰 경계를 둘 것.

자주 묻는 질문

pdf 스킬만 따로 설치할 수 있나요?

마켓플레이스를 통해 document-skills 묶음으로 설치되며, pdf는 docx·xlsx·pptx와 함께 들어옵니다. 사용할 때는 PDF 작업에 한해 pdf 스킬이 동작합니다. 정확한 구성은 설치 후 공식 문서 확인을 권장합니다.

문서가 외부 서버로 전송되나요?

이 스킬은 외부 SaaS 변환 서비스에 의존하지 않고 동봉 스크립트로 로컬 처리를 안내·실행하는 구조라, 기본적으로 PDF가 외부로 전송되지 않습니다. 다만 사용하는 다른 도구·환경 설정에 따라 달라질 수 있으니 민감 문서는 처리 경로를 확인하세요.

폼 필드 채우기나 암호화도 되나요?

네. 폼(입력 양식) 필드 채우기, 워터마크, 암호화·복호화까지 지원합니다. 폼 관련 세부 절차는 forms.md, 전체 기능·옵션은 reference.md에 정리되어 있으니 해당 문서를 참고하세요.