kicad-happy
무엇인가
kicad-happy는 KiCad 전자 설계 프로젝트를 대상으로 에이전트가 회로 검토를 수행하도록 규율하는 스킬 묶음이다. S-expression 형식의 회로도·PCB 파일과 Gerber를 구조화 데이터로 파싱하고, 네트 추적·전압 계산·부품 값 대조를 거쳐 설계 결함을 보고하는 절차를 정의한다.
어떻게 동작하나
저장소의 skills/ 아래에 kicad, spice, emc, datasheets, bom, digikey, mouser, lcsc, element14, jlcpcb, pcbway 디렉터리가 있고 각 디렉터리가 SKILL.md를 포함한 개별 스킬이다. 에이전트는 프로젝트 경로를 지정받으면 해당 스킬을 로드해 회로도·PCB 파싱, 전원 트리 구성과 피드백 분배기 기반 출력 전압 계산, 커넥터별 ESD 커버리지 감사, 패시브 네트워크 검증, 적용 가능 인증 후보 산출, BOM 잠금 상태와 디커플링 적정성 점검을 순서대로 수행한다. opencode는 .opencode/opencode.json을 자동 발견해 skills/ 전체를 로드하고, Claude Code는 플러그인 마켓플레이스 등록을 통해 슬래시 명령 형태로 호출한다.
무엇과 다른가
프롬프트에 회로 검토 지침을 직접 적어 넣는 방식과 달리 파싱·계산 절차가 스킬 파일에 고정되어 있어 프로젝트마다 같은 순서로 검토가 재현된다. 범용 코드 리뷰 규칙 파일(CLAUDE.md·AGENTS.md)은 전자 설계 도메인 지식(피드백 분배기 전압 계산, 신호 대 접지 비율, ESD 클램프 배치)을 담지 않지만 kicad-happy는 이 계산식을 스킬 안에 명시한다. 또한 GitHub Action으로 PR 리뷰에 붙이거나 독립 Python 스크립트로 실행할 수 있어 에이전트 없이도 동작한다.
어떻게 쓰나
Claude Code에서는 /plugin marketplace add aklofas/kicad-happy 후 /plugin install kicad-happy@kicad-happy로 설치한다. Codex는 $skill-installer로 설치하거나 skills/ 하위 디렉터리를 ~/.codex/skills/에 심볼릭 링크하고, Antigravity는 agy plugin install https://github.com/aklofas/kicad-happy.git을 쓴다. 설치 후 에이전트에 "Analyze my KiCad project at hardware/rev2/"처럼 프로젝트 경로를 지정하면 검토가 시작된다.
전제와 한계
Claude Code, OpenAI Codex, GitHub Copilot CLI, Google Antigravity, opencode에서 동작한다. KiCad 프로젝트 파일이 있어야 하며 검토 결과는 파일에 담긴 부품 값과 넷 정보에 한정된다. 데이터시트 대조와 부품 소싱은 digikey·mouser·lcsc·element14 같은 외부 유통사 조회에 의존하므로 해당 접근이 막히면 해당 기능은 동작하지 않는다. Claude Code의 /plugin update가 새 버전을 감지하지 못하는 알려진 문제가 있어 캐시 삭제 후 재설치가 필요하다.