RNLRich Netlist
日本語

Translated from English by AI; it may contain errors. Report an issue · The English terms are the normative ones. Glossary

RICH NETLIST · AGENT SKILLRNL 0.3 · パッケージ 0.3

エージェント向け

スキルパッケージをダウンロードすれば、エージェントがRNLの読み書き・検証・描画を行えます

RNLは回路図の描画情報をSPICEまたはSpectreのネットリストのコメント内に記述するものであり、回路そのものの定義は引き続きネットリストだけが担います。スキルパッケージはAgent Skills形式のフォルダで、言語の簡潔なガイド、標準パッケージのリファレンス、ファイルを検証・描画するツールの使用手順、およびrnl checkで検証済みのサンプルが含まれています。このページではそのダウンロード方法とインストール方法を説明します。エージェント向けのプレーンテキストの入口はllms.txtです。

パッケージ
rnl
フォーマット
Agent Skills:SKILL.mdとリファレンスファイル
言語
RNL 0.3
標準パッケージ
シリーズ 0.3
ダウンロード
rnl-skill.zip
ライセンス
MIT · CC-BY-4.0 · CC0-1.0

01 · 一文で指示

エージェントにこの一文を渡してください。残りはエージェント自身が行います

Claude Codeをはじめ、Webページの読み取りとファイルの書き込みができる任意のエージェントに対応しています。エージェントはllms.txtを読み取り、スキルパッケージのダウンロード先と展開先を把握した上で、SKILL.mdに従ってRNLを読み書きします。

https://rich-netlist.github.io/rnl/llms.txt を読み取り、そこに記載されているRNLスキルをインストールした上で、私のRNLネットリストの作業を手伝ってください。

llms.txtはエージェント向けに用意されたプレーンテキストで、インストール手順、パッケージ内のファイル構成、ファイルの検証方法、言語標準の場所が記されています。英語で書かれており、/rnl/llms.txtにあります。

02 · インストール

エージェントがスキルを保存するディレクトリに展開すると、rnl/SKILL.md が配置されます

スキル本体はrnl/フォルダです。Claude Codeでは個人用スキル(すべてのプロジェクトから参照可能)を~/.claude/skills/に、プロジェクト固有のスキルを.claude/skills/に配置します。他のエージェントでもそれぞれのドキュメントに従ったディレクトリに配置してください。以下のコマンドはzipをClaude Codeの個人用ディレクトリに展開します。

macOS · Linux · Git Bash

mkdir -p ~/.claude/skills
curl -fL https://rich-netlist.github.io/rnl/skill/rnl-skill.zip -o /tmp/rnl-skill.zip
unzip -o /tmp/rnl-skill.zip -d ~/.claude/skills

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Invoke-WebRequest https://rich-netlist.github.io/rnl/skill/rnl-skill.zip -OutFile "$env:TEMP\rnl-skill.zip"
Expand-Archive -Force "$env:TEMP\rnl-skill.zip" "$HOME\.claude\skills"

手動で導入

rnl-skill.zipにはrnl/フォルダとそのすべてのファイルが含まれています。展開してrnl/をエージェントのスキル保存先に入れてください。zipおよび各ファイルのSHA-256はSHA256SUMS.txtに、各ファイルのサイズとパスはmanifest.jsonに記載されています。

インストールせずに読む

アーカイブの展開やファイルの書き込みができないエージェントは、プレーンテキストをそのまま読み取れます。まずSKILL.mdを読み、そこからreferences/配下の各ファイルへと進みます。すべてのファイルはskill/rnl/配下にあり、下記に一覧があります。

リポジトリから取得

スキルのソースはリポジトリ内のskills/rnl/にあります。リポジトリをクローンしてそのフォルダをコピーしても同じ結果になります。ここで配布しているzipは常に最新のmainからビルドされています。

03 · パッケージの内容

簡潔なガイド、自動生成されたリファレンス、そして検証済みのサンプル

すべてのファイルはプレーンテキストとして読めます。リファレンスは標準パッケージのファイルから自動生成されるため常に同期が保たれており、パッケージ内のすべてのSPICEおよびSpectreサンプルはCIでrnl checkによる検証を通過しています。

skill/rnl/zip一式

04 · 検証と描画

書いたものを検証する。実行可能な最初のツールを使ってください

4つのツールはすべて1つのコアを共有しているため、ファイルを同じように読み取ります。エージェントは最初の2つを直接実行して検証や描画を行えます。2つのビューアは対話的な確認用です(また、求められればエージェントがデスクトップビューアをインストールして起動することもできます)。詳細とコマンドはreferences/tools.mdにあります。

rnl

最新のコアリリースからWindows・Linux・macOS向けのアーカイブをダウンロードするか、ソースからビルドします(Rust 1.85以降:cargo build --release -p rnl-cli)。rnl check FILEは診断メッセージを表示し、エラーがあれば終了コード1を返します。rnl render FILE -o DIRは各レベルのSVGを書き出します。最も機能が揃っており、CIでも使用されています。

npm

npm i @rich-netlist/runtime(Node 18以降):同じコアをWebAssemblyにコンパイルしたもので、診断結果と各レベルのSVGを出力します。バージョン番号はrnlコマンドと共通で、コアと同時にリリースされます。

Webビューア

ブラウザを使う人間向け:rich-netlist.github.io/rnl/viewer/。ファイルを開いて回路図と問題一覧を確認でき、ファイルが外部へアップロードされることはありません。ブラウザを直接操作できないエージェントは、ここでファイルを開くようユーザーに案内します。

デスクトップビューア

Windows 10/11、Linux x86_64、およびmacOS 13以降に対応。ダウンロードはツールのページにあります。

05 · バージョンとライセンス

mainブランチに追随し、ファイルごとにライセンスを明記

  • バージョンこのスキルは言語標準0.3(リビジョン2)および標準シリーズ0.3の標準パッケージに対応しています。言語もツールキットもまだ草案段階であり、0.xのバージョン間では互換性は保証されません。0.2のファイルは異なる名前を使用しており、シリーズ0.2のパッケージで読み込まれます。
  • 常に最新と同期zipと各ファイルはサイトが公開されるたびに再生成されるため、常に最新のmainの内容になります。リファレンスはパッケージファイルから生成され、ガイドは言語標準とともに管理され、サンプルはCIでrnl checkによって検証されています。
  • ライセンスSKILL.mdとツールの解説はMITライセンス、言語ガイドはCC-BY-4.0(再利用時は出典を明記)、標準パッケージのリファレンスとサンプルはCC0-1.0です。パッケージ内にコードやフォントは含まれません。条文はパッケージ内のLICENSE.mdおよびLICENSES/にあります。
  • 誤りを見つけた場合スキルやガイドの記述が言語標準と異なる場合は、言語標準が優先されます。ぜひGitHubにてご報告ください。