image-to-relief-stl
Turn a source image (or multi-color mask image) into a 3D-printable bas-relief STL by mapping colors (or grayscale) to heights. Use when you have an image from an image-gen skill (nano-banana-pro, etc.) and want a real, printable model (STL) via a deterministic pipeline.
Best use case
image-to-relief-stl is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Turn a source image (or multi-color mask image) into a 3D-printable bas-relief STL by mapping colors (or grayscale) to heights. Use when you have an image from an image-gen skill (nano-banana-pro, etc.) and want a real, printable model (STL) via a deterministic pipeline.
Teams using image-to-relief-stl should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/image-to-relief-stl/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How image-to-relief-stl Compares
| Feature / Agent | image-to-relief-stl | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Turn a source image (or multi-color mask image) into a 3D-printable bas-relief STL by mapping colors (or grayscale) to heights. Use when you have an image from an image-gen skill (nano-banana-pro, etc.) and want a real, printable model (STL) via a deterministic pipeline.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# image-to-relief-stl Generate a **watertight, printable STL** from an input image by mapping colors (or grayscale) to heights. This is an orchestrator-friendly workflow: - Use **nano-banana-pro** (or any image model) to generate a **flat-color** image. - Run this skill to convert it into a **bas-relief** model. ## Practical constraints (to make it work well) Ask the image model for: - **exactly N solid colors** (no gradients) - **no shadows / no antialiasing** - bold shapes with clear edges That makes segmentation reliable. ## Quick start (given an image) ```bash bash scripts/image_to_relief.sh input.png --out out.stl \ --mode palette \ --palette '#000000=3.0,#ffffff=0.0' \ --base 1.5 \ --pixel 0.4 ``` ### Grayscale mode ```bash bash scripts/image_to_relief.sh input.png --out out.stl \ --mode grayscale \ --min-height 0.0 \ --max-height 3.0 \ --base 1.5 \ --pixel 0.4 ``` ## Outputs - `out.stl` (ASCII STL) - optional `out-preview.svg` (vector preview via potrace; best-effort) ## Notes - This v0 uses a **raster heightfield** meshing approach (robust, no heavy CAD deps). - The `--pixel` parameter controls resolution (smaller = higher detail, bigger STL).
Related Skills
alphashop-image
AlphaShop（遨虾）图像处理 API 工具集。支持11个接口：图片翻译、图片翻译PRO、 图片高清放大、图片主题抠图、图片元素识别、图片元素智能消除、图像裁剪、 虚拟试衣（创建+查询）、模特换肤（创建+查询）。 触发场景：图片翻译、翻译图片文字、放大图片、高清放大、抠图、去背景、 检测水印/Logo/文字、消除水印、去牛皮癣、裁剪图片、虚拟试衣、AI试衣、 模特换肤、换模特、AlphaShop图像、遨虾图片处理。
image-gen
Generate AI images from text prompts. Triggers on: "生成图片", "画一张", "AI图", "generate image", "配图", "create picture", "draw", "visualize", "generate an image".
🎨 Pollinations Image Generation Skill
A clean, modular, and user-friendly image generation tool powered by [Pollinations.ai](https://pollinations.ai).
doubao-image-gen
使用豆包 Seedream 模型文生图，支持并发批量生成，输出图库预览页
rynjer-image-generation
No description provided.
image-understanding
使用智谱AI的GLM-4V-Flash免费多模态API理解图片内容。当用户需要理解图片内容、描述图片、识别图中物体时使用此skill。
openai-image-gen
Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
feishu-image-sender - 飞书图片发送技能
**智能图片发送工具，支持系统截图、本地图片发送，自动处理大图片压缩和双版本发送。**
chatgpt-image-generation
Generate images from ChatGPT using Playwright browser automation. Opens ChatGPT, sends prompts, waits for generation, and saves the resulting images.
IMA Image Generator
AI image generator and photo generator with SeeDream 4.5, Midjourney, Nano Banana 2, and Nano Banana Pro. Generate AI images for posters, thumbnails, logos, art, illustrations, product photos, and social media graphic design. Text-to-image and image-to-image AI generation with intelligent model selection and knowledge base support. AI poster generator, AI thumbnail generator, AI logo generator, AI art generator, AI illustration generator, product photo generator, and social media image generator in one unified tool. Supports 1K/2K/4K resolution and custom aspect ratios. Better alternative to DALL-E, Stable Diffusion, or standalone image generation skills. Requires IMA_API_KEY.
IMA Nano Banana Image Generator
Nano Banana-only image generation on IMA Open API. Supports text_to_image and image_to_image with gemini-3.1-flash-image (budget) and gemini-3-pro-image (premium). Deterministic size/ratio mapping, 512/1K/2K/4K resolution. Requires IMA_API_KEY.
image-duplication-detector
Detect image duplication and tampering in manuscript figures using computer vision algorithms