01 · Une phrase
Donnez cette phrase à votre agent. Il s’occupe du reste
Claude Code, ou tout agent capable de lire une page web et d’écrire des fichiers : il lit llms.txt, apprend où télécharger le paquet de compétence et où le décompresser, puis suit SKILL.md pour lire et écrire du RNL.
Lisez https://rich-netlist.github.io/rnl/llms.txt, installez la compétence RNL qu’il décrit, puis aidez-moi avec ma netlist RNL.
llms.txt est le texte brut destiné aux agents : comment installer le paquet, quels fichiers il contient, comment vérifier les fichiers, où se trouve la norme. Il est en anglais, à l’adresse /rnl/llms.txt.
02 · Installation
Décompressez-le là où votre agent range ses compétences. Vous obtenez rnl/SKILL.md
La compétence est le dossier rnl/. Claude Code range les compétences personnelles dans ~/.claude/skills/, où tous les projets les voient, et celles propres à un projet dans .claude/skills/ ; les autres agents ont leur propre répertoire, indiqué dans leur documentation. Les commandes ci-dessous décompressent l’archive zip dans le répertoire personnel de Claude Code.
macOS · Linux · Git Bash
Windows PowerShell
Manuellement
rnl-skill.zip contient le dossier rnl/ avec tous ses fichiers. Décompressez-le et placez rnl/ là où votre agent range ses compétences. L’empreinte SHA-256 de l’archive zip et de chaque fichier figure dans SHA256SUMS.txt, et la taille ainsi que l’adresse de chaque fichier dans manifest.json.
Sans installation
Un agent qui ne peut ni décompresser ni écrire de fichiers lit directement le texte brut : d’abord SKILL.md, qui renvoie aux fichiers sous references/. Tous les fichiers se trouvent sous skill/rnl/, listés ci-dessous.
Depuis le dépôt
La source de la compétence se trouve dans skills/rnl/ dans le dépôt : clonez-le et copiez ce dossier, ce qui revient au même. L’archive zip proposée ici est toujours construite à partir de la branche main la plus récente.
03 · Contenu du paquet
Un guide abrégé, une référence générée, et des exemples validés
Chaque fichier se lit comme du texte brut. La référence est générée à partir des fichiers des paquets standards afin de rester synchronisée avec eux, et chaque exemple SPICE ou Spectre du paquet est vérifié par rnl check dans l’intégration continue (CI).
-
Commencer ici
SKILL.mdCe qu’est RNL, un exemple complet, les étapes du travail, les règles qui font gagner du temps.
-
Guide abrégé du langage
references/language.mdTout ce qu’il faut pour lire et écrire un fichier RNL 0.3 : la structure d’un fichier, les instructions, les objets et références, les définitions, le placement, les fils, le texte et les paquets. Ce même guide figure aussi sur la page de la norme du langage RNL 0.3.
-
Les paquets standards
references/packages.mdChaque paquet de la série 0.3, les définitions avec leurs rôles, les symboles avec leurs broches, quel symbole une instance reçoit par défaut, les ensembles, et ce qu’est le paquet d’alias
rnl-zh. La galerie avec les dessins se trouve sur la page des paquets. -
Vérifier et dessiner
references/tools.mdComment utiliser la commande
rnlprécompilée ou compilée depuis les sources, le paquet npm@rich-netlist/runtime, la visionneuse web et la visionneuse de bureau, avec un script de vérification complet. -
Exemple : structure seule
examples/ota5t.spUn OTA à cinq transistors en SPICE : la paire différentielle et le miroir de courant sont écrits, rien n’est placé ; le même circuit en Spectre est
examples/ota5t.scs. -
Exemple : placé et câblé
examples/ota5t-placed.spLe même circuit avec chaque objet placé, et les fils, ports, masses et alimentations écrits, que
rnl renderdessine entièrement. -
Licences
LICENSE.mdSous quelle licence se trouve chaque fichier, ainsi que les textes intégraux (
LICENSES/).
04 · Vérifier et dessiner
Vérifiez ce que vous écrivez. Utilisez le premier outil que vous pouvez exécuter
Les quatre outils partagent le même cœur, ils lisent donc un fichier exactement de la même manière. Un agent peut exécuter les deux premiers directement pour la vérification et le rendu ; les deux visionneuses servent à l’inspection interactive (et un agent peut aussi installer et lancer la visionneuse de bureau sur demande). Tous les détails et les commandes figurent dans references/tools.md.
rnl
Téléchargez l’archive pour Windows, Linux ou macOS depuis la dernière publication du cœur, ou compilez-la depuis les sources (Rust 1.85 ou ultérieur) : cargo build --release -p rnl-cli. rnl check FILE affiche les diagnostics et renvoie le code 1 en cas d’erreur ; rnl render FILE -o DIR écrit un SVG pour chaque niveau. C’est l’outil le plus complet, et celui qu’utilise la CI.
npm
npm i @rich-netlist/runtime (Node 18 ou ultérieur) : le même cœur compilé en WebAssembly, fournissant les diagnostics et un SVG pour chaque niveau. Il porte le numéro de version de la commande rnl et est publié avec le cœur.
Visionneuse web
Pour une personne disposant d’un navigateur : rich-netlist.github.io/rnl/viewer/. Ouvrez un fichier, voyez le schéma et les problèmes ; rien n’est téléversé. Un agent qui ne peut pas piloter un navigateur demande à l’utilisateur d’y ouvrir le fichier.
Visionneuse de bureau
Windows 10 et 11, Linux x86_64 et macOS 13 ou ultérieur : le téléchargement se trouve sur la page des outils.
05 · Versions et licence
Il suit la branche main, et chaque fichier indique sa licence
- VersionsLa compétence suit le langage 0.3 (révision 2) et les paquets standards de la série 0.3. Tant le langage que la chaîne d’outils sont encore des brouillons, et les versions 0.x ne garantissent aucune compatibilité : les fichiers en 0.2 utilisent des noms différents et se lisent avec les paquets de la série 0.2.
- Maintenu à jourL’archive zip et les fichiers sont régénérés à chaque publication du site, de sorte qu’ils reflètent toujours l’état actuel de
main. La référence est générée à partir des fichiers de paquets, le guide est maintenu avec la norme, et les exemples sont vérifiés parrnl checkdans la CI. - LicenceSKILL.md et les notes sur les outils sont sous licence MIT, le guide du langage sous CC-BY-4.0 (mentionnez la source lors d’une réutilisation), et la référence des paquets ainsi que les exemples sous CC0-1.0. Le paquet ne contient ni code ni polices. Les conditions complètes figurent dans
LICENSE.mdetLICENSES/dans le paquet. - Vous avez trouvé une erreurLorsque la compétence ou le guide diffère de la norme, la norme prévaut ; merci de le signaler sur GitHub.