01 · 한 문장으로 시작
에이전트에게 이 한 문장을 건네세요. 나머지는 에이전트가 알아서 처리합니다
Claude Code처럼 웹 페이지를 읽고 파일을 쓸 수 있는 에이전트라면 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
Windows PowerShell
수동 설치
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.mdRNL 개요, 완전한 예제 하나, 작업 단계, 시간을 아껴 주는 핵심 규칙들입니다.
-
언어 요약 가이드
references/language.mdRNL 0.3 파일을 읽고 쓰는 데 필요한 모든 내용으로, 파일 구조, 구문, 객체와 참조, 정의, 레이아웃, 배선, 텍스트 및 패키지를 다룹니다. 동일한 가이드가 RNL 0.3 언어 표준 페이지에도 실려 있습니다.
-
표준 패키지 레퍼런스
references/packages.md시리즈 0.3의 모든 패키지, 역할이 포함된 정의, 핀이 포함된 심볼, 인스턴스에 기본 배정되는 심볼, 집합, 그리고 별칭 패키지
rnl-zh를 설명합니다. 심볼 도면이 포함된 갤러리는 패키지 페이지에 있습니다. -
검사 및 그리기
references/tools.md사전 빌드되었거나 소스에서 빌드한
rnl명령줄 도구, npm 패키지@rich-netlist/runtime, 웹 뷰어와 데스크톱 뷰어의 사용법 및 완전한 검사 스크립트를 담고 있습니다. -
예제: 구조만 작성
examples/ota5t.spSPICE로 작성한 5트랜지스터 OTA입니다. 차동쌍과 전류 거울 구조만 선언하고 위치는 지정하지 않았습니다. 같은 회로의 Spectre 버전은
examples/ota5t.scs입니다. -
예제: 배치 및 배선 완료
examples/ota5t-placed.sp동일한 회로에 모든 객체의 위치와 배선, 포트, 접지, 전원을 모두 작성하여
rnl render로 완전한 회로도를 그릴 수 있는 예제입니다. -
라이선스
LICENSE.md각 파일에 적용되는 라이선스와 라이선스 전문(
LICENSES/)입니다.
04 · 검사 및 그리기
작성한 결과물을 검사하세요. 실행 가능한 첫 번째 도구를 쓰면 됩니다
네 가지 도구는 동일한 코어를 공유하므로 파일을 똑같이 해석합니다. 에이전트는 앞의 두 도구를 직접 실행해 파일을 검사하고 렌더링할 수 있으며, 두 뷰어는 대화형 확인용입니다(요청 시 에이전트가 데스크톱 뷰어를 설치하고 실행할 수도 있습니다). 자세한 설명과 명령어는 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 명령줄 도구와 버전 번호가 같으며 코어와 함께 배포됩니다.
웹 뷰어
브라우저를 사용하는 사람을 위한 도구입니다: 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에 제보해 주세요.