K Gov Skills — AI skill for Claude Code

k-gov-skills

한국 공무원의 업무 분야별 반복 업무를, **공식 출처와 합성 fixture를 구분해 근거를 정리하는 Agent Skill**로 패키징한 프로젝트입니다.

60개 업무 분야(domain)에 308개 Skill이 있고, 그 안쪽은 22개 공통 capability가 실제로 실행합니다.

**이 도구가 하는 일과 하지 않는 일**

• 한다: 공식 출처 조회, 인용·문서의 구조적 대조, 초안·근거표 정리
• 하지 않는다: 법적 판단, 결재·제출·발송, 원본 변경

모든 Skill은 `read-only`, `draft-only` 또는 `manual-review-only` 경계 안에서만 동작합니다. 최종 판단과 결재는 담당자 몫입니다.

목차

• 무엇을 해결하나요
• 5분 만에 써보기
• 내 업무 분야 Skill 찾기
• 핵심 개념 4가지
• capability 22개 목록
• 예제: 법령·판례 인용 검증
• 저장소 구조
• 개발·검증
• 증거를 읽는 법
• 안전 경계와 외부 reference

무엇을 해결하나요

보고서에 법 조항을 인용했는데 항·호가 틀렸거나, 존재하지 않는 판례번호가 들어가거나, 검색 결과·LLM 답변을 그대로 믿고 근거로 쓰는 상황을 막습니다.

이런 상황	이 저장소의 접근
LLM이 그럴듯한 법 조항을 지어냄	합성 fixture로 계약을 검사하고, 별도 승인된 live 정책이 있을 때만 공식 원문을 조회해 대조
검색 snippet만 보고 근거로 인용	1차 출처 URL과 함께 통과·불일치 상태를 분리 보고
애매하면 알아서 비슷한 걸로 채움	검색 0건·복수 후보·불일치는 fail-closed로 차단
민원 원문에 개인정보가 섞여 들어감	비식별 인용 후보만 입력받고 직접 식별자를 차단

5분 만에 써보기

네트워크나 인증정보 없이, 합성 fixture만으로 동작 방식을 확인할 수 있습니다.

git clone https://github.com/vertexsquad/k-gov-skills.git
cd k-gov-skills

# 1) 전체 검증 (네트워크·credential 불필요)
python3 scripts/check.py

# 2) capability 하나를 fixture로 실행
python3 -m kgov_runtime.capabilities.korean_legal_citation_verification --fixture

`--fixture`는 **입출력 계약이 맞는지**만 확인합니다. fixture 성공은 공식 원문 검증 성공을 뜻하지 않습니다. 이 둘은 저장소 전체에서 끝까지 구분해 표기합니다.

Claude Code와 Codex의 등록·호출 방법은 **[클라이언트 빠른 시작](docs/client-quickstart.md)** 을 따르세요. 전체 checkout 루트에서 실행하며, 등록이 확인된 뒤 Skill 이름으로 요청합니다. native Skill 탐색이 없는 클라이언트의 수동 파일 로딩 대안도 안내합니다.

`public-administration-legal-citation-verification` Skill로 이 초안의 법령·판례 인용만 검증해 줘. 개인정보는 입력하지 말고, 불일치는 자동 보완하지 말고 차단 상태로 알려 줘.

내 업무 분야 Skill 찾기

`domains/<업무 분야>/skills/<이름>/SKILL.md`가 진입점입니다. 각 분야마다 최소 5개의 Skill이 있습니다.

그룹	업무 분야
국가운영 (11)	행정 · 재정 · 세무 · 관세 · 감사 · 통계 · 조달 · 외교 · 통