{
  "markdown": "# Legalize-KR Agent Skills\n\n[![skills.sh](https://skills.sh/b/legalize-kr/agent-skills)](https://skills.sh/legalize-kr/agent-skills)\n\nLegalize-KR의 공개 한국 법률 데이터를 AI Agent가 활용하도록 돕는 스킬/플러그인 저장소입니다.\n\n이 저장소는 법률 자문 도구가 아닙니다. AI Agent가 아래 공개 데이터에 더 정확히 접근하도록 돕는 안내와 설정을 제공합니다.\n\n- 법령: `legalize-kr/legalize-kr`\n- 판례: `legalize-kr/precedent-kr`\n- 행정규칙: `legalize-kr/admrule-kr`\n- 자치법규: `legalize-kr/ordinance-kr`\n\n스킬 이름은 `legalize-kr`입니다.\n\n## 먼저 고르기\n\n터미널이나 개발 도구가 익숙하지 않다면 **Claude Cowork에서 Release ZIP 업로드**를 권장합니다.\n\n| 상황 | 권장 방법 |\n|---|---|\n| Claude Cowork를 쓰고 있고 터미널을 피하고 싶음 | GitHub Releases에서 `legalize-kr-plugin.zip` 다운로드 후 Cowork에 업로드 |\n| Claude Code를 씀 | `/plugin marketplace add legalize-kr/agent-skills` 후 플러그인 설치 |\n| Cursor, Codex, Cline, GitHub Copilot, Warp 등을 씀 | `npx skills add legalize-kr/agent-skills --skill legalize-kr` |\n| Agent가 실제 도구 호출로 법령/판례를 조회해야 함 | `legalize-mcp` MCP 서버 연결 |\n| API나 자체 Agent에 넣고 싶음 | `SKILL.md`와 `references/` 문서를 프롬프트 컨텍스트에 포함 |\n\n## 무엇이 설치되나요?\n\n이 저장소는 두 계층을 제공합니다.\n\n| 계층 | 역할 | 터미널 필요 여부 |\n|---|---|---|\n| 스킬/플러그인 | Agent가 Legalize-KR 데이터셋, 접근 방법, 출처 표기 방식을 이해하도록 안내 | 대부분 불필요 |\n| 로컬 MCP 설정 | Agent가 `legalize-mcp`를 실행해 법령·판례·행정규칙·자치법규를 실제 도구로 조회 | 필요 |\n\n비개발자는 먼저 스킬/플러그인만 설치해도 됩니다. 다만 Agent가 실제 도구 호출까지 수행하려면 사용 중인 앱이 로컬 MCP 서버를 실행할 수 있어야 하며, `uvx` 또는 `pipx`로 `legalize-cli[mcp]`를 실행할 수 있어야 합니다.\n\n## 바로 써보기\n\n설치 후 Agent에게 아래처럼 요청합니다.\n\n```text\nLegalize-KR로 민법 제750조를 조회해줘.\n```\n\n```text\n점유취득시효 관련 판례를 찾아서 사건번호와 요지를 정리해줘.\n```\n\n```text\n서울특별시 조례 중 공공시설 사용료와 관련된 내용을 찾아줘.\n```\n\n```text\n근로기준법이 2020년과 2024년 사이에 어떻게 바뀌었는지 비교해줘.\n```\n\nAgent가 단순 설명만 하고 실제 조회를 하지 않는다면 MCP 서버가 연결되지 않은 상태일 수 있습니다. 이 경우에도 스킬은 접근 방법을 안내하지만, 실제 데이터 조회 도구까지 쓰려면 `legalize-cli` 또는 `legalize-mcp` 설정이 필요합니다.\n\n## 지원 방식 요약\n\n| 대상 | 권장 설치 방식 | 상태 | 비고 |\n|---|---|---|---|\n| Claude Code | Claude plugin marketplace | 지원 | `/legalize-kr:legalize-kr`로 사용 |\n| Claude Cowork | Release ZIP 업로드 또는 조직 Marketplace | 지원 | 비개발자에게 가장 쉬운 경로 |\n| Claude Desktop | MCP 서버 설정 | 지원 | 도구 호출 기반 조회 |\n| Cursor | Cursor plugin metadata, `skills.sh`, MCP 서버 설정 | 지원 | `.cursor-plugin/marketplace.json` 포함 |\n| Codex | `skills.sh`, Codex plugin manifest | 지원 | `.codex-plugin/plugin.json` 포함 |\n| Gemini CLI | Gemini extension 또는 `skills.sh` | 지원 | `gemini-extension.json` 포함 |\n| GitHub Copilot, Cline, Warp 등 | `skills.sh` 또는 범용 `plugin.json` | 지원 | `skills` CLI의 agent sync 대상 |\n| OpenAI/Claude API 직접 사용 | 프롬프트에 `SKILL.md`와 references 포함 | 수동 지원 | 네이티브 스킬 설치 개념이 없을 때 사용 |\n\n별도 실행 바이너리는 제공하지 않습니다. 이 저장소는 Markdown 스킬, 플러그인 메타데이터, 보조 Python 스크립트만 포함합니다. 실제 데이터 조회 실행 도구는 `legalize-cli`와 `legalize-mcp`가 담당합니다.\n\n## Claude Cowork\n\nCowork는 유료 플랜(Pro, Max, Team, Enterprise)에서 플러그인을 사용할 수 있습니다.\n\n### 개인 사용자\n\n1. GitHub Releases에서 `legalize-kr-plugin.zip`을 다운로드합니다.\n2. Claude Desktop 앱에서 Cowork 탭을 엽니다.\n3. 왼쪽 사이드바의 `Customize` 메뉴로 이동합니다.\n4. `Browse plugins`에서 custom plugin file 업로드를 선택합니다.\n5. 다운로드한 ZIP을 업로드합니다.\n6. 대화에서 `/` 또는 `+` 버튼을 눌러 `legalize-kr` 스킬을 선택합니다.\n\n### 조직 사용자\n\nTeam/Enterprise에서는 관리자가 이 저장소를 조직 plugin marketplace로 추가하는 방식이 적합합니다.\n\n```text\n/plugin marketplace add legalize-kr/agent-skills\n/plugin install legalize-kr@legalize-kr-marketplace\n```\n\n조직 배포에서는 사용자가 ZIP을 직접 내려받지 않아도 되고, marketplace 업데이트로 새 버전을 받을 수 있습니다.\n\n## Claude Code\n\nGitHub 저장소를 Claude plugin marketplace로 추가한 뒤 플러그인을 설치합니다.\n\n```bash\nclaude plugin marketplace add legalize-kr/agent-skills\nclaude plugin install legalize-kr@legalize-kr-marketplace\n```\n\nClaude Code 대화형 UI에서는 slash command로도 가능합니다.\n\n```text\n/plugin marketplace add legalize-kr/agent-skills\n/plugin install legalize-kr@legalize-kr-marketplace\n```\n\n설치 후 스킬 호출:\n\n```text\n/legalize-kr:legalize-kr\n```\n\n업데이트:\n\n```text\n/plugin marketplace update legalize-kr-marketplace\n/plugin update legalize-kr@legalize-kr-marketplace\n```\n\n로컬 테스트:\n\n```bash\ngit clone https://github.com/legalize-kr/agent-skills.git\ncd agent-skills\nclaude plugin validate .\nclaude --plugin-dir .\n```\n\n## Cursor\n\n이 저장소는 Cursor plugin discovery를 위한 [.cursor-plugin/marketplace.json](./.cursor-plugin/marketplace.json)을 포함합니다. Cursor UI에서 plugin marketplace를 직접 추가할 수 있는 환경에서는 `legalize-kr/agent-skills`를 추가하고 `legalize-kr` 플러그인을 설치합니다.\n\n스킬만 설치하려면:\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent cursor\n```\n\nMCP 도구로 쓰려면 `.cursor/mcp.json`에 등록합니다.\n\n```json\n{\n  \"servers\": {\n    \"legalize-kr\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"legalize-cli[mcp]\", \"legalize-mcp\"]\n    }\n  }\n}\n```\n\n## Codex\n\n이 저장소는 Codex plugin manifest인 [.codex-plugin/plugin.json](./.codex-plugin/plugin.json)을 포함합니다. 현재 가장 호환성이 좋은 경로는 `skills.sh`로 스킬을 설치하는 방식입니다.\n\n프로젝트에 스킬 설치:\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent codex\n```\n\n전역 설치:\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent codex --global\n```\n\n설치 후 Codex에 `legalize-kr 스킬을 사용해서 민법 제750조를 조회해줘`처럼 요청합니다.\n\n## Gemini CLI\n\nGemini CLI extension metadata인 [gemini-extension.json](./gemini-extension.json)을 포함합니다.\n\n```bash\ngemini extensions install https://github.com/legalize-kr/agent-skills\n```\n\n스킬 파일만 설치하려면 `skills.sh`를 사용합니다.\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent gemini-cli\n```\n\n## GitHub Copilot, Cline, Warp 등\n\n`skills.sh`의 universal agent 설치를 사용합니다.\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent '*'\n```\n\n특정 agent만 지정할 수도 있습니다.\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent cline\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent github-copilot\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --agent warp\n```\n\n사용 가능한 agent 이름은 로컬 `skills` CLI 버전에 따라 달라질 수 있습니다.\n\n```bash\nnpx skills add legalize-kr/agent-skills --skill legalize-kr --list\nnpx skills list --json\n```\n\n## MCP 도구 연결\n\n이 저장소의 [.mcp.json](./.mcp.json)은 `uvx`로 `legalize-cli[mcp]`를 실행합니다. `uvx` 방식은 별도 가상환경을 만들지 않고 MCP 서버를 실행하므로, Claude Code, Cursor, Gemini CLI 같은 개발자 도구에서 가장 간단합니다.\n\n```json\n{\n  \"mcpServers\": {\n    \"legalize-kr\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"legalize-cli[mcp]\", \"legalize-mcp\"]\n    }\n  }\n}\n```\n\n`uvx`를 쓰지 않는 환경에서는 먼저 MCP extra를 한 번 설치한 뒤 `legalize-mcp`를 직접 실행하도록 바꿉니다.\n\n```bash\npipx install 'legalize-cli[mcp]'\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"legalize-kr\": {\n      \"command\": \"legalize-mcp\"\n    }\n  }\n}\n```\n\nClaude Desktop의 `claude_desktop_config.json`에도 같은 설정을 넣을 수 있습니다. Python 도구 설치가 익숙하지 않은 사용자는 이 단계에서 도움을 받을 가능성이 높습니다.\n\n```json\n{\n  \"mcpServers\": {\n    \"legalize-kr\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"legalize-cli[mcp]\", \"legalize-mcp\"]\n    }\n  }\n}\n```\n\n토큰 없이도 동작하지만 GitHub API 한도가 낮습니다. 반복 검색이나 코드 검색을 쓸 때는 Agent를 시작하는 환경에 `GITHUB_TOKEN` 또는 `LEGALIZE_GITHUB_TOKEN`을 설정하세요.\n\n## 직접 API에 넣기\n\n네이티브 스킬 설치 기능이 없는 환경에서는 아래 파일을 프롬프트 컨텍스트에 포함합니다.\n\n```text\nskills/legalize-kr/SKILL.md\nskills/legalize-kr/references/access-options.md\nskills/legalize-kr/references/data-layout.md\n```\n\n대량 조회나 자동화가 필요하면 모델에 `legalize-cli` 또는 `legalize-mcp` 사용을 지시하는 편이 낫습니다.\n\n## 데이터 조회 CLI\n\n스킬은 접근 전략을 안내하고, 실제 데이터 조회는 다음 도구를 사용합니다.\n\n```bash\npipx install legalize-cli\npipx install 'legalize-cli[mcp]'\nuvx legalize-cli laws list --json\n```\n\n예시:\n\n```bash\nlegalize laws article 민법 제750조 --json\nlegalize precedents get \"2022다12345\" --json\nlegalize admrules list --agency 행정안전부 --type 고시 --json\nlegalize ordinances list --jurisdiction 서울특별시 --type 조례 --json\nlegalize search \"부동산 점유취득시효\" --in all --json\n```\n\n접근 방식 추천:\n\n```bash\npython3 skills/legalize-kr/scripts/select_access_mode.py --task search --scope all\n```\n\n## 설치 확인\n\n스킬 레이어 확인:\n\n```text\nLegalize-KR에는 어떤 데이터셋이 있고, 법령과 판례는 어떻게 조회해야 해?\n```\n\nMCP 도구 확인:\n\n```text\nLegalize-KR MCP 도구로 민법 제750조를 JSON 기준으로 조회해줘.\n```\n\n검색 확인:\n\n```text\nLegalize-KR에서 \"부동산 점유취득시효\"를 전체 데이터셋 기준으로 검색해줘.\n```\n\n기대 결과는 “일반적인 법률 설명”이 아니라 Legalize-KR 데이터셋, 기준일, 경로, 사건번호, 조문 번호 같은 출처 단서가 포함된 답변입니다.\n\n## 문제 해결\n\n### 스킬이 보이지 않음\n\n- Claude Code/Cowork는 플러그인을 설치한 뒤 새 대화에서 `/`를 눌러 확인합니다.\n- `skills.sh` 사용자는 `npx skills list --json`으로 설치 여부를 확인합니다.\n- Agent가 캐시를 쓰는 경우 앱 또는 세션을 재시작합니다.\n\n### MCP 도구가 보이지 않음\n\n- `uvx --version` 또는 `legalize-mcp`가 실행되는지 확인합니다.\n- `uvx`를 사용한다면 `uvx --from legalize-cli[mcp] legalize-mcp`가 실행되는지 확인합니다.\n- `pipx install 'legalize-cli[mcp]'`로 MCP extra가 설치되어 있는지 확인합니다.\n- Claude/Cursor/Gemini 등 호스트 앱을 재시작합니다.\n\n### GitHub rate limit 오류\n\n반복 검색이나 code search에는 GitHub 토큰이 필요할 수 있습니다.\n\n```bash\nexport GITHUB_TOKEN=$(gh auth token)\n```\n\n토큰은 공개 저장소 읽기 용도만 필요합니다.\n\n### Cowork ZIP 업로드가 실패함\n\n- GitHub Releases의 `legalize-kr-plugin.zip`을 그대로 업로드합니다.\n- 저장소 전체 ZIP이 아니라 Release asset ZIP이어야 합니다.\n- 직접 만든 ZIP은 아래 명령으로 검증합니다.\n\n```bash\npython3 scripts/package_claude_plugin.py\npython3 scripts/validate_claude_plugin_package.py dist/legalize-kr-plugin.zip\n```\n\n## Release 산출물\n\nCowork 업로드용 ZIP만 Release asset으로 제공합니다.\n\n- 파일명: `legalize-kr-plugin.zip`\n- 내용: `.claude-plugin/plugin.json`, `.mcp.json`, `skills/legalize-kr/**`, `README.md`\n- 제외: `.git`, `dist`, 캐시, 빌드 산출물\n\nGit tag를 푸시하면 GitHub Actions가 ZIP을 만들고 Release에 첨부합니다.\n\n```bash\ngit tag v0.1.0\ngit push origin v0.1.0\n```\n\n일반 AI Agent용 별도 바이너리는 제공하지 않습니다. 이유는 다음과 같습니다.\n\n- 스킬은 Markdown 기반 지식/절차 패키지입니다.\n- Claude Code와 Cowork는 플러그인/ZIP을 직접 소비합니다.\n- Cursor, Codex, Gemini CLI, Cline 등은 `skills.sh`가 스킬 파일을 설치합니다.\n- 데이터 조회 실행 파일은 이미 `legalize-cli` 패키지가 담당합니다.\n\n## 저장소 구조\n\n```text\n.claude-plugin/\n  marketplace.json\n  plugin.json\n.codex-plugin/\n  plugin.json\n.cursor-plugin/\n  marketplace.json\n.github/workflows/\n  release.yml\n.mcp.json\ngemini-extension.json\nplugin.json\nscripts/\n  package_claude_plugin.py\n  validate_claude_plugin_package.py\nskills/\n  legalize-kr/\n    SKILL.md\n    agents/openai.yaml\n    references/\n    scripts/\n```\n\n## 참고\n\n- Legalize-KR LLM 문맥: https://legalize.kr/llms.txt\n- Legalize-KR GitHub: https://github.com/legalize-kr\n- CLI/MCP 도구: https://github.com/legalize-kr/cli-tools\n- skills.sh: https://skills.sh/\n- Claude Code plugin marketplace 문서: https://code.claude.com/docs/ko/plugin-marketplaces\n- Claude Cowork plugin 문서: https://support.claude.com/en/articles/13837440-use-plugins-in-claude-cowork\n",
  "bytes": 9970,
  "sha": "cfe4809d9f43eb9ce618856bc6a9b3a46417e2eb4beecd6a2185cdb79f84500b",
  "repo_slug": "legalize-kr/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_legalize_kr_agent_skills_92a69ef0/readme"
}