Image to Three.js Model
img2threejs/img2threejs
Rebuilds the object in a reference image as a procedural, animation-ready Three.js model written entirely in code, using staged sculpting with quality checks.
How to write application code with Tellux (0.3 API shape). An agent skill from cyanfish-x/tellux.
Install Tellux
$ npx skills add cyanfish-x/tellux --skill tellux -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cyanfish-x/tellux tellux --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tellux .claude/skills/tellux && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .claude/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/telluxType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cyanfish-x/tellux --skill tellux -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cyanfish-x/tellux tellux --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/tellux .agents/skills/tellux && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .agents/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cyanfish-x/tellux --skill tellux -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cyanfish-x/tellux tellux --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/tellux .cursor/skills/tellux && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .cursor/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cyanfish-x/tellux.git --path .agents/skills/tellux--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cyanfish-x/tellux --skill tellux -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cyanfish-x/tellux tellux --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/tellux .gemini/skills/tellux && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .gemini/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cyanfish-x/tellux telluxInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cyanfish-x/tellux --skill tellux -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/tellux .github/skills/tellux && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .github/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cyanfish-x/tellux --skill tellux -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cyanfish-x/tellux tellux --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cyanfish-x/tellux.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/tellux .opencode/skills/tellux && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tellux" agent skill from https://github.com/cyanfish-x/tellux/tree/dev/.agents/skills/tellux into .opencode/skills/tellux/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tellux", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tellux- GitHub stars
- 207
- Token cost
- ~884 tokens
- SKILL.md length
- 214 words
- Files
- 5 (incl. references)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
How to write application code with Tellux (0.3 API shape). An agent skill from cyanfish-x/tellux.
- Works in 5 steps: 安装与导入 → 单位与坐标系（高频踩坑点） → 必须确保容器有尺寸 → …
- Tasks that involve 3D graphics and WebGL
- SKILL.md covers 何时使用本 skill, 核心约定（先读这一段）, 能力导航 and 产出代码的规范, plus 1 more section
- Calls npm
What it does
Tellux is an agent skill from cyanfish-x/tellux. How to write application code with Tellux (0.3 API shape). Use for Viewer init, overlays, terrain, 3D Tiles, models, entities, atmosphere, clouds, postProcess, highlighter, camera, picking, and HISM. Do not use as a source for implementing the tellux library itself.
Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/coordinates.md`, `references/core-api.md` and `references/interaction.md`).
It sits in Game Development, covering 3D graphics and WebGL. It works with Three.js and TypeScript. The repository describes itself as: Open-source 3D Earth Engine built on Three.js for digital globes, digital twins, 3D maps — terrain, 3D Tiles, atmosphere & clouds. The licence is MIT.
When your agent uses it
- Tasks that involve 3D graphics and WebGL
Example prompts
- “/tellux”
Requirements
- Node.js
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 16961c8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Tellux loads about 884 tokens when it runs, and up to ~9.8k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 214 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from cyanfish-x/tellux at commit 16961c8, republished under its MIT licence (© cyanfish-x). 214 words, ~884 tokens.
Download SKILL.mdSave it as
.claude/skills/tellux/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.- name
- tellux
- description
- How to write application code with Tellux (0.3 API shape). Use for Viewer init, overlays, terrain, 3D Tiles, models, entities, atmosphere, clouds, postProcess, highlighter, camera, picking, and HISM. Do not use as a source for implementing the tellux library itself.
Tellux 应用开发助手
Tellux 是一个基于 Three.js 的 ESM TypeScript 库，用于在网页里构建数字地球、加载 Cesium 地形 / 影像 / 3D Tiles，并集成大气、体积云和后处理。本 skill 辅助你为使用 Tellux 的应用编写正确、可运行的代码。公开 API 已收敛为稳定形状，随 0.3 发布；从 0.2 升级见仓库 docs/guide/migration-0.3.md。
何时使用本 skill
当用户在做以下任何一件事时启用：
- 初始化
tellux.Viewer、配置场景 / 相机 / 渲染器 - 加载或切换地形、影像图层（XYZ / WMS / WMTS / MVT / GeoJSON / Cesium Ion）
- 加载 3D Tiles 或在经纬度放置 glTF 模型（点云可用 Cesium 形
pointCloudShading） - 绘制点 / 线 / 面实体，以及屏幕空间图标与文字标注
- 配置大气、光照模式、体积云、后处理
- 相机飞行 / 定位、鼠标交互、拾取、高度采样
- HISM 大规模实例化（森林、岩石场、多 LOD、实例拾取）
- 把自定义 Three.js 对象按经纬高放到地球上
核心约定（先读这一段）
这些是产出代码前必须遵守的硬性约定，违反会导致代码不可用或语义错误。
1. 安装与导入
Tellux 的 three、3d-tiles-renderer 和 @takram/* 是 peer dependency，应用侧必须显式安装：
npm install tellux three 3d-tiles-renderer postprocessing \
@takram/three-geospatial @takram/three-geospatial-effects \
@takram/three-atmosphere @takram/three-clouds
# 用 MVT 矢量瓦片时再加（可选）：
npm install @mapbox/vector-tile pbf导入：默认导出 tellux 对象 + 命名导出类 / 类型。
import tellux from 'tellux'
// 也可按需导入类型
import type { ViewerOptions, ImageryLayerOptions } from 'tellux'2. 单位与坐标系（高频踩坑点）
- 经纬度、heading / pitch / roll 用「度」，不是弧度。
- 高度、near / far、云层高度用「米」（WGS84 椭球海拔）。
- 太阳 / 月亮角半径（
sunAngularRadius等）是弧度。 - heading / pitch / roll 相对**当地东北天（ENU）**坐标系。
- 经纬高元组输入顺序是
[经度, 纬度, 高度]（遵循 GeoJSON），和对象{ longitude, latitude, height }字段顺序相反——混用极易出错。
// 元组：[经度, 纬度, 高度]
viewer.sampleHeight([121.4737, 31.2304])
// 对象
viewer.sampleHeight({ longitude: 121.4737, latitude: 31.2304 })3. 必须确保容器有尺寸
#viewer { width: 100vw; height: 100vh; }容器宽高为 0 时 Viewer 仍会创建，但画面不显示，这是最常见的"白屏"原因。
4. 销毁时机
viewer.destroy() 应放在组件卸载 / SPA 路由切换时调用，不要只挂在 beforeunload（浏览器卸载时同步释放不可靠）：
useEffect(() => {
const viewer = new tellux.Viewer(container, options)
return () => viewer.destroy()
}, [])5. WebGPU 是实验性能力
用 renderer.type: 'webgpu' 时：
- 用
await tellux.Viewer.create(...)（异步工厂），不要用new Viewer(...)后立刻渲染。 - 体积云、SMAA / 抖动在 WebGPU 下不渲染；星空、镜头光晕和 TAA 已支持。
taa默认关闭，LensFlare → TAA 的顺序固定，给 SMAA / 抖动开关赋值没有视觉效果。 - 瓦片 LOD 淡入淡出在 WebGPU 下不可用，瓦片为直接切换。
- WebGPU 不会在不支持的环境自动回退 WebGL，应用层需自行检测。
能力导航
产出代码前，先判断属于哪个领域，读对应的 reference 文件。不要一次性把所有 reference 读进上下文——按需读取，保持精简。
| 用户需求 | 读取的 reference |
|---|---|
| 初始化 Viewer、相机飞行、加影像/地形/3D Tiles/模型/实体、HISM 实例化 | references/core-api.md |
| 大气、光照模式、体积云、后处理、地表材质 | references/scene-effects.md |
| 鼠标事件、拾取坐标 / feature、高度采样 | references/interaction.md |
| 把自定义 Three.js 对象按经纬度放到地球 | references/coordinates.md |
判断不准时，先读 references/core-api.md——它覆盖了 80% 的高频场景。
产出代码的规范
- 完整可运行：包含 import、容器准备、Viewer 创建。不要只给"核心片段"让用户自己拼。
- 文档与 skill reference 使用占位 URL（
https://example.com/...）；可运行示例中的真实服务地址见examples/源码与环境变量配置。 - 配置用领域分组结构：
scene.atmosphere.lighting.mode而不是拍平的atmosphereLightingMode。初始化配置和运行时入口同构（路径一致）。 - 代码后跟简短中文说明：解释关键参数为什么这么取值、有什么副作用，不展开成长篇。
- 标注限制：若用到 WebGPU 下不可用的能力，在说明里点明。
查不到时的兜底
- 公开 API 全量签名：仓库内
src/Viewer.ts、src/types/、src/Camera.ts、src/LayerManager.ts。 - 用户向文档：仓库内
docs/guide/（相机、交互、地形影像、光照、大气效果、数据源、能力边界）和docs/api/types.md（完整ViewerOptions配置项参考）。 - 当本 skill 的 reference 与源码冲突时，以源码为准，并回来更新 reference。
© cyanfish-x, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 4 other files (references) in .agents/skills/tellux of cyanfish-x/tellux.
- SKILL.md
- references/coordinates.md
- references/core-api.md
- references/interaction.md
- references/scene-effects.md
Open the folder on GitHubat commit 16961c8
Compare with similar skills
Tellux next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tellux this skillcyanfish-x/tellux | 207 | — | ~884 | Automated safety check: Pass | MIT | |
| Image to Three.js Modelimg2threejs/img2threejs | 18k | 1 repos | ~8.2k | Automated safety check: Pass | Apache-2.0 | |
| Threejs Gameplay Systemsvalkor-ai/loom | 1.2k | 1 repos | ~1.4k | Automated safety check: Pass | Apache-2.0 | |
| Threejs Gameplay Systemscorosolto/client | 257 | — | ~1.5k | Automated safety check: Pass | AGPL-3.0 | |
| Typegpusoftware-mansion-labs/skills | 291 | 2 repos | ~5.6k | Automated safety check: Pass | None | |
| Tslpmndrs/glyph | 395 | — | ~1.5k | Automated safety check: Pass | MIT |
Similar skills
Threejs Gameplay Systems
valkor-ai/loom
Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…
Threejs Gameplay Systems
corosolto/client
Build and iterate playable Three.js game systems. An agent skill from corosolto/client.
Typegpu
software-mansion-labs/skills
TypeGPU is type-safe WebGPU in TypeScript. An agent skill from software-mansion-labs/skills.
Tsl
pmndrs/glyph
Implement, migrate, review, debug, or verify Three.js Shading Language (TSL) materials, node graphs, WebGPU compute work, and post-processing.
Shader for Interfaces
v2space-labs/shader-for-interfaces
Decides whether an interface effect belongs in CSS, SVG, Canvas 2D, WebGL or WebGPU, then builds, debugs and visually verifies focused GPU effects inside product UIs.
More from cyanfish-x/tellux
Deploy
cyanfish-x/tellux
Deploy tellux examples/docs sites via project scripts — one local command (pnpm run deploy) rclone-syncs to the self-hosted site then Wrangler Direct Uploads to Cloudflare Pages.
Release
cyanfish-x/tellux
Cut and publish a new tellux release — bump version, curate a changelog summary from recent commits, pause for the user to manually pnpm publish (browser 2FA), then push the tag and create the…
Related
Works with
Categories
Questions about Tellux
What does Tellux do?
How to write application code with Tellux (0.3 API shape). An agent skill from cyanfish-x/tellux. Tellux is an agent skill from cyanfish-x/tellux.3 API shape).
When should I use Tellux?
Tellux fits situations like: tasks that involve 3D graphics and WebGL.
How do I install Tellux in Claude Code?
Run `npx skills add cyanfish-x/tellux --skill tellux -a claude-code`. Or copy the skill folder (.agents/skills/tellux in cyanfish-x/tellux) into .claude/skills/tellux in your project. Claude Code loads it when a task matches its description.
How do I install Tellux in Codex?
Run `npx skills add cyanfish-x/tellux --skill tellux -a codex`. Or copy the skill folder (.agents/skills/tellux in cyanfish-x/tellux) into .agents/skills/tellux in your project. Codex loads it when a task matches its description.
Can I use Tellux in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cyanfish-x/tellux --skill tellux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tellux, .gemini/skills/tellux, .github/skills/tellux and .opencode/skills/tellux in your project.
What does Tellux need to run?
Going by SKILL.md and its folder, Tellux needs the command-line tools its instructions call (npm). Our summary lists: Node.js.
Does Tellux access the network?
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Tellux safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Tellux use?
Tellux is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Tellux use?
About 884 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.9k tokens, read only when the agent opens those files.
What are the alternatives to Tellux?
Skills that share tags, products or a category with Tellux: Image to Three.js Model (img2threejs/img2threejs, 18k stars), Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars), Threejs Gameplay Systems (corosolto/client, 257 stars) and Typegpu (software-mansion-labs/skills, 291 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Tellux?
cyanfish-x (a GitHub user) maintains it in cyanfish-x/tellux, which has 207 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 10, 2026.
Source: cyanfish-x/tellux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.