Skip to content
Skills Library
Other · Automation

edit

/edit

List a Project's objects with editable values, units and frames, then apply edit operations by object ID with explicit units, checked by the engine and written atomically to a new file (optionally run). Use it to change a design reproducibly.

Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

List a Project's objects with editable values, units and frames, then apply edit operations by object ID with explicit units, checked by the engine and written atomically to a new file (optionally run). Use it to change a design reproducibly.

Original author description

List a Project's objects with editable values, units and frames, then apply edit operations by object ID with explicit units, checked by the engine and written atomically to a new file (optionally run). Use it to change a design reproducibly.

How it works

  1. When to use
  2. When not to use
  3. Inputs
  4. Outputs
  5. Minimal example
  6. Limits
  7. Version
Original SKILL.md headings · 59 lines, 307 words
SKILL.md preview
---
name: edit
description: List a Project's objects with editable values, units and frames, then apply edit operations by object ID with explicit units, checked by the engine and written atomically to a new file (optionally run). Use it to change a design reproducibly.
version: 0.2.0
command: os-optics-kit edit
requires: os-optics>=0.13,<0.14
kind: tool
---

# edit

## When to use

- Find object IDs, current values, units, frames and supported operations: `--describe [--ids A,B]`.
- Move, rotate or re-parameterize components, sources, observation planes or targets by ID.
- Retry safely: a repeated identical edit reports `ALREADY_APPLIED` and writes nothing.

## When not to use

- Many values of one parameter: use `sweep`.
- Reading results only: use `summary`.

## Inputs

- `BASE.json`: a Project (never modified).
- `--edits EDITS.json`: a list of operations (or `{"ops": [...]}`): `set_component_pose`,
  `set_source_model`, `set_observation_pose`, `set_target`, `set_component_product`, add/remove ops,
  and `transform` (`selector`, `translation_mm`, `rotation`, `frame` `"design"` or `{"component": ID}`,
  `pivot`). Numbers are in the field's unit (name suffix `_mm`, `_nm`, `_w`, `_deg`) or
  `{"value": x, "unit": "um"}`; unknown or incompatible units are refused.
- `--out NEW.json`; optional `--run RUN_DIR`, `--changes FILE`, `--overwrite`, `--expect-base-hash H`.

## Outputs

`NEW.json` (normalized, engine-checked) and `NEW.changes.json` (operations as given and normalized,
before/after values, base and output hashes). Stdout: one JSON document; status `EDITED`,
`ALREADY_APPLIED` or `DESCRIBED`, with `--run` the run's outcome.
Exit 0 edited / described; with `--run` 1 FAIL, 2 UNKNOWN, 3 out of model scope; 4 refused edit or
invalid input (JSON error on stderr with the operation index and code).

## Minimal example

`edits.json`:

```
[{"op": "transform", "selector": {"ids": ["L1"]}, "frame": {"component": "L1"},
  "translation_mm": [0, 0, {"value": 500, "unit": "um"}]}]
```

```
os-optics project example --kind focus > project.json
os-optics-kit edit project.json --describe --ids L1
os-optics-kit edit project.json --edits edits.json --out moved.json --run run-moved
```

The moved lens misses the `focus_position` target: status FAIL, exit 1.

## Limits

- Every operation applies to the unchanged base; an edit the engine refuses writes nothing.
- Workspace frames (`{"group": ID}`) need a workspace; Project files have none (`FRAME_INVALID`).
- `--describe` bands are advisory; the engine run decides validity.

## Version

0.2.0 (os-optics-kit 0.2.0), verified with os-optics 0.13.0 and catalog release 2026-10-28.1.

Versions

RepositoryScoreLicence
This page · JunLin615/os-optics-kit100MIT
bankielewicz/mod-builder100MIT
jakeschincariol/master-skills100MIT
yyu0310/ai-slide-maker96MIT
langri-sha/skills95MIT
gagoar/iceberg87MIT

Database snapshot: 13.11.2026 · package version 9c1ea75d7547 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100apply-patch
    Apply multi-file or tricky edits atomically with git apply instead of many fragile edit_file calls. Use when changing several files at once or when edit_file fails to match.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.