01 · Una frase
Dale esta frase a tu agente. Él se encarga del resto
Claude Code, o cualquier agente capaz de leer una página web y escribir archivos: lee llms.txt, aprende de dónde descargar el paquete de habilidades y dónde descomprimirlo, y luego sigue SKILL.md para leer y escribir RNL.
Lee https://rich-netlist.github.io/rnl/llms.txt, instala la habilidad de RNL que describe y luego ayúdame con mi netlist de RNL.
llms.txt es el texto plano pensado para los agentes: cómo instalarlo, qué archivos contiene el paquete, cómo comprobar archivos y dónde está el estándar. Está en inglés, en /rnl/llms.txt.
02 · Instalación
Descomprímelo donde tu agente guarda las habilidades. Obtendrás rnl/SKILL.md
La habilidad es la carpeta rnl/. Claude Code guarda las habilidades personales en ~/.claude/skills/, donde las ven todos los proyectos, y las propias de un proyecto en .claude/skills/; otros agentes tienen su propio directorio, según indique su documentación. Los comandos siguientes descomprimen el zip en el directorio personal de Claude Code.
macOS · Linux · Git Bash
Windows PowerShell
Manualmente
rnl-skill.zip contiene la carpeta rnl/ con todos sus archivos. Descomprímelo y coloca rnl/ donde tu agente guarda las habilidades. El SHA-256 del zip y de cada archivo se encuentra en SHA256SUMS.txt, y el tamaño y la dirección de cada archivo en manifest.json.
Sin instalar
Un agente que no pueda descomprimir ni escribir archivos puede leer directamente el texto plano: primero SKILL.md, que apunta a los archivos bajo references/. Todos los archivos están bajo skill/rnl/ y se enumeran más abajo.
Desde el repositorio
El código fuente de la habilidad está en skills/rnl/ dentro del repositorio: clonarlo y copiar esa carpeta equivale a lo mismo. El zip de aquí se genera siempre a partir de la rama main más reciente.
03 · Contenido del paquete
Una guía breve, una referencia generada y ejemplos validados
Todos los archivos se leen como texto plano. La referencia se genera a partir de los archivos de los paquetes estándar, de modo que se mantiene sincronizada con ellos, y cada ejemplo en SPICE o Spectre del paquete se comprueba con rnl check en la integración continua (CI).
-
Empieza aquí
SKILL.mdQué es RNL, un ejemplo completo, los pasos de trabajo y las reglas que ahorran tiempo.
-
Guía breve del lenguaje
references/language.mdTodo lo necesario para leer y escribir un archivo de RNL 0.3: estructura de archivos, sentencias, objetos y referencias, definiciones, disposición, cables, texto y paquetes. La misma guía también aparece en la página del estándar del lenguaje RNL 0.3.
-
Los paquetes estándar
references/packages.mdCada paquete de la serie 0.3, las definiciones con sus roles, los símbolos con sus pines, qué símbolo recibe una instancia por defecto, los conjuntos y qué es el paquete de alias
rnl-zh. La galería con los dibujos se encuentra en la página de paquetes. -
Comprobar y dibujar
references/tools.mdCómo usar el comando
rnlprecompilado o compilado desde el código fuente, el paquete de npm@rich-netlist/runtime, el visor web y el visor de escritorio, con un script completo de comprobación. -
Ejemplo: solo estructura
examples/ota5t.spUn OTA de cinco transistores en SPICE: el par diferencial y el espejo de corriente declarados, sin posiciones asignadas; el mismo circuito en Spectre es
examples/ota5t.scs. -
Ejemplo: colocado y cableado
examples/ota5t-placed.spEl mismo circuito con cada objeto colocado y con los cables, puertos, tierras y alimentaciones escritos, que
rnl renderdibuja por completo. -
Licencias
LICENSE.mdBajo qué licencia está cada archivo y los textos completos (
LICENSES/).
04 · Comprobar y dibujar
Comprueba lo que escribes. Usa la primera herramienta que puedas ejecutar
Las cuatro herramientas comparten un mismo núcleo, por lo que leen los archivos de igual manera. Un agente puede ejecutar las dos primeras directamente para comprobar y renderizar; los dos visores sirven para la inspección interactiva (y un agente también puede instalar e iniciar el visor de escritorio cuando se le solicite). Todos los detalles y comandos están en references/tools.md.
rnl
Descarga el archivo comprimido para Windows, Linux o macOS de la versión más reciente del núcleo, o compílalo desde el código fuente (Rust 1.85 o posterior): cargo build --release -p rnl-cli. rnl check FILE imprime los diagnósticos y termina con código 1 si hay errores; rnl render FILE -o DIR genera un SVG por cada nivel. Es la opción más completa y la que utiliza la CI.
npm
npm i @rich-netlist/runtime (Node 18 o posterior): el mismo núcleo compilado a WebAssembly, que entrega los diagnósticos y un SVG por cada nivel. Tiene la misma versión que el comando rnl y se publica junto con el núcleo.
Visor web
Para una persona con navegador: rich-netlist.github.io/rnl/viewer/. Permite abrir un archivo y ver el dibujo y los problemas; no se sube nada a ningún servidor. Un agente que no pueda controlar un navegador puede pedirle al usuario que abra el archivo allí.
Visor de escritorio
Windows 10 y 11, Linux x86_64 y macOS 13 o posterior: la descarga se encuentra en la página de herramientas.
05 · Versiones y licencia
Sigue la rama main y cada archivo indica su licencia
- VersionesLa habilidad sigue el lenguaje 0.3 (revisión 2) y los paquetes estándar de la serie 0.3. Tanto el lenguaje como el conjunto de herramientas siguen siendo borradores y las versiones 0.x no prometen compatibilidad entre sí: los archivos de la versión 0.2 usan nombres diferentes y se leen con los paquetes de la serie 0.2.
- Siempre sincronizadoEl zip y los archivos se vuelven a generar cada vez que se publica el sitio, de modo que reflejan siempre el estado actual de
main. La referencia se genera a partir de los archivos de paquetes, la guía se mantiene junto con el estándar y los ejemplos se comprueban conrnl checken la CI. - LicenciaSKILL.md y las notas de herramientas están bajo licencia MIT, la guía del lenguaje bajo CC-BY-4.0 (cita la fuente al reutilizarla) y la referencia de paquetes y los ejemplos bajo CC0-1.0. El paquete no contiene código ni fuentes tipográficas. Los términos se encuentran en
LICENSE.mdyLICENSES/dentro del paquete. - Notificar un errorCuando la habilidad o la guía difieran del estándar, prevalece el estándar; por favor infórmalo en GitHub.