All documentation

Editor

The editor is where skills change and grow. It works like a small publishing system: you edit a working copy, and when you like the result you publish a version. The version history is kept forever, and you can go back to any of them.

The working copy

Pick a skill and its text opens. Every edit goes into a draft without touching the published version:

  • the “modified” mark — the draft differs from the current version; “same as current” — no edits;
  • Show changes — a highlight of what you changed relative to the current version;
  • Discard edits — return the draft to the current version if the experiment failed.

You can edit and close the app at any time — the draft stays where it is, and the copies installed into your AI tools do not change until you publish and update them.

Publishing a version

When the draft is ready:

  1. Press Publish version.
  2. Give it a number in MAJOR.MINOR.PATCH form (1.2.0, for example). The rule is simple: the third number is small fixes, the second is new capabilities, the first is a big rework. onplate checks the format and will not let you duplicate an existing version.
  3. Fill in “What changed” — a couple of lines for the history. In a month you will thank yourself.

Publishing fixes the version in the history. Installed copies are not updated by themselves — in Bindings they get a “newer available” mark, and you decide when to update.

Version history and rollback

The Version history block shows every publication: the number, the date and the changelog. The current one is marked. The Roll back button brings any past version back — useful when a new edition of a skill works worse.

Comparing versions

The Compare versions block: pick “From version” and “To version” and you see exactly what changed between them. Instead of a version you can pick the draft and compare it with any publication. If there are no differences, it says so: “No changes”.

Skill metadata

A separate form for the properties of the skill:

  • Name (slug) — the unique identifier; install paths are built from it;
  • Title and description — what both a human and an AI see when picking the skill;
  • Author;
  • Compatibility and target AI tools — which tools the skill works with;
  • Permissions — the list of what the skill is allowed to do.

The Save metadata button applies the changes.