reborn-token 1.0.1 → 1.0.2

package/README.md

@@ -4,11 +4,11 @@
 전부 로컬. API 키 없음. 네트워크 안 씁니다. MIT.
 
 ```
-npx reborn-token
+npx --yes reborn-token
 ```
 
 그다음 클로드에게 **"이 PDF 마크다운으로 바꿔줘"** 라고 말하면 됩니다.
-터미널에서 바로 쓰려면 `npx reborn-token md contract.pdf`.
+터미널에서 바로 쓰려면 `npx --yes reborn-token md contract.pdf`.
 
 ---
 
@@ -43,8 +43,8 @@ Anthropic 문서(`build-with-claude/pdf-support`, 2026-08-24 확인)에서 **그
 | `pptx` | 슬라이드별 제목 + 글머리 |
 
 ```
-npx reborn-token md contract.pdf proposal.docx pricing.xlsx
-npx reborn-token md contract.pdf -o ./out
+npx --yes reborn-token md contract.pdf proposal.docx pricing.xlsx
+npx --yes reborn-token md contract.pdf -o ./out
 ```
 
 찍어 주는 것:
@@ -81,7 +81,7 @@ npx reborn-token md contract.pdf -o ./out
 ## 설치 확인
 
 ```
-npx reborn-token --check
+npx --yes reborn-token --check
 ```
 
 설치기는 파일을 복사하고 끝내지 않고 **변환기를 실제로 불러** 확인한 뒤에

package/cli.mjs

