Skip to content

Commit 1c5b168

Browse files
author
Hoa Dang DNA PC
committed
feat(wave3): add 15 skills, expand to 81 skills across 13 domains
Wave 3 adds: - Data & Analytics (4): dashboard-kpi-designer, data-quality-auditor, survey-analyzer, sql-query-builder - Engineering (3): architecture-decision-writer, incident-postmortem, api-design-reviewer - IT & Admin (2, new domain): vendor-comparison-matrix, change-management-plan - Training & Development (2, new domain): training-needs-analyzer, workshop-facilitator - Cross-Functional (4, new domain): decision-log, crisis-communication, business-case-writer, policy-document-writer Updated: skill-finder.md, README.md, CHANGELOG.md, package.json (x2), START-HERE scripts, installation page Version: 0.7.0
1 parent 3253f47 commit 1c5b168

42 files changed

Lines changed: 2536 additions & 22 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CHANGELOG.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
77

88
## [Unreleased]
99

10+
## [0.7.0] - 2026-03-20
11+
12+
### Added
13+
14+
- **15 new skills** (Wave 3 — expanded domain coverage to 81 total skills):
15+
- **Data & Analytics (4)**: `codexkit-dashboard-kpi-designer` (SMART KPIs + visualization selection), `codexkit-data-quality-auditor` (DAMA six dimensions + remediation), `codexkit-survey-analyzer` (distributions + segmentation + theme extraction), `codexkit-sql-query-builder` (CTEs + window functions + performance docs).
16+
- **Engineering (3)**: `codexkit-architecture-decision-writer` (ADR format + options comparison), `codexkit-incident-postmortem` (SRE + 5 Whys + action items), `codexkit-api-design-reviewer` (REST/GraphQL naming + versioning + errors + pagination).
17+
- **IT & Admin (2, new domain)**: `codexkit-vendor-comparison-matrix` (weighted scoring + TCO), `codexkit-change-management-plan` (ADKAR + Kotter + adoption metrics).
18+
- **Training & Development (2, new domain)**: `codexkit-training-needs-analyzer` (ADDIE + Bloom's + Kirkpatrick), `codexkit-workshop-facilitator` (Design Thinking + Liberating Structures).
19+
- **Cross-Functional (4, new domain)**: `codexkit-decision-log` (RAPID framework + options analysis), `codexkit-crisis-communication` (holding statements + Q&A), `codexkit-business-case-writer` (NPV/ROI/Payback + risk assessment), `codexkit-policy-document-writer` (ISO document control + compliance monitoring).
20+
21+
### Changed
22+
23+
- Skill count increased from 66 to 81.
24+
- Domain coverage expanded from 10 to 13 categories (added IT & Admin, Training & Development, Cross-Functional).
25+
- `skill-finder.md` updated to include all 81 skills across 13 domains.
26+
1027
## [0.6.0] - 2026-03-20
1128

1229
### Added
@@ -114,7 +131,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
114131
- Cross-platform skill installation scripts and a validation script.
115132
- New docs site positioned for OpenAI Codex and ChatGPT users.
116133

117-
[Unreleased]: https://github.com/hoavdc/CodexKit/compare/v0.6.0...HEAD
134+
[Unreleased]: https://github.com/hoavdc/CodexKit/compare/v0.7.0...HEAD
135+
[0.7.0]: https://github.com/hoavdc/CodexKit/releases/tag/v0.7.0
118136
[0.6.0]: https://github.com/hoavdc/CodexKit/releases/tag/v0.6.0
119137
[0.5.0]: https://github.com/hoavdc/CodexKit/releases/tag/v0.5.0
120138
[0.4.0]: https://github.com/hoavdc/CodexKit/releases/tag/v0.4.0

README.md

Lines changed: 30 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
Open-source operating kit for people using OpenAI Codex and ChatGPT to think, write, analyze, decide, automate routine work, and ship better output with more consistency.
44

5-
CodexKit is a fresh project rebuilt around the surfaces that matter in Codex today: local Skills, high-signal playbooks, automation recipes, operational templates, department starter workspaces, repo guardrails, and MCP onboarding guidance. The pack now covers engineering workflows, high-reasoning work, and low-reasoning office automation across project management, finance, legal, HR, operations, supply chain, strategy, analytics, marketing, data, and customer success. It includes deep sub-skills for SAFe PI Planning, Earned Value Management, stakeholder registers, rolling forecasts, audit readiness, legal due diligence, structured interviews, onboarding plans, supplier evaluation, procurement RFPs, Porter/PESTEL/SWOT strategic analysis, competitive intelligence, campaign briefs, A/B test planning, and churn risk analysis — in addition to Wave 1 depth skills for Scrum, Kanban, OKR, FP&A, contract drafting, performance reviews, process improvement, root cause analysis, and customer journey mapping. It follows the official Codex Skills layout with `SKILL.md`, optional `agents/openai.yaml`, and standard `.agents/skills` discovery paths.
5+
CodexKit is a fresh project rebuilt around the surfaces that matter in Codex today: local Skills, high-signal playbooks, automation recipes, operational templates, department starter workspaces, repo guardrails, and MCP onboarding guidance. The pack covers 81 skills across 13 domains: engineering workflows, high-reasoning work, and low-reasoning office automation across project management, finance, legal, HR, operations, supply chain, strategy, analytics, marketing, data, customer success, IT & admin, training & development, and cross-functional work. It follows the official Codex Skills layout with `SKILL.md`, optional `agents/openai.yaml`, and standard `.agents/skills` discovery paths.
66

77
## What is included
88

9-
- `skills/`: 66 installable Codex Skills across engineering, high-reasoning business work, and low-reasoning office automation.
9+
- `skills/`: 81 installable Codex Skills across 13 domains — engineering, high-reasoning business work, and low-reasoning office automation.
1010
- `playbooks/`: copy-ready prompts for clarify, execute, review, decision, delegation, and release work.
1111
- `automations/`: recurring task recipes for engineering plus weekly business, close, hiring, legal intake, operations, and marketing routines.
1212
- `mcp/`: practical guidance for choosing and rolling out MCP servers without overloading the team.
@@ -31,12 +31,12 @@ CodexKit is a fresh project rebuilt around the surfaces that matter in Codex tod
3131
If you do not want to use Git commands or remember terminal steps, use the GitHub release package:
3232

3333
1. Open the Releases page for this repository.
34-
2. Download `codexkit-starter-pack-v0.6.0.zip`.
34+
2. Download `codexkit-starter-pack-v0.7.0.zip`.
3535
3. Unzip it anywhere on your computer.
3636
4. On Windows, double-click `START-HERE-WINDOWS.cmd`.
3737
- If Codex is not installed, the script will show installation instructions.
3838
5. Restart Codex.
39-
6. In Codex, type `/skills` to confirm all 66 skills appear.
39+
6. In Codex, type `/skills` to confirm all 81 skills appear.
4040
7. Open `skill-finder.md` to browse skills by situation.
4141
7. Optional: double-click `CREATE-WORKSPACE-WINDOWS.cmd` to create a starter workspace.
4242

@@ -111,7 +111,27 @@ npm --prefix web install
111111
npm run dev
112112
```
113113

114-
### 4. Start from a department workspace
114+
### 4. Update to the latest version
115+
116+
Git users:
117+
118+
```bash
119+
bash ./scripts/update-codexkit.sh
120+
```
121+
122+
Windows:
123+
124+
```powershell
125+
.\scripts\update-codexkit.ps1
126+
```
127+
128+
Or double-click `UPDATE-WINDOWS.cmd`.
129+
130+
The update script auto-detects your install method:
131+
- **Git clone**: Runs `git pull` + re-installs all skills with `--force`.
132+
- **Zip download**: Fetches the latest release from GitHub, extracts new skills, and overwrites the installed ones.
133+
134+
### 5. Start from a department workspace
115135

116136
Copy one folder from `workspaces/` into your own repo or operating folder, then adapt the files to your context. Each starter workspace is opinionated on cadence, core artifacts, and the mix of high-reasoning versus routine automation work.
117137

@@ -189,19 +209,19 @@ CodexKit/
189209
- Replace placeholder maintainer details where needed.
190210
- Add screenshots or a short demo GIF to the docs site.
191211
- Commit and push the release candidate branch or `main`.
192-
- Tag `v0.6.0` after validating the pack and docs build.
212+
- Tag `v0.7.0` after validating the pack and docs build.
193213
- Push the tag to trigger the GitHub release workflow.
194214

195215
## Release process
196216

197217
1. Update `package.json`, `web/package.json`, and `CHANGELOG.md`.
198218
2. Run `npm run check`.
199219
3. Commit and push the release commit.
200-
4. Create the tag: `git tag v0.6.0`
201-
5. Push the tag: `git push origin v0.6.0`
220+
4. Create the tag: `git tag v0.7.0`
221+
5. Push the tag: `git push origin v0.7.0`
202222
6. GitHub Actions publishes:
203-
`codexkit-source-v0.6.0.zip`
204-
`codexkit-starter-pack-v0.6.0.zip`
223+
`codexkit-source-v0.7.0.zip`
224+
`codexkit-starter-pack-v0.7.0.zip`
205225

206226
## Related files
207227

START-HERE-WINDOWS.cmd

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ echo.
1111
echo Turn Codex and ChatGPT into disciplined
1212
echo specialists for your daily work.
1313
echo.
14-
echo 66 skills ^| 9 playbooks ^| 10 templates
14+
echo 81 skills ^| 9 playbooks ^| 10 templates
1515
echo 10 automations ^| 6 starter workspaces
1616
echo.
1717
echo ================================================
@@ -63,7 +63,7 @@ echo.
6363
echo Next steps:
6464
echo.
6565
echo 1. Restart Codex (or close and reopen the terminal)
66-
echo 2. Type /skills in Codex to confirm all 66 skills
66+
echo 2. Type /skills in Codex to confirm all 81 skills
6767
echo 3. Open skill-finder.md to browse skills by situation
6868
echo 4. Optional: double-click CREATE-WORKSPACE-WINDOWS.cmd
6969
echo to scaffold a department workspace

START-HERE.sh

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ echo ""
1111
echo " Turn Codex and ChatGPT into disciplined"
1212
echo " specialists for your daily work."
1313
echo ""
14-
echo " 66 skills | 9 playbooks | 10 templates"
14+
echo " 81 skills | 9 playbooks | 10 templates"
1515
echo " 10 automations | 6 starter workspaces"
1616
echo ""
1717
echo "================================================"
@@ -51,7 +51,7 @@ echo ""
5151
echo " Next steps:"
5252
echo ""
5353
echo " 1. Restart Codex (or close and reopen the terminal)"
54-
echo " 2. Type /skills in Codex to confirm all 66 skills"
54+
echo " 2. Type /skills in Codex to confirm all 81 skills"
5555
echo " 3. Open skill-finder.md to browse skills by situation"
5656
echo " 4. Optional: bash ./CREATE-WORKSPACE.sh"
5757
echo " to scaffold a department workspace"

UPDATE-WINDOWS.cmd

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
@echo off
2+
:: ──────────────────────────────────────────
3+
:: CodexKit Updater (Windows double-click)
4+
:: ──────────────────────────────────────────
5+
6+
echo.
7+
echo ================================================
8+
echo CodexKit Updater
9+
echo ================================================
10+
echo.
11+
12+
:: Check PowerShell
13+
where pwsh >nul 2>&1
14+
if %errorlevel%==0 (
15+
pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\update-codexkit.ps1"
16+
) else (
17+
powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\update-codexkit.ps1"
18+
)
19+
20+
echo.
21+
pause

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
{
22
"name": "codexkit",
3-
"version": "0.6.0",
3+
"version": "0.7.0",
44
"private": true,
55
"repository": {
66
"type": "git",
77
"url": "https://github.com/hoavdc/CodexKit.git"
88
},
9-
"homepage": "https://github.com/hoavdc/CodexKit",
9+
"homepage": "https://codexkit.pages.dev",
1010
"bugs": {
1111
"url": "https://github.com/hoavdc/CodexKit/issues"
1212
},

scripts/update-codexkit.ps1

Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
param(
2+
[string]$Destination = (Join-Path $HOME ".agents\skills")
3+
)
4+
5+
$ErrorActionPreference = "Stop"
6+
$RepoUrl = "https://github.com/hoavdc/CodexKit"
7+
$ApiUrl = "https://api.github.com/repos/hoavdc/CodexKit/releases/latest"
8+
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
9+
$RootDir = Split-Path -Parent $ScriptDir
10+
$CurrentVersion = ""
11+
12+
# ── Detect current version ──
13+
$pkgPath = Join-Path $RootDir "package.json"
14+
if (Test-Path $pkgPath) {
15+
$pkg = Get-Content $pkgPath -Raw | ConvertFrom-Json
16+
$CurrentVersion = $pkg.version
17+
}
18+
19+
Write-Host ""
20+
Write-Host "================================================" -ForegroundColor Cyan
21+
Write-Host " CodexKit Updater " -ForegroundColor Cyan
22+
Write-Host "================================================" -ForegroundColor Cyan
23+
Write-Host ""
24+
if ($CurrentVersion) { Write-Host "Current version: v$CurrentVersion" }
25+
Write-Host "Skills destination: $Destination"
26+
Write-Host ""
27+
28+
# ── Detect update method ──
29+
$gitDir = Join-Path $RootDir ".git"
30+
if (Test-Path $gitDir) {
31+
Write-Host "[GIT] Git repository detected. Updating via git pull..." -ForegroundColor Green
32+
Write-Host ""
33+
34+
Push-Location $RootDir
35+
36+
# Check for uncommitted changes
37+
$status = git status --porcelain 2>$null
38+
$stashed = $false
39+
if ($status) {
40+
Write-Host "Warning: You have uncommitted changes. Stashing them..." -ForegroundColor Yellow
41+
git stash
42+
$stashed = $true
43+
}
44+
45+
# Pull latest
46+
$before = git rev-parse HEAD
47+
try {
48+
git pull --rebase origin main 2>&1
49+
} catch {
50+
git pull origin main 2>&1
51+
}
52+
$after = git rev-parse HEAD
53+
54+
if ($before -eq $after) {
55+
Write-Host ""
56+
Write-Host "Already up to date!" -ForegroundColor Green
57+
} else {
58+
Write-Host ""
59+
Write-Host "Updated successfully!" -ForegroundColor Green
60+
Write-Host ""
61+
Write-Host "Changes:"
62+
git log --oneline "$before..$after" 2>$null
63+
}
64+
65+
# Restore stashed changes
66+
if ($stashed) {
67+
Write-Host ""
68+
Write-Host "Restoring your local changes..."
69+
try { git stash pop } catch { Write-Warning "Could not auto-restore stash. Run 'git stash pop' manually." }
70+
}
71+
72+
# Re-read version
73+
if (Test-Path $pkgPath) {
74+
$pkg = Get-Content $pkgPath -Raw | ConvertFrom-Json
75+
$LatestVersion = $pkg.version
76+
Write-Host ""
77+
Write-Host "Version: v$CurrentVersion -> v$LatestVersion" -ForegroundColor Green
78+
}
79+
80+
Pop-Location
81+
82+
# Re-install skills
83+
Write-Host ""
84+
Write-Host "Re-installing skills..." -ForegroundColor Cyan
85+
& "$RootDir\scripts\install-skills.ps1" -Destination $Destination -Force
86+
87+
} else {
88+
# ── Non-git: Download latest release ──
89+
Write-Host "[DOWNLOAD] No git repo found. Checking GitHub for latest release..." -ForegroundColor Yellow
90+
Write-Host ""
91+
92+
try {
93+
$headers = @{ "User-Agent" = "CodexKit-Updater" }
94+
$release = Invoke-RestMethod -Uri $ApiUrl -Headers $headers -TimeoutSec 15
95+
$LatestVersion = $release.tag_name -replace '^v', ''
96+
} catch {
97+
Write-Host "Could not fetch latest version from GitHub." -ForegroundColor Red
98+
Write-Host "Check your internet connection or visit: $RepoUrl/releases"
99+
exit 1
100+
}
101+
102+
Write-Host "Latest version: v$LatestVersion"
103+
104+
if ($CurrentVersion -eq $LatestVersion) {
105+
Write-Host "You are already on the latest version!" -ForegroundColor Green
106+
Write-Host ""
107+
Write-Host "Re-installing skills anyway..."
108+
& "$RootDir\scripts\install-skills.ps1" -Destination $Destination -Force
109+
exit 0
110+
}
111+
112+
# Download latest starter pack
113+
$downloadUrl = "$RepoUrl/releases/download/v$LatestVersion/codexkit-starter-pack-v$LatestVersion.zip"
114+
$tmpDir = Join-Path $env:TEMP "codexkit-update-$(Get-Random)"
115+
$zipFile = Join-Path $tmpDir "codexkit.zip"
116+
$extractDir = Join-Path $tmpDir "extracted"
117+
118+
New-Item -ItemType Directory -Force -Path $tmpDir | Out-Null
119+
120+
Write-Host ""
121+
Write-Host "Downloading v$LatestVersion from GitHub..." -ForegroundColor Cyan
122+
Write-Host " $downloadUrl"
123+
124+
try {
125+
Invoke-WebRequest -Uri $downloadUrl -OutFile $zipFile -TimeoutSec 120
126+
} catch {
127+
Write-Host "Download failed. Please download manually from:" -ForegroundColor Red
128+
Write-Host " $RepoUrl/releases"
129+
Remove-Item -Recurse -Force $tmpDir -ErrorAction SilentlyContinue
130+
exit 1
131+
}
132+
133+
Write-Host "Extracting..." -ForegroundColor Cyan
134+
Expand-Archive -Path $zipFile -DestinationPath $extractDir -Force
135+
136+
# Find the extracted skills directory
137+
$extractedSkills = Get-ChildItem -Path $extractDir -Recurse -Directory -Filter "skills" | Select-Object -First 1
138+
if (-not $extractedSkills) {
139+
Write-Host "Could not find skills directory in the downloaded package." -ForegroundColor Red
140+
Remove-Item -Recurse -Force $tmpDir -ErrorAction SilentlyContinue
141+
exit 1
142+
}
143+
144+
# Copy new skills
145+
Write-Host "Installing new skills from v$LatestVersion..." -ForegroundColor Cyan
146+
New-Item -ItemType Directory -Force -Path $Destination | Out-Null
147+
$installedCount = 0
148+
149+
Get-ChildItem -Path $extractedSkills.FullName -Directory | ForEach-Object {
150+
$target = Join-Path $Destination $_.Name
151+
if (Test-Path $target) { Remove-Item -Recurse -Force $target }
152+
Copy-Item -Recurse -Force $_.FullName $target
153+
$installedCount++
154+
}
155+
156+
Write-Host "Updated $installedCount skills to v$LatestVersion" -ForegroundColor Green
157+
158+
# Update local reference files
159+
$extractedRoot = Get-ChildItem -Path $extractDir -Directory | Select-Object -First 1
160+
if ($extractedRoot) {
161+
foreach ($file in @("skill-finder.md", "HUONG-DAN-NHANH.md", "CHANGELOG.md")) {
162+
$src = Join-Path $extractedRoot.FullName $file
163+
if (Test-Path $src) {
164+
Copy-Item -Force $src (Join-Path $RootDir $file) -ErrorAction SilentlyContinue
165+
}
166+
}
167+
}
168+
169+
# Cleanup
170+
Remove-Item -Recurse -Force $tmpDir -ErrorAction SilentlyContinue
171+
}
172+
173+
Write-Host ""
174+
Write-Host "================================================" -ForegroundColor Green
175+
Write-Host " Update complete! " -ForegroundColor Green
176+
Write-Host "================================================" -ForegroundColor Green
177+
Write-Host ""
178+
Write-Host "Next steps:"
179+
Write-Host " 1. Restart Codex to pick up new/updated skills"
180+
Write-Host " 2. Type /skills to verify the update"
181+
Write-Host " 3. Open skill-finder.md to browse new skills"
182+
Write-Host ""

0 commit comments

Comments
 (0)