k-gov-skills: 공공기관 실무용 AI 스킬 모음

먼저 결론

이 글은 k-gov-skills: 공공기관 실무용 AI 스킬 모음를 실무에서 바로 판단하고 적용할 수 있도록 정리한 보물창고 글입니다. 핵심은 정보를 많이 담는 것이 아니라, 반복 가능한 절차와 확인 기준을 남기는 것입니다. 기존 설명의 핵심은 "k-gov-skills 는 공무원·공공기관 실무자가 AI를 더 안전하고 실용적으로 쓰기 위한 공개 스킬 저장소입니다."로 요약할 수 있습니다.

k-gov-skills는 공무원·공공기관 실무자가 AI를 더 안전하고 실용적으로 쓰기 위한 공개 스킬 저장소입니다.

저장소 주소: https://github.com/mouseco/k-gov-skills

공공기관에서 문서, 회의록, 근거조사, HWPX 양식 때문에 시간을 많이 쓴다면 이 스킬 모음은 언젠가 반드시 필요해집니다.

보고서 초안, 정책 근거조사, 회의록 PDF, HWPX 양식 채우기, 출장 증빙 정리처럼 공공 실무에서 반복되는 일을 AI 에이전트에게 맡기기 위한 스킬 모음입니다.

핵심은 단순 자동화가 아닙니다.

양식은 지키고, 작성 흐름은 줄이고, 결과물은 사람이 바로 검토할 수 있게 만드는 것입니다.

목차

• 무엇을 해결하나
• 현재 포함된 스킬
• 빠른 선택 가이드
• 설치 방법
• 업무 흐름으로 묶어 쓰는 방법
• 스킬별 상세 기준
• 공개 배포 기준
• 검증 명령
• 한 줄 요약

무엇을 해결하나

공공 실무에서 AI를 쓰기 어려운 이유는 “글을 못 써서”가 아닙니다. 실제 문제는 더 구체적입니다.

• 보고서 유형마다 구조와 문체가 다릅니다.
• 법령·지침·공식자료 출처가 필요합니다.
• 최종 산출물이 HWPX 양식에 맞아야 합니다.
• 회의록은 요약뿐 아니라 상세 발언 기록도 필요합니다.
• 출장·여비 정산은 증빙 파일 형식과 정리 기준이 중요합니다.
• 개인정보, 내부 경로, 비공개 양식이 공개 저장소에 섞이면 안 됩니다.

k-gov-skills는 이 반복 업무를 스킬 단위로 나눠, AI 에이전트가 지켜야 할 절차와 검증 기준을 고정합니다.

현재 포함된 스킬

skills/
  official-report-skillset/
  deep-research-pro/
  hwpx-mouseco/
  gov-meeting-minutes/
  transport-receipt-collector/

빠른 선택 가이드

공공 보고서 작성

• 스킬: official-report-skillset
• 용도: 검토보고·계획보고·결과보고·간부보고 초안을 공공기관 문체와 의사결정 구조로 정리
• 필요한 자료: 주제, 원문 메모, 문서 유형, 독자, 일정, 담당, 예산, 관련 근거
• 로그인: 불필요
• 주의: 근거 없는 수치, 일정, 법령명, 예산을 임의로 만들지 않음

정책·제도 심층조사

• 스킬: deep-research-pro
• 용도: 법령·지침·공식자료·통계·사례를 출처와 함께 조사해 보고서 근거 메모 작성
• 필요한 자료: 조사 주제, 조사 목적, 기간·기관·법령 등 범위, 원하는 산출물 형식
• 로그인: 기본 불필요. 비공개 자료는 사용자가 직접 제공해야 함
• 주의: 검색 스니펫만 보고 결론을 내리지 않고 원출처를 확인함

HWPX 보고서 생성

• 스킬: hwpx-mouseco
• 용도: 공개 배포용 HWPX 템플릿을 분석하고 원페이퍼·다중페이퍼·장문 보고서 생성·검증
• 필요한 자료: 보고서 JSON, 사용할 프로파일 또는 템플릿 경로, 제목, 작성정보, 본문 섹션, 표
• 로그인: 불필요
• 주의: .hwp 바이너리 직접 편집이 아니라 .hwpx ZIP/XML 구조를 대상으로 함

회의록 PDF 작성

• 스킬: gov-meeting-minutes
• 용도: 회의 메모·ClovaNote 전사를 1쪽 회의록과 상세 발언록이 포함된 공문서형 PDF로 정리
• 필요한 자료: 회의 메모, 전사 원문, 참석자, 안건, 회의명, 일시
• 로그인: 불필요
• 주의: 실제로 확정되지 않은 내용을 결정사항처럼 쓰지 않음

교통비 증빙 수집

• 스킬: transport-receipt-collector
• 용도: 출장·여비 정산용 하이패스 영수증을 PDF와 PNG로 저장
• 필요한 자료: provider, 시작일, 종료일, 저장 폴더, 저장 대상
• 로그인: 하이패스 ID/PW 환경변수 필요
• 주의: 추가 본인확인, CAPTCHA, 2차 인증 자동 통과는 공개 스킬 범위 밖

설치 방법

필요한 스킬 경로를 지정해 설치합니다.

$skill-installer install https://github.com/mouseco/k-gov-skills/tree/main/skills/official-report-skillset
$skill-installer install https://github.com/mouseco/k-gov-skills/tree/main/skills/deep-research-pro
$skill-installer install https://github.com/mouseco/k-gov-skills/tree/main/skills/hwpx-mouseco
$skill-installer install https://github.com/mouseco/k-gov-skills/tree/main/skills/gov-meeting-minutes
$skill-installer install https://github.com/mouseco/k-gov-skills/tree/main/skills/transport-receipt-collector

설치 후에는 새 세션에서 스킬이 인식되는지 확인하고, 각 기능 문서를 열어 입력값, 예시, 제한사항을 확인합니다. HWPX·회의록·영수증처럼 파일을 만드는 스킬은 결과 파일을 실제로 열어 검증해야 합니다.

업무 흐름으로 묶어 쓰는 방법

각 스킬은 따로 쓸 수도 있지만, 함께 쓰면 공공기관 업무 흐름을 더 안정적으로 만들 수 있습니다.

deep-research-pro
  공식 근거와 사례 조사

-> official-report-skillset
  보고서 유형에 맞게 초안 작성

-> hwpx-mouseco
  HWPX 보고서 양식으로 산출

-> gov-meeting-minutes
  회의 기록과 후속조치 정리

-> transport-receipt-collector
  출장·교통비 증빙 정리

예를 들어 “공공기관 AI 도입 방안”을 검토한다고 하면, 먼저 deep-research-pro로 법령·지침·사례를 조사합니다. 그다음 official-report-skillset으로 검토보고서 구조를 잡고, 필요하면 hwpx-mouseco로 HWPX 보고서를 만듭니다. 회의 후에는 gov-meeting-minutes로 회의록 PDF를 남기고, 출장이나 외부 회의가 있었다면 transport-receipt-collector로 증빙을 정리합니다.

스킬별 상세 기준

official-report-skillset

이 스킬은 예쁜 문장을 만드는 스킬이 아니라 의사결정용 문서 구조를 잡는 스킬입니다.

기본 흐름은 다음입니다.

1. 요청 목적을 확인합니다. 승인, 공유, 검토, 보고 중 무엇인지 나눕니다.
2. 문서 유형을 정합니다.
3. 보고서의 독자와 의사결정 포인트를 잡습니다.
4. 목차와 문단 위계를 구성합니다.
5. 공공기관 개조식 문장으로 초안을 씁니다.
6. 근거·누락·리스크·후속조치를 점검합니다.
7. 한글 문장과 표현을 다듬습니다.

결과물은 문서 목적이 분명해야 합니다. 승인 문서인지 공유 문서인지, 핵심 판단이 앞부분에 있는지, 담당자·일정·산출물·점검 기준이 빠지지 않았는지 확인합니다.

deep-research-pro

이 스킬은 단순 검색 결과가 아니라 보고서에 붙일 수 있는 근거 메모를 만드는 것이 목표입니다.

출력은 다음 구성을 권장합니다.

1. Executive Summary
2. 연구 질문
3. 핵심 쟁점별 사실·해석·근거·판단
4. 보고서 반영 문장
5. 출처 목록
6. 조사 방법
7. 한계와 추가 확인 필요사항

출처 우선순위는 법령·시행령·고시·행정규칙·지침, 정부·공공기관 공식자료, 통계청·공공데이터·정부 통계, 국회·감사원·연구기관 보고서, 유사기관 사례, 신뢰 가능한 언론·전문 매체 순입니다.

이 스킬은 ClawHub deep-research-pro를 Windows/OpenClaw 공공문서 리서치 환경에 맞게 조정한 적응본입니다. 따라서 mouseco의 순수 창작물처럼 표시하지 않고, 출처와 수정 범위는 docs/attribution.md에 따로 둡니다.

hwpx-mouseco

이 기능의 목표는 새 문서를 예쁘게 만드는 것이 아니라, 기존 HWPX 양식의 구조와 스타일을 보존한 채 내용을 안전하게 채우는 것입니다.

결과 확인 포인트는 다음입니다.

• 생성된 .hwpx가 다시 열리는가
• content.hpf manifest와 spine 참조가 맞는가
• header.xml과 section XML 참조가 깨지지 않았는가
• 핵심 본문 텍스트가 실제 XML 안에 들어갔는가
• 템플릿의 표, 글머리, 작성정보 위치가 유지됐는가
• ** 마크다운 표시나 깨진 한글이 남지 않았는가
• Preview/PrvText.txt가 오래된 내용을 보여주지 않는가

