Molayo

© 2026 Molayo

GitHub요약2026. 05. 20. 01:21

agent-sh/agnix

요약

agnix는 Claude Code, Cursor, Copilot 등 다양한 AI 에이전트 도구의 설정 파일(CLAUDE.md, SKILL.md 등)을 검증하고 자동으로 수정해 주는 도구입니다. 423개의 규칙을 통해 잘못된 구문이나 형식을 잡아내어 AI 에이전트의 스킬 호출 실패와 성능 저하를 방지합니다.

핵심 포인트

  • 423개의 규칙을 통해 CLAUDE.md, SKILL.md, MCP 설정 등 다양한 에이전트 구성 파일을 검증
  • 잘못된 설정을 자동으로 수정하는 Auto-fix 기능 제공
  • VS Code, JetBrains, Neovim, Zed 등 주요 IDE 및 GitHub Action 지원
  • 멀티 도구 스택(Cursor, Claude Code, Copilot 등) 간의 설정 호환성 문제 해결

AI 도구가 조용히 무시해 버리기 전에 잘못된 에이전트 설정(agent configs)을 잡아내세요.

Claude Code, Codex CLI, OpenCode, Cursor, Copilot 등을 아우르는 423개의 규칙을 통해 —

CLAUDE.md, SKILL.md, hooks, MCP 설정 및 기타 에이전트 파일들을 검증합니다.

자동 수정 (Auto-fix) | GitHub Action | VS Code + JetBrains + Neovim + Zed

새로운 규칙과 도구 지원이 지속적으로 업데이트됩니다. 실시간 업데이트를 위해 팔로우하세요.

당신의 스킬이 실행되지 않습니다. Vercel의 연구에 따르면 올바른 구문(syntax)이 없으면 스킬 호출률이 0%에 달합니다. 필드 하나만 잘못되어도 당신의 스킬은 보이지 않게 됩니다.

"거의 맞음"이 최악의 결과입니다. 개발자의 66%가 이를 AI 사용 시 가장 큰 좌절 요인으로 꼽았습니다. 잘못 설정된 에이전트(Misconfigured agents)가 정확히 이런 결과를 만들어냅니다.

멀티 도구 스택(Multi-tool stacks)은 조용히 실패합니다. Cursor + Claude Code + Copilot은 각각 서로 다른 형식을 요구합니다. 한 도구에서 작동하는 설정이 다른 도구에서는 깨질 수 있습니다.

잘못된 패턴이 증폭됩니다. AI 어시스턴트는 잘못된 설정을 무시하는 것이 아니라, 그것으로부터 학습합니다.

agnix는 이 모든 것을 검증합니다 — 공식 사양(official specs), 학술 연구, 그리고 실제 발생한 오류 패턴에서 추출한 423개의 규칙을 제공합니다. 자동 수정 기능이 포함되어 있습니다.

먼저 사용해보고 싶으신가요? 플레이그라운드(playground)를 열어보세요. 어떤 에이전트 설정이든 붙여넣으면 즉시 진단 결과를 확인할 수 있습니다. 설치할 필요 없이 브라우저에서 바로 실행됩니다.

$ npx agnix .
Validating: .
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]
...

vs.code.example.mp4

# npm (권장, 모든 플랫폼)
npm install -g agnix
# Homebrew (macOS/Linux)
...

사전 빌드된 바이너리(Pre-built binaries) | 모든 설치 옵션

에디터 (Editor)설치 (Install)
VS CodeVS Code Marketplace
JetBrainsJetBrains Marketplace
Neovim{ "agent-sh/agnix", config = function() require("agnix").setup() end }
ZedExtensions에서 "agnix" 검색
- name: Validate agent configs
uses: agent-sh/agnix@v0
with:
...

agnix . # 현재 디렉토리 검증
agnix --fix . # HIGH 및 MEDIUM 신뢰도의 수정 사항 적용
agnix --fix-safe . # HIGH 신뢰도의 수정 사항만 적용
...

전체 CLI 레퍼런스 (Full CLI reference) | 전체 규칙 레퍼런스 (Full rules reference)

도구 (Tool)규칙 (Rules)개수 (Count)설정 파일 (Config Files)
Agent SkillsAS-, CC-SK-31SKILL.md
...

Rust 워크스페이스 크레이트 (workspace crates):

agnix-rules

  • knowledge-base/rules.json에서 생성된 규칙 메타데이터 (rule metadata)

agnix-core

  • 공유 검증 엔진 라이브러리 (shared validation engine library)

agnix-cli

  • 커맨드 라인 인터페이스 (command-line interface) 바이너리

agnix-lsp

  • 언어 서버 (language server) 바이너리

agnix-mcp

  • MCP 서버 (MCP server) 바이너리

agnix-wasm

  • 브라우저/런타임 통합을 위한 WebAssembly (Wasm) 바인딩

기여를 환영합니다. 개발 가이드는 CONTRIBUTING.md를 참조하세요.

버그 보고 (Report a bug) | 규칙 요청 (Request a rule) | 초보자용 이슈 (Good first issues)

MIT 또는 Apache-2.0

다른 개발자들이 agnix를 찾을 수 있도록 이 저장소를 스타(Star) 해주세요.

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0