hwp2md-ingest SKILL.md skillA
hwp2md-ingest from lemoncloud-io/2nd-brain is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add lemoncloud-io/2nd-brain/hwp2md-ingest@git:20261002.9cc45c7Pins git:20261002.9cc45c7 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- lemoncloud-io/2nd-brain
- Path
projects/second-brain/config/skills/hwp2md-ingest/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261002.9cc45c7, committed Oct 2, 2026
- First version recorded
- Aug 24, 2026
- Size
- 8,981 bytes
- Repository stars
- 5
- License
- MIT
HWP/HWPX(한글 문서)를 vault 잉게스트 가능한 MD로 변환해 Clippings/에 투입한다. 기본 전략은 H1(hwp-hwpx-parser 순수 Python 직행 — 한컴오피스 불필요)이고, 텍스트 희소 문서는 H3(페이지 렌더 → Claude 비전 전사)로 폴백한다. wiki화는 하지 않는다 — 기존 vault-ingest가 이어받는다. 커밋 불가 문서(고객사·개인)는 vault 밖 변환 모드로 변환만 수행한다. 근거: 2026-08-21 로컬 스모크 실측 (§ 근거·주의).
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# hwp2md-ingest (HWP/HWPX → Clippings MD)
## 언제 사용하는가
- 사용자가 "이 hwp 잉게스트해줘" / "한글 문서를 vault에 넣어줘"라고 요청할 때
- .hwp(HWP 5.0 바이너리) 또는 .hwpx(OWPML) 내용을 wiki 지식으로 만들고 싶을 때
이 스킬은 **변환과 Clippings 투입까지만** 담당한다. 개념 추출·wiki 생성·커밋·PR은
하지 않는다 (기존 vault-ingest / vault-ingest-claude 몫). PDF는 이 스킬이 아니라
`pdf2md-ingest`를 쓴다 — "hwp를 pdf로 출력해서" 우회할 필요가 없다는 것이 이 스킬의
존재 이유다.
## 전제 도구 (없으면 안내 후 중단 — 자동 설치 금지)
| 도구 | 확인 | 설치 안내 |
|---|---|---|
| uv (H1 — hwp-hwpx-parser 자동 준비) | `command -v uv` | `brew install uv` |
| Node 18+ (H3 렌더·H2 옵션) | `node --version` | nvm 등으로 설치 |
한컴오피스·JVM은 필요 없다. H3/H2가 쓰는 `hwp-mcp`는 `npx -y hwp-mcp`로 실행 시점에
준비된다 (전역 설치 불필요).
**스킬 발견용 설치** (머신별 1회): `$VAULT_DIR/.claude/skills/`에 심링크
```bash
mkdir -p "$VAULT_DIR/.claude/skills"
ln -s "$VAULT_DIR/projects/second-brain/config/skills/hwp2md-ingest" \
"$VAULT_DIR/.claude/skills/hwp2md-ingest"
```
## 절차
### 0. 게이트 (변환 전 — 하나라도 실패하면 아무것도 쓰지 않고 보고)
1. **커밋 가능성**: 사용자에게 확인 — "이 문서는 팀 공유 vault에 커밋 가능한가?"
고객사·개인 문서면 정식 잉게스트(§3 산출·마무리)는 중단한다. 변환 자체가 필요한
경우에는 § vault 밖 변환 모드를 제안하고, 사용자가 그 모드를 명시적으로 선택한
경우에만 진행한다. (고객사 hwp 서식·계획서가 전형적 해당 사례.)
…Read the whole file at its exact version.
How to install
mdr add lemoncloud-io/2nd-brain/hwp2md-ingest@sha256:07c818adee4a58eeThe line at the top of this page pins the label git:20261002.9cc45c7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_s3vefeiu2zjd3h5e)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Aug 24, 2026 and Oct 2, 2026, about one every 39 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261002.9cc45c7 latest | 2026-10-02 | 9cc45c7 | 8,981 B | A | view · diff |
| git:20260824.fe8de12 | 2026-08-24 | fe8de12 | 8,991 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8981 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
lemoncloud-io/2nd-brain · 5 stars · license MIT · pushed 2026-10-28 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_s3vefeiu2zjd3h5e GET https://markdownregistry.com/api/v1/resolve?ref=lemoncloud-io/2nd-brain/hwp2md-ingest GET https://markdownregistry.com/api/v1/blob/07c818adee4a58eef9e02474c4c17025d15778bb315af2997d8009be33100709
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.