HWPX 자동화는 본문 치환으로 끝나지 않습니다. 문서 패키지와 미리보기까지 검증해야 합니다.

gov-meeting-minutes

이 스킬은 회의 보고서가 아니라 회의 기록물을 만드는 스킬입니다.

기본 구성은 다음입니다.

1. 회의록 요약본
2. 상세 발언록
3. 발언자 식별 또는 확인 필요 메모

회의에서 실제로 확정되지 않은 내용을 결정사항처럼 쓰지 않고, 발언자 이름이나 직함을 임의로 만들지 않습니다. 익명 발언자가 있으면 먼저 주요 발언 취지를 요약하고 사용자에게 이름·직함을 확인합니다.

PDF 품질도 확인합니다. 1쪽이 회의록으로 보이는지, 결정사항과 논의내용이 구분됐는지, 후속조치가 원문 근거 없이 만들어지지 않았는지, 하단 빈 회색 박스나 불필요한 페이지 분리가 없는지 확인합니다.

transport-receipt-collector

이 스킬은 출장·여비·교통비 정산에 필요한 영수증을 PDF와 PNG 파일로 정리합니다.

v0.1/v0.2 기준 1차 대상은 하이패스입니다. 코레일·SRT 영수증은 같은 구조로 확장할 수 있도록 provider 구조를 둡니다.

하이패스는 사용자가 브라우저를 열어 미리 로그인해 둘 필요가 없습니다. 기본값은 로컬 환경변수 KGOV_HIPASS_ID, KGOV_HIPASS_PW를 읽어 자동 로그인 후 조회·저장하는 방식입니다.

출력 예시는 다음과 같습니다.

outputs/receipts/2026-05/
  2026-05-03_hipass_서울TG-동대구TG_12800.pdf
  2026-05-03_hipass_서울TG-동대구TG_12800.png

PDF와 PNG가 같은 거래를 가리키는지, PNG가 영수증 영역 중심으로 잘렸는지, 파일명에 날짜·provider·구간·금액이 들어갔는지, 실패 항목의 사유가 남았는지를 확인합니다.

공개 배포 기준

이 저장소는 공개 프로젝트이므로 자료 경계를 엄격히 둡니다.

커밋하지 않는 자료는 다음입니다.

• 실제 기관 내부문서 원본
• 개인명, 이메일, 전화번호, 주소, 계좌, 사번 등 개인정보
• 비공개 조직명, 내부 부서명, 문서번호, 결재선
• API 키, 토큰, 쿠키, 비밀번호, 세션 파일
• 로그인 후 받은 원문, 유료 자료, 접근 제한 자료
• 생성 결과물, 임시 파일, 압축 해제 폴더

허용 자료는 다음입니다.

• 공개 배포용으로 정리한 HWPX 템플릿
• 가상 기관·가상 주제 기반 예시 JSON
• 공공문서 작성 규칙과 HWPX 구조 참고자료
• 공개 웹페이지, 공식 문서, 오픈소스 프로젝트 링크
• 실행 검증용 최소 스크립트

새 스킬이나 예시 파일을 추가할 때는 먼저 docs/security-and-secrets.md를 확인하는 흐름을 기본으로 둡니다.

검증 명령

현재 스킬 모음은 아래 명령으로 검증합니다.

python -X utf8 scripts\validate_skills.py

검증 범위는 SKILL.md frontmatter, 스킬명과 폴더명 일치, feature docs 존재, JSON 파싱, Python compile, HWPX ZIP/XML 구조, 민감 문자열 기본 검색입니다.

다만 검증은 보조 수단입니다. 민감정보 공개 가능성은 최종적으로 사람이 다시 확인해야 합니다.

한 줄 요약

k-gov-skills는 공공문서를 많이 찍어내기 위한 저장소가 아니라, AI가 공공기관 실무의 작성 규칙과 검증 절차를 잊지 않게 만드는 작업 표준입니다.

자주 묻는 질문

이 글은 언제 쓰면 좋나요?

반복 업무를 매번 새로 설명하지 않고, 절차와 검증 기준을 고정하고 싶을 때 적용합니다.

그대로 따라 해도 되나요?

출발점으로는 그대로 써도 됩니다. 다만 실제 업무에서는 목표, 입력 자료, 제약 조건, 검수 기준을 자신의 상황에 맞게 바꾸는 편이 안전합니다.

결과가 기대와 다르면 무엇을 먼저 확인해야 하나요?

먼저 입력이 충분한지, 출력 형식이 명확한지, 하지 말아야 할 조건이 빠지지 않았는지 확인합니다. 문제가 반복되면 실패 사례를 다음 요청에 포함해 기준을 좁힙니다.

정리

k-gov-skills: 공공기관 실무용 AI 스킬 모음의 핵심은 이해보다 재사용입니다. 스킬은 읽는 문서보다 실행 절차에 가깝습니다. 한 번 사용한 뒤 막힌 지점을 체크리스트에 반영해야 다음 실행 품질이 올라갑니다.