К основному содержанию
скилл CX Codex

steve-step-import — скилл для Claude Code: STEP-геометрия

Скилл steve-step-import для Claude Code помогает импортировать STEP-геометрию и добавлять к ней CAD-функции. Загружается для изменения импортированной детали, сборки из частей или ремонта функций, привязанных к номерам граней.

Apache-2.0 ★ 86 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add stevecad/steve --skill steve-step-import -a claude-code
Открыть на GitHub

Что делает steve-step-import

Скилл объясняет, как импортировать STEP-файлы в Steve, выбирать отдельные тела и строить новые функции поверх импортированной геометрии. Он описывает работу с гранями по номерам и геометрическими селекторами, которые повторно находят подходящие рёбра после перестановки граней. Номера граней меняются при замене файла, поэтому постоянные ссылки на номера могут сломаться.

Для импорта используются локальные CAD-инструменты Steve: cad_read, cad_build, cad_inspect и cad_api_reference; произвольный STEP-файл импортируется через локальный интерфейс Import. Исходную геометрию импортированного тела изменить нельзя: к нему можно добавлять функции, выполнять вырезы или перестраивать его нативно. Ошибки импорта включают неизвестный импорт, нечитаемый файл, файл без тел и недопустимый индекс тела.

Какие задачи решает

  • импортировать STEP-файл в модель Steve
  • добавить вырез или скругление к импортированному телу
  • связать эскиз с гранью STEP-модели
  • исправить функцию, сломанную после замены STEP-файла
  • разместить одну импортированную деталь в нескольких местах сборки

Примеры запросов агенту

  • Импортируй STEP-файл и добавь вырез в импортированное тело.
  • Исправь скругление, которое сломалось после обновления STEP-файла.
  • Собери модель из нескольких деталей STEP и размести повторяющиеся компоненты.

Как установить steve-step-import

1Через Skills CLI (Vercel)

npx skills add stevecad/steve --skill steve-step-import -a claude-code

2Вручную: положить файлы

~/.claude/skills/steve-step-import/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/steve-step-import/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о steve-step-import

Как установить steve-step-import в Claude Code?

Выполни npx skills add stevecad/steve --skill steve-step-import -a claude-code. Файл скилла появится по пути ~/.claude/skills/steve-step-import/SKILL.md.

Что делает steve-step-import?

Скилл помогает импортировать STEP-геометрию, добавлять к ней CAD-функции и выбирать грани. Для ссылок, устойчивых к изменению нумерации, он описывает геометрические селекторы.

Почему ссылки на грани STEP-модели ломаются?

Номера граней могут измениться, когда STEP-файл заменяют. Для функций, которые должны пережить такую замену, скилл описывает выбор рёбер по геометрии.

Исходный текст

SKILL.md · Apache-2.0
---
name: steve-step-import
description: >-
  Imported STEP geometry: import_step, file-order face names (import_1.face(n)), adding features to imported bodies, and selector references that survive renumbered faces. Load when a part contains import_step or the person wants to change an imported file, or when a feature on numbered faces (import_1.face(n), model.add's code_1.face(n)) broke after an upstream change. Also load before bringing many parts or a whole assembly in from another CAD system.
---

## Steve execution rules

This skill adapts Steve Studio's CAD guidance for Steve running locally. The modeling
examples below describe the shared CAD runtime. These local execution rules take
precedence over upstream service workflows and tool names in that reference.

- Read the active document with `cad_read`; inspect built geometry with `cad_inspect`.
  Do not guess persistent face names, document shapes, revision IDs or import hashes.
- Apply source changes with `cad_build(document=..., expected_revision=...)`, preserving
  the document schema returned by `cad_read`. Use `cad_set_parameters` for parameter
  changes. Inspect the build result and errors before reporting success.
- `cad_api_reference` provides installed Model, Sketch, Component and Design signatures.
  The installed runtime and available tool schemas are authoritative if reference
  examples describe newer or unavailable capabilities.
- Export built geometry using `cad_export` with the current revision and a supported
  format. Drawing PDF/SVG/DXF workflows are available in the drawing UI; do not claim
  the geometry export tool exports drawings unless its schema supports that.
- Find standard parts or locally imported McMaster parts with `cad_find_parts`, then
  cache a part using `cad_import_catalog_part`. Use the returned import hash with
  `Model.import_step`. Import arbitrary STEP files through the local Import UI.
- `cad_source_package` reads a transferable source package; `cad_import_package`
  imports supplied root and dependency documents locally. These do not publish.
- Upstream `read_part`, `edit_part`, `read_design`, `inspect_model`, upload-ticket,
  workspace/server/document-ID and cloud export instructions are reference context,
  not available local commands. Use the local tools above. Do not sign in to Studio,
  upload, publish, or call a connected Studio MCP merely to perform local CAD.
- SaaS upload quotas are not local limits. Simulation, electronics, CAM, teams and
  cloud jobs are outside this local CAD skill. Do not invent their availability.
  References to unbundled skills do not imply those features are installed.

## Upstream CAD reference



# Imported STEP geometry

People import STEP files from the toolbar (or by dropping a file). The import becomes a feature
that names the upload by its content hash:

```python
model.import_step("import_1", "3f2a…(sha256)", name="Bracket", op="new", solids=None)
```

- `list_imports` shows the STEP files uploaded to this workspace and `insert_import` places one into a part or
  design. An agent outside STEVE uploads a file from its machine (or one it converted, e.g. from a mesh) with
  `request_upload(filename, size_bytes, sha256)` and runs the command it returns: a one-time ticket for that exact
  file. STEVE in the app asks the person to upload it (File → Import…, or drop it on the window). Never upload
  through a browser.
- `op="new"` (the default) adds one body per solid: `import_1` for one solid, `import_1_1`,
  `import_1_2`, … for several.
- `op="join"`, `"cut"` or `"intersect"` combine every imported solid with the target body.
- `solids=[k, …]` imports only those solids (1-based, file order).

## Many parts or a whole assembly

Each upload takes one ticket, at most 60 an hour per workspace (more returns 429 `too_many_tickets`);
re-requesting a file that is already uploaded returns `already_uploaded` and takes none. So don't upload
one file per part:

- Export the parts together as one STEP (or a few, up to 20 GB each) and give each component its own
  solid of it: `bracket.import_step("import_1", sha, name="Bracket", solids=[3])` in
  `components/bracket.py` (load steve-designs). The upload result and list_imports give `solid_names`,
  the file's solids in order; map them to components before writing.
- One build can use at most 1024 imported files and 20 GB of them together, counting every component and
  linked document it builds, so keep the split to a few files.
- Import each distinct part once, as a component, and place it as many times as it appears with
  `design.add(..., name=..., at=...)` or `design.pattern`, not one import per placed copy.
- Rename imported names before writing them: component ids and joint, coupling and fit check
  names are lowercase letters, digits and underscores (`Bracket__Left_Mount` → `bracket_left_mount`), and file names at most 64 characters.
  Keep a table of old → new names in a data file if the person needs to map them back.

## Face names

- Faces are named in file order: `import_1.face(12)`, or `import_1.solid(2).face(3)` when the
  file has several solids. Groups: `import_1.faces`, `import_1.solid(2).faces`.
- These names survive later features, so you can fillet imported edges, sketch on imported faces,
  cut into imported bodies and move them:

```python
with model.sketch("sketch_1", on="import_1.face(4)") as s:
    s.circle("c1", (0, 0), 3)
model.extrude("cut_1", "sketch_1", distance=-5, op="cut")
model.fillet("fillet_1", edges=["edge(import_1.face(4)|import_1.face(7))"], radius=1)
```

- There is no feature history inside an imported solid: you can't change its original dimensions,
  only add features to it, cut it, or remodel it natively.
- Use `inspect_model` and the selection context (the person's picks name faces like
  `import_1.face(n)`) to find the right face. Don't guess numbers.
- Face numbers change when the file is replaced (and `model.add` numbers change when its code
  adds or removes faces), breaking `edge(import_1.face(4)|import_1.face(7))`. For features that
  should survive that, reference the geometry instead; it is re-resolved at every build:

```python
model.chamfer("chamfer_1", edges=cq.selectors.BoxSelector((-1, -1, 19), (1, 1, 21))
              & cq.selectors.TypeSelector("CIRCLE"), distance=1.5)        # the circle centred at (0, 0, 20)
model.fillet("fillet_2", edges=['select(edges, "%CIRCLE and >Z", on="import_1")'], radius=1)
```

  `BoxSelector` matches by centre position; combine with `&`, `+`, `-`. `on=` limits a string
  selector to one body (or a feature's faces). Make selectors specific (position plus type), and
  check the feature's `detail.edges` count: a broad one can match new edges after a change.

## Errors

These are recorded on the feature, and later features still run:
- an unknown import;
- an unreadable file;
- a file with no solids (surfaces only);
- a solid index out of range.

`detail` reports `solids`, `imported`, `bodies`, `faces` and the file's `names`, one per solid in file order: the
body's own name, as `Component / Body` when its component holds several bodies, else the component's. Imported bodies
show those names until you give one with `model.body_name`, which wins. To
convert an imported flat plate to sheet metal, load `steve-sheet-metal` (`sheet_convert`).

© stevecad · Apache-2.0 · stevecad/steve

Похожие скиллы

Каталог скиллов SKILL.md →
ace-step prime-skills Генерирует музыку через ACE Step на RunComfy по тегам жанра, настроения и инструментов. Работает через runcomfy CLI — от 5 секунд до 4 минут стерео за $0.0002–0.0003 в секунду. CX Codex +1 379 200установок steve-jobs-design-review wondelai Скилл steve-jobs-design-review для Claude Code и Cursor проводит аудит интерфейса или продукта по стандартам Стива Джобса: сокращает лишние функции и оценивает клиентский путь без скидок на компромиссы. CX Codex +1 3 800установок step-parts earthtojake Ищет детали в каталоге step.parts по имени, стандарту или размеру и отдаёт канонический .step вместо упрощённой геометрии в сборке. CX Codex +1 12 000установок processing-s3-uploads-with-step-functions aws Скилл processing-s3-uploads-with-step-functions развёртывает обработку загрузок в S3: небольшие файлы отправляет в Lambda, крупные — в Fargate через Step Functions. CX Codex +1 5 800установок aws-step-functions aws Пишет и правит определения AWS Step Functions на Amazon States Language: типы состояний, JSONata, Retry/Catch, Distributed Map. CX Codex +1 4 700установок tao-train-single-step NVIDIA Corporation Скилл tao-train-single-step для Claude Code запускает стандартный пайплайн обучения, оценки и экспорта моделей NVIDIA TAO без циклов AutoML. Выполняет одиночное дообучение на размеченном датасете. CX Codex +1 1 600установок

Из того же набора9

steve-surfaces Скилл steve-surfaces для Claude Code помогает строить свипы, лофты и поверхности в CAD-модели. Подключается перед созданием или изменением этих объектов и превращением поверхностей в тела. CX Codex +1 ★ 86звёзд репо steve-standard-parts Скилл steve-standard-parts для Claude Code находит готовые детали в каталоге step.parts и добавляет крепежи в CAD-модели. Запускается перед сборкой узлов и заменой временных заглушек. CX Codex +1 ★ 86звёзд репо steve-materials Скилл steve-materials для Claude Code задаёт материалы и внешний вид деталей в CAD-модели. Загружайте его перед назначением материала, расчётом массы или добавлением изображения на поверхность. CX Codex +1 ★ 86звёзд репо steve-sheet-metal Скилл steve-sheet-metal для Claude Code помогает создавать детали из листового металла средствами Steve CAD. Он подключается перед кодом с функциями sheet_*, чтобы задавать правила листа и строить его элементы. CX Codex +1 ★ 86звёзд репо steve-motion Скилл steve-motion для Claude Code задаёт движение деталей в CAD-проекте. Подключается, когда нужно добавить шарниры, передачи, анимацию или вид со взрыв-схемой. CX Codex +1 ★ 86звёзд репо steve-designs Скилл steve-designs для Claude Code описывает проектирование сборок из нескольких компонентов. Он подключается при создании модели типа design, проверке посадки деталей и работе с крупной сборкой. CX Codex +1 ★ 86звёзд репо steve-blender Скилл steve-blender для Claude Code создаёт Blender-сцены на Python через bpy. Он подключается перед работой с Blender-документом: написанием, правками или ревью. CX Codex +1 ★ 86звёзд репо steve-drawings Скилл steve-drawings для Claude Code создаёт инженерные чертежи для изготовления. Подключается к задачам по созданию, правке или разбору чертежа, штампа, таблицы ревизий, спецификации или карты раскроя. CX Codex +1 ★ 86звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой