- GitHub 저장소의 별·업데이트·라이선스·README를 보고 쓸 만한 도구인지 판단할 수 있다
- 터미널을 열고 Node.js·Python 설치 여부를 확인할 수 있다
- ir-search·kordoc·hwpxskill 등으로 공고 찾기 → 공고문 읽기 → 양식 채우기 흐름을 구성할 수 있다
- 작업실 폴더와 지시서를 만들어 AI 에이전트에게 단계별로 일을 맡길 수 있다
1. GitHub이 뭐고, 왜 지원사업 준비에 쓸모가 있나
GitHub(깃허브)은 전 세계 개발자들이 프로그램 코드를 올려 두고 함께 고치는 웹사이트입니다. 여기에 올라온 프로그램 하나하나를 저장소(repository, 줄여서 repo)라고 부릅니다. 저장소 주소는 github.com/만든사람/저장소이름 형식이고, 이 챕터에서는 줄여서 만든사람/저장소이름(예: chrisryugj/kordoc)으로 씁니다.
최근 1~2년 사이 한국 개발자들이 "정부지원사업 공고 찾기", "한글(HWP) 문서를 AI가 읽게 하기", "사업계획서 결함 검사" 같은 도구를 무료로 공개하기 시작했습니다. 챕터 03에서 배운 10단계 중 시간이 가장 많이 드는 일 — 공고를 빠짐없이 찾고, 공고문 HWP를 AI에 넣고, 마지막에 HWP 양식에 옮기는 일 — 이 바로 이 도구들이 잘하는 일입니다.
1-1. 저장소 화면 읽는 법 (처음 들어갔을 때 볼 4가지)
| 보는 곳 | 무엇인가 | 어떻게 판단하나 |
|---|---|---|
| ★ Star(별) | 다른 사람이 "유용하다"고 눌러 준 북마크 수 | 많을수록 많이 쓰이고 검증된 편. 수십 개 이하면 개인 프로젝트일 가능성이 높아 더 조심해서 검증 |
| 최근 업데이트 (커밋 날짜) | 마지막으로 코드가 고쳐진 날 | 몇 년째 멈춰 있으면 지금 사이트 구조와 안 맞을 수 있음. 공고 사이트 크롤링 도구는 특히 최신인지 확인 |
| License(라이선스) | 이 코드를 써도 되는 조건 | MIT·Apache-2.0은 개인·상업 사용이 비교적 자유로운 편. 라이선스 표기가 없거나 불분명하면 "개인 학습·사용은 하되, 재배포·상업 이용 전 확인" 원칙 |
| README | 저장소 첫 화면 아래에 나오는 설명서 | 무엇을 하는지, 설치 방법, 하지 않는 일(한계)이 적혀 있음. 설치 전 반드시 끝까지 읽기 |
그 밖에 Issues(이슈) 탭에는 사용자들이 올린 오류 신고가 있습니다. 설치하다 막히면 같은 오류를 누가 먼저 겪었는지 여기서 찾아보면 해결책이 있는 경우가 많습니다.
1-2. 안전 수칙 7가지 (꼭 지키세요)
- 별 수·최근 업데이트·라이선스·이슈를 먼저 확인합니다. 위 표의 기준대로요.
- 남의 코드를 실행하기 전에 README와 설치 스크립트를 읽습니다. 특히
curl … | bash처럼 "인터넷에서 받은 스크립트를 바로 실행"하는 명령은 편하지만, 내용을 모른 채 실행하면 내 컴퓨터에서 무엇이 일어나는지 알 수 없습니다. 주소를 브라우저로 열어 내용을 한 번 훑어보거나, 그 대신 단계별 수동 설치 방법을 쓰세요. - API 키·비밀번호·주민번호·계좌번호를 파일이나 AI 대화에 넣지 않습니다. API 키는 "AI 서비스를 프로그램으로 쓰기 위한 비밀 열쇠"인데, 남이 보면 내 돈으로 AI를 쓸 수 있습니다.
- 미공개 아이디어·고객 개인정보(인터뷰 대상자 이름·전화번호)는 AI에 넣기 전에 지우거나 "사장님 A"처럼 바꿉니다.
- 크롤링(웹사이트에서 자동으로 정보 수집)은 각 사이트의 이용약관을 지킵니다. 짧은 시간에 너무 많이 반복 실행하지 말고, 필요할 때 한 번씩만 돌리세요.
- 별이 적은 개인 프로젝트는 "참고용"으로 쓰고 결과를 반드시 사람이 검증합니다.
- 도구가 낸 결과도 최종 판단은 원문 공고로 합니다. 도구는 공고를 놓치거나 잘못 읽을 수 있습니다.
2. 시작 전 준비 — 코딩을 몰라도 됩니다
2-1. 코딩 없이 vs 도구를 쓰면 — 무엇이 달라지나
| 할 일 | 코딩 없이 (웹 AI + 챕터 03 프롬프트) | GitHub 도구를 쓰면 |
|---|---|---|
| 공고 찾기 | K-Startup·기업마당에서 직접 검색, 키워드에 안 걸리는 공고는 놓치기 쉬움 | ir-search가 여러 사이트의 모집중 공고를 전부 훑고 내 조건으로 A·B·C 그룹 분류 |
| 공고문 HWP 읽기 | 한글에서 PDF로 저장 후 AI에 올림, 표가 깨질 수 있음 | kordoc이 HWP·HWPX·PDF를 표 구조를 살린 Markdown으로 변환 |
| 10단계 작성 | 한 대화방에서 프롬프트를 하나씩 복사 | 작업실 폴더 + 지시서로 에이전트가 순서대로 진행하고 단계별 파일 저장 |
| 결함 진단 | 챕터 03 ⑥ 근거 검수 프롬프트 | plan-lint가 누락·분량·수치 모순을 규칙으로 먼저 잡고, 원문 인용과 함께 보고 |
| HWP 양식에 옮기기 | 한글을 열고 목차별로 복사·붙여넣기 | hwpxskill·hwpx-skill로 양식 서식을 지키며 내용만 교체, kordoc으로 HWPX 생성 |
| 발표자료·재무표 | AI가 준 목차를 보고 직접 PPT·엑셀 작성 | anthropics/skills의 pptx·xlsx 스킬로 파일까지 생성 |
결론: 계획서 내용의 질은 챕터 01~04가 결정합니다. 도구는 시간과 누락을 줄여 줄 뿐입니다.
2-2. 용어 정리 (처음 보는 말만)
| 용어 | 쉬운 뜻 |
|---|---|
| 터미널 | 마우스 대신 글자로 컴퓨터에 명령하는 창. Mac은 "터미널", Windows는 "PowerShell" |
| 명령어 | 터미널에 입력하는 한 줄. 이 페이지의 회색 상자(pre) 안 글자를 그대로 복사해 붙여 넣고 Enter |
| Node.js / npm / npx | Node.js는 자바스크립트 프로그램을 돌리는 엔진, npm은 그 프로그램을 설치하는 도구, npx는 설치 없이 한 번 실행하는 도구. kordoc이 사용 |
| Python / pip | Python은 또 다른 프로그래밍 언어 엔진, pip는 Python 프로그램 설치 도구. plan-lint·ir-search 일부가 사용 |
| clone(클론) | GitHub 저장소를 내 컴퓨터에 통째로 복사해 오는 것 (git clone 주소) |
| 스킬(Skill) | AI 에이전트에게 주는 "작업 설명서 + 보조 프로그램" 묶음. 폴더 하나에 들어 있고, 에이전트가 필요할 때 읽어서 따라 함 |
| 플러그인(Plugin) | 스킬·설정 등을 한 번에 설치할 수 있게 포장한 것. "마켓플레이스 추가 → 설치" 두 단계가 보통 |
| MCP | Model Context Protocol. AI 앱이 외부 도구(예: 문서 변환기)를 "손발처럼" 불러 쓰게 연결하는 표준 규격. 연결해 두면 AI에게 "이 HWP 읽어 줘"라고 말만 하면 됨 |
| CLI | Command Line Interface. 터미널에서 명령어로 쓰는 프로그램 |
| Markdown(마크다운) | # 제목, - 목록처럼 기호로 서식을 표시하는 글 형식. AI가 가장 잘 읽고 쓰는 형식 |
2-3. 터미널 처음 열기
Mac
Command(⌘) + Space를 눌러 Spotlight 검색을 엽니다.- "터미널" 또는 "Terminal"을 입력하고 Enter.
- 검은(또는 흰) 창에 깜빡이는 커서가 보이면 준비 완료입니다.
Windows
- 시작 버튼을 누르고 "PowerShell"을 입력합니다.
- "Windows PowerShell"을 클릭해 엽니다(관리자 권한은 꼭 필요할 때만).
2-4. 설치되어 있는지 확인하는 명령
터미널에 아래를 한 줄씩 입력해 보세요. 숫자(버전)가 나오면 설치된 것입니다.
node -v python3 --version git --version
node -v결과가 v20 이상이어야 kordoc을 쓸 수 있습니다(README 기준 Node.js 20 이상). 없거나 낮으면 nodejs.org에서 LTS(장기 지원) 버전을 받아 설치합니다.- Windows에서
python3가 안 되면python --version또는py --version을 시도하세요. 없으면 python.org에서 설치(설치 화면에서 "Add Python to PATH" 체크). git이 없으면 git-scm.com에서 설치합니다. clone할 때 필요합니다.
2-5. 어떤 AI 에이전트를 쓸까
| 에이전트 | 특징 | 비용 |
|---|---|---|
| Claude Code | Anthropic의 코딩 에이전트. 폴더 안 파일을 읽고 쓰고, 스킬·플러그인·MCP를 지원. 이 챕터 도구 대부분이 지원 | 유료 플랜 필요 (가격은 서비스·시기별로 다름) |
| Codex | OpenAI의 코딩 에이전트. ir-search·kordoc·hwpx-skill 등이 지원 | 요금제는 서비스·시기별로 다름 |
| Gemini CLI | Google의 터미널용 AI. ir-search가 확장(extension)으로 지원 | 무료 사용 범위는 서비스 정책에 따라 다름 |
| Cursor 등 | 코드 편집기에 AI가 붙은 형태. 일부 도구가 지원 | 서비스별로 다름 |
돈을 아끼려면: 먼저 챕터 03 프롬프트로 웹 AI(무료 계정)에서 해 보고, 반복 작업이 많아져 시간이 아까울 때 에이전트를 고려하세요. 에이전트 없이도 kordoc CLI(터미널 명령)는 단독으로 쓸 수 있습니다.
3. 나만의 지원사업 AI 작업실 — 전체 그림
도구 하나하나보다 순서가 중요합니다. 아래 6단계는 챕터 03의 10단계와 관문 3곳에 그대로 연결됩니다.
① 공고 전수조사 ir-search → 후보 A·B·C 그룹 보고서 [관문 ① 사람이 후보 3개 확정]
↓
② 공고문·양식 읽기 kordoc → 공고문 HWP/PDF → Markdown, 양식 구조 파악
↓
③ 10단계 작성 지시서 + 에이전트 → 인터뷰·조사·반대증거·재무·초안 [관문 ② 사람이 전략 선택]
↓
④ 결함 진단 plan-lint → 누락·분량·수치 모순·근거 없는 주장 목록
↓
⑤ 양식에 채우기 hwpxskill / hwpx-skill / kordoc generate → 제출용 HWPX
↓ [관문 ③ 사람이 사실 증거 채우고 제출]
⑥ 발표·재무 파일 anthropics/skills (pptx, xlsx) → 발표자료, 재무 추정표
| 단계 | 도구 | 넣는 것 | 나오는 것 | 사람이 확인할 것 | 챕터 연결 |
|---|---|---|---|---|---|
| ① | ir-search | 내 프로필(단계·지역·필요) | A·B·C 그룹 보고서, 원문 URL | A그룹 공고를 원문으로 열어 자격·마감 재확인 | 챕터 01 공고 검토 5단계 |
| ② | kordoc | 공고문·양식 HWP/HWPX/PDF | Markdown(표 포함) | 표 숫자(배점·금액)가 원문과 같은지 | 챕터 01 공고 분석 프롬프트 |
| ③ | 에이전트 + 지시서 | 공고 Markdown, 내 메모, 인터뷰 | 단계별 결과 파일, 초안 | 관문 ①②에서 멈췄는지, 숫자 출처 | 챕터 03 10단계 |
| ④ | plan-lint | 초안 Markdown | 결함 보고서(원문 인용) | 지적이 맞는지, 고칠지 결정 | 챕터 03 ⑥ 근거 검수 |
| ⑤ | hwpxskill 등 | 공고 HWPX 양식 + 최종 원고 | 내용이 채워진 HWPX | 한글로 열어 쪽수·서식·잔재 문구 확인 | 챕터 03 ⑩ 문서 완성 |
| ⑥ | anthropics/skills | 최종 원고, 재무 가정 | PPTX, XLSX | 발표 숫자 = 계획서 숫자, 수식 검산 | 챕터 04 발표·재무 |
4. 도구 ① ir-search — 지원사업 공고 전수조사
저장소: djfksjd/ir-search · ★394 · MIT (2026-11-18 기준)
4-1. 무엇을 하나
README 기준으로, 한국 정부·공공기관 지원사업을 "전수조사"하는 스킬입니다. K-Startup·기업마당(bizinfo)·NIPA·KOCCA·SMTECH의 모집중 공고를 모은 뒤, 내 프로필(창업 단계·지역·필요한 것: 자금/공간/R&D)에 맞는 사업을 골라 상세공고 원문으로 자격요건을 검증하고, 세 그룹으로 나눈 보고서를 만들어 줍니다.
| 그룹 | 뜻 | 내가 할 일 |
|---|---|---|
| A그룹 | 지금 신분 그대로 자격 충족 — 즉시 지원 가능 (마감순, 임박 강조) | 원문 확인 후 챕터 01 후보 메모로 |
| B그룹 | 요건을 충족하면 열림 — 법인 설립·투자유치 같은 "트리거"와 이어지는 경로 표시 | 로드맵으로 저장, 연간 캘린더에 반영 |
| C그룹 | 아이템을 다른 분야 언어로 재서술(프레이밍)하면 가능 | 무리한 각색인지 판단, 애매하면 문의처에 전화 |
왜 키워드 검색이 아니라 전수조사인가? README의 설명대로, 키워드로는 안 걸리지만 내 아이템이 지원할 수 있는 사업(예: 다른 부처의 콘텐츠·사회서비스 관련 사업)이 있기 때문입니다. 결과는 ~/Documents/지원사업조사_대상_날짜/ 폴더에 보고서(md), 원시 데이터(jsonl), 상세공고 원문으로 저장되고, 공고에 없는 정보는 추정하지 않고 '불명'으로 적는다고 README에 쓰여 있습니다.
4-2. 조사 범위 고르기 (프리셋)
| 프리셋 | 용도 | 언제 |
|---|---|---|
quick | K-Startup 한 곳만 빠르게 | 처음 써 볼 때, 주간 점검 |
focused | 내가 고른 등록 소스 한 곳만 | 특정 기관만 볼 때 |
recommended | K-Startup·기업마당 + 프로필과 맞는 자동 소스 (권장) | 본격 후보 찾기 |
all_registered | 자동화된 모든 등록 소스 | 놓친 게 없는지 한 번 크게 |
all_known | 후보·수동 확인 소스까지 계획 | 연초 통합공고 시즌 |
custom | --include로 지정한 소스만 | 익숙해진 뒤 |
README에 따르면 범위를 정하는 scope_plan.py는 네트워크·API·LLM을 호출하지 않습니다. 실제 수집은 그다음 단계에서 일어나니, 계획부터 확인하고 돌리면 불필요한 수집을 줄일 수 있습니다.
4-3. 설치
방법 A — 한 줄 설치 (설치된 에이전트를 자동으로 찾아 설치. 편하지만, 실행 전 스크립트 내용을 브라우저로 열어 확인하는 것을 권장합니다)
curl -fsSL https://raw.githubusercontent.com/djfksjd/ir-search/main/install.sh | bash
방법 B — 쓰는 에이전트별 수동 설치
Claude Code
claude plugin marketplace add djfksjd/ir-search claude plugin install ir-search@djfksjd
Codex
codex plugin marketplace add djfksjd/ir-search codex plugin add ir-search@djfksjd
Gemini CLI
gemini extensions install https://github.com/djfksjd/ir-search pip3 install 'curl_cffi>=0.15'
README 기준 Claude Code·Codex는 필요한 부품(curl_cffi)을 세션 시작 시 자동 설치하고, Gemini CLI·agy는 위처럼 따로 설치합니다. 설치 후에는 에이전트를 껐다 켜야 새 플러그인이 보이는 경우가 많습니다.
4-4. 첫 실행 — 재고콕으로 해 보기
에이전트(예: Claude Code)를 작업실 폴더에서 열고, 아래처럼 말합니다. 처음에는 quick으로 작게 시작하세요.
# 지원사업 전수조사 — 재고콕 (카페 재고 SaaS, 예비창업자, 서울)
조사 범위 quick · K-Startup 모집중 공고 [N]건 검토 → 후보 [n]건 상세 검증
## A그룹 — 지금 즉시 지원 가능 (마감순)
1. [예시 공고명 1] — [주관기관]
- 지원: [공고 원문의 지원 내용]
- 자격: 예비창업자 포함 ✓ · 지역 제한 없음 ✓ · 연령 [불명 — 원문에 기재 없음]
- 마감: [YYYY-MM-DD HH:MM] (D-[n])
- [원문 URL]
## B그룹 — 요건 충족 시 열림
- [예시 공고명 2]: 트리거 = 사업자 등록(창업 3년 이내 대상). 경로: 모두의 창업 준비 → 사업자 등록 → 초기 단계 사업
## C그룹 — 프레이밍하면 가능
- [예시 공고명 3]: "재고 앱"이 아니라 "소상공인 식자재 폐기 감소 서비스"로 재서술하면 대상. 위험: 실제 폐기 감소 데이터가 없으면 과장으로 읽힘(위험도 중)
## 부재 확인
- [사업명]: 현재 모집중 아님 — 통상 공고 시기 확인 필요
4-5. 결과를 받은 뒤 할 일
- A그룹 공고를 하나씩 원문 링크로 열어 챕터 01의 공고 검토 5단계(종류·자격·제외·마감·평가표)로 다시 확인합니다.
- 중복 판단 4질문을 적용합니다. 도구는 내 과거 수혜 이력을 모릅니다.
- 최종 후보 3개를 챕터 01 "후보 지원사업 3개 메모" 표로 옮깁니다. — 관문 ①은 사람이 닫습니다.
- B그룹은 연간 캘린더(챕터 01)에 "트리거 → 다음 사업" 순서로 적어 둡니다.
4-6. 주의
- 크롤링 도구는 공고 사이트 구조가 바뀌면 일부 공고를 놓칠 수 있습니다. 중요한 시즌에는 K-Startup에서 직접 한 번 더 확인하세요.
- 너무 자주 돌리지 마세요. 주 1회
quick+ 공고 시즌에recommended정도면 충분합니다. - C그룹 "프레이밍"은 거짓말이 아니라 같은 사실을 다른 언어로 설명하는 것이어야 합니다. 사실을 바꾸면 안 됩니다.
5. 도구 ② kordoc — HWP·HWPX·PDF를 AI가 읽고 쓰게
저장소: chrisryugj/kordoc · ★3,035 · MIT (2026-11-18 기준)
5-1. 무엇을 하나
README의 표현대로 "한국 공문서를 AI가 읽고 쓸 수 있게" 하는 도구입니다. HWP(3.x·5.x), HWPX, HWPML, PDF, XLS·XLSX, DOCX, PPTX, 이미지(스캔본은 OCR=글자 인식)를 Markdown과 구조화 데이터로 바꾸고, 반대로 Markdown에서 HWPX·HWP 문서를 만듭니다. 라이브러리·CLI(터미널 명령)·MCP 서버(AI 앱에 연결) 세 가지 방식으로 쓸 수 있고, MCP로 연결하면 README 기준 22개 도구를 AI가 불러 씁니다.
지원사업에서 쓰는 곳은 두 군데입니다.
- 입구: 공고문·사업계획서 양식(HWP/PDF)을 Markdown으로 바꿔 AI에 넣기 → 표(배점표, 사업비 기준)가 깨지지 않아 AI가 정확히 읽음
- 출구: AI와 다듬은 최종 원고(Markdown)를 HWPX로 만들기
5-2. 설치
Node.js 20 이상이 필요합니다(2-4 참고).
# 설치 없이 바로 한 번 써 보기 npx kordoc 공고문.hwpx -o 공고문.md # 계속 쓸 거라면 설치 npm install kordoc
AI 앱에 연결(MCP) — 연결하면 터미널 명령 없이 AI에게 "이 파일 읽어 줘"라고 말하면 됩니다.
# 설치된 Claude Desktop·Claude Code·Cursor·Codex 등을 찾아 자동 등록 npx -y kordoc setup
Claude Code 플러그인으로 설치하려면 Claude Code 안에서:
/plugin marketplace add chrisryugj/kordoc /plugin install kordoc@kordoc
Claude 앱(데스크톱)은 README 기준 플러그인 디렉터리에서 kordoc을 찾아 설치할 수 있습니다. 등록 후에는 앱을 다시 시작하세요.
5-3. 자주 쓸 명령 (README 예시 기준)
| 하고 싶은 일 | 명령 |
|---|---|
| HWPX 공고문 → Markdown | npx kordoc 공고문.hwpx -o 공고문.md |
| PDF 일부 쪽만 JSON으로 | npx kordoc 문서.pdf --format json --pages 1-3 |
| 스캔본 PDF 글자 인식 | npx kordoc 스캔본.pdf --ocr -o 스캔본.md |
| 옛 HWP → HWPX 변환 | npx kordoc to-hwpx 양식.hwp -o 양식.hwpx |
| Markdown 원고 → HWPX 문서 | npx kordoc generate 보고서.md --preset 보고서 -o 보고서.hwpx |
| 템플릿에 값 채우기 | npx kordoc fill --template gian -j 값.json -o 기안문.hwpx |
| HWPX 문서 검사 | npx kordoc lint 보고서.hwpx --gate --preset 보고서 |
--preset 보고서, --template gian(기안문)은 README 예시에 나온 이름입니다. 사업계획서 양식은 공고마다 다르므로, 제출 양식 자체를 채울 때는 6장 hwpxskill처럼 공고가 준 원본 양식을 기준으로 하는 편이 안전합니다.
5-4. 첫 실행 — 재고콕
작업실/공고/에 넣고, 둘 다 Markdown으로 바꿔 작업실/공고/md/에 저장. 그다음 챕터 01 "공고 분석 프롬프트"를 그 Markdown에 적용.cd 작업실/공고 npx kordoc to-hwpx 공고문.hwp -o 공고문.hwpx npx kordoc 공고문.hwpx -o md/공고문.md npx kordoc to-hwpx 양식.hwp -o 양식.hwpx npx kordoc 양식.hwpx -o md/양식.md
MCP로 연결했다면 에이전트에게 이렇게 말해도 됩니다.
변환 완료: 공고/md/공고문.md, 공고/md/양식.md
| 항목 | 내용 | 근거 |
| 업력 기준 | [공고 원문 문구] | 제[n]조 [n]항 |
| 평가 배점 | 문제 인식 [n]점 / 실현 가능성 [n]점 / … | 붙임 [n] 평가표 |
| 분량 | [양식에 적힌 쪽수 제한] | 양식 작성 요령 |
⚠ 확인 필요: 평가표 3쪽의 병합 칸 숫자는 원문 PDF와 대조 권장
5-5. 주의
- 변환 결과의 숫자(배점·금액·날짜)는 원문과 한 번 대조하세요. 아무리 좋은 변환기도 100% 보장은 없습니다.
- 공고문은 공개 문서지만, 내 계획서 초안에 고객 개인정보가 있다면 지우고 변환하세요.
6. 도구 ③④ hwpxskill · hwpx-skill — 공고 양식(HWPX)에 내 계획서 채우기
정부지원사업 계획서는 대부분 공고가 준 한글 양식에 써야 합니다. 서식(글꼴·표·칸 병합·여백·쪽수)을 망가뜨리면 보기 나쁜 것은 물론 분량 규정 위반이 될 수도 있습니다. 이 두 스킬은 그 문제를 다룹니다.
6-1. Canine89/hwpxskill (★339, 2026-11-18 기준 · 라이선스 표기는 저장소에서 확인 필요)
무엇을 하나: README 기준, 원본 HWPX 양식을 넣으면 스타일·표 구조·셀 병합·여백까지 분석해 구조를 보존한 채 내용만 바꿔 줍니다. 작업 후 page_guard.py가 원본 대비 쪽수가 달라졌는지, content_guard.py가 원문 잔재·placeholder(예: "○○○를 입력하세요" 같은 안내 문구)가 남았는지 검사합니다. Claude Code·Cursor·Codex CLI에서 동작합니다.
언제 쓰나: 챕터 03 ⑩ "문서 완성" 단계 — 최종 원고가 확정된 뒤, 공고 양식에 옮길 때.
설치: 저장소를 복사(clone)한 뒤, 쓰는 에이전트의 스킬 폴더에 넣습니다. 스킬 폴더 위치는 에이전트마다 다르니 저장소 README의 에이전트별 안내를 따르세요.
git clone https://github.com/Canine89/hwpxskill.git
6-2. jkf87/hwpx-skill (★312, 2026-11-18 기준 · README에 MIT 표기)
무엇을 하나: README 기준, HWP/HWPX 문서 변환·생성·읽기·편집을 위한 AI 에이전트 스킬(Claude·Codex)입니다. Windows에서는 설치된 한컴오피스로 HWP를 HWPX로 바꾼 뒤 작업을 이어 갑니다. 레퍼런스 양식을 복제해 문구를 바꾸는 흐름에서 map_preflight.py로 바꿀 자리를 뽑고(dump) 점검한 뒤(check), fill_hwpx.py replace로 채우고, residue로 원본 문구 잔재를 검사합니다. 원샷 생성 유형으로 official-letter, brief-report, plan-report, markdown을 지원합니다.
언제 쓰나: 양식 채우기 외에, 사업계획서 요약본·내부 보고서를 HWPX로 새로 만들 때(plan-report, brief-report).
# README의 치환 흐름 예시 (저장소 폴더 안에서) python3 scripts/map_preflight.py dump base.hwpx python3 scripts/map_preflight.py check base.hwpx --map map.json python3 scripts/fill_hwpx.py replace base.hwpx out.hwpx --map map.json python3 scripts/map_preflight.py residue out.hwpx --against base.hwpx
명령을 직접 치기 어렵다면, 스킬을 설치한 에이전트에게 아래 프롬프트처럼 "말로" 시키면 에이전트가 이 명령들을 대신 실행합니다.
6-3. 첫 실행 — 재고콕 원고를 양식에 채우기
공고/양식.hwpx(공고가 준 원본 양식), 초안/최종원고.md(챕터 03 ⑨까지 끝난 원고, 목차가 양식과 같음). 결과: 제출/재고콕_사업계획서.hwpx.저장: 제출/사업계획서.hwpx
- 쪽수: 원본 양식 [n]쪽 → 결과 [n+1]쪽 ⚠ "3. 성장 전략"이 약 1/3쪽 넘침. 줄일 후보 문장 3개: (1) … (2) … (3) …
- 잔재 검사: 안내 문구 1건 남음 — "※ 작성 시 삭제" (2쪽 표 아래) → 삭제 완료
- 직접 확인할 곳: 사업비 표 합계 칸, 일정표 병합 칸, 첫 쪽 블라인드 위반 여부
6-4. 주의
- 반드시 한글(한컴오피스 또는 한글 뷰어)로 열어 눈으로 확인하세요. 검사 도구가 통과해도 실제 화면에서 줄바꿈이 어색할 수 있습니다.
- 공고가 PDF 변환 제출을 요구하는지, HWP 원본 제출인지 확인하세요.
- hwpxskill은 라이선스 표기가 없으니 개인 사용 범위에서 쓰고, hwpx-skill도 사용 전 저장소의 라이선스 안내를 확인하세요.
7. 도구 ⑤ anthropics/skills — Word·PPT·엑셀 파일 만들기
저장소: anthropics/skills · Anthropic 공식 Agent Skills 저장소 · ★약 19.7만 (2026-11-18 기준)
7-1. 무엇이 들어 있나
저장소의 skills 폴더에는 여러 스킬이 있고, 지원사업 준비에 직접 쓸 만한 것은 다음과 같습니다.
| 스킬 | 쓰는 곳 | 재고콕 예 |
|---|---|---|
docx | Word 문서 생성·편집 | 양식이 Word(docx)인 공고의 계획서, 인터뷰 요약 보고서 |
pptx | PowerPoint 발표자료 | 발표평가·오디션용 슬라이드(챕터 04 발표 대비와 연결) |
xlsx | 엑셀 파일·수식 | 3년 추정 손익표, 손익분기·민감도 표 |
pdf | PDF 다루기 | PDF 공고문 읽기, 제출용 PDF |
doc-coauthoring | 문서를 함께 쓰는 흐름 | 초안 공동 작성·수정 |
skill-creator | 나만의 스킬 만들기 | "내 지원사업 작업 순서"를 스킬로 만들어 매번 재사용 |
설치·사용 방법은 Claude 앱인지 Claude Code인지에 따라 다르고 바뀔 수 있으므로, 저장소 README의 최신 안내를 따르세요.
7-2. 첫 실행 — 재고콕 발표자료와 재무표
재무추정.xlsx 생성 — 손익분기 셀 수식:
=ROUNDUP(가정!B3/(가정!B1-가정!B2),0) → 200(곳)확인할 것: 가정 시트의 신규 고객 가정 근거(인터뷰·거래처 제휴)가 원고와 같은지
8. 도구 ⑥ plan-lint — 사업계획서 결함 진단 (참고용)
저장소: Choihello/plan-lint · ★1 · MIT (2026-11-18 기준)
8-1. 무엇을 하나
README 기준, 정부 창업지원사업 사업계획서의 객관적 결함을 원문 인용과 함께 짚어 주는 CLI입니다.
- 룰(규칙) 검사: 필수 항목 누락, 분량 위반, 수치 모순(예: 사업비 합계 불일치)
- LLM 검사: 논리 단절, 근거 없는 주장, 내부 모순, 구체성 부족
- 하지 않는 것: 점수 매기기, 합격 예측, 아이디어 품질 평가
기본 검사 기준(프로파일)은 예비창업패키지 PSST 표준이고, 공고별 프로파일(yaml 파일)을 추가할 수 있다고 README에 쓰여 있습니다. 2027년에는 예비창업패키지가 정부안에서 0원이므로, 모두의 창업·초기창업패키지 양식에 맞게 프로파일을 손봐야 정확도가 올라갑니다.
8-2. 설치와 실행
git clone https://github.com/Choihello/plan-lint.git cd plan-lint pip install -e . # API 키 없이 규칙 검사만 plan-lint 사업계획서.md --rules-only # 점검 보고서 파일로 (README 예시 그대로 — 키가 필요한 전체 검사) plan-lint 사업계획서.md --report out.md
LLM 검사까지 하려면 Anthropic 또는 OpenAI API 키(유료)가 필요합니다. 키 없이 --rules-only로도 누락·분량·수치 모순은 잡을 수 있습니다. 키는 절대 파일에 적어 공유하지 마세요.
8-3. 재고콕에 적용
--rules-only로 검사 → "사업비 표 합계 3,000만원 vs 본문 '총 3,200만원' 불일치" 같은 지적이 나오면 어느 쪽이 맞는지 사람이 확인해 고칩니다. (예시 지적은 가상)9. 도구 ⑦ StartupKit — 아이디어 단계 검증 (영어)
저장소: mohamedameen-io/StartupKit · ★170 · MIT (2026-11-18 기준)
README 기준, Claude Code용 아이디어 검증 파이프라인입니다. 11단계 — diverge(아이디어 넓히기) → niche(틈새 고르기) → competitors(경쟁사) → positioning(포지셔닝) → offer(제안) → validate(검증) → money(수익) → leads(잠재 고객) → skills(AI 스킬 활용 계획) → pitch(피치) → export(내보내기) — 를 스킬로 하나씩 진행하고, API 키가 필요 없습니다.
언제 쓰나: 아직 아이템이 확정되지 않았을 때, 챕터 02 문제 정의 전에 "어떤 고객의 어떤 문제를 풀지"를 넓게 탐색하는 용도. 영어 기반이므로 결과를 한국 지원사업 언어(PSST)로 옮기는 프롬프트를 함께 쓰세요.
10. 작업실 만들기 — 폴더 구조와 지시서 전문
도구를 설치했다면 이제 "작업실"을 만듭니다. 에이전트는 폴더를 열면 그 안의 지시서 파일(Claude Code는 CLAUDE.md, Codex 등은 AGENTS.md를 읽는 경우가 많음)을 먼저 읽고 그 규칙대로 일합니다. 챕터 03의 지시서에 이 챕터의 도구 순서를 더한 버전입니다.
10-1. 폴더 구조
지원사업작업실/
CLAUDE.md ← 지시서 (Codex 등은 같은 내용을 AGENTS.md로)
내자료/
아이템메모.md ← 문제·고객·해 본 것
인터뷰/ ← 인터뷰 메모 (이름은 "사장님 A"로)
내글.md ← 말투 기준 글 1~2쪽
경력실적.md ← 사실만: 기간·역할·숫자
공고/
원본/ ← K-Startup에서 받은 공고문·양식 (HWP/HWPX/PDF)
md/ ← kordoc 변환 결과
조사/
전수조사/ ← ir-search 보고서 복사본
출처목록.md ← 직접 확인한 출처만
초안/ ← 10단계 결과 파일 (01_인터뷰.md … 10_최종원고.md)
점검/ ← plan-lint 보고서, 모의심사 결과
제출/ ← 최종 HWPX, PPTX, XLSX
10-2. 지시서 전문 (복사해서 CLAUDE.md 또는 AGENTS.md로 저장)
10-3. 첫 메시지 예시
11. 문제 해결 — 설치하다 막혔을 때
| 증상 | 흔한 원인 | 해결 요령 |
|---|---|---|
command not found: node / npx | Node.js 미설치 또는 설치 후 터미널을 다시 안 엶 | nodejs.org에서 LTS 설치 → 터미널을 완전히 닫았다 다시 열기 → node -v |
| kordoc 실행 시 버전 관련 오류 | Node.js가 20 미만 | node -v 확인 후 최신 LTS로 업데이트 |
pip 권한 오류(Permission denied) | 시스템 Python에 설치하려 함 | pip install --user … 또는 가상환경(python3 -m venv .venv 후 활성화)에서 설치. sudo pip는 피하기 |
python3가 Windows에서 안 됨 | Windows는 python/py 명령을 씀 | py --version 시도, 안 되면 python.org 설치 시 PATH 체크 |
| 설치한 플러그인·스킬이 안 보임 | 에이전트가 시작될 때만 읽음 | 에이전트(앱)를 완전히 종료 후 다시 시작, 설치 위치가 README 안내와 같은지 확인 |
| 한글 파일명·내용이 깨짐 | 인코딩·글꼴 문제, 옛 HWP 형식 | 파일명을 영어로 바꿔 보기, HWP는 먼저 HWPX로 변환(kordoc to-hwpx) 후 작업 |
| 변환된 표가 이상함 | 복잡한 병합 칸, 스캔본 | PDF로도 변환해 비교, 스캔본은 --ocr, 숫자는 원문 대조 |
| 크롤링 결과가 0건 | 사이트 구조 변경, 일시 장애, 범위가 좁음 | 잠시 후 재시도, 프리셋을 recommended로, 저장소 Issues에서 같은 증상 검색 |
| 채운 HWPX가 한글에서 경고 | 서식 XML 손상 가능성 | 원본 양식으로 다시 시작, 쪽수·잔재 검사 재실행, 그래도 안 되면 한글에서 직접 붙여넣기 |
막혔을 때 가장 빠른 방법: 오류 메시지를 통째로 복사해 AI에게 "이 오류가 났어. 나는 [Mac/Windows]이고 [어떤 명령]을 실행했어. 초보자도 따라 할 수 있게 한 단계씩 알려 줘"라고 묻기.
12. 도구 없이 같은 일을 하는 대체법
| 도구 | 대체법 (코딩 없음) |
|---|---|
| ir-search | K-Startup "사업공고"와 기업마당에서 내 단계·지역으로 필터 → 목록을 복사해 AI에 붙이고 "이 목록에서 예비창업자·서울·사업화 자금에 맞는 것만 표로, 원문 확인 필요 표시" |
| kordoc | 한글(또는 한글 뷰어)에서 공고문을 PDF로 저장 → 웹 AI에 PDF 업로드. 표가 많으면 표를 캡처해 이미지로도 함께 올리기 |
| hwpxskill | AI에게 "양식 목차 순서대로 나눠서, 한 항목씩 복사하기 좋게 출력"을 시키고 한글에서 직접 붙여넣기(서식은 "텍스트만 붙여넣기") |
| plan-lint | 챕터 03 ⑥ 근거 검수 + ⑩ 최종 점검 프롬프트, 챕터 04 블라인드 검사 프롬프트 |
| anthropics/skills | AI에게 슬라이드별 제목·문장·도표 아이디어를 받아 PPT에 직접, 엑셀은 챕터 04의 수식을 그대로 입력 |
13. 더 배우고 싶다면 — 무료 학습 자료 (GitHub)
| 저장소 | 별 (2026-11-18) | 라이선스 | 무엇을 배우나 |
|---|---|---|---|
anthropics/prompt-eng-interactive-tutorial | 약 3.9만 | 저장소에서 확인 | Anthropic의 대화형 프롬프트 엔지니어링 튜토리얼 — 역할·예시·형식 지정 등 기본기 |
dair-ai/Prompt-Engineering-Guide | 약 8만 | MIT | 프롬프트 기법 총정리 가이드 |
microsoft/generative-ai-for-beginners | 약 12.4만 | MIT | 생성형 AI 입문 21강 |
f/prompts.chat | 약 17.8만 | 저장소에서 확인 | 옛 이름 Awesome ChatGPT Prompts — 역할별 프롬프트 모음(아이디어 참고용) |
anthropics/claude-cookbooks | — | MIT | Claude 활용 예제 모음(개발자용) |
openai/openai-cookbook | — | MIT | OpenAI API 활용 예제(개발자용) |
google-gemini/cookbook | — | Apache-2.0 | Gemini API 활용 예제(개발자용) |
추천 순서: 비개발자라면 prompt-eng-interactive-tutorial(기본기) → Prompt-Engineering-Guide(기법) → generative-ai-for-beginners(전체 이해). cookbook 3종은 API로 직접 프로그램을 만들고 싶을 때.
확인 기준과 남기는 것
확인 기준: 내 상황에서 도구를 쓸지 말지 정했고, 쓴다면 어떤 단계에 어떤 도구를 쓸지 작업실 지시서에 적었는가?
남기는 것: 작업실 폴더 + 지시서(CLAUDE.md/AGENTS.md) + ir-search 첫 보고서(또는 대체법으로 만든 공고 후보 표).
- 준비 확인(10분): 터미널을 열고
node -v,python3 --version(Windows는py --version),git --version결과를 적어 보기. 없는 것은 설치. - 도구 1개 설치(30분): 쓰는 에이전트에 ir-search를 설치(4-3). 에이전트가 없다면 kordoc을
npx로 한 번 실행해 공고문 하나를 Markdown으로 바꿔 보기. - 전수조사 실행(20분): 재고콕 대신 내 아이템과 내 프로필로 ir-search를
quick으로 실행(4-4 프롬프트). - 후보 메모로 옮기기(20분): 결과 A그룹 중 3개를 원문 링크로 열어 확인하고, 챕터 01의 "후보 지원사업 3개 메모" 표에 옮기기. 도구가 '불명'으로 둔 칸은 원문에서 직접 채우기.
- 작업실 만들기(15분): 10-1 폴더 구조를 만들고 10-2 지시서를 저장. 첫 메시지(10-3)를 보내 1단계까지만 진행.
- □ 설치 전에 README와 설치 스크립트를 읽었다
- □ API 키·개인정보를 파일에 넣지 않았다
- □ A그룹 공고 3개를 원문으로 다시 확인했다
- □ 변환된 공고 Markdown의 배점·금액 숫자를 원문과 대조했다
- □ 채운 HWPX를 한글로 열어 쪽수·잔재 문구를 눈으로 확인했다
핵심 요약
- ir-search는 K-Startup·기업마당·NIPA·KOCCA·SMTECH 공고를 모아 A·B·C 그룹 보고서를 만드는 스킬입니다(2026-11-18 기준 ★394).
- kordoc은 HWP·HWPX·PDF를 Markdown으로 바꿔 AI가 읽게 하고, Markdown에서 HWPX를 만듭니다(★3,035, MIT).
- hwpxskill·hwpx-skill은 공고 양식(HWPX)의 서식을 지키며 내용만 바꾸는 데 씁니다.
- 남의 코드를 실행하기 전에는 README와 설치 스크립트를 확인하고, API 키·개인정보를 넣지 않습니다.
- 도구가 없어도 웹 AI와 챕터 03 프롬프트만으로 계획서는 쓸 수 있으며, 이 챕터는 시간을 줄이는 선택 과정입니다.
확인 퀴즈 (6문항)
답을 먼저 골라 보고 "정답 확인"을 누르세요.
Q1. 처음 보는 저장소의 설치 명령이 "curl … | bash"입니다. 가장 안전한 행동은?
- 바로 실행한다
- 스크립트 내용을 먼저 열어 무엇을 설치하는지 확인한 뒤 실행한다
- 관리자 권한으로 실행한다
- 별이 많으면 확인할 필요 없다
정답 확인
정답 B. curl | bash는 내려받은 스크립트를 그대로 실행합니다. 내용을 먼저 확인하는 것이 기본 안전 수칙입니다.
Q2. 공고문이 HWP 파일이라 AI에 올리면 글자가 깨집니다. 가장 알맞은 도구는?
- StartupKit
- plan-lint
- ir-search
- kordoc으로 Markdown 변환 후 올리기
정답 확인
정답 D. kordoc은 HWP·HWPX·PDF를 Markdown과 구조화 데이터로 바꿔 AI가 표까지 읽을 수 있게 합니다.
Q3. 공고 양식(HWPX)의 표·서식을 그대로 두고 내 내용만 채우고 싶습니다. 어떤 도구 계열이 맞나요?
- prompts.chat
- StartupKit
- hwpxskill / hwpx-skill
- ir-search
정답 확인
정답 C. hwpxskill은 원본 양식의 스타일·표 구조·셀 병합을 보존하고 내용만 바꾸며, page_guard로 페이지 수 변화를 검사합니다.
Q4. ir-search 보고서의 "B그룹"은 무엇을 뜻하나요?
- 법인 설립·투자 유치 같은 요건을 갖추면 열리는 사업
- 지금 즉시 지원 가능
- 아이템을 다른 분야 언어로 재서술하면 가능한 사업
- 마감된 사업
정답 확인
정답 A. A는 즉시 가능, B는 트리거(요건) 충족 시 로드맵, C는 프레이밍을 바꾸면 가능한 사업입니다.
Q5. 별이 1개인 개인 프로젝트 도구(plan-lint)를 쓸 때 맞는 태도는?
- 공식 도구처럼 결과를 그대로 믿는다
- 절대 쓰면 안 된다
- 별 수와 품질은 항상 같다
- 참고용으로 쓰고 지적 내용은 원문과 직접 대조해 검증한다
정답 확인
정답 D. 별이 적은 프로젝트는 검증 사례가 적습니다. 진단 결과를 힌트로만 쓰고 최종 판단은 직접 합니다.
Q6. 작업실 지시서(CLAUDE.md·AGENTS.md)에 꼭 넣어야 할 규칙은?
- 모든 결정을 AI가 알아서 하라
- 관문에서 멈추고 사람에게 묻기, 내 자료에 없는 경력·실적은 만들지 않기
- 최대한 길게 써라
- 출처는 나중에 붙여라
정답 확인
정답 B. 자동화할수록 관문 3곳에서 멈추고, 사실을 지어내지 않는 규칙이 있어야 결과를 믿고 쓸 수 있습니다.
자주 묻는 질문
GitHub을 몰라도 지원사업 AI 도구를 쓸 수 있나요?
네, 쓸 수 있습니다. 터미널을 열고 이 챕터의 명령어를 복사해 붙여 넣는 정도면 됩니다. 예를 들어 kordoc은 Node.js 20 이상만 있으면 npx kordoc 공고문.hwpx -o 공고문.md 한 줄로 공고문을 AI가 읽기 좋은 Markdown으로 바꿉니다. 그래도 어렵다면 챕터 01~04의 웹 AI 프롬프트만으로도 계획서 초안까지 충분히 갈 수 있습니다.
이 GitHub 도구들은 무료인가요?
도구 자체는 무료 공개입니다. 2026년 11월 18일 기준 ir-search·kordoc·plan-lint·StartupKit은 MIT 라이선스이고, hwpx-skill은 README에 MIT로 적혀 있으며, hwpxskill은 라이선스 표기가 없어 개인 사용 범위에서 쓰는 것이 안전합니다. 다만 도구를 돌리는 AI 에이전트(Claude Code 등)는 유료 플랜이 필요할 수 있고, plan-lint의 LLM 검사는 유료 API 키가 필요합니다. 키 없이 --rules-only 검사는 가능합니다.
한글(HWP) 사업계획서 양식을 AI로 채울 수 있나요?
네, 가능합니다. hwpxskill은 원본 HWPX 양식의 표 구조·셀 병합·여백을 보존한 채 내용만 바꾸고, 원본 대비 쪽수 변화와 안내 문구 잔재를 자동 검사합니다. 옛 HWP 양식은 kordoc to-hwpx로 먼저 HWPX로 바꿉니다. 그래도 제출 전에는 반드시 한글로 열어 쪽수·서식·사업비 표 합계를 눈으로 확인해야 합니다.
정부지원사업 공고를 자동으로 찾는 방법이 있나요?
있습니다. ir-search 스킬은 K-Startup·기업마당·NIPA·KOCCA·SMTECH 5곳의 모집중 공고를 모아 내 단계·지역·필요에 맞는 사업을 고르고, 원문으로 자격을 검증해 A(즉시 지원)·B(요건 충족 시)·C(재서술 시) 3개 그룹 보고서를 만듭니다. 주 1회 quick 프리셋으로 점검하고, 결과는 반드시 공고 원문으로 다시 확인하세요.
GitHub에서 받은 도구를 내 컴퓨터에서 실행해도 안전한가요?
확인 절차를 지키면 위험을 크게 줄일 수 있습니다. 실행 전 별 수·최근 업데이트·라이선스·이슈를 보고, README와 설치 스크립트를 먼저 읽으세요. 특히 curl … | bash 한 줄 설치는 내용을 확인한 뒤 쓰고, API 키·주민번호·고객 개인정보는 파일이나 AI에 넣지 마세요. 별이 적은 개인 프로젝트는 참고용으로만 쓰는 것이 안전합니다.