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, why won't my skill publish, dev skill blocked on publish, confirmed_user_skills, skill in the wrong folder."+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, make a skill for my app, standalone skill package, skill in app repo vs separate package." ---  # How the Adom Wiki works@@ -85,6 +85,24 @@ hints**: each carries a ready-to-run `cmd` for the next step.  ## Skill types: the three-tier layout (user, dev, publish) +### First: a skill in an app, or a standalone skill package?++Before the three tiers, one decision people get wrong constantly. When you make+"a skill for my app", it belongs **inside that app's repo** as+`skills/<name>/SKILL.md` — it ships with the app and shows on the app's Skills+tab. **Do NOT create a separate wiki package/page for it.** A standalone skill+package (its own page, its own `pkg publish`) is only for a **reusable skill that+many apps or agents share** (e.g. `adom/google`, or this `adom/wiki` skill).++- Skill belongs to one app → a file in that app's repo (`skills/<name>/SKILL.md`).+- Skill is general / reused across apps → its own standalone skill package.++`pkg init --type skill` and the first `pkg publish` of a standalone skill both+emit an `APP_SKILL_LOCATION` hint reminding you of this, because the default AI+move — spinning up a separate skill repo for an app — is almost always wrong.++### The three tiers (within an app)+ Every app should ship a skill, but not every skill you write should reach the people who install the app. Skills come in **three types**, sorted by a top-level directory. The directory IS the type — nothing about the type goes in the@@ -174,6 +192,7 @@ SKILL.md), per-skill: | Browse / share source | push files to the repo, link the Files tab; do NOT attach a tarball | | Get a local copy of source | `adom-wiki repo clone <owner>/<slug>` | | Distribute an installable (CLI + skills) | `adom-wiki pkg publish`, consumers `adom-wiki pkg install` |+| Make a skill for your app | put it in the app's repo as `skills/<name>/SKILL.md`; do NOT create a separate skill package (that's only for reusable, cross-app skills) | | Keep a build/debug/test or publish skill out of installs | put it in `dev-skills/` or `publish-skills/`; it stays in source, never in the tarball | | Host a downloadable binary (e.g. Windows installer) | `adom-wiki release upload <ref> <ver> <file> --platform <os>` | | Re-ship a new version | bump `version` in package.json, `adom-wiki pkg publish` |

@@ -1,7 +1,7 @@ {   "slug": "wiki",   "title": "Adom Wiki",-  "version": "3.5.0",+  "version": "3.6.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.5.0",+  "version": "3.6.0",   "type": "skill",   "org": "adom",   "org_id": "681d18d2a224243b0d62c9b2",