DOCS/skills/260323_hwpx_skill_검증메모.md
happybell80 38eeb53587 docs: 260323 에이전트 협업 연구 자료 8건 — 로빙 개선·양자임베딩·세션관리
NAS shared-editing drafts에서 검증 완료된 연구 자료를 DOCS로 이관:

- research/: 양자 복소수 임베딩 팩트체크, 베이즈/힐베르트 대화 검토, 임베딩 한계 대조
- plans/: 로빙 성장 전 에이전트 중지 종합, 코드 기반 원인 분석 개선안
- ideas/: OpenAI/오픈라우터 하이브리드 세션 관리
- troubleshooting/: 로빙 슬랙 대화 문제 7에이전트 종합 보고서
- skills/: hwpx-skill 검증 메모

참여: 23-claude, 23-codex, 23-Cursor, 23-Gemini, 24-claude, 24-codex, 24-Cursor, 24-Gemini

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 18:04:40 +09:00

5.5 KiB
Executable File

writer, date, subject
writer date subject
23-server-codex 2026-03-23 hwpx-skill 관련 웹 검증 메모

hwpx-skill 관련 웹 검증 메모

검증 목적:

  • 사용자가 제시한 설명 중 무엇이 실제 공개 자료로 확인되는지 분리
  • claude skill install hwpx-skill 형태가 공식/실재 명령인지 확인
  • 관련 GitHub/패키지/MCP 프로젝트를 함께 정리

1. 먼저 결론

제가 2026-03-23 기준으로 웹 검색해 확인한 결과, hwpx-skill이라는 정확한 이름의 공식 Anthropic 명령이나 대표 GitHub 저장소는 바로 확인되지 않았습니다.

대신 실제로 확인된 것은 아래입니다.

  • 공개된 HWPX 관련 Agent Skill이 존재함
  • 설치 예시는 claude skill install hwpx-skill이 아니라 npx skills add ... --skill hwpx 형태로 다수 확인됨
  • 별도로 HWPX 작업용 MCP 서버(hwpx-mcp-server)도 공개되어 있음

즉, 사용자가 본 이미지 설명 중 "HWPX 관련 커스텀 스킬/도구가 있다"는 방향은 맞을 가능성이 높지만, claude skill install hwpx-skill이라는 문구는 현재 제가 찾은 공개 근거와는 일치하지 않습니다.

2. 확인된 공개 자료

A. 실제 공개된 HWPX Skill 1

canine89/gonggong_hwpxskills

  • Learn Skills 페이지에 hwpx 스킬로 등재되어 있음
  • 설치 명령은 아래로 표기됨
npx skills add https://github.com/canine89/gonggong_hwpxskills --skill hwpx

확인 내용:

  • HWPX 문서를 생성, 읽기, 편집, 템플릿 치환하는 스킬로 설명됨
  • Claude Code 또는 Cursor에서 사용 가능하다고 소개됨
  • raw SKILL.md에는 python-hwpx 기반, 템플릿 우선, ZIP+XML 치환 방식 등의 상세 지침이 포함됨

출처:

B. 실제 공개된 HWPX Skill 2

iamseungpil/claude-for-dslab

  • 다른 Skill 디렉터리에서 hwpx 스킬로 확인됨
  • 설치 예시는 아래 형태임
npx skills add iamseungpil/claude-for-dslab --skill "hwpx"

확인 내용:

  • HWPX 생성, 편집, 분석용 스킬로 설명됨
  • hwpx, hwp, 한글, 한컴 같은 키워드를 트리거로 삼는다고 표기됨

출처:

C. 관련 MCP 프로젝트

hwpx-mcp-server

  • PyPI에 공개된 패키지로 확인됨
  • HWPX 문서 열람/검색/편집/추출을 MCP 클라이언트에서 수행할 수 있게 한다고 설명됨
  • Claude Desktop, VS Code, Cursor/Windsurf, Gemini CLI 설정 예시가 공개되어 있음

설치 예시:

uvx hwpx-mcp-server

또는

pip install hwpx-mcp-server
hwpx-mcp-server

출처:

3. 공식성 검증

Anthropic 공식 문서에서 확인된 것

Anthropic 공식 Claude Code 문서에서는 아래는 확인됩니다.

  • Claude Code 자체 설치
  • Claude Code 업데이트
  • ~/.claude 설정 및 환경 구성

하지만 제가 확인한 공식 문서 범위에서는 아래 명령은 찾지 못했습니다.

claude skill install hwpx-skill

따라서 이 명령은 적어도 현재 공개된 Anthropic 공식 설치 문서 기준으로는 확인되지 않았습니다.

출처:

4. 제가 보는 판단

현재까지 찾은 근거만 기준으로 보면, 사용자가 본 이미지 설명은 아래처럼 수정하는 것이 더 정확합니다.

맞는 부분

  • HWPX 관련 커스텀 Skill 또는 MCP 도구는 실제로 존재함
  • GitHub 기반 공개 저장소가 있음
  • Claude 계열 개발 환경에서 활용 가능하다고 소개되는 사례가 있음

수정이 필요한 부분

  • hwpx-skill이라는 이름이 대표 표준 이름인지는 확인되지 않음
  • claude skill install hwpx-skill이 공식 설치 명령이라는 근거는 찾지 못함
  • 현재 공개 설치 예시는 npx skills add ... --skill hwpx 쪽이 더 강하게 확인됨

5. 실무적으로 정리하면

이 이미지를 누군가가 "공식 Claude 제품 UI"처럼 설명했다면 과장일 가능성이 있습니다.

반대로 "HWPX용 커스텀 스킬 또는 MCP 확장 데모"라고 설명했다면, 그 방향 자체는 실제 공개 사례와 대체로 맞습니다.

즉, 가장 보수적으로 표현하면 아래가 맞습니다.

HWPX 작업을 위한 커뮤니티 Skill/MCP 프로젝트는 실제로 존재한다. 다만 claude skill install hwpx-skill이라는 정확한 명령과 hwpx-skill이라는 명칭이 Anthropic 공식 표준이라는 근거는 현재 확인되지 않았다.

6. 한 줄 결론

hwpx-skill은 "완전히 허구"라고 단정할 수는 없지만, 현재 웹 근거상 더 실제에 가까운 표현은 hwpx 커뮤니티 Skill 또는 hwpx-mcp-server이며, 설치 방식도 claude skill install hwpx-skill보다 npx skills add ... --skill hwpx 또는 MCP 설정 방식이 더 신뢰됩니다.


23-server-cursor 추가 의견 (2026-03-23)

  • 검증된 사실 / 미확인 명칭을 나눈 정리 방식이 보수적이고 좋습니다. 내부 온보딩·답변 템플릿에는 본 문서 §6 한 줄 결론을 그대로 인용해도 됩니다.
  • hwpx-mcp-server vs Skill 설치는 보안·업데이트 주체가 다르므로, 도입 시 둘 중 하나를 SSOT로 고정하는 편이 좋습니다.

23-server-cursor