Improve release packaging and non-coder install flow

Author: Hoa Dang DNA PC

.github/workflows/ci.yml

@@ -39,16 +39,23 @@ jobs:
         run: |
           bash ./scripts/install-skills.sh --destination ./.tmp/skills --force
           test -f ./.tmp/skills/codexkit-execution-planner/SKILL.md
-          test "$(find ./.tmp/skills -mindepth 1 -maxdepth 1 -type d | wc -l)" -eq 9
+          expected="$(find ./skills -mindepth 1 -maxdepth 1 -type d | wc -l)"
+          actual="$(find ./.tmp/skills -mindepth 1 -maxdepth 1 -type d | wc -l)"
+          test "$actual" -eq "$expected"
+          bash ./scripts/quick-start.sh --starter project-management-office --destination ./.tmp/pmo --force
+          test -f ./.tmp/pmo/README.md
 
       - name: Smoke install on Windows
         if: runner.os == 'Windows'
         shell: pwsh
         run: |
           ./scripts/install-skills.ps1 -Destination .\.tmp\skills -Force
           if (-not (Test-Path .\.tmp\skills\codexkit-execution-planner\SKILL.md)) { throw "Missing installed skill." }
-          $count = (Get-ChildItem .\.tmp\skills -Directory).Count
-          if ($count -ne 9) { throw "Expected 9 installed skills, got $count." }
+          $expected = (Get-ChildItem .\skills -Directory).Count
+          $actual = (Get-ChildItem .\.tmp\skills -Directory).Count
+          if ($actual -ne $expected) { throw "Expected $expected installed skills, got $actual." }
+          ./scripts/quick-start.ps1 -Starter project-management-office -Destination .\.tmp\pmo -Force
+          if (-not (Test-Path .\.tmp\pmo\README.md)) { throw "Missing scaffolded workspace." }
 
   docs:
     name: Docs Build

.github/workflows/release.yml

@@ -34,18 +34,18 @@ jobs:
       - name: Package release assets
         run: |
           git archive --format=zip --output "codexkit-source-${GITHUB_REF_NAME}.zip" HEAD
-          mkdir -p release/codexkit-skill-pack
-          cp -R skills scripts release/codexkit-skill-pack/
-          cp README.md LICENSE NOTICE.md release/codexkit-skill-pack/
+          mkdir -p release/codexkit-starter-pack
+          cp -R skills templates workspaces playbooks automations mcp scripts release/codexkit-starter-pack/
+          cp README.md LICENSE NOTICE.md START-HERE-WINDOWS.cmd START-HERE.sh CREATE-WORKSPACE-WINDOWS.cmd CREATE-WORKSPACE.sh release/codexkit-starter-pack/
           cd release
-          zip -r "../codexkit-skill-pack-${GITHUB_REF_NAME}.zip" codexkit-skill-pack
+          zip -r "../codexkit-starter-pack-${GITHUB_REF_NAME}.zip" codexkit-starter-pack
 
       - name: Publish GitHub release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           gh release create "$GITHUB_REF_NAME" \
             "codexkit-source-${GITHUB_REF_NAME}.zip" \
-            "codexkit-skill-pack-${GITHUB_REF_NAME}.zip" \
+            "codexkit-starter-pack-${GITHUB_REF_NAME}.zip" \
             --generate-notes \
             --verify-tag

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-03-20
+
+### Added
+
+- Double-click and one-command launcher files so non-technical users can install CodexKit from a release package more easily.
+- Interactive workspace creation wrappers for Windows and shell environments.
+
+### Changed
+
+- README and installation docs now include a detailed release-download path for non-coders.
+- Install scripts now report counts and clearer next steps after completion.
+- CI now validates installed skill counts dynamically and smoke-tests workspace scaffolding.
+- Release packaging now ships a full starter pack with skills, templates, workspaces, playbooks, automations, MCP guides, scripts, and quick-start launchers.
+
 ## [0.3.0] - 2026-03-20
 
 ### Added
@@ -45,7 +59,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - Cross-platform skill installation scripts and a validation script.
 - New docs site positioned for OpenAI Codex and ChatGPT users.
 
