[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C4MFEJV3TJBTD6Q72R10SD":3,"skill-same:01M6C4MFEJV3TJBTD6Q72R10SD":69},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":32,"linkOnly":33,"markdownContent":34,"markdownBody":35,"frontMatter":36,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":14,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M6C4MFEJV3TJBTD6Q72R10SD","circuitjson-bookshelf-converter",null,"Converts Circuit JSON PCB and schematic designs into Bookshelf physical design format (.nodes, .nets, .pl, .scl, .aux) with courtyard keep-out boundary modeling, and back-annotates Cypress placement optimization results back into Circuit JSON. Trigger this skill whenever converting circuit.json files to Bookshelf format or back-annotating .pl \u002F .gp.pl placement outputs into Circuit JSON.","vivekvjnk\u002Fthree-wise-monkeys","vivekvjnk","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F57674825?v=4","01M6C4KWVXPJ0AG14HH8G6R07Y","Vivek Vijayan","01M6C4KX0DKKJ9JGJKMV2K2W54",0,"GPL-2.0","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuitjson-bookshelf-converter\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31],"converter","circuitjson bookshelf converter","design","Optimization","boundary","json","format","results","2026-11-10 10:12:30",false,"---\nname: circuitjson-bookshelf-converter\ndescription: Converts Circuit JSON PCB and schematic designs into Bookshelf physical design format (.nodes, .nets, .pl, .scl, .aux) with courtyard keep-out boundary modeling, and back-annotates Cypress placement optimization results back into Circuit JSON. Trigger this skill whenever converting circuit.json files to Bookshelf format or back-annotating .pl \u002F .gp.pl placement outputs into Circuit JSON.\n---\n\n# Circuit JSON \u003C-> Bookshelf Converter Skill\n\nThis skill provides step-by-step guidance, mathematical conversion rules, and deterministic CLI\u002FPython tools for translating **Circuit JSON** designs into the **Bookshelf** format (`.aux`, `.nodes`, `.nets`, `.pl`, `.scl`) required by the Cypress placement engine, and back-annotating global placement results (`.gp.pl`) into updated `circuit.json` files.\n\n---\n\n## 1. Operational Knowledge\n\nThe core matrix conversion engine is located in `tools\u002Fmatrix_converter.py`.\n\n### Command Line Interface (CLI) Commands\n\n#### 1. Forward Conversion (Circuit JSON $\\longrightarrow$ Bookshelf PCB)\nConverts a Circuit JSON file into a set of Bookshelf files using courtyard keep-out boundary extraction and coordinate normalization.\n\n```bash\npython3 tools\u002Fmatrix_converter.py to_bookshelf_pcb \u003Ccircuit_json_path> \u003Coutput_dir> [design_name]\n```\n\n#### 2. Back-Annotation (Bookshelf Placement $\\longrightarrow$ Circuit JSON PCB)\nBack-annotates global placement coordinates (`.gp.pl` or `.pl`) back into an updated `circuit.json` file.\n\n```bash\npython3 tools\u002Fmatrix_converter.py from_bookshelf_pcb \u003Coriginal_json_path> \u003Cpl_file_path> \u003Coutput_json_path>\n```\n\n#### 3. Schematic Domain Conversions\n```bash\n# Forward Schematic Conversion\npython3 tools\u002Fmatrix_converter.py to_bookshelf_schematic \u003Ccircuit_json_path> \u003Coutput_dir> [design_name]\n\n# Reverse Schematic Back-Annotation\npython3 tools\u002Fmatrix_converter.py from_bookshelf_schematic \u003Coriginal_json_path> \u003Cpl_file_path> \u003Coutput_json_path>\n```\n\n#### 4. Board Preview Rendering\nRenders a 2D visualization (PNG) of component layout boundaries against board dimensions.\n\n```bash\npython3 tools\u002Fmatrix_converter.py render \u003Ccircuit_json_path> \u003Coutput_png_path>\n```\n\n---\n\n### Python API Usage\n\nTo integrate the converter directly inside Python automation pipelines:\n\n```python\nfrom tools.matrix_converter import CircuitJSONMatrixConverter\n\n# Initialize converter with scale=1000.0 (mm to um)\nconverter = CircuitJSONMatrixConverter(scale=1000.0)\n\n# 1. Forward Conversion to Bookshelf\naux_file_path = converter.to_bookshelf_pcb(\n    circuit_json_path=\"bms_project\u002Fpower_circuit\u002Fcircuit.json\",\n    output_dir=\"\u002Ftmp\u002Fbookshelf_out\",\n    design_name=\"power_circuit\"\n)\n\n# 2. Back-annotate placement output into updated Circuit JSON\nconverter.from_bookshelf_pcb(\n    original_json_path=\"bms_project\u002Fpower_circuit\u002Fcircuit.json\",\n    pl_path=\"\u002Ftmp\u002Fbookshelf_out\u002Fpower_circuit.gp.pl\",\n    output_path=\"\u002Ftmp\u002Fupdated_circuit.json\"\n)\n```\n\n---\n\n## 2. Reasoning Guidance\n\n### Deep Transformation & Coordinate Modeling Reference\nFor mathematical details regarding forward coordinate normalization, un-rotation formulas, courtyard bounding box offset calculations ($\\Delta \\mathbf{c}$), and inverse matrix back-annotations, refer to `references\u002Ftransformation_matrices.md`.\n\n### Conversion Rules & Decision Guidance\n1. **Courtyard Keep-out Modeling**: Component nodes in `.nodes` must reflect full courtyard keep-out bounding boxes ($\\theta = 0^\\circ$) rather than nominal package body sizes to prevent physical overlap during placement.\n2. **Courtyard Center Offset Recalibration**: When component origins differ from courtyard geometric centers, pin offsets in `.nets` must be offset by $\\Delta \\mathbf{c}$ to maintain exact net topology.\n3. **Child Element Shift Propagation**: During back-annotation, coordinate displacements $(\\Delta x, \\Delta y)$ applied to `pcb_component` must be recursively applied to all child elements (`pcb_smtpad`, `pcb_courtyard_*`, `pcb_silkscreen_*`, `pcb_port`, `cad_component`).\n\n---\n\n## 3. Workflow Instructions\n\n1. **Step 1: Execute Forward Conversion**  \n   Run `python3 tools\u002Fmatrix_converter.py to_bookshelf_pcb` to create Bookshelf artifacts (`.nodes`, `.nets`, `.pl`, `.scl`, `.aux`).\n2. **Step 2: External Optimization Engine Run**  \n   Pass the generated `.aux` file to Cypress \u002F DREAMPlace placement solver.\n3. **Step 3: Execute Back-Annotation**  \n   Run `python3 tools\u002Fmatrix_converter.py from_bookshelf_pcb` with the solver output `.gp.pl` file to update the `circuit.json`.\n4. **Step 4: Layout Preview & Verification**  \n   Generate board render image using `tools\u002Fmatrix_converter.py render` to inspect spatial layout visually.\n\n---\n\n## 4. Verification\n\nPerform this verification checklist to confirm valid conversion and back-annotation:\n\n1. **Board Outline Existence**: Confirm the input `circuit.json` contains a valid `pcb_board` object with positive `width` and `height`.\n2. **Bounding Box Dimension Verification**: Inspect `\u003Cdesign_name>.nodes` to verify multi-pin ICs reflect actual courtyard keep-out boundaries rather than body boundaries.\n3. **Non-Negative Coordinate Check**: Confirm all initial coordinates in `\u003Cdesign_name>.pl` are non-negative database units within board bounds $[0, S \\cdot W_{\\text{board}}]$.\n4. **DRC Overlap Verification**: Run `python3 tools\u002Fanalyze_circuit.py \u003Coutput_json_path>` on back-annotated JSON to verify component placement overlap errors are resolved.\n","# Circuit JSON \u003C-> Bookshelf Converter Skill\n\nThis skill provides step-by-step guidance, mathematical conversion rules, and deterministic CLI\u002FPython tools for translating **Circuit JSON** designs into the **Bookshelf** format (`.aux`, `.nodes`, `.nets`, `.pl`, `.scl`) required by the Cypress placement engine, and back-annotating global placement results (`.gp.pl`) into updated `circuit.json` files.\n\n---\n\n## 1. Operational Knowledge\n\nThe core matrix conversion engine is located in `tools\u002Fmatrix_converter.py`.\n\n### Command Line Interface (CLI) Commands\n\n#### 1. Forward Conversion (Circuit JSON $\\longrightarrow$ Bookshelf PCB)\nConverts a Circuit JSON file into a set of Bookshelf files using courtyard keep-out boundary extraction and coordinate normalization.\n\n```bash\npython3 tools\u002Fmatrix_converter.py to_bookshelf_pcb \u003Ccircuit_json_path> \u003Coutput_dir> [design_name]\n```\n\n#### 2. Back-Annotation (Bookshelf Placement $\\longrightarrow$ Circuit JSON PCB)\nBack-annotates global placement coordinates (`.gp.pl` or `.pl`) back into an updated `circuit.json` file.\n\n```bash\npython3 tools\u002Fmatrix_converter.py from_bookshelf_pcb \u003Coriginal_json_path> \u003Cpl_file_path> \u003Coutput_json_path>\n```\n\n#### 3. Schematic Domain Conversions\n```bash\n# Forward Schematic Conversion\npython3 tools\u002Fmatrix_converter.py to_bookshelf_schematic \u003Ccircuit_json_path> \u003Coutput_dir> [design_name]\n\n# Reverse Schematic Back-Annotation\npython3 tools\u002Fmatrix_converter.py from_bookshelf_schematic \u003Coriginal_json_path> \u003Cpl_file_path> \u003Coutput_json_path>\n```\n\n#### 4. Board Preview Rendering\nRenders a 2D visualization (PNG) of component layout boundaries against board dimensions.\n\n```bash\npython3 tools\u002Fmatrix_converter.py render \u003Ccircuit_json_path> \u003Coutput_png_path>\n```\n\n---\n\n### Python API Usage\n\nTo integrate the converter directly inside Python automation pipelines:\n\n```python\nfrom tools.matrix_converter import CircuitJSONMatrixConverter\n\n# Initialize converter with scale=1000.0 (mm to um)\nconverter = CircuitJSONMatrixConverter(scale=1000.0)\n\n# 1. Forward Conversion to Bookshelf\naux_file_path = converter.to_bookshelf_pcb(\n    circuit_json_path=\"bms_project\u002Fpower_circuit\u002Fcircuit.json\",\n    output_dir=\"\u002Ftmp\u002Fbookshelf_out\",\n    design_name=\"power_circuit\"\n)\n\n# 2. Back-annotate placement output into updated Circuit JSON\nconverter.from_bookshelf_pcb(\n    original_json_path=\"bms_project\u002Fpower_circuit\u002Fcircuit.json\",\n    pl_path=\"\u002Ftmp\u002Fbookshelf_out\u002Fpower_circuit.gp.pl\",\n    output_path=\"\u002Ftmp\u002Fupdated_circuit.json\"\n)\n```\n\n---\n\n## 2. Reasoning Guidance\n\n### Deep Transformation & Coordinate Modeling Reference\nFor mathematical details regarding forward coordinate normalization, un-rotation formulas, courtyard bounding box offset calculations ($\\Delta \\mathbf{c}$), and inverse matrix back-annotations, refer to `references\u002Ftransformation_matrices.md`.\n\n### Conversion Rules & Decision Guidance\n1. **Courtyard Keep-out Modeling**: Component nodes in `.nodes` must reflect full courtyard keep-out bounding boxes ($\\theta = 0^\\circ$) rather than nominal package body sizes to prevent physical overlap during placement.\n2. **Courtyard Center Offset Recalibration**: When component origins differ from courtyard geometric centers, pin offsets in `.nets` must be offset by $\\Delta \\mathbf{c}$ to maintain exact net topology.\n3. **Child Element Shift Propagation**: During back-annotation, coordinate displacements $(\\Delta x, \\Delta y)$ applied to `pcb_component` must be recursively applied to all child elements (`pcb_smtpad`, `pcb_courtyard_*`, `pcb_silkscreen_*`, `pcb_port`, `cad_component`).\n\n---\n\n## 3. Workflow Instructions\n\n1. **Step 1: Execute Forward Conversion**  \n   Run `python3 tools\u002Fmatrix_converter.py to_bookshelf_pcb` to create Bookshelf artifacts (`.nodes`, `.nets`, `.pl`, `.scl`, `.aux`).\n2. **Step 2: External Optimization Engine Run**  \n   Pass the generated `.aux` file to Cypress \u002F DREAMPlace placement solver.\n3. **Step 3: Execute Back-Annotation**  \n   Run `python3 tools\u002Fmatrix_converter.py from_bookshelf_pcb` with the solver output `.gp.pl` file to update the `circuit.json`.\n4. **Step 4: Layout Preview & Verification**  \n   Generate board render image using `tools\u002Fmatrix_converter.py render` to inspect spatial layout visually.\n\n---\n\n## 4. Verification\n\nPerform this verification checklist to confirm valid conversion and back-annotation:\n\n1. **Board Outline Existence**: Confirm the input `circuit.json` contains a valid `pcb_board` object with positive `width` and `height`.\n2. **Bounding Box Dimension Verification**: Inspect `\u003Cdesign_name>.nodes` to verify multi-pin ICs reflect actual courtyard keep-out boundaries rather than body boundaries.\n3. **Non-Negative Coordinate Check**: Confirm all initial coordinates in `\u003Cdesign_name>.pl` are non-negative database units within board bounds $[0, S \\cdot W_{\\text{board}}]$.\n4. **DRC Overlap Verification**: Run `python3 tools\u002Fanalyze_circuit.py \u003Coutput_json_path>` on back-annotated JSON to verify component placement overlap errors are resolved.\n",{"name":5,"description":7},"main","8413773f2869ef1060cdff2a70ff224b4fbb64a1","crazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuitjson-bookshelf-converter","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys","https:\u002F\u002Fgithub.com\u002Fvivekvjnk","2026-08-23 20:15:00",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add vivekvjnk\u002Fthree-wise-monkeys --skill circuitjson-bookshelf-converter",{"tool":49,"command":50},"bunx","bunx skills add vivekvjnk\u002Fthree-wise-monkeys --skill circuitjson-bookshelf-converter",{"tool":52,"command":53},"pnpm","pnpm dlx skills add vivekvjnk\u002Fthree-wise-monkeys --skill circuitjson-bookshelf-converter","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuitjson-bookshelf-converter\u002FSKILL.md",true,[57,63],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Ftransformation_matrices.md","REFERENCE","参考文档",8132,"https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuitjson-bookshelf-converter\u002Freferences\u002Ftransformation_matrices.md",{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":68},"tools\u002Fmatrix_converter.py","SCRIPT","脚本",31176,"https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuitjson-bookshelf-converter\u002Ftools\u002Fmatrix_converter.py",[70,81,94,118,123,130],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":32},"01M6C4MJNVM205XN83K79M9B9M","cypress-tuning","Systematically diagnoses, tunes, and executes Cypress GPU-accelerated PCB placement optimization runs. Trigger when running DREAMPlace\u002FCypress component placement, diagnosing placement divergence or clumping, or tuning wirelength, density, rotation, and net crossing parameters.","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcypress-tuning\u002FSKILL.md",[],[77,78,27,79,80],"cypress tuning","tuning","gpu","component",{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":88,"publishedAt":32},"01M6C4MCGT8VE95H167GW3ZMSM","circuit-json-analysis","Analyzes Circuit JSON files for structural component relationships, domain mappings (source, schematic, pcb, cad), and geometric layout DRC violations (courtyard overlaps, solder paste misalignments, pad clearances). Trigger this skill whenever analyzing a circuit.json file, inspecting PCB placement, or performing design rule checks on Circuit JSON data.","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fprocesses\u002Fcomponent-placement\u002Fskills\u002Fcircuit-json-analysis\u002FSKILL.md",[87],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[89,29,90,80,91,92,93,26],"circuit json analysis","analysis","data","analyzing","file",{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":104,"publishedAt":32},"01M6C4M9D400A6HAVWVYA6S4DW","vhl-concepts","Architectural foundation for Virtual Hardware Laboratory (VHL). Explains the four fundamental VHL concepts (Module vs Assembly, Interface Boundary, Git Worktree Workspace Isolation, and Shared Circuit Understanding Document), why VHL uses them, their core invariants, and when an agent must reason about them. Trigger this skill whenever reasoning about VHL architecture, defining boundaries, identifying module\u002Fassembly scope, or referencing SCUD artifacts.","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fconcepts\u002FVEC\u002Fskills\u002FVHL_Concepts\u002FSKILL.md",[100,103],{"categoryNo":101,"categoryName":102,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理",{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[105,106,107,108,109,110,111,112,113,114,115,28,116,117],"vhl concepts","architecture","core","git","reasoning","SCUD","assembly","workspace","virtual","git worktree","why","worktree","artifacts",{"skillNo":119,"name":110,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":32},"01M6C4M84NXPYJP0MQBK1KCPGR","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fconcepts\u002FVEC\u002Fskills\u002FSCUD\u002FSKILL.md",[],[110],{"skillNo":124,"name":125,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":32},"01M6C4M74376ZGW7PVHA3A7WZV","Module_Synthesis","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fconcepts\u002FVEC\u002Fskills\u002FModule_Synthesis\u002FSKILL.md",[],[129],"Module Synthesis",{"skillNo":131,"name":132,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":32},"01M6C4M5QGD7QHY9TZ153VJY6D","Boundary_Reconciliation","https:\u002F\u002Fgithub.com\u002Fvivekvjnk\u002Fthree-wise-monkeys\u002Fblob\u002Fmain\u002Fcrazy_orca\u002FVHL\u002Fconcepts\u002FVEC\u002Fskills\u002FBoundary_Reconciliation\u002FSKILL.md",[],[136,28],"Boundary Reconciliation"]