@@ -2,10 +2,11 @@
 /**
  * 토큰 절반 — PDF·워드·엑셀을 **깔끔한 마크다운**으로 바꾼다.
  *
- *   npx reborn-token                  스킬 설치 (+ 설치 뒤 실제로 돌려 확인)
- *   npx reborn-token md <파일...>      변환 → 파일 옆에 .md
- *   npx reborn-token md <파일> -o out  나갈 폴더 지정
- *   npx reborn-token --check          설치 상태만 본다
+ *   npx --yes reborn-token                  스킬 설치 (+ 설치 뒤 실제로 돌려 확인)
+ *   npx --yes reborn-token md <파일...>      변환 → 파일 옆에 .md
+ *   npx --yes reborn-token md <파일> -o out  나갈 폴더 지정
+ *   npx --yes reborn-token --check          설치 상태만 본다
+ *   npx --yes reborn-token --lang=en        화면을 영어로 (안 주면 컴퓨터 로케일)
  *
  * ★왜 만들었나 — Anthropic 공식 문서(2026-08-24 확인):
  *     "The system converts each page of the document into an image.
@@ -25,6 +26,129 @@ const c = { g: "\x1b[32m", r: "\x1b[31m", y: "\x1b[33m", d: "\x1b[90m", cy: "\x1
 
 const 인자 = process.argv.slice(2);
 const 첫 = 인자[0];
+/** `--lang=en` · `--lang=ko`. 안 주면 이 컴퓨터의 로케일로 정한다(→ `말정하기`). */
+const 말강제 = (인자.find((a) => a.startsWith("--lang=")) || "").slice(7).toLowerCase();
+
+/**
+ * 어느 말로 말할 것인가. (2026-09-23 · 영어권 2차 ①)
+ *
+ * ★기준 패턴은 `claudekit/npm_video_skills/install.mjs` 다. 거기와 같은 인자 규약(`--lang=`)을 쓴다.
+ * ★고객 컴퓨터의 로케일이 곧 그 사람이 읽는 말이다. 서버에 묻지 않는다.
+ * ★못 읽으면 한국어로 떨어진다. 지금 이걸 받는 사람의 절대다수가 한국 고객이라,
+ *   판정이 실패했을 때 덜 틀리는 쪽이 그쪽이다.
+ */
+export function 말정하기(강제) {
+  if (강제 === "en" || 강제 === "ko") return 강제;
+  try {
+    return /^ko\b/i.test(Intl.DateTimeFormat().resolvedOptions().locale || "") ? "ko" : "en";
+  } catch { return "ko"; }
+}
+
+/**
+ * 화면에 찍는 말. **색은 여기 넣지 않는다** — 부르는 쪽이 입힌다.
+ *
+ * ★한국어 문구는 **한 글자도 바꾸지 않았다.** 옮겨 담기만 했다.
+ * ★영문 꼬리는 번역이 아니다. 영어권 고객에게는 스킬팩(영문 착지) 한 칸으로 간다.
+ */
+const 글표 = {
+  ko: {
+    /* md 변환 */
+    파일주세요: "✗ 바꿀 파일을 주세요",
+    파일예시: "예: npx --yes reborn-token md contract.pdf",
+    파일없음: "파일이 없습니다",
+    스캔본오류: (쪽수) => `글자가 거의 없습니다(${쪽수}쪽) — 스캔본이거나 이미지로만 된 PDF 입니다. `
+      + `이런 파일은 마크다운으로 바꿀 텍스트 자체가 없어, 그대로 클로드에 넣는 편이 낫습니다.`,
+    미지원형식: (확장) => `아직 못 바꾸는 형식입니다(${확장 || "확장자 없음"}) — pdf · docx · xlsx · pptx 를 지원합니다`,
+    글자없음: "가져올 글자가 없습니다",
+    글자표시: (n) => `글자 ${n}자 · 페이지 이미지 0`,
+    /* 설치 확인 — 색이 문구 중간에 끼어 있어 조각으로 쪼갠다(색은 부르는 쪽이 입힌다) */
+    설치됨확인: "✓ 설치되어 있고 변환기가 실제로 뜹니다",
+    아직없음: "· 아직 없습니다",
+    이유_SKILL없음: "SKILL.md 가 없습니다",
+    이유_머리말깨짐: "SKILL.md 의 머리말이 깨졌습니다(name 을 못 읽습니다)",
+    이유_office못불림: "office 변환기를 못 불렀습니다",
+    이유_토큰추정0: "토큰 추정기가 0 을 냅니다",
+    이유_pdfjs못불림: "pdfjs 를 못 불렀습니다",
+    이유_걸림: (msg) => `변환기를 부르다 걸렸습니다 — ${msg}`,
+    /* 머리말 */
+    머리: "토큰 절반",
+    머리설명: "PDF·워드·엑셀을 깔끔한 마크다운으로 바꿔, 페이지 이미지 토큰을 없앱니다.",
+    /* 설치 본 실행 */
+    짐없음머리: "✗ 패키지 안에 skill/ 폴더가 없습니다",
+    짐없음꼬리: "배포가 잘못된 것입니다.",
+    파일수: (n, 자리) => `${n}개 파일 → ${자리}`,
+    확인중: "변환기를 실제로 불러 확인하는 중…",
+    확인못통과: "✗ 깔았는데 확인에서 걸렸습니다",
+    설치완료머리: "✓ 설치 완료",
+    설치완료꼬리: "— 변환기가 실제로 떴습니다.",
+    재시작안내: "★ 클로드 코드를 껐다 켜야 스킬이 잡힙니다.",
+    쓰는법머리: "쓰는 법",
+    말하세요라벨: "클로드에게 그냥 말하세요 — ",
+    말하세요예시: '"이 PDF 마크다운으로 바꿔줘"',
+    터미널라벨: "터미널에서 바로: ",
+    지원형식설명: "pdf · docx · xlsx · pptx → 제목과 표를 살린 .md",
+    설명라벨: "설명 · ",
+    설명주소: "https://rebornlabs.kr/token?utm_source=installer&utm_medium=cli&utm_campaign=token",
+    /* 스킬팩 홍보 꼬리 */
+    홍보전환문장: "방금 들어가는 토큰을 줄였습니다. 나가는 토큰과 헛일까지 줄이는 묶음이 따로 있습니다.",
+    프로모이름: "리본랩스 스킬팩 · 토큰절약형",
+    프로모설명: " — 12종 3,900원 — 전부 48종은 8,900원",
+    프로모링크: "https://rebornlabs.kr/skillpack?utm_source=installer&utm_medium=cli&utm_campaign=token",
+    프로모꼬리: "목록과 직접 까는 명령까지 그 페이지에 그대로 적어 두었습니다. 안 사셔도 됩니다.",
+  },
+  en: {
+    /* md convert */
+    파일주세요: "✗ Give me a file to convert",
+    파일예시: "e.g. npx --yes reborn-token md contract.pdf",
+    파일없음: "That file does not exist",
+    스캔본오류: (쪽수) => `Barely any text came out (${쪽수} page${쪽수 === 1 ? "" : "s"}) — this looks like a scanned or image-only PDF. `
+      + `There is no text to turn into markdown, so it is better to hand Claude the original PDF instead.`,
+    미지원형식: (확장) => `This format is not supported yet (${확장 || "no extension"}) — pdf, docx, xlsx and pptx are.`,
+    글자없음: "There was no text to pull out of that file",
+    글자표시: (n) => `${n} character${n === 1 ? "" : "s"} · page images: 0`,
+    /* install check */
+    설치됨확인: "✓ Installed, and the converter actually loads",
+    아직없음: "· Not installed yet",
+    이유_SKILL없음: "SKILL.md is missing",
+    이유_머리말깨짐: "SKILL.md's front matter is broken (could not read its name)",
+    이유_office못불림: "Could not load the office converter",
+    이유_토큰추정0: "The token estimator returns 0",
+    이유_pdfjs못불림: "Could not load pdfjs",
+    이유_걸림: (msg) => `Loading the converter failed — ${msg}`,
+    /* header */
+    머리: "Token Half",
+    머리설명: "Turns PDF, Word and Excel files into clean markdown, so page-image tokens disappear.",
+    /* install run */
+    짐없음머리: "✗ There is no skill/ folder inside this package",
+    짐없음꼬리: "this build is broken.",
+    파일수: (n, 자리) => `${n} file${n === 1 ? "" : "s"} → ${자리}`,
+    확인중: "Loading the converter for real to check it…",
+    확인못통과: "✗ Installed, but it failed the check",
+    설치완료머리: "✓ Installed",
+    설치완료꼬리: "— the converter actually loaded.",
+    재시작안내: "★ Restart Claude Code for the skill to be picked up.",
+    쓰는법머리: "How to use it",
+    말하세요라벨: "Just tell Claude — ",
+    말하세요예시: '"turn this PDF into markdown"',
+    터미널라벨: "Straight from the terminal: ",
+    지원형식설명: "pdf · docx · xlsx · pptx → .md that keeps headings and tables",
+    설명라벨: "Details · ",
+    설명주소: "https://rebornlabs.kr/token?utm_source=installer&utm_medium=cli&utm_campaign=token",
+    /* skill pack promo tail */
+    홍보전환문장: "That just cut the tokens going in. There is a separate bundle that cuts the tokens going out, and the wasted work too.",
+    프로모이름: "REBORN Labs Skill Pack — token-saving set",
+    프로모설명: " — 12 skills for $3.90, or all 48 for $8.90",
+    프로모링크: "https://skillpack.rebornlabs.kr/?utm_source=installer&utm_medium=cli&utm_campaign=token",
+    프로모꼬리: "The list and the exact install commands are right there on that page. No obligation to buy.",
+  },
+};
+
+/** 이번 실행이 쓰는 말. */
+const 말 = 말정하기(말강제);
+/** 화면 문구. 부르는 쪽은 `G.무엇` 으로 쓴다. */
+const G = 글표[말];
+/** 숫자 자리 구분. 말에 맞춰 로케일을 바꾼다. */
+const 콤마 = (n) => Number(n).toLocaleString(말 === "en" ? "en-US" : "ko-KR");
 
 /* ══ 변환 ═════════════════════════════════════════════════════════════ */
 async function 변환명령(입력) {
@@ -34,7 +158,7 @@ async function 변환명령(입력) {
   const 파일들 = 입력.filter((a) => !a.startsWith("-"));
 
   if (!파일들.length) {
-    console.error(`${c.r}✗ 바꿀 파일을 주세요${c[0]}  ${c.d}예: npx reborn-token md contract.pdf${c[0]}`);
+    console.error(`${c.r}${G.파일주세요}${c[0]}  ${c.d}${G.파일예시}${c[0]}`);
     process.exit(2);
   }
 
@@ -47,7 +171,7 @@ async function 변환명령(입력) {
 }
 
 async function 하나변환(경로, 나갈곳) {
-  if (!existsSync(경로)) throw new Error("파일이 없습니다");
+  if (!existsSync(경로)) throw new Error(G.파일없음);
   const 확장 = extname(경로).toLowerCase();
   const { 요약 } = await import(`file://${join(여기, "lib", "tokens.mjs").replace(/\\/g, "/")}`);
 
@@ -62,8 +186,7 @@ async function 하나변환(경로, 나갈곳) {
     /* ★★스캔본은 **조용히 빈 파일을 내지 않는다.** 그건 「변환됐다」가 아니다.
        여기서 멈추고 왜 안 되는지 말한다 — 빈 .md 를 받아 든 사람은 원인을 못 찾는다. */
     if (md.replace(/\s/g, "").length < 20) {
-      throw new Error(`글자가 거의 없습니다(${쪽수}쪽) — 스캔본이거나 이미지로만 된 PDF 입니다. `
-        + `이런 파일은 마크다운으로 바꿀 텍스트 자체가 없어, 그대로 클로드에 넣는 편이 낫습니다.`);
+      throw new Error(G.스캔본오류(쪽수));
     }
   } else if (확장 === ".docx") {
     const { docx읽기 } = await import(`file://${join(여기, "lib", "office.mjs").replace(/\\/g, "/")}`);
@@ -75,10 +198,10 @@ async function 하나변환(경로, 나갈곳) {
     const { pptx읽기 } = await import(`file://${join(여기, "lib", "office.mjs").replace(/\\/g, "/")}`);
     md = pptx읽기(경로);
   } else {
-    throw new Error(`아직 못 바꾸는 형식입니다(${확장 || "확장자 없음"}) — pdf · docx · xlsx · pptx 를 지원합니다`);
+    throw new Error(G.미지원형식(확장));
   }
 
-  if (!md.trim()) throw new Error("가져올 글자가 없습니다");
+  if (!md.trim()) throw new Error(G.글자없음);
 
   const 폴더 = 나갈곳 ? resolve(나갈곳) : dirname(resolve(경로));
   mkdirSync(폴더, { recursive: true });
@@ -87,7 +210,7 @@ async function 하나변환(경로, 나갈곳) {
 
   console.log(`\n${c.g}✓${c[0]} ${basename(경로)} → ${c.b}${basename(나감)}${c[0]}`);
   if (쪽수) console.log(요약(쪽수, md));
-  else console.log(`  ${c.d}글자 ${md.length.toLocaleString("ko-KR")}자 · 페이지 이미지 0${c[0]}`);
+  else console.log(`  ${c.d}${G.글자표시(콤마(md.length))}${c[0]}`);
   console.log(`  ${c.d}${나감}${c[0]}`);
 }
 
@@ -111,78 +234,93 @@ function 파일목록(뿌리) {
 /** ★파일이 있다는 것으로 통과시키지 않는다. **실제로 한 장을 바꿔 본다.** */
 async function 진짜도나() {
   const md = join(대상, "SKILL.md");
-  if (!existsSync(md)) return { 됨: false, 이유: "SKILL.md 가 없습니다" };
+  if (!existsSync(md)) return { 됨: false, 이유: G.이유_SKILL없음 };
   if (!/^---[\s\S]*?\bname:\s*pdf-to-md\b/m.test(readFileSync(md, "utf8"))) {
-    return { 됨: false, 이유: "SKILL.md 의 머리말이 깨졌습니다(name 을 못 읽습니다)" };
+    return { 됨: false, 이유: G.이유_머리말깨짐 };
   }
   try {
     const { docx읽기 } = await import(`file://${join(여기, "lib", "office.mjs").replace(/\\/g, "/")}`);
     const { 텍스트토큰추정 } = await import(`file://${join(여기, "lib", "tokens.mjs").replace(/\\/g, "/")}`);
-    if (typeof docx읽기 !== "function") return { 됨: false, 이유: "office 변환기를 못 불렀습니다" };
-    if (텍스트토큰추정("가나다 abcd") <= 0) return { 됨: false, 이유: "토큰 추정기가 0 을 냅니다" };
+    if (typeof docx읽기 !== "function") return { 됨: false, 이유: G.이유_office못불림 };
+    if (텍스트토큰추정("가나다 abcd") <= 0) return { 됨: false, 이유: G.이유_토큰추정0 };
     const pdfjs = await import("pdfjs-dist/legacy/build/pdf.mjs");
-    if (!pdfjs?.getDocument) return { 됨: false, 이유: "pdfjs 를 못 불렀습니다" };
+    if (!pdfjs?.getDocument) return { 됨: false, 이유: G.이유_pdfjs못불림 };
     return { 됨: true };
   } catch (e) {
-    return { 됨: false, 이유: `변환기를 부르다 걸렸습니다 — ${String(e.message || e).slice(0, 120)}` };
+    return { 됨: false, 이유: G.이유_걸림(String(e.message || e).slice(0, 120)) };
   }
 }
 
 async function 설치확인만() {
   머리말();
   const r = await 진짜도나();
-  if (r.됨) console.log(`${c.g}✓ 설치되어 있고 변환기가 실제로 뜹니다${c[0]} ${c.d}(${대상})${c[0]}\n`);
-  else console.log(`${c.y}· 아직 없습니다${c[0]} ${c.d}— ${r.이유}${c[0]}\n`);
+  if (r.됨) console.log(`${c.g}${G.설치됨확인}${c[0]} ${c.d}(${대상})${c[0]}\n`);
+  else console.log(`${c.y}${G.아직없음}${c[0]} ${c.d}— ${r.이유}${c[0]}\n`);
   process.exit(r.됨 ? 0 : 1);
 }
 
 function 머리말() {
-  console.log(`\n${c.b}토큰 절반${c[0]} ${c.d}· REBORN LABS · MIT${c[0]}`);
-  console.log(`${c.d}PDF·워드·엑셀을 깔끔한 마크다운으로 바꿔, 페이지 이미지 토큰을 없앱니다.${c[0]}\n`);
+  console.log(`\n${c.b}${G.머리}${c[0]} ${c.d}· REBORN LABS · MIT${c[0]}`);
+  console.log(`${c.d}${G.머리설명}${c[0]}\n`);
 }
 
 async function 설치() {
   머리말();
   const 원본 = join(여기, "skill");
   if (!existsSync(원본)) {
-    console.error(`${c.r}✗ 패키지 안에 skill/ 폴더가 없습니다${c[0]} — 배포가 잘못된 것입니다.`);
+    console.error(`${c.r}${G.짐없음머리}${c[0]} — ${G.짐없음꼬리}`);
     process.exit(2);
   }
   let 쓴수 = 0;
   for (const src of 파일목록(원본)) {
     const 상대 = relative(원본, src);
+    /* ★SKILL.en.md 는 원본 이름으로 심지 않는다 — 영문이면 아래서 SKILL.md 자리에 덮어 쓴다.
+       한국어면 애초에 안 쓴다(고객 폴더에 낯선 파일을 남기지 않는다). */
+    if (상대 === "SKILL.en.md") continue;
     const dst = join(대상, 상대);
     mkdirSync(dirname(dst), { recursive: true });
     writeFileSync(dst, readFileSync(src));
     쓴수++;
     console.log(`  ${c.d}·${c[0]} ${상대}`);
   }
-  console.log(`\n${c.d}${쓴수}개 파일 → ${대상}${c[0]}`);
-  console.log(`${c.d}변환기를 실제로 불러 확인하는 중…${c[0]}`);
+  /* ★영문이면 SKILL.md 를 영문판으로 덮어 쓴다 (2026-09-23 · 영어권 2차 ①).
+     ★description 이 영어여야 영어권 클로드가 이 스킬을 실제로 부른다 — 이게 핵심이다.
+     ★파일이 없으면(아직 영문판을 못 만든 다른 배포라도) 그냥 넘어간다 — 설치 자체를 막지 않는다. */
+  if (말 === "en") {
+    const en원본 = join(원본, "SKILL.en.md");
+    if (existsSync(en원본)) {
+      writeFileSync(join(대상, "SKILL.md"), readFileSync(en원본));
+      console.log(`  ${c.d}·${c[0]} SKILL.md ${c.d}(en)${c[0]}`);
+    }
+  }
+  console.log(`\n${c.d}${G.파일수(쓴수, 대상)}${c[0]}`);
+  console.log(`${c.d}${G.확인중}${c[0]}`);
 
   const r = await 진짜도나();
   if (!r.됨) {
-    console.error(`\n${c.r}✗ 깔았는데 확인에서 걸렸습니다${c[0]} — ${r.이유}\n`);
+    console.error(`\n${c.r}${G.확인못통과}${c[0]} — ${r.이유}\n`);
     process.exit(1);
   }
 
-  console.log(`\n${c.g}${c.b}✓ 설치 완료${c[0]} ${c.d}— 변환기가 실제로 떴습니다.${c[0]}`);
-  console.log(`\n${c.y}★ 클로드 코드를 껐다 켜야 스킬이 잡힙니다.${c[0]}`);
-  console.log(`\n${c.b}쓰는 법${c[0]}`);
-  console.log(`  클로드에게 그냥 말하세요 — ${c.cy}"이 PDF 마크다운으로 바꿔줘"${c[0]}`);
-  console.log(`  터미널에서 바로: ${c.cy}npx reborn-token md contract.pdf${c[0]}`);
-  console.log(`  ${c.d}pdf · docx · xlsx · pptx → 제목과 표를 살린 .md${c[0]}\n`);
-  console.log(`${c.d}설명 · https://rebornlabs.kr/token?utm_source=installer&utm_medium=cli&utm_campaign=token${c[0]}`);
+  console.log(`\n${c.g}${c.b}${G.설치완료머리}${c[0]} ${c.d}${G.설치완료꼬리}${c[0]}`);
+  console.log(`\n${c.y}${G.재시작안내}${c[0]}`);
+  console.log(`\n${c.b}${G.쓰는법머리}${c[0]}`);
+  console.log(`  ${G.말하세요라벨}${c.cy}${G.말하세요예시}${c[0]}`);
+  console.log(`  ${G.터미널라벨}${c.cy}npx --yes reborn-token md contract.pdf${c[0]}`);
+  console.log(`  ${c.d}${G.지원형식설명}${c[0]}\n`);
+  console.log(`${c.d}${G.설명라벨}${G.설명주소}${c[0]}`);
   /* ★무료 배포물 안에 유료 제품 안내를 둔다. 숨기지 않는다. */
   /* ★가리키는 곳을 158,000원 클로드킷 → 8,900원 스킬팩으로 내렸다 (2026-08-24).
      무료 다음 칸이 곧바로 158,000원이라 아무도 못 건넜다(판매 페이지까지 간 10명 중 0명).
      자비스는 스킬팩을 산 사람에게 민다 — 그래야 계단이 생긴다.
-     ★문안 정본은 skillpack/tail_copy.mjs. */
-  console.log(`${c.d}방금 들어가는 토큰을 줄였습니다. 나가는 토큰과 헛일까지 줄이는 묶음이 따로 있습니다.${c[0]}`);
+     ★문안 정본은 skillpack/tail_copy.mjs.
+     ★영문은 전용 호스트(`skillpack.rebornlabs.kr`)로 간다 — 한국어 착지로 보내면
+       영어권 고객이 원화와 한국어 약관 앞에서 돌아선다. → G.프로모링크 가 가른다. */
+  console.log(`${c.d}${G.홍보전환문장}${c[0]}`);
   console.log(`
-${c.b}리본랩스 스킬팩 · 토큰절약형${c[0]}${c.d} — 12종 3,900원 — 전부 48종은 8,900원${c[0]}`);
-  console.log(`${c.cy}https://rebornlabs.kr/skillpack?utm_source=installer&utm_medium=cli&utm_campaign=token${c[0]}`);
-  console.log(`${c.d}목록과 직접 까는 명령까지 그 페이지에 그대로 적어 두었습니다. 안 사셔도 됩니다.${c[0]}
+${c.b}${G.프로모이름}${c[0]}${c.d}${G.프로모설명}${c[0]}`);
+  console.log(`${c.cy}${G.프로모링크}${c[0]}`);
+  console.log(`${c.d}${G.프로모꼬리}${c[0]}
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reborn-token",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "PDF·워드·엑셀을 깔끔한 마크다운으로 바꿔 클로드에 넣습니다. PDF 를 그대로 넣으면 페이지마다 텍스트와 이미지가 둘 다 청구되는데(Anthropic 공식 문서), 마크다운에는 페이지 이미지가 없습니다. 제목과 표는 그대로 유지. 전부 로컬, API 키 없음.",
   "keywords": [
     "claude",

package/skill/SKILL.en.md

@@ -0,0 +1,80 @@
+---
+name: pdf-to-md
+description: Converts PDF, Word, Excel and PowerPoint files into clean markdown before Claude reads them, so headings and tables survive but page-image tokens do not. Anthropic's own docs say every PDF page is billed as text AND as a rendered image — markdown has no pages and no images, so that image cost disappears entirely. Use this whenever the user hands over a PDF, contract, report, spreadsheet or Word file and says things like "read this", "summarize this", "analyze this", "go through this doc", or asks "why is this PDF so expensive", "how do I save tokens on documents", "convert this file". Runs fully offline, no API key needed.
+license: MIT
+---
+
+# PDF → Markdown (pdf-to-md)
+
+Turn a document into **text-only markdown** before handing it to Claude.
+
+## Why do this first
+
+Anthropic's own documentation (`build-with-claude/pdf-support`) says:
+
+> The system converts each page of the document into an image.
+> The text from each page is extracted and provided alongside each page's image.
+
+> Text token costs: Each page typically uses **1,500–3,000 tokens per page**
+> Image token costs: **Because each page is converted into an image**, the same
+> image-based cost calculations are applied.
+
+In other words, feeding Claude a raw PDF bills **both text and an image for every page.**
+A 20-page contract can burn tens of thousands of tokens before a single question is asked.
+
+Markdown has **no pages and no images.** Only the text cost remains.
+
+## When this kicks in
+
+- The user hands over a **PDF, DOCX, XLSX or PPTX file** and says "read this / summarize this / analyze this / go through this"
+- "Find X in this contract", "just the key points of this report"
+- "Why is feeding in a PDF so expensive?", "how do I save tokens on documents", "convert this file"
+
+## How to do it
+
+```
+npx --yes reborn-token md <file...> --lang=en
+```
+
+This writes a `.md` file next to the original. Then **read that `.md` file** and answer from it.
+
+- Several at once: `npx --yes reborn-token md a.pdf b.docx c.xlsx --lang=en`
+- A different output folder: `npx --yes reborn-token md a.pdf -o ./out --lang=en`
+
+### Order of operations
+
+1. **Convert first.** Don't read the user's original document as-is — run the command above to produce the `.md`.
+2. **Read the converted file.** Answer from the `.md`, not the original.
+3. **Mention the size drop in one line.** Reuse the "before / after" numbers the command itself printed.
+   ★Don't invent numbers. Only state what the command actually printed.
+
+## What survives the conversion
+
+| Survives | Dropped |
+|---|---|
+| Heading levels (`#` `##`) | Page images |
+| Paragraphs and line breaks | Figures, charts, shapes |
+| **Tables** (as markdown tables) | Fonts, colors, spacing |
+| Per-sheet tables from Excel | Headers/footers as decoration |
+
+## When it doesn't work — say so plainly
+
+- **Scanned or image-only PDFs**: there is no text to pull out. The command stops right there and prints why.
+  In this case, **feeding Claude the original PDF is actually the better choice** — it's a document that has to be seen, not read.
+  ★Never write an empty `.md` and claim it "converted."
+- **Documents where charts or diagrams carry the meaning**: stripping to text-only loses that meaning. Include the original alongside the `.md`.
+- Supported formats are `pdf`, `docx`, `xlsx`, `pptx` only. Anything else is rejected by the command.
+
+## How to answer the user
+
+1. **Convert first, then answer.** Don't ask "should I convert it?" first — that costs an extra round trip.
+2. **Add one line about how much it shrank.** Keep it short, don't over-explain.
+3. If it's a scan, **say the conversion failed** and suggest using the original file instead.
+4. This tool **never touches the network.** If asked "where does this get uploaded," the answer is: nowhere.
+
+## Reference
+
+- `references/PDF토큰.md` — the original Anthropic quote and how the estimate is computed (Korean; the numbers and quoted English text are the same either way)
+
+---
+REBORN LABS · MIT · https://rebornlabs.kr/token?utm_source=installer&utm_medium=cli&utm_campaign=token

package/skill/SKILL.md

@@ -33,13 +33,13 @@ Anthropic 공식 문서(`build-with-claude/pdf-support`)가 이렇게 적어 두
 ## 어떻게 하나
 
 ```
-npx reborn-token md <파일...>
+npx --yes reborn-token md <파일...>
 ```
 
 파일 옆에 `.md` 가 생긴다. 그다음 **그 `.md` 를 읽어서** 답한다.
 
-- 여러 개 한 번에: `npx reborn-token md a.pdf b.docx c.xlsx`
-- 다른 폴더로: `npx reborn-token md a.pdf -o ./out`
+- 여러 개 한 번에: `npx --yes reborn-token md a.pdf b.docx c.xlsx`
+- 다른 폴더로: `npx --yes reborn-token md a.pdf -o ./out`
 
 ### 순서
 

package//354/225/210/353/202/264/354/212/244/355/202/254.md

@@ -1,50 +1,50 @@
----
-name: reborn-token-guide
-description: >
-  PDF 를 클로드에 넣으면 왜 비용이 두 번 나가는지, 마크다운으로 바꾸면 무엇이 사라지는지,
-  그리고 그다음 단계인 무인 자동 발행이 어디서부터 필요한지 알려 준다.
-  "PDF 넣으면 왜 비싸", "토큰 아끼는 법", "문서 변환", "계약서 요약",
-  "자동으로 올리고 싶다" 같은 이야기가 나올 때 쓴다.
----
-
-# PDF 는 왜 두 번 청구되나 — 그리고 어디부터는 다른 문제인가
-
-> 이 파일은 **리본랩스(REBORN LABS)** 의 무료 설치기가 넣은 것입니다.
-> 필요 없으시면 이 폴더를 지우세요. 지워도 `pdf-to-md` 스킬은 그대로 동작합니다.
-
-## 방금 깐 것
-
-`pdf-to-md` — 문서를 **제목과 표를 살린 마크다운**으로 바꿔 클로드에 넣습니다.
-
-```
-npx reborn-token md contract.pdf
-```
-
-`pdf` · `docx` · `xlsx` · `pptx` 넷을 바꿉니다. 전부 로컬에서 돌고 API 키가 없습니다.
-
-## 한 줄 요약
-
-Anthropic 공식 문서가 이렇게 적어 두었습니다 —
-**"각 페이지가 이미지로 변환되고, 그 텍스트가 페이지 이미지와 함께 제공된다."**
-그래서 PDF 한 장에 **텍스트와 이미지가 둘 다** 실립니다.
-마크다운에는 페이지가 없으니 이미지 몫이 사라집니다.
-
-## 이게 해 주지 않는 것
-
-- **스캔본은 못 바꿉니다.** 글자가 없는 PDF 는 원본을 그대로 넣는 편이 낫습니다.
-- 차트·도형의 뜻은 옮기지 못합니다. 글자만 가져옵니다.
-- 요금 청구서를 계산해 주지 않습니다.
-- 정해진 시각에 **사람 없이** 도는 예약 실행
-- 실패했을 때 다시 미는 회복 경로 (무인 운영 사고의 대부분이 여기서 납니다)
-- 채널별 규격 · 중복 차단 · 발행 원장
-
-문서를 아껴 넣어도 **매일 알아서 올라가지는 않습니다.** 그건 파이프라인이 하는 일입니다.
-
-## 그 다음이 필요하면
-리본랩스 **스킬팩 · 토큰절약형** — 나가는 토큰과 헛일까지 줄이는 12종(3,900원).
-전부 48종은 8,900원입니다.
-**목록과 직접 까는 명령이 같은 주소에 전부 공개돼 있습니다** — 한 푼도 안 내고 쓰실 수 있습니다.
-
-https://rebornlabs.kr/skillpack?utm_source=installer&utm_medium=cli&utm_campaign=token
-
-> 광고입니다. 다만 `pdf-to-md` 는 그것과 무관하게 그냥 쓰셔도 됩니다 — MIT 이고 완전 무료입니다.
+---
+name: reborn-token-guide
+description: >
+  PDF 를 클로드에 넣으면 왜 비용이 두 번 나가는지, 마크다운으로 바꾸면 무엇이 사라지는지,
+  그리고 그다음 단계인 무인 자동 발행이 어디서부터 필요한지 알려 준다.
+  "PDF 넣으면 왜 비싸", "토큰 아끼는 법", "문서 변환", "계약서 요약",
+  "자동으로 올리고 싶다" 같은 이야기가 나올 때 쓴다.
+---
+
+# PDF 는 왜 두 번 청구되나 — 그리고 어디부터는 다른 문제인가
+
+> 이 파일은 **리본랩스(REBORN LABS)** 의 무료 설치기가 넣은 것입니다.
+> 필요 없으시면 이 폴더를 지우세요. 지워도 `pdf-to-md` 스킬은 그대로 동작합니다.
+
+## 방금 깐 것
+
+`pdf-to-md` — 문서를 **제목과 표를 살린 마크다운**으로 바꿔 클로드에 넣습니다.
+
+```
+npx --yes reborn-token md contract.pdf
+```
+
+`pdf` · `docx` · `xlsx` · `pptx` 넷을 바꿉니다. 전부 로컬에서 돌고 API 키가 없습니다.
+
+## 한 줄 요약
+
+Anthropic 공식 문서가 이렇게 적어 두었습니다 —
+**"각 페이지가 이미지로 변환되고, 그 텍스트가 페이지 이미지와 함께 제공된다."**
+그래서 PDF 한 장에 **텍스트와 이미지가 둘 다** 실립니다.
+마크다운에는 페이지가 없으니 이미지 몫이 사라집니다.
+
+## 이게 해 주지 않는 것
+
+- **스캔본은 못 바꿉니다.** 글자가 없는 PDF 는 원본을 그대로 넣는 편이 낫습니다.
+- 차트·도형의 뜻은 옮기지 못합니다. 글자만 가져옵니다.
+- 요금 청구서를 계산해 주지 않습니다.
+- 정해진 시각에 **사람 없이** 도는 예약 실행
+- 실패했을 때 다시 미는 회복 경로 (무인 운영 사고의 대부분이 여기서 납니다)
+- 채널별 규격 · 중복 차단 · 발행 원장
+
+문서를 아껴 넣어도 **매일 알아서 올라가지는 않습니다.** 그건 파이프라인이 하는 일입니다.
+
+## 그 다음이 필요하면
+리본랩스 **스킬팩 · 토큰절약형** — 나가는 토큰과 헛일까지 줄이는 12종(3,900원).
+전부 48종은 8,900원입니다.
+**목록과 직접 까는 명령이 같은 주소에 전부 공개돼 있습니다** — 한 푼도 안 내고 쓰실 수 있습니다.
+
+https://rebornlabs.kr/skillpack?utm_source=installer&utm_medium=cli&utm_campaign=token
+
+> 광고입니다. 다만 `pdf-to-md` 는 그것과 무관하게 그냥 쓰셔도 됩니다 — MIT 이고 완전 무료입니다.