onescience-structure-viewer SKILL.md skillB
onescience-structure-viewer from onescience-ai/oneskills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add onescience-ai/oneskills/onescience-structure-viewer@git:20261030.3665286Pins git:20261030.3665286 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- onescience-ai/oneskills
- Path
skills/onescience-structure-viewer/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261030.3665286, committed Oct 30, 2026
- First version recorded
- Oct 18, 2026
- Size
- 7,397 bytes
- Repository stars
- 24
- License
- MIT
需要把原子结构（POSCAR/CONTCAR/XYZ）呈现为可交互三维图形，或把数据图表（PNG/JPG 训练曲线、能量温度演化、RDF）包成 OneCode 可渲染的 HTML 时使用：三维产出单文件 view.html（3Dmol.js）+ structure.json；图表用 render_chart.py 生成自包含 HTML（base64 内嵌）。任何"给出可视化/图表/效果图"的场景都应调用本技能——OneCode 平台只渲染 HTML，裸 PNG 在预览里是 base64 乱码。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 三维结构可视化（onescience-structure-viewer）
## 这个技能解决什么
给出一个 POSCAR/XYZ，让人**在浏览器里 360° 看清楚**：晶胞轮廓、原子颜色、成键、
哪些是固定的、哪些是溶剂/吸附物/骨架。用文字描述几何（"CO2 落在顶层 Cu 上方 3.35 Å"）
不如一张可旋转的图 5 秒钟说清楚，也是 DFT 交付里最容易被漏掉的一环。
产物只有两份，**无第三方 Python 依赖**（纯标准库），JS 侧走 CDN：
| 文件 | 说明 |
|---|---|
| `view.html` | 单文件三维查看器；结构数据 inline，可 `file://` 直开 |
| `structure.json` | 结构化 payload（原子、成键、晶胞、角色分组），供其它工具复用 |
## 什么时候用
- 你**产出或消费**了任何原子结构文件，并且它要被"看"：
- `onescience-dft-model-gate` 走完构建/门限之后 → 交付里必须附 `view.html`
- 表面/界面/异质结/溶剂化模型的初构
- NEB 端点、吸附位点、缺陷构型
- MLMD/LAMMPS 轨迹的代表帧（每帧调一次或挑关键帧）
- 用户明确说"给我看一下""画个三维图""可视化"，或提交前需要自证几何合理。
- 你**不需要**为了跑 VASP 而生成图；这个技能只是让"看图"这一步不再依赖
VESTA/OVITO 是否装在本地。
## 图表（PNG/JPG）→ HTML（render_chart.py）
**OneCode 平台文件预览只渲染 HTML**，直接交 `.png` 打开是一屏 base64 乱码。因此任何
作为交付物的二维数据图表（MACE 训练曲线、MD 能量/温度演化、RDF、DOS…）都必须先用
本技能的 `render_chart.py` 包成**自包含 HTML**（图片以 base64 data-URI 内嵌，无外部
请求、不受 CSP 影响）。每个 `X.png` 生成同名 `X.html`，正好满足 dft-model-gate 的
**I12 硬门限**（裸光栅图无同名 HTML → FAIL）。
```bash
# 每张图生成同名 sibling HTML；--combine 再额外产出一个合并索引页
python3 .opencode/skills/onescience-structure-viewer/scripts/render_chart.py \
mace_training.png md_energy_temp.png \
…Read the whole file at its exact version.
How to install
mdr add onescience-ai/oneskills/onescience-structure-viewer@sha256:3c6ba44aa4739fd5The line at the top of this page pins the label git:20261030.3665286, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_biwwwkgjgz6pwvmx)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Oct 18, 2026 and Oct 30, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261030.3665286 latest | 2026-10-30 | 3665286 | 7,397 B | B | view · diff |
| git:20261020.90dffec | 2026-10-20 | 90dffec | 6,670 B | B | view · diff |
| git:20261018.30e823c | 2026-10-18 | 30e823c | 5,447 B | B | view |
Audit of the latest version
- fail: No script tag (matched: <script)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7397 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
onescience-ai/oneskills · 24 stars · license MIT · pushed 2026-11-04 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_biwwwkgjgz6pwvmx GET https://markdownregistry.com/api/v1/resolve?ref=onescience-ai/oneskills/onescience-structure-viewer GET https://markdownregistry.com/api/v1/blob/3c6ba44aa4739fd50cdac7409ed16af3cb034708bd9e4a59814ffe31227abe6d
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.