Hello-QM/catgo-LRG / .claude/skills/structure-nanotube
nanotube-generation
VerifiedUse when the user asks to build a nanotube, roll up a 2D sheet into a tube, create a carbon nanotube (CNT), boron nitride nanotube (BNNT), or specify chiral indices (n, m).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
SKILL.md
View on GitHub---
name: nanotube-generation
description: >
Use when the user asks to build a nanotube, roll up a 2D sheet into a tube,
create a carbon nanotube (CNT), boron nitride nanotube (BNNT), or specify
chiral indices (n, m).
---
# Nanotube Generation
## Overview
Nanotubes are formed by rolling a 2D sheet into a cylinder defined by
chiral indices (n, m). The chirality determines electronic and mechanical
properties.
Common applications:
- **Carbon nanotubes (CNTs)**: electronics, composites, catalysis
- **Boron nitride nanotubes (BNNTs)**: high-temperature insulation, radiation shielding
- **MoS2 / WS2 nanotubes**: lubricants, batteries, photocatalysis
- **Custom 2D roll-ups**: any 2D material loaded in the viewer
## Chirality Quick Reference
| Type | Condition | Electronic Character (CNT) |
|-----------|-----------|---------------------------|
| Armchair | n = m | Metallic |
| Zigzag | m = 0 | Metallic if n mod 3 = 0, else semiconducting |
| Chiral | n != m, m != 0 | Metallic if (n - m) mod 3 = 0, else semiconducting |
## MCP Tools
### catgo_nanotube_info -- Query geometry before building
```json
{"tool": "catgo_nanotube_info", "arguments": {
"n": 10, "m": 0,
"bond_length": 1.42
}}
```
Returns diameter, circumference, chiral angle, translational vector length,
and estimated atom count without building the structure. Use this to check
size before committing to a build.
### catgo_nanotube_build -- Build the nanotube
```json
{"tool": "catgo_nanotube_build", "arguments": {
"n": 10, "m": 0,
"length": 20.0,
"bond_length": 1.42
}}
```
| Parameter | Description | Default |
|-----------|-------------|---------|
| `n`, `m` | Chiral indices | (required) |
| `length` | Tube length in Angstroms | one translational period |
| `bond_length` | C-C bond length in Angstroms | 1.42 |
The tool accepts either a loaded 2D structure from the viewer or
explicit lattice vectors / basis coordinates. For carbon nanotubes,
the default graphene sheet is used automatically.
### Router: `/nanotube/info` (POST), `/nanotube/build` (POST)
## Complete Workflow: (10,0) Zigzag CNT Relaxation
### Step 1: Check nanotube geometry
```json
{"tool": "catgo_nanotube_info", "arguments": {
"n": 10, "m": 0
}}
```
Verify the diameter (~7.8 A) and atom count are reasonable for DFT.
### Step 2: Build the nanotube
```json
{"tool": "catgo_nanotube_build", "arguments": {
"n": 10, "m": 0,
"length": 12.5
}}
```
### Step 3: Verify in viewer
```json
{"tool": "catgo_view", "arguments": {"action": "get_state"}}
```
Check: cylindrical geometry, no overlapping atoms, correct atom count.
### Step 4: Relax with DFT
```json
{"tool": "catgo_workflow_engine", "arguments": {
"action": "create", "params": {"name": "(10,0) CNT relaxation"}
}}
```
```json
{"tool": "catgo_workflow_engine", "arguments": {
"action": "add_task", "params": {
"workflow_id": "<wf_id>",
"task_type": "geo_opt",
"params": {"software": "vasp", "ENCUT": 520, "ISPIN": 1,
"system_name": "CNT-10-0 relax"}
}
}}
```
## Multi-walled Nanotubes (MWNT)
The backend supports multi-walled nanotubes via additional walls.
Each wall is defined by its own chiral indices. The inter-wall spacing
defaults to ~3.4 A (van der Waals distance for graphitic layers).
## Non-Carbon Nanotubes
To build a BN nanotube or MoS2 nanotube:
1. Fetch or load the 2D monolayer structure (e.g., hexagonal BN)
2. The nanotube builder rolls up whatever 2D structure is loaded
```json
{"tool": "catgo_fetch", "arguments": {
"action": "crystal", "formula": "BN", "source": "mc3d"
}}
```
Then build the nanotube from the loaded structure.
## Common Pitfalls
1. Large chiral indices (n > 30) produce structures with thousands of atoms.
Check atom count with `catgo_nanotube_info` before building.
2. The tube length should be at least one translational period for
meaningful periodic calculations.
3. For DFT on nanotubes, ensure sufficient vacuum in the non-periodic
directions (at least 12-15 A between periodic images).
4. Bond length 1.42 A is for graphene/CNT. Use 1.45 A for BN, 2.42 A
for MoS2.
5. Semiconducting CNTs require careful k-point sampling along the tube
axis. Use at least 1x1x8 k-points for a single unit cell.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |