/ 디렉터리 / 플레이그라운드 / Agnix (Agent Config Linter)
● 커뮤니티 avifenesh ⚡ 바로 사용

Agnix (Agent Config Linter)

제작: avifenesh · avifenesh/agnix

The missing linter and LSP for AI-coding-assistant configs (CLAUDE.md, SKILL.md, hooks, MCP).

Agnix validates agent configuration files — CLAUDE.md, AGENTS.md, SKILL.md frontmatter, hook scripts, MCP settings — with 156 rules and autofixes. Plugins for VS Code, Zed, Neovim. Treat it like ESLint for your agent setup.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

agnix-skill.replay ▶ 준비됨
0/0

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: Agnix (Agent Config Linter)

Enforce skill quality in CI before merging to the team's shared skill repo

👤 Teams maintaining a skill library ⏱ ~15 min intermediate

언제 쓸까: You don't want a broken SKILL.md frontmatter to ship and break everyone's agent.

사전 조건
  • Server/skill installed and authenticated — See repo README
흐름
  1. Set up CI
    Add agnix check to GitHub Actions on every PR touching .claude/ or skills/.✓ 복사됨
    → Workflow file added
  2. Fix locally
    Run agnix fix on the staged files. Show me the diff before committing.✓ 복사됨
    → Autofix diff

결과: No more bad-frontmatter incidents in production.

함정
  • Some rules are opinion-shaped (e.g., max description length). Tune in .agnix.toml rather than ignoring globally. — Some rules are opinion-shaped (e.g., max description length). Tune in .agnix.toml rather than ignoring globally.

비용 및 제한

운영 비용

API 쿼터
See provider docs for rate limits
호출당 토큰
Varies by tool
금액
See repo README for pricing details
팁
Cache tool results and avoid repeated identical calls.

보안

권한, 시크릿, 파급범위

자격 증명 저장: Use environment variables; never commit secrets
데이터 외부 송신: Tool calls go to the provider's API as documented

문제 해결

자주 발생하는 오류와 해결

rule too strict

Tune in .agnix.toml — every rule has severity/disable settings.

확인: agnix check --explain <rule-id>
LSP doesn't activate

Make sure the editor extension matches your agnix CLI version.

확인: agnix --version vs extension version

대안

Agnix (Agent Config Linter) 다른 것과 비교

대안언제 쓰나단점/장점
Hand-rolled YAML lintersYou only need one formatWon't catch cross-file issues

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기