Adom Wiki

@@ -1,7 +1,7 @@ --- name: adom-wiki user-invocable: true-description: "How the Adom Wiki (wiki.adom.inc) actually works, and how to drive it end to end with the adom-wiki CLI. READ THIS FIRST before publishing, hosting source, sharing a tool, or installing from the wiki. Covers the two storage layers (git page repo vs package registry, which are NOT synced), how to host source (push files, never a tarball), how to make a package and cut per-platform releases, the three-tier skill layout (user skills ship; dev-skills/ and publish-skills/ stay source-only), and a decision table. adom-wiki is the current tool; adompkg and any wiki-v1/v2 or *.adom.cloud slug host are DEPRECATED and dead. Triggers: publish to wiki, host source, share/distribute a tool or CLI or skill, make a package, cut a release, Files tab, clone a wiki page, how does the wiki work, wiki.adom.inc, adompkg, dev skills, publish skills, user skills, dev-skills, publish-skills, keep skills out of the tarball, how to structure skills."+description: "How the Adom Wiki (wiki.adom.inc) actually works, and how to drive it end to end with the adom-wiki CLI. READ THIS FIRST before publishing, hosting source, sharing a tool, or installing from the wiki. Covers the two storage layers (git page repo vs package registry, which are NOT synced), how to host source (push files, never a tarball), how to make a package and cut per-platform releases, the three-tier skill layout (user skills ship; dev-skills/ and publish-skills/ stay source-only), and a decision table. adom-wiki is the current tool; adompkg and any wiki-v1/v2 or *.adom.cloud slug host are DEPRECATED and dead. Triggers: publish to wiki, host source, share/distribute a tool or CLI or skill, make a package, cut a release, Files tab, clone a wiki page, how does the wiki work, wiki.adom.inc, adompkg, dev skills, publish skills, user skills, dev-skills, publish-skills, keep skills out of the tarball, how to structure skills, why won't my skill publish, dev skill blocked on publish, confirmed_user_skills, skill in the wrong folder." ---  # How the Adom Wiki works@@ -134,6 +134,27 @@ wiring a release), it is a **dev** or **publish** skill → `dev-skills/` or `publish-skills/`. If a user of the *installed* app would invoke it, it is a **user** skill → `skills/`. +### Publish enforces it (so a dev skill can't leak)++Putting a skill in the wrong folder is the easy mistake — a build/test/release+skill dropped into `skills/` would ship to every install. So `pkg publish`+**reads each `skills/<slug>` SKILL.md and blocks the publish** when one reads like+dev or publish work (its description mentions e.g. "test suite", "cross-compile",+"cut a release", "bump the version"). It names the skill and the fix. The message+is the only thing that catches this — the folder exclusion can't, because the+skill is in the wrong folder.++If it is a false positive — a genuine user skill for a tool that legitimately+talks about tests or releases (e.g. this CLI's own user skill) — confirm it in+package.json. This is the one override, kept in the manifest (never in the+SKILL.md), per-skill:++```json+{ "confirmed_user_skills": ["my-user-skill-slug"] }+```++(or `pkg publish --skip-lint` to bypass all soft checks at once).+ ### Writing a good skill (any type)  - YAML frontmatter with `name` and a rich, **trigger-laden `description`** — the

@@ -1,7 +1,7 @@ {   "slug": "wiki",   "title": "Adom Wiki",-  "version": "3.4.0",+  "version": "3.5.0",   "type": "skill",   "org": "adom",   "description": "How the Adom Wiki (wiki.adom.inc) works and how to drive it with the adom-wiki CLI: the two storage layers (git page repo vs package registry), hosting source by pushing files (not a tarball), making packages, cutting per-platform releases, and the three-tier skill layout (user skills ship, dev-skills/ and publish-skills/ stay source-only). adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.",

@@ -1,6 +1,6 @@ {   "slug": "wiki",-  "version": "3.4.0",+  "version": "3.5.0",   "type": "skill",   "org": "adom",   "org_id": "681d18d2a224243b0d62c9b2",