From 0bf62a37a0572c2f46cbbc523a93e7db3a263c39 Mon Sep 17 00:00:00 2001
From: Bob <bob@dutifulbob.com>
Date: Fri, 20 Feb 2026 18:13:59 +0100
Subject: [PATCH 1/2] chore: upgrade skillflag to 0.1.4, update README with
 badges and --skill install

---
 README.md         | 14 ++++++++++++--
 package-lock.json | 30 ++++++++++++++++++++++++++----
 package.json      |  2 +-
 3 files changed, 39 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index a1c1d1f..2f59eee 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
 # SimpleDoc
 
+[![npm version](https://img.shields.io/npm/v/@simpledoc/simpledoc.svg)](https://www.npmjs.com/package/@simpledoc/simpledoc)
+[![npm downloads](https://img.shields.io/npm/dm/@simpledoc/simpledoc.svg)](https://www.npmjs.com/package/@simpledoc/simpledoc)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 > Lightweight standard for organizing Markdown documentation in codebases
 
 SimpleDoc defines a small set of rules for the naming and placement of Markdown files in a codebase, agnostic of any documentation framework.
@@ -40,10 +44,16 @@ Configuration for tooling can be shared in `simpledoc.json` and overridden per-u
 
 ## Install
 
-Install the bundled agent skill + `AGENTS.md` instructions (no doc migrations):
+Install the bundled agent skill (interactive wizard picks your agent and scope):
+
+```bash
+npx -y @simpledoc/simpledoc --skill install simpledoc
+```
+
+Or install without interaction:
 
 ```bash
-npx -y @simpledoc/simpledoc install
+npx -y @simpledoc/simpledoc --skill install simpledoc --agent codex --scope repo
 ```
 
 ## Migrate
diff --git a/package-lock.json b/package-lock.json
index f576c9a..ef910f2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -11,7 +11,7 @@
       "dependencies": {
         "@clack/prompts": "^0.11.0",
         "commander": "^11.0.0",
-        "skillflag": "^0.1.3"
+        "skillflag": "^0.1.4"
       },
       "bin": {
         "simpledoc": "dist/bin/simpledoc.js"
@@ -3690,11 +3690,12 @@
       "license": "MIT"
     },
     "node_modules/skillflag": {
-      "version": "0.1.3",
-      "resolved": "https://registry.npmjs.org/skillflag/-/skillflag-0.1.3.tgz",
-      "integrity": "sha512-hMMFarrI8KhOUsSjtl7/8tvkI9du0lp1ZXyV+aL4/wzmpI0FxBFs0PkRNuu0MecX9LXXb8mYUMyiDhTLCuI7Cw==",
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/skillflag/-/skillflag-0.1.4.tgz",
+      "integrity": "sha512-egFg+XCF5sloOWdtzxZivTX7n4UDj5pxQoY33wbT8h+YSDjMQJ76MZUg2rXQIBXmIDtlZhLgirS1g/3R5/qaHA==",
       "license": "MIT",
       "dependencies": {
+        "@clack/prompts": "^1.0.1",
         "tar-stream": "^3.1.7"
       },
       "bin": {
@@ -3705,6 +3706,27 @@
         "node": ">=18"
       }
     },
+    "node_modules/skillflag/node_modules/@clack/core": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@clack/core/-/core-1.0.1.tgz",
+      "integrity": "sha512-WKeyK3NOBwDOzagPR5H08rFk9D/WuN705yEbuZvKqlkmoLM2woKtXb10OO2k1NoSU4SFG947i2/SCYh+2u5e4g==",
+      "license": "MIT",
+      "dependencies": {
+        "picocolors": "^1.0.0",
+        "sisteransi": "^1.0.5"
+      }
+    },
+    "node_modules/skillflag/node_modules/@clack/prompts": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@clack/prompts/-/prompts-1.0.1.tgz",
+      "integrity": "sha512-/42G73JkuYdyWZ6m8d/CJtBrGl1Hegyc7Fy78m5Ob+jF85TOUmLR5XLce/U3LxYAw0kJ8CT5aI99RIvPHcGp/Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@clack/core": "1.0.1",
+        "picocolors": "^1.0.0",
+        "sisteransi": "^1.0.5"
+      }
+    },
     "node_modules/slice-ansi": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz",
diff --git a/package.json b/package.json
index 470e571..2299e80 100644
--- a/package.json
+++ b/package.json
@@ -51,7 +51,7 @@
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "commander": "^11.0.0",
-    "skillflag": "^0.1.3"
+    "skillflag": "^0.1.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",

From 078ce26a80f8c7ddae9eaa9408c485740a192873 Mon Sep 17 00:00:00 2001
From: Bob <bob@dutifulbob.com>
Date: Fri, 20 Feb 2026 18:23:15 +0100
Subject: [PATCH 2/2] docs: remove explicit --agent/--scope install example

---
 README.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/README.md b/README.md
index 2f59eee..fb6b620 100644
--- a/README.md
+++ b/README.md
@@ -50,12 +50,6 @@ Install the bundled agent skill (interactive wizard picks your agent and scope):
 npx -y @simpledoc/simpledoc --skill install simpledoc
 ```
 
-Or install without interaction:
-
-```bash
-npx -y @simpledoc/simpledoc --skill install simpledoc --agent codex --scope repo
-```
-
 ## Migrate
 
 Run the migrator from the repo root to rename/move docs and add frontmatter as needed: