omni-lessons
Turn what a session learned — a trap, a rule, a working recipe — into a durable update of the right marketplace skill through Omni, instead of a note in one project. Use when the user says "remember this", "add this to the skill", "we should note that", or at the end of a task that changed how something should be done.
- License 许可
- MIT
- 所属仓库
- suarja/omni
- 最近更新
- 2026-10-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- omni-lessons
- description
- Turn what a session learned — a trap, a rule, a working recipe — into a durable update of the right marketplace skill through Omni, instead of a note in one project. Use when the user says "remember this", "add this to the skill", "we should note that", or at the end of a task that changed how something should be done.
03 SKILL.md 正文
From a lesson to a skill
A lesson kept in one project's notes is lost for the next project. Omni keeps the marketplace as the single source of truth: update the skill there, and every project that carries it can take the update.
Steps
- State the lesson in one or two sentences: the situation, what failed or worked, the rule that follows. Ask the user to confirm the wording when it changes a rule.
omni_find_skill { query }— find the skill that should hold it. If none fits, useomni-marketplace-routingto decide where a new skill belongs.- Read the current skill body (the
findresult gives its path; the user's project copy is fine to read) and place the lesson in its natural section — a rule under "Rules", a trap under "Pitfalls", a step in the sequence. Keep the skill's voice and length. omni_preview_update_skill { sourceId, packageId, folderName, files, reason }with the full updatedSKILL.md; thereasonis the lesson in one line (it becomes the commit message context).- Present the diff summary from the plan, then apply the consent rule below. Existing clear approval for that exact plan counts; do not ask again.
- After the receipt,
omni_drift_reportfor the projects that carry the skill: they now showupdate; offer to apply it where the user works.
Rules
- One lesson per update; small diffs are reviewable diffs.
- Never rewrite the whole skill to add a line.
Use the packageId returned by omni_list_marketplace or omni_find_skill,
for example packages/<name>. The short package name also works. Previews and
receipts keep the canonical observed id.
Consent
<!-- Generated from packages/omni-skills/consent.md. -->
For ordinary skill changes, previously given clear approval for this exact plan counts; do not ask again. If approval is not already clear, present the plan and wait for a clear yes; no or unclear means do nothing. For approval: "omni": Approval happens in Omni for the reason returned with the preview. Tell the user in one line, then call omni_apply; it returns pending while the request waits. Call it again with the same requestId; the request does not expire. If the user approves in Omni later, omni_receipt shows the result. Route every write through Omni preview, omni_apply, and its receipt.
For sharing or publishing, follow omni-share; author and fix skills only in the active workshop, never in a storefront.
Install external skills through Omni using omni_list_external_library, omni_preview_install_external, omni_apply and its receipt; never run npx skills add directly.
Managed files
Never edit a skill folder, a plugin or marketplace manifest, or the personal marketplace
directly — Omni's guard refuses it. Use omni_preview_update_skill, omni_preview_capture, or
omni_preview_assign to plan the change, then omni_apply using the user's existing clear authorization for that exact change.
04 同仓库更多 Skills
review
暂无简介
omni-summarize
Summarize what an agent session did, or what a receipt changed, in one factual paragraph. Use when the user asks what an agent session did, or what a receipt changed.
omni-suggest
Suggest marketplace skills that fit this project's detected stack, add the chosen ones through Omni with consent, then offer to assign them to the project. Use when the user asks what skills would help this project, what to install, or how to improve the agent setup.
omni-skill-authoring
Create or update a skill in the user's Omni marketplace through the Omni MCP tools instead of writing SKILL.md files by hand. Use when the user asks to create, write, add, improve or update a skill, or to turn a lesson into a skill.
omni-share
Share a workshop plugin through a public storefront using Omni. Use when the user says "share this plugin", "share this skill", "publish", "make a marketplace for a person, team or vertical", "lead magnet", or "storefront".
omni-project-sync
Assign marketplace skills to projects, detect drift between a project's copies and the marketplace, and resolve it through Omni's previewed operations. Use when the user asks to install, add, sync, update or check skills in a project, or when a project's skills look out of date.