kicad-happy — KiCad向けClaude Codeスキル集

Tool

概要

kicad-happyは「Claude Code」向けのスキルセットとして提供される、KiCadプロジェクトの設計支援ツール群です。ターミナル上で動作するエージェントを通じて、回路図やPCBレイアウトの解析、BOM作成、データシートや部品のソーシング候補の提示、製造向けの出力準備といった一連の作業を半自動化します。主にPythonで実装され、KiCadのファイル(回路図・PCB)を読み取って解析を行い、外部の部品情報サイトと連携して部品情報を補完します。Claude Codeが持つ自然言語ベースの操作性を活かし、設計レビューや製造前チェックを簡便に行える点が特徴です。

GitHub

リポジトリの統計情報

  • スター数: 12
  • フォーク数: 0
  • ウォッチャー数: 12
  • コミット数: 2
  • ファイル数: 11
  • メインの言語: Python

主な特徴

  • Claude CodeのエージェントスキルとしてKiCad設計ワークフローを拡張。
  • 回路図・PCBの解析とレビューを自動化し、問題点の指摘や改善提案を生成。
  • BOMの生成と部品候補の取得(例:Digi-Keyなど)をサポート。
  • ターミナル中心の操作で設計から製造準備までの作業を一連で実行可能。

技術的なポイント

kicad-happyは、KiCadプロジェクトファイルをプログラム的に扱うための実装方針と、Claude Codeエージェントを介した対話的なワークフローを組み合わせている点が注目されます。技術的には以下の要素が中心です。

  • ファイル解析: KiCadの回路図(.schやS-expression形式)やPCB(.kicad_pcb)を読み取り、部品、ネット、フットプリント、テキスト注記などの情報を抽出します。PythonでS式解析やテキスト処理を行い、設計要素を構造化してエージェントに渡すことで、自然言語での解析・レビューが可能になります。
  • Claude Code統合: 実行にはAnthropicのClaude Codeが必要で、スキル(skills)としてエージェントに設計解析や設計改善のタスクを与えます。これにより「この回路で電源デカップリングは充分か」「パターン幅やクリアランスの問題はあるか」などの設計チェックを会話ベースで行えます。
  • BOMと部品調達支援: リポジトリ内にbomディレクトリやdigikeyディレクトリがあることから、BOM生成ロジックと外部部品データ(例えばDigi-Keyの検索結果や部品情報)を取得・整形する機能が含まれています。スクリプトは部品名や型番を正規化し、候補の供給元、最小発注量、パッケージ情報、データシートリンクなどを付与して出力することが想定されます。
  • 製造準備: 基板製造に必要な情報(アセンブリ図、部品配置リスト、製造向けの注意点)を生成するためのテンプレートやチェックリストを提供することで、Gerber出力の前段階のレビューを支援します。
  • 拡張性と注意点: Pythonベースであるため、pcbnewのPython APIや既存のKiCadユーティリティと組み合わせられますが、実行には環境依存の差異(KiCadバージョンやファイル形式の差)への対応が必要です。また、外部サービス(Digi-Key等)と連携する場合はAPIキーやスクレイピングの取り扱い、利用規約の遵守、ネットワーク接続の安全性確保が求められます。さらに、Claude Codeへ送る設計情報のプライバシーにも留意する必要があります。

リポジトリは比較的小規模で初期段階の実装に見えますが、エージェントに設計知識を持たせることで設計レビューや部品選定の初期作業を大幅に効率化できる可能性があります。現状では環境構築や実行のためにClaude Codeと連携する設定作業が必要であり、用途に応じたカスタマイズや追加のテストが望まれます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • bom: dir
  • digikey: dir

…他 6 ファイル

(上記はリポジトリのトップレベル構成を簡潔に示しています。bomディレクトリにはBOM生成関連スクリプトやテンプレート、digikeyディレクトリには部品検索や候補取得のための補助ファイルが含まれていると推測されます。)

まとめ

Claude Codeと組み合わせたKiCad設計支援ツールで、設計レビューやBOM作成の自動化に有用だが、実運用には環境設定とセキュリティ配慮が必要。

リポジトリ情報:

READMEの抜粋:

⚡ kicad-happy

Claude Code skills for electronics design with KiCad. Analyze schematics, review PCB layouts, download datasheets, source components, and prepare boards for fabrication — all from your terminal.

🛠️ Requires Claude Code — Anthropic’s agentic coding tool that lives in your terminal. Skills like these let you extend it into entirely new domains beyond software.

These ski…