More readme tweaks + improving the sample extension (#26)

* Adding images

* Push readme

* Update extension.json

* Update README.md

* Update README.md

* Update README.md

* Push

Author: niels9001

.github/schemas/extension.schema.json

@@ -70,6 +70,11 @@
       "format": "uri",
       "examples": ["https://github.com/jiripolasek/MediaControlsExtension"]
     },
+    "listed": {
+      "type": "boolean",
+      "description": "Whether this extension should appear in the public gallery. Defaults to true if omitted. Set to false for sample or test extensions.",
+      "default": true
+    },
     "tags": {
       "type": "array",
       "description": "Optional freeform tags for filtering. Maximum 5 tags.",

.github/scripts/generate.py

@@ -28,7 +28,7 @@
 )
 
 # Fields from extension.json that should not appear in the gallery output.
-FIELDS_TO_REMOVE = {"$schema", "icon"}
+FIELDS_TO_REMOVE = {"$schema", "icon", "listed"}
 
 VALID_SCREENSHOT_EXTENSIONS = {".png", ".jpg", ".jpeg"}
 MAX_SCREENSHOTS = 5
@@ -154,6 +154,9 @@ def generate_gallery() -> dict:
         if data is None:
             skipped += 1
             continue
+        if not data.get("listed", True):
+            skipped += 1
+            continue
         entry = transform_extension(data)
         entry["addedAt"] = existing_added_at.get(data["id"], today)
         extensions.append(entry)

README.md

@@ -12,6 +12,8 @@
   <a href="https://learn.microsoft.com/windows/powertoys/command-palette/extensibility-overview">Create your own extension</a>
 </h3>
 
+<br/>
+
 🔍 **Discoverable by millions** — your extension shows up right inside Command Palette
 
 📦 **Host it your way** — publish through winget, the Microsoft Store, or your own download link — you stay in control
@@ -24,18 +26,19 @@
 
 New to building Command Palette extensions? Check out the [Extension Development docs](https://learn.microsoft.com/windows/powertoys/command-palette/extensibility-overview) to get started.
 
-Once your extension is ready, follow these steps to list it in the gallery:
+📦 **Host it your way** — publish through winget, the Microsoft Store, or your own download link — you stay in control
+
+🌍 **Open-source & community-driven** — join a growing ecosystem of developers extending Windows productivity
+
+<br/>
 
-1. **Fork** this repository
-2. **Create a folder** at `extensions/<your-name>/<extension-name>/` (lowercase, hyphens only)
-3. **Add an `extension.json`** with your extension metadata — see the [Contributing Guide](docs/CONTRIBUTING.md) for the full field reference and template
-4. **Add an icon** in the same folder
-5. **Publish your extension** to at least one install source: [winget](https://learn.microsoft.com/windows/powertoys/command-palette/publish-extension), [Microsoft Store](https://learn.microsoft.com/windows/powertoys/command-palette/publish-extension), or a direct download URL (e.g. a [GitHub Releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases) page)
-6. **Open a pull request** targeting `main`
+## 🛠️ Submit your extension
+
+New to building Command Palette extensions? Check out the [Extension Development docs](https://learn.microsoft.com/windows/powertoys/command-palette/extensibility-overview) to get started.
 
-CI will validate your submission automatically and the Command Palette team will review your PR. Once merged, your extension will show up in the Command Palette Extension Gallery.
+Once your extension is ready, add it to the gallery by opening a pull request with an `extension.json`, an icon, and at least one install source — winget, Microsoft Store, or a direct download URL. CI validates your submission automatically and the Command Palette team will review your PR.
 
-See [`extensions/microsoft/sample-extension/`](extensions/microsoft/sample-extension/) for a complete example.
+👉 **[Submit your extension guide](docs/CONTRIBUTING.md)** — full walkthrough, field reference, and a [sample extension](extensions/microsoft/sample-extension/) to get started.
 
 <p align="center">
   <img src="docs/images/details.png" alt="Extension details page" width="700" />

docs/CONTRIBUTING.md

@@ -68,16 +68,16 @@ Create an `extension.json` file inside your folder. Here is the full template wi
     "name": "Publisher Display Name",
     "url": "https://github.com/publisher"
   },
+  "icon": "icon.png",
+  "homepage": "https://github.com/publisher/extension",
   "tags": ["tag1", "tag2"],
   "categories": ["productivity", "utilities-and-tools"],
-  "icon": "icon.png",
   "installSources": [
     {
       "type": "winget",
       "id": "Publisher.PackageName"
     }
-  ],
-  "homepage": "https://github.com/publisher/extension"
+  ]
 }
 ```
 
@@ -91,11 +91,12 @@ Create an `extension.json` file inside your folder. Here is the full template wi
 | `shortDescription` | **Required** | Short one-line description of the extension (max 200 characters). |
 | `description` | **Required** | Full description of the extension, typically sourced from the Store listing or README (max 3000 characters). |
 | `author` | **Required** | Object with `name` (required, max 100 characters) and `url` (optional). |
-| `tags` | Optional | Up to 5 freeform tags for filtering (each max 30 characters). |
-| `categories` | Optional | Up to 3 categories from a fixed list. See [Allowed categories](#allowed-categories) below. |
 | `icon` | **Required** | Filename of the icon in the same folder (e.g., `icon.png`). |
 | `installSources` | **Required** | Array of install source objects. Each has a `type` and a type-specific identifier. See below. |
 | `homepage` | Optional | URL to the project homepage or repository. |
+| `tags` | Optional | Up to 5 freeform tags for filtering (each max 30 characters). |
+| `categories` | Optional | Up to 3 categories from a fixed list. See [Allowed categories](#allowed-categories) below. |
+| `listed` | Optional | Whether the extension appears in the public gallery. Defaults to `true`. Set to `false` for sample or test extensions. |
 
 #### Install source types
 

extensions.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/microsoft/CmdPal-Extensions/main/.github/schemas/gallery.schema.json",
   "version": "1.0",
-  "generatedAt": "2026-04-10T10:56:52Z",
+  "generatedAt": "2026-04-11T09:31:27Z",
   "extensionCount": 12,
   "extensions": [
     {
@@ -302,6 +302,10 @@
         {
           "type": "msstore",
           "id": "9P2JPD7XDB3C"
+        },
+        {
+          "type": "url",
+          "uri": "https://github.com/niels9001/CmdPal-EventViewer/releases"
         }
       ],
       "iconUrl": "https://raw.githubusercontent.com/microsoft/CmdPal-Extensions/main/extensions/nielslaute/event-viewer/icon.png",

extensions/microsoft/sample-extension/extension.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "../../../.github/schemas/extension.schema.json",
+  "id": "microsoft.sample-extension",
+  "listed": false,
+  "title": "Sample Extension",
+  "shortDescription": "A sample extension to demonstrate the gallery submission format.",
+  "description": "A sample Command Palette extension to demonstrate the gallery submission format. Use this as a reference when creating your own extension submission.",
+  "author": {
+    "name": "Microsoft",
+    "url": "https://github.com/microsoft"
+  },
+  "icon": "icon.png",
+  "homepage": "https://github.com/microsoft/CmdPal-Extensions",
+  "tags": ["sample", "demo", "template"],
+  "categories": ["utilities-and-tools"],
+  "installSources": [
+    {
+      "type": "winget",
+      "id": "Microsoft.PowerToys"
+    },
+    {
+      "type": "msstore",
+      "id": "XP89DCGQ3K6VLD"
+    },
+    {
+      "type": "url",
+      "uri": "https://github.com/microsoft/CmdPal-Extensions/releases/latest"
+    }
+  ]
+}