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, 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."+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." ---  # How the Adom Wiki works@@ -83,6 +83,35 @@ adom-wiki repo clone <owner>/<slug>          # browse / get the source Add `--json` to any command for a `{ status, data, hints[] }` envelope. **Read the hints**: each carries a ready-to-run `cmd` for the next step. +## Skills: the three-tier layout (user vs dev vs publish)++Every app should ship a skill, but not every skill you write should reach the+people who install the app. Sort skills into three top-level directories; the+directory IS the tier (nothing goes in the SKILL.md frontmatter):++| Directory | Tier | Who it is for | Ships in the install tarball? |+|---|---|---|---|+| `skills/` | **User** | everyone who installs the app (user-invocable) | YES |+| `dev-skills/` | **Dev** | whoever checks out the source: build, debug, test | NO (source-only) |+| `publish-skills/` | **Publish** | app -> wiki glue: how to publish/release THIS app | NO (source-only) |++`adom-wiki pkg publish` / `pkg pack` **auto-exclude `dev-skills/` and+`publish-skills/` from the tarball** — you no longer have to remember to strip+them. They stay in the source tree, so `adom-wiki repo push` keeps them on the+page (the Files tab and the Skills tab show all three tiers); only `skills/`+installs for consumers. Every pack/publish echoes a `SKILL_LAYOUT` hint telling+you exactly what shipped vs what stayed source-only.++Rule of thumb: if a skill is only useful with the source in front of you (running+the build, wiring the release), it is a dev or publish skill — put it in+`dev-skills/` or `publish-skills/`. If a user of the installed app would invoke+it, it is a user skill — put it in `skills/`.++Writing a good user skill: give it YAML frontmatter with `name` and a rich,+trigger-laden `description` (the phrases a user would actually say), `user-invocable: true`,+and a body that teaches the fastest path, not an exhaustive reference. One skill =+one clear job.+ ## Decision table  | You want to | Do this |@@ -91,6 +120,7 @@ hints**: each carries a ready-to-run `cmd` for the next step. | 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` |+| 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` | | Remove a superseded asset | `adom-wiki release delete-asset <ref> <ver> <file>` |@@ -103,3 +133,5 @@ hints**: each carries a ready-to-run `cmd` for the next step. - Assuming `pkg install` drags down every page asset. It fetches one per-platform   tarball. - Re-supplying title/hero/body to bump a version. Metadata lives in package.json.+- Dumping build/debug/publish skills into `skills/` so they ship to every install.+  Put them in `dev-skills/` or `publish-skills/` — publish auto-keeps them out.

@@ -1,11 +1,27 @@ {   "slug": "wiki",   "title": "Adom Wiki",-  "version": "3.2.0",+  "version": "3.3.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, and cutting per-platform releases. adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.",+  "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.",   "tags": ["wiki", "cli", "packages", "registry", "publishing", "guide"],+  "discovery_triggers": [+    "how does the wiki work",+    "publish to the wiki",+    "host my source on the wiki",+    "share a tool or skill",+    "make a package",+    "cut a release",+    "keep dev skills out of the tarball",+    "how to structure skills"+  ],+  "discovery_pitch": "Read this before you publish, host source, share a tool, or install from wiki.adom.inc: the two storage layers, source vs release, and the three-tier skill layout.",+  "sample_prompts": [+    { "label": "Publish a tool", "prompt": "How do I publish my CLI to the Adom wiki so people can install it?" },+    { "label": "Host source", "prompt": "How do I put my project's source on its wiki page?" },+    { "label": "Structure skills", "prompt": "Where do I put dev and publish skills so they don't ship to everyone who installs my app?" }+  ],   "dependencies": {},   "scripts": {     "install": "./install.sh",

@@ -1,10 +1,10 @@ {   "slug": "wiki",-  "version": "3.2.0",+  "version": "3.3.0",   "type": "skill",   "org": "adom",   "org_id": "681d18d2a224243b0d62c9b2",-  "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, and cutting per-platform releases. adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.",+  "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.",   "dependencies": {},   "scripts": {     "install": "./install.sh",@@ -28,15 +28,28 @@     "path": "screenshots/hero.png"   },   "discovery_triggers": [-    "how the wiki works",+    "how does the wiki work",     "publish to the wiki",-    "host source on the wiki",-    "distribute a tool or cli",-    "make a wiki package",+    "host my source on the wiki",+    "share a tool or skill",+    "make a package",     "cut a release",-    "files tab",-    "clone a wiki page",-    "install from the wiki",-    "adompkg"+    "keep dev skills out of the tarball",+    "how to structure skills"+  ],+  "discovery_pitch": "Read this before you publish, host source, share a tool, or install from wiki.adom.inc: the two storage layers, source vs release, and the three-tier skill layout.",+  "sample_prompts": [+    {+      "label": "Publish a tool",+      "prompt": "How do I publish my CLI to the Adom wiki so people can install it?"+    },+    {+      "label": "Host source",+      "prompt": "How do I put my project's source on its wiki page?"+    },+    {+      "label": "Structure skills",+      "prompt": "Where do I put dev and publish skills so they don't ship to everyone who installs my app?"+    }   ] }\ No newline at end of file