Legalize-KR의 공개 한국 법률 데이터를 AI Agent가 활용하도록 돕는 스킬/플러그인 저장소입니다.

이 저장소는 법률 자문 도구가 아닙니다. AI Agent가 아래 공개 데이터에 더 정확히 접근하도록 돕는 안내와 설정을 제공합니다.

• 법령: legalize-kr/legalize-kr
• 판례: legalize-kr/precedent-kr
• 행정규칙: legalize-kr/admrule-kr
• 자치법규: legalize-kr/ordinance-kr

스킬 이름은 legalize-kr입니다.

터미널이나 개발 도구가 익숙하지 않다면 Claude Cowork에서 Release ZIP 업로드를 권장합니다.

이 저장소는 두 계층을 제공합니다.

비개발자는 먼저 스킬/플러그인만 설치해도 됩니다. 다만 Agent가 실제 도구 호출까지 수행하려면 사용 중인 앱이 로컬 MCP 서버를 실행할 수 있어야 하며, uvx 또는 pipx로 legalize-cli[mcp]를 실행할 수 있어야 합니다.

설치 후 Agent에게 아래처럼 요청합니다.

Legalize-KR로 민법 제750조를 조회해줘.

점유취득시효 관련 판례를 찾아서 사건번호와 요지를 정리해줘.

서울특별시 조례 중 공공시설 사용료와 관련된 내용을 찾아줘.

근로기준법이 2020년과 2024년 사이에 어떻게 바뀌었는지 비교해줘.

Agent가 단순 설명만 하고 실제 조회를 하지 않는다면 MCP 서버가 연결되지 않은 상태일 수 있습니다. 이 경우에도 스킬은 접근 방법을 안내하지만, 실제 데이터 조회 도구까지 쓰려면 legalize-cli 또는 legalize-mcp 설정이 필요합니다.

특정 날짜의 법령을 물을 때에는 공포된 버전과 시행 중인 파일 버전을 구분해야 합니다. legalize-cli와 MCP laws_get, laws_article은 기본적으로 공포일자를 사용하므로, 시행 중인 파일을 찾는 요청에는 시행일자를 명시합니다.

2024-10-01에 시행 중이던 민법 제1조를 조회해줘. 시행일자 기준을 사용하고, 조문별 부칙 시행일은 파일 단위 조회로 판정할 수 없다는 점도 밝혀줘.

응답의 file_effective_date_only가 true이면 조문별 시행일, 부칙의 적용례와 경과조치는 별도로 확인해야 합니다. 공포일자 기준 버전이 아직 시행 전이면 warning이 반환됩니다. 1970년 이전 기준일은 Git 보정 날짜 대신 frontmatter의 실제 공포일자 또는 시행일자를 사용합니다.

별도 실행 바이너리는 제공하지 않습니다. 이 저장소는 Markdown 스킬, 플러그인 메타데이터, 보조 Python 스크립트만 포함합니다. 실제 데이터 조회 실행 도구는 legalize-cli와 legalize-mcp가 담당합니다.

Cowork는 유료 플랜(Pro, Max, Team, Enterprise)에서 플러그인을 사용할 수 있습니다.

1. GitHub Releases에서 legalize-kr-plugin.zip을 다운로드합니다.
2. Claude Desktop 앱에서 Cowork 탭을 엽니다.
3. 왼쪽 사이드바의 Customize 메뉴로 이동합니다.
4. Browse plugins에서 custom plugin file 업로드를 선택합니다.
5. 다운로드한 ZIP을 업로드합니다.
6. 대화에서 / 또는 + 버튼을 눌러 legalize-kr 스킬을 선택합니다.

Team/Enterprise에서는 관리자가 이 저장소를 조직 plugin marketplace로 추가하는 방식이 적합합니다.

/plugin marketplace add legalize-kr/agent-skills
/plugin install legalize-kr@legalize-kr-marketplace

조직 배포에서는 사용자가 ZIP을 직접 내려받지 않아도 되고, marketplace 업데이트로 새 버전을 받을 수 있습니다.

GitHub 저장소를 Claude plugin marketplace로 추가한 뒤 플러그인을 설치합니다.

claude plugin marketplace add legalize-kr/agent-skills
claude plugin install legalize-kr@legalize-kr-marketplace

Claude Code 대화형 UI에서는 slash command로도 가능합니다.

/plugin marketplace add legalize-kr/agent-skills
/plugin install legalize-kr@legalize-kr-marketplace

설치 후 스킬 호출:

/legalize-kr:legalize-kr

업데이트:

/plugin marketplace update legalize-kr-marketplace
/plugin update legalize-kr@legalize-kr-marketplace

로컬 테스트:

git clone https://github.com/legalize-kr/agent-skills.git
cd agent-skills
claude plugin validate .
claude --plugin-dir .

이 저장소는 Cursor plugin discovery를 위한 .cursor-plugin/marketplace.json을 포함합니다. Cursor UI에서 plugin marketplace를 직접 추가할 수 있는 환경에서는 legalize-kr/agent-skills를 추가하고 legalize-kr 플러그인을 설치합니다.

스킬만 설치하려면:

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent cursor

MCP 도구로 쓰려면 .cursor/mcp.json에 등록합니다.

{
  "servers": {
    "legalize-kr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "legalize-cli[mcp]", "legalize-mcp"]
    }
  }
}

이 저장소는 Codex plugin manifest인 .codex-plugin/plugin.json을 포함합니다. 현재 가장 호환성이 좋은 경로는 skills.sh로 스킬을 설치하는 방식입니다.

프로젝트에 스킬 설치:

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent codex

전역 설치:

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent codex --global

설치 후 Codex에 legalize-kr 스킬을 사용해서 민법 제750조를 조회해줘처럼 요청합니다.

Gemini CLI extension metadata인 gemini-extension.json을 포함합니다.

gemini extensions install https://github.com/legalize-kr/agent-skills

스킬 파일만 설치하려면 skills.sh를 사용합니다.

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent gemini-cli

skills.sh의 universal agent 설치를 사용합니다.

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent '*'

특정 agent만 지정할 수도 있습니다.

npx skills add legalize-kr/agent-skills --skill legalize-kr --agent cline
npx skills add legalize-kr/agent-skills --skill legalize-kr --agent github-copilot
npx skills add legalize-kr/agent-skills --skill legalize-kr --agent warp

사용 가능한 agent 이름은 로컬 skills CLI 버전에 따라 달라질 수 있습니다.

npx skills add legalize-kr/agent-skills --skill legalize-kr --list
npx skills list --json

이 저장소의 .mcp.json은 uvx로 legalize-cli[mcp]를 실행합니다. uvx 방식은 별도 가상환경을 만들지 않고 MCP 서버를 실행하므로, Claude Code, Cursor, Gemini CLI 같은 개발자 도구에서 가장 간단합니다.

{
  "mcpServers": {
    "legalize-kr": {
      "command": "uvx",
      "args": ["--from", "legalize-cli[mcp]", "legalize-mcp"]
    }
  }
}

uvx를 쓰지 않는 환경에서는 먼저 MCP extra를 한 번 설치한 뒤 legalize-mcp를 직접 실행하도록 바꿉니다.

pipx install 'legalize-cli[mcp]'

{
  "mcpServers": {
    "legalize-kr": {
      "command": "legalize-mcp"
    }
  }
}

Claude Desktop의 claude_desktop_config.json에도 같은 설정을 넣을 수 있습니다. Python 도구 설치가 익숙하지 않은 사용자는 이 단계에서 도움을 받을 가능성이 높습니다.

{
  "mcpServers": {
    "legalize-kr": {
      "command": "uvx",
      "args": ["--from", "legalize-cli[mcp]", "legalize-mcp"]
    }
  }
}

토큰 없이도 동작하지만 GitHub API 한도가 낮습니다. 반복 검색이나 코드 검색을 쓸 때는 Agent를 시작하는 환경에 GITHUB_TOKEN 또는 LEGALIZE_GITHUB_TOKEN을 설정하세요.

네이티브 스킬 설치 기능이 없는 환경에서는 아래 파일을 프롬프트 컨텍스트에 포함합니다.

skills/legalize-kr/SKILL.md
skills/legalize-kr/references/access-options.md
skills/legalize-kr/references/data-layout.md

대량 조회나 자동화가 필요하면 모델에 legalize-cli 또는 legalize-mcp 사용을 지시하는 편이 낫습니다.

스킬은 접근 전략을 안내하고, 실제 데이터 조회는 다음 도구를 사용합니다.

pipx install legalize-cli
pipx install 'legalize-cli[mcp]'
uvx legalize-cli laws list --json

예시:

legalize laws article 민법 제750조 --json
legalize precedents get "2022다12345" --json
legalize admrules list --agency 행정안전부 --type 고시 --json
legalize ordinances list --jurisdiction 서울특별시 --type 조례 --json
legalize search "부동산 점유취득시효" --in all --json

접근 방식 추천:

python3 skills/legalize-kr/scripts/select_access_mode.py --task search --scope all

스킬 레이어 확인:

Legalize-KR에는 어떤 데이터셋이 있고, 법령과 판례는 어떻게 조회해야 해?

MCP 도구 확인:

Legalize-KR MCP 도구로 민법 제750조를 JSON 기준으로 조회해줘.

검색 확인:

Legalize-KR에서 "부동산 점유취득시효"를 전체 데이터셋 기준으로 검색해줘.

기대 결과는 “일반적인 법률 설명”이 아니라 Legalize-KR 데이터셋, 기준일, 경로, 사건번호, 조문 번호 같은 출처 단서가 포함된 답변입니다.

• Claude Code/Cowork는 플러그인을 설치한 뒤 새 대화에서 /를 눌러 확인합니다.
• skills.sh 사용자는 npx skills list --json으로 설치 여부를 확인합니다.
• Agent가 캐시를 쓰는 경우 앱 또는 세션을 재시작합니다.

• uvx --version 또는 legalize-mcp가 실행되는지 확인합니다.
• uvx를 사용한다면 uvx --from legalize-cli[mcp] legalize-mcp가 실행되는지 확인합니다.
• pipx install 'legalize-cli[mcp]'로 MCP extra가 설치되어 있는지 확인합니다.
• Claude/Cursor/Gemini 등 호스트 앱을 재시작합니다.

반복 검색이나 code search에는 GitHub 토큰이 필요할 수 있습니다.

export GITHUB_TOKEN=$(gh auth token)

토큰은 공개 저장소 읽기 용도만 필요합니다.

• GitHub Releases의 legalize-kr-plugin.zip을 그대로 업로드합니다.
• 저장소 전체 ZIP이 아니라 Release asset ZIP이어야 합니다.
• 직접 만든 ZIP은 아래 명령으로 검증합니다.

python3 scripts/package_claude_plugin.py
python3 scripts/validate_claude_plugin_package.py dist/legalize-kr-plugin.zip

Cowork 업로드용 ZIP만 Release asset으로 제공합니다.

• 파일명: legalize-kr-plugin.zip
• 내용: .claude-plugin/plugin.json, .mcp.json, skills/legalize-kr/**, README.md
• 제외: .git, dist, 캐시, 빌드 산출물

Git tag를 푸시하면 GitHub Actions가 ZIP을 만들고 Release에 첨부합니다.

git tag v0.1.0
git push origin v0.1.0

일반 AI Agent용 별도 바이너리는 제공하지 않습니다. 이유는 다음과 같습니다.

• 스킬은 Markdown 기반 지식/절차 패키지입니다.
• Claude Code와 Cowork는 플러그인/ZIP을 직접 소비합니다.
• Cursor, Codex, Gemini CLI, Cline 등은 skills.sh가 스킬 파일을 설치합니다.
• 데이터 조회 실행 파일은 이미 legalize-cli 패키지가 담당합니다.

.claude-plugin/
  marketplace.json
  plugin.json
.codex-plugin/
  plugin.json
.cursor-plugin/
  marketplace.json
.github/workflows/
  release.yml
.mcp.json
gemini-extension.json
plugin.json
scripts/
  package_claude_plugin.py
  validate_claude_plugin_package.py
skills/
  legalize-kr/
    SKILL.md
    agents/openai.yaml
    references/
    scripts/

• Legalize-KR LLM 문맥: https://legalize.kr/llms.txt
• Legalize-KR GitHub: https://github.com/legalize-kr
• CLI/MCP 도구: https://github.com/legalize-kr/cli-tools
• skills.sh: https://skills.sh/
• Claude Code plugin marketplace 문서: https://code.claude.com/docs/ko/plugin-marketplaces
• Claude Cowork plugin 문서: https://support.claude.com/en/articles/13837440-use-plugins-in-claude-cowork