-[Unreleased]: https://example.com/codexkit/compare/v0.3.0...HEAD
+[Unreleased]: https://example.com/codexkit/compare/v0.3.1...HEAD
+[0.3.1]: https://example.com/codexkit/releases/tag/v0.3.1
 [0.3.0]: https://example.com/codexkit/releases/tag/v0.3.0
 [0.2.0]: https://example.com/codexkit/releases/tag/v0.2.0
 [0.1.0]: https://example.com/codexkit/releases/tag/v0.1.0

CREATE-WORKSPACE-WINDOWS.cmd

@@ -0,0 +1,38 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+title CodexKit Starter Workspace
+
+echo ==========================================
+echo CodexKit starter workspace scaffold
+echo ==========================================
+echo.
+echo Available starters:
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\quick-start.ps1" -List
+echo.
+set /p STARTER=Enter starter name: 
+set /p DESTINATION=Enter destination folder (example: .\my-pmo): 
+
+if "%STARTER%"=="" (
+  echo Starter name is required.
+  pause
+  exit /b 1
+)
+
+if "%DESTINATION%"=="" (
+  echo Destination is required.
+  pause
+  exit /b 1
+)
+
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\quick-start.ps1" -Starter "%STARTER%" -Destination "%DESTINATION%"
+if errorlevel 1 (
+  echo.
+  echo Workspace creation failed.
+  pause
+  exit /b 1
+)
+
+echo.
+echo Workspace created at %DESTINATION%.
+pause

CREATE-WORKSPACE.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "Available starters:"
+bash "$ROOT_DIR/scripts/quick-start.sh" --list
+echo
+read -r -p "Enter starter name: " STARTER
+read -r -p "Enter destination folder (example: ./my-pmo): " DESTINATION
+
+if [[ -z "${STARTER}" || -z "${DESTINATION}" ]]; then
+  echo "Starter name and destination are required." >&2
+  exit 1
+fi
+
+bash "$ROOT_DIR/scripts/quick-start.sh" --starter "$STARTER" --destination "$DESTINATION"
+echo "Workspace created at $DESTINATION"

README.md

@@ -24,6 +24,24 @@ CodexKit is a fresh project rebuilt around the surfaces that matter in Codex tod
 
 ## Quick start
 
+### Fastest path for non-coders
+
+If you do not want to use Git commands or remember terminal steps, use the GitHub release package:
+
+1. Open the Releases page for this repository.
+2. Download `codexkit-starter-pack-v0.3.1.zip`.
+3. Unzip it anywhere on your computer.
+4. On Windows, double-click `START-HERE-WINDOWS.cmd`.
+5. Restart Codex.
+6. In Codex, type `/skills` to confirm the pack appears.
+7. Optional: double-click `CREATE-WORKSPACE-WINDOWS.cmd` to create a starter workspace.
+
+For macOS or Linux, download the same release package, unzip it, then run:
+
+```bash
+bash ./START-HERE.sh
+```
+
 ### 1. Install CodexKit skills
 
 Windows PowerShell:
@@ -40,6 +58,16 @@ bash ./scripts/install-skills.sh
 
 By default, both scripts copy every folder from `skills/` into `$HOME/.agents/skills`, which matches the user-scope Codex Skills location documented by OpenAI.
 
+Windows double-click install is also available:
+
+- `START-HERE-WINDOWS.cmd`: installs the skills into `%USERPROFILE%\.agents\skills`
+- `CREATE-WORKSPACE-WINDOWS.cmd`: asks for a workspace starter and destination folder
+
+Shell shortcuts are also available for extracted release packages:
+
+- `START-HERE.sh`
+- `CREATE-WORKSPACE.sh`
+
 For repository-scoped discovery, install the pack into `.agents/skills` inside the repo:
 
 Windows PowerShell:
@@ -58,6 +86,12 @@ Codex scans `.agents/skills` from the current working directory up to the reposi
 
 Codex can use skills through explicit invocation or implicit description matching. In CLI and IDE workflows, use `/skills` or type `$` to mention a skill directly. CodexKit keeps `codexkit-cloud-delegation` and `codexkit-automation-designer` explicit-only to avoid accidental activation on sensitive workflows.
 
+If the install completed but the skills do not appear:
+
+1. Restart Codex.
+2. Check that the skills were copied into `%USERPROFILE%\.agents\skills` on Windows or `$HOME/.agents/skills` on macOS/Linux.
+3. In Codex, use `/skills` to verify discovery.
+
 ### 2. Validate the pack
 
 ```bash
@@ -89,6 +123,12 @@ bash ./scripts/quick-start.sh --list
 bash ./scripts/quick-start.sh --starter finance-performance-desk --destination ./acme-finance
 ```
 
+For Windows users who prefer prompts instead of command arguments:
+
+1. Double-click `CREATE-WORKSPACE-WINDOWS.cmd`.
+2. Copy the starter name from the list.
+3. Enter a destination folder such as `.\my-pmo` or `C:\Work\FinanceDesk`.
+
 ## Recommended adoption path
 
 1. Install the skills into `$HOME/.agents/skills` or copy selected skills into repo-local `.agents/skills`.
@@ -134,13 +174,27 @@ CodexKit/
 - release workflow with packaged skill-pack artifacts
 - Dependabot updates for GitHub Actions and the docs app
 - separate docs app ready to publish
+- release packages that can be downloaded and installed by non-technical users
 
 ## Publish checklist
 
 - Update repository URLs in docs and package metadata.
 - Replace placeholder maintainer details where needed.
 - Add screenshots or a short demo GIF to the docs site.
-- Tag `v0.3.0` after validating the pack and docs build.
+- Commit and push the release candidate branch or `main`.
+- Tag `v0.3.1` after validating the pack and docs build.
+- Push the tag to trigger the GitHub release workflow.
+
+## Release process
+
+1. Update `package.json`, `web/package.json`, and `CHANGELOG.md`.
+2. Run `npm run check`.
+3. Commit and push the release commit.
+4. Create the tag: `git tag v0.3.1`
+5. Push the tag: `git push origin v0.3.1`
+6. GitHub Actions publishes:
+   `codexkit-source-v0.3.1.zip`
+   `codexkit-starter-pack-v0.3.1.zip`
 
 ## Related files
 

START-HERE-WINDOWS.cmd

@@ -0,0 +1,28 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+title CodexKit Quick Install
+
+echo ==========================================
+echo CodexKit quick install for Windows
+echo ==========================================
+echo.
+echo This will install CodexKit skills into:
+echo   %USERPROFILE%\.agents\skills
+echo.
+
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\install-skills.ps1"
+if errorlevel 1 (
+  echo.
+  echo Installation failed.
+  pause
+  exit /b 1
+)
+
+echo.
+echo CodexKit install complete.
+echo 1. Restart Codex if the skills do not appear immediately.
+echo 2. Type /skills in Codex to confirm installation.
+echo 3. Optional: double-click CREATE-WORKSPACE-WINDOWS.cmd to scaffold a starter workspace.
+echo.
+pause

START-HERE.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "=========================================="
+echo "CodexKit quick install"
+echo "=========================================="
+echo
+
+bash "$ROOT_DIR/scripts/install-skills.sh"
+
+echo
+echo "CodexKit install complete."
+echo "1. Restart Codex if the skills do not appear immediately."
+echo "2. Type /skills in Codex to confirm installation."
+echo "3. Optional: run bash ./CREATE-WORKSPACE.sh to scaffold a starter workspace."

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexkit",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": true,
   "description": "Open-source operating kit for people using OpenAI Codex and ChatGPT across engineering, high-reasoning work, and repeatable office operations.",
   "engines": {

scripts/install-skills.ps1

@@ -6,6 +6,7 @@ param(
 
 $resolvedSource = (Resolve-Path $SourceDir).Path
 New-Item -ItemType Directory -Force -Path $Destination | Out-Null
+$installedCount = 0
 
 Write-Host "Installing CodexKit skills from $resolvedSource"
 Write-Host "Destination: $Destination"
@@ -23,7 +24,12 @@ Get-ChildItem -Path $resolvedSource -Directory | ForEach-Object {
     }
 
     Copy-Item -Recurse -Force $_.FullName $target
+    $installedCount += 1
     Write-Host "Installed $($_.Name)"
 }
 
-Write-Host "CodexKit skill installation complete."
+Write-Host "CodexKit skill installation complete. Installed $installedCount skills."
+Write-Host "Next steps:"
+Write-Host "1. Restart Codex if the skills do not appear immediately."
+Write-Host "2. Type /skills in Codex to confirm installation."
+Write-Host "3. Optional: run .\\scripts\\quick-start.ps1 -List to scaffold a starter workspace."