Skip to content

Commit 64f0be9

Browse files
author
Hoa Dang DNA PC
committed
feat(v0.4.0): office-productivity skills, enriched templates, Codex-aware launchers
- Add 5 new skills: email-composer, report-summarizer, sprint-planning-assistant, budget-variance-explainer, presentation-outliner - Add skill-finder.md index (36 skills by situation and category) - Add Vietnamese quick-start guide (HUONG-DAN-NHANH.md) - Enrich all 10 templates with instructions and worked examples - Add real-world examples to all 9 playbooks - Upgrade START-HERE scripts with Codex CLI detection and install guidance - Bump version to 0.4.0 across package.json, web/package.json, README, CHANGELOG - Update web docs: skills.json (36 entries), installation page (v0.4.0 + Codex prerequisite) - Web build verified: 13/13 static pages generated - Pack validation passed: 36 skills, 9 playbooks, 10 automations, 10 templates, 6 workspaces
1 parent ffab4a1 commit 64f0be9

40 files changed

Lines changed: 1828 additions & 155 deletions

‎CHANGELOG.md‎

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

88
## [Unreleased]
99

10+
## [0.4.0] - 2026-03-20
11+
12+
### Added
13+
14+
- **Skill Finder**: `skill-finder.md` — situation-based index for all 36 skills, organized by 8 categories.
15+
- **5 new office-productivity skills**: `codexkit-email-composer`, `codexkit-report-summarizer`, `codexkit-sprint-planning-assistant`, `codexkit-budget-variance-explainer`, `codexkit-presentation-outliner`.
16+
- **Vietnamese quick-start guide**: `HUONG-DAN-NHANH.md` — localized onboarding for Vietnamese office users.
17+
18+
### Changed
19+
20+
- All 10 templates now include detailed field instructions, usage tips, and worked examples.
21+
- All 9 playbooks now include concrete, real-world prompt examples.
22+
- Skill count increased from 31 to 36.
23+
24+
1025
## [0.3.1] - 2026-03-20
1126

1227
### Added
@@ -59,7 +74,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
5974
- Cross-platform skill installation scripts and a validation script.
6075
- New docs site positioned for OpenAI Codex and ChatGPT users.
6176

62-
[Unreleased]: https://example.com/codexkit/compare/v0.3.1...HEAD
77+
[Unreleased]: https://example.com/codexkit/compare/v0.4.0...HEAD
78+
[0.4.0]: https://example.com/codexkit/releases/tag/v0.4.0
6379
[0.3.1]: https://example.com/codexkit/releases/tag/v0.3.1
6480
[0.3.0]: https://example.com/codexkit/releases/tag/v0.3.0
6581
[0.2.0]: https://example.com/codexkit/releases/tag/v0.2.0

‎HUONG-DAN-NHANH.md‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
# Hướng Dẫn Nhanh — CodexKit
2+
3+
> Bản hướng dẫn tiếng Việt dành cho người dùng văn phòng. Xem [README.md](README.md) để biết chi tiết đầy đủ.
4+
5+
---
6+
7+
## CodexKit là gì?
8+
9+
CodexKit là bộ quy trình (skills) giúp bạn sử dụng AI hiệu quả hơn trong công việc hàng ngày — viết email, tóm tắt báo cáo, quản lý dự án, phân tích tài chính, và nhiều hơn nữa.
10+
11+
**Không cần biết lập trình.** Bạn chỉ cần copy–paste prompt vào Codex hoặc ChatGPT.
12+
13+
---
14+
15+
## Cài đặt nhanh (3 phút)
16+
17+
### Cách 1: Tải bản release (đơn giản nhất)
18+
19+
1. Vào [Releases](https://github.com/your-org/codexkit/releases) → tải file `.zip` mới nhất
20+
2. Giải nén vào thư mục dự án của bạn
21+
3. Xong! Mở file `skill-finder.md` để bắt đầu
22+
23+
### Cách 2: Chạy script cài đặt
24+
25+
**Windows (PowerShell):**
26+
```powershell
27+
.\scripts\install-skills.ps1
28+
```
29+
30+
**macOS / Linux:**
31+
```bash
32+
./scripts/install-skills.sh
33+
```
34+
35+
---
36+
37+
## Bắt đầu từ đâu?
38+
39+
### Bước 1: Xem bảng tra cứu
40+
41+
Mở file **[skill-finder.md](skill-finder.md)** — tìm tình huống công việc của bạn → biết dùng skill nào.
42+
43+
### Bước 2: Chọn workspace phù hợp
44+
45+
| Bộ phận | Workspace |
46+
|---------|-----------|
47+
| Quản lý dự án (PMO) | `workspaces/project-management-office/` |
48+
| Tài chính | `workspaces/finance/` |
49+
| Nhân sự | `workspaces/hr/` |
50+
| Pháp lý | `workspaces/legal/` |
51+
| Marketing | `workspaces/marketing/` |
52+
| Vận hành | `workspaces/operations/` |
53+
54+
### Bước 3: Dùng playbook để bắt đầu ngay
55+
56+
Playbooks là các prompt mẫu bạn có thể copy–paste trực tiếp:
57+
58+
| Tôi cần… | Playbook |
59+
|-----------|----------|
60+
| Viết recap cuộc họp | `playbooks/meeting-to-actions.md` |
61+
| Tổng hợp status | `playbooks/status-synthesis.md` |
62+
| Viết memo quyết định | `playbooks/write-decision-memo.md` |
63+
64+
---
65+
66+
## 5 Skill phổ biến nhất cho văn phòng
67+
68+
| # | Skill | Tác dụng |
69+
|---|-------|----------|
70+
| 1 | `codexkit-email-composer` | Viết email chuyên nghiệp từ ghi chú |
71+
| 2 | `codexkit-report-summarizer` | Tóm tắt báo cáo dài thành key points |
72+
| 3 | `codexkit-meeting-action-router` | Biến notes cuộc họp thành action items |
73+
| 4 | `codexkit-inbox-priority-triage` | Phân loại inbox theo mức ưu tiên |
74+
| 5 | `codexkit-presentation-outliner` | Dàn ý slide trình bày |
75+
76+
---
77+
78+
## Cách dùng một Skill
79+
80+
1. Mở file `SKILL.md` trong thư mục skill
81+
2. Đọc phần **"When to use"** để đảm bảo đúng skill
82+
3. Xem phần **"Examples"** để lấy prompt mẫu
83+
4. Copy prompt, thay `[paste ...]` bằng nội dung thực tế
84+
5. Paste vào Codex hoặc ChatGPT → nhận kết quả
85+
86+
### Ví dụ cụ thể
87+
88+
Bạn cần viết email nhắc vendor:
89+
90+
```text
91+
Act as a business communication specialist.
92+
Draft a polite follow-up email to our vendor (Acme Corp)
93+
asking for updated pricing by end of this week.
94+
Context: We sent the original request 5 days ago, no response yet.
95+
Tone: professional but firm.
96+
```
97+
98+
---
99+
100+
## Cần hỗ trợ?
101+
102+
- Xem **[skill-finder.md](skill-finder.md)** — bảng tra cứu đầy đủ
103+
- Xem **[README.md](README.md)** — hướng dẫn chi tiết bằng tiếng Anh
104+
- Mỗi skill có phần **Examples** với prompt mẫu sẵn sàng sử dụng

‎README.md‎

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,16 @@ CodexKit is a fresh project rebuilt around the surfaces that matter in Codex tod
66

77
## What is included
88

9-
- `skills/`: installable Codex Skills across engineering, high-reasoning business work, and low-reasoning office automation.
9+
- `skills/`: 36 installable Codex Skills across 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.
1313
- `templates/`: reusable department templates for PM, finance, HR, legal, operations, marketing, and cross-functional work.
1414
- `workspaces/`: starter workspace kits for PM, finance, HR, legal, ops, and marketing teams.
1515
- `scripts/`: cross-platform skill installers, workspace quick-start scripts, and a pack validator.
1616
- `web/`: a Next.js docs site for publishing the kit as a public open-source project.
17+
- `skill-finder.md`: situation-based skill index — "I need to… → Use this skill".
18+
- `HUONG-DAN-NHANH.md`: Vietnamese quick-start guide for non-technical office users.
1719

1820
## Who it is for
1921

@@ -29,11 +31,13 @@ CodexKit is a fresh project rebuilt around the surfaces that matter in Codex tod
2931
If you do not want to use Git commands or remember terminal steps, use the GitHub release package:
3032

3133
1. Open the Releases page for this repository.
32-
2. Download `codexkit-starter-pack-v0.3.1.zip`.
34+
2. Download `codexkit-starter-pack-v0.4.0.zip`.
3335
3. Unzip it anywhere on your computer.
3436
4. On Windows, double-click `START-HERE-WINDOWS.cmd`.
37+
- If Codex is not installed, the script will show installation instructions.
3538
5. Restart Codex.
36-
6. In Codex, type `/skills` to confirm the pack appears.
39+
6. In Codex, type `/skills` to confirm all 36 skills appear.
40+
7. Open `skill-finder.md` to browse skills by situation.
3741
7. Optional: double-click `CREATE-WORKSPACE-WINDOWS.cmd` to create a starter workspace.
3842

3943
For macOS or Linux, download the same release package, unzip it, then run:
@@ -149,7 +153,10 @@ CodexKit/
149153
|-- skills/
150154
|-- templates/
151155
|-- workspaces/
152-
`-- web/
156+
|-- web/
157+
|-- skill-finder.md
158+
|-- HUONG-DAN-NHANH.md
159+
`-- START-HERE-WINDOWS.cmd / START-HERE.sh
153160
```
154161

155162
## Design principles
@@ -182,19 +189,19 @@ CodexKit/
182189
- Replace placeholder maintainer details where needed.
183190
- Add screenshots or a short demo GIF to the docs site.
184191
- Commit and push the release candidate branch or `main`.
185-
- Tag `v0.3.1` after validating the pack and docs build.
192+
- Tag `v0.4.0` after validating the pack and docs build.
186193
- Push the tag to trigger the GitHub release workflow.
187194

188195
## Release process
189196

190197
1. Update `package.json`, `web/package.json`, and `CHANGELOG.md`.
191198
2. Run `npm run check`.
192199
3. Commit and push the release commit.
193-
4. Create the tag: `git tag v0.3.1`
194-
5. Push the tag: `git push origin v0.3.1`
200+
4. Create the tag: `git tag v0.4.0`
201+
5. Push the tag: `git push origin v0.4.0`
195202
6. GitHub Actions publishes:
196-
`codexkit-source-v0.3.1.zip`
197-
`codexkit-starter-pack-v0.3.1.zip`
203+
`codexkit-source-v0.4.0.zip`
204+
`codexkit-starter-pack-v0.4.0.zip`
198205

199206
## Related files
200207

‎START-HERE-WINDOWS.cmd‎

Lines changed: 60 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,74 @@
11
@echo off
22
setlocal
33
cd /d "%~dp0"
4-
title CodexKit Quick Install
4+
title CodexKit v0.4.0
55

6-
echo ==========================================
7-
echo CodexKit quick install for Windows
8-
echo ==========================================
96
echo.
10-
echo This will install CodexKit skills into:
11-
echo %USERPROFILE%\.agents\skills
7+
echo ================================================
8+
echo CodexKit v0.4.0 - Work Operating Kit
9+
echo ================================================
10+
echo.
11+
echo Turn Codex and ChatGPT into disciplined
12+
echo specialists for your daily work.
13+
echo.
14+
echo 36 skills ^| 9 playbooks ^| 10 templates
15+
echo 10 automations ^| 6 starter workspaces
16+
echo.
17+
echo ================================================
18+
echo.
19+
20+
REM ---- Check if Codex CLI is installed ----
21+
where codex >nul 2>&1
22+
if errorlevel 1 (
23+
echo [!] Codex CLI was not detected on this system.
24+
echo.
25+
echo CodexKit requires OpenAI Codex to work.
26+
echo Install it first, then re-run this installer.
27+
echo.
28+
echo Step 1: Install Node.js 20+ from https://nodejs.org
29+
echo Step 2: Run this command in PowerShell or Terminal:
30+
echo.
31+
echo npm install -g @openai/codex
32+
echo.
33+
echo Step 3: Verify with: codex --version
34+
echo Step 4: Re-run this START-HERE file.
35+
echo.
36+
echo Docs: https://github.com/openai/codex
37+
echo.
38+
pause
39+
exit /b 1
40+
)
41+
42+
echo [OK] Codex detected. Proceeding with skill installation...
43+
echo.
44+
45+
REM ---- Show where skills will go ----
46+
echo This will install 36 CodexKit skills into:
47+
echo %USERPROFILE%\.agents\skills
1248
echo.
1349

1450
powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\install-skills.ps1"
1551
if errorlevel 1 (
16-
echo.
17-
echo Installation failed.
18-
pause
19-
exit /b 1
52+
echo.
53+
echo [FAIL] Installation failed. Check the error above.
54+
pause
55+
exit /b 1
2056
)
2157

2258
echo.
23-
echo CodexKit install complete.
24-
echo 1. Restart Codex if the skills do not appear immediately.
25-
echo 2. Type /skills in Codex to confirm installation.
26-
echo 3. Optional: double-click CREATE-WORKSPACE-WINDOWS.cmd to scaffold a starter workspace.
59+
echo ================================================
60+
echo Installation complete!
61+
echo ================================================
62+
echo.
63+
echo Next steps:
64+
echo.
65+
echo 1. Restart Codex (or close and reopen the terminal)
66+
echo 2. Type /skills in Codex to confirm all 36 skills
67+
echo 3. Open skill-finder.md to browse skills by situation
68+
echo 4. Optional: double-click CREATE-WORKSPACE-WINDOWS.cmd
69+
echo to scaffold a department workspace
70+
echo.
71+
echo Quick start (Vietnamese): HUONG-DAN-NHANH.md
72+
echo Full docs: README.md
2773
echo.
2874
pause

‎START-HERE.sh‎

Lines changed: 53 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,59 @@ set -euo pipefail
33

44
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
55

6-
echo "=========================================="
7-
echo "CodexKit quick install"
8-
echo "=========================================="
9-
echo
6+
echo ""
7+
echo "================================================"
8+
echo " CodexKit v0.4.0 — Work Operating Kit"
9+
echo "================================================"
10+
echo ""
11+
echo " Turn Codex and ChatGPT into disciplined"
12+
echo " specialists for your daily work."
13+
echo ""
14+
echo " 36 skills | 9 playbooks | 10 templates"
15+
echo " 10 automations | 6 starter workspaces"
16+
echo ""
17+
echo "================================================"
18+
echo ""
1019

20+
# ---- Check if Codex CLI is installed ----
21+
if ! command -v codex &>/dev/null; then
22+
echo " [!] Codex CLI was not detected on this system."
23+
echo ""
24+
echo " CodexKit requires OpenAI Codex to work."
25+
echo " Install it first, then re-run this script."
26+
echo ""
27+
echo " Step 1: Install Node.js 20+ from https://nodejs.org"
28+
echo " Step 2: Run this command:"
29+
echo ""
30+
echo " npm install -g @openai/codex"
31+
echo ""
32+
echo " Step 3: Verify with: codex --version"
33+
echo " Step 4: Re-run: bash ./START-HERE.sh"
34+
echo ""
35+
echo " Docs: https://github.com/openai/codex"
36+
echo ""
37+
exit 1
38+
fi
39+
40+
echo " [OK] Codex detected. Proceeding with skill installation..."
41+
echo ""
42+
43+
# ---- Install skills ----
1144
bash "$ROOT_DIR/scripts/install-skills.sh"
1245

13-
echo
14-
echo "CodexKit install complete."
15-
echo "1. Restart Codex if the skills do not appear immediately."
16-
echo "2. Type /skills in Codex to confirm installation."
17-
echo "3. Optional: run bash ./CREATE-WORKSPACE.sh to scaffold a starter workspace."
46+
echo ""
47+
echo "================================================"
48+
echo " Installation complete!"
49+
echo "================================================"
50+
echo ""
51+
echo " Next steps:"
52+
echo ""
53+
echo " 1. Restart Codex (or close and reopen the terminal)"
54+
echo " 2. Type /skills in Codex to confirm all 36 skills"
55+
echo " 3. Open skill-finder.md to browse skills by situation"
56+
echo " 4. Optional: bash ./CREATE-WORKSPACE.sh"
57+
echo " to scaffold a department workspace"
58+
echo ""
59+
echo " Quick start (Vietnamese): HUONG-DAN-NHANH.md"
60+
echo " Full docs: README.md"
61+
echo ""

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "codexkit",
3-
"version": "0.3.1",
3+
"version": "0.4.0",
44
"private": true,
55
"description": "Open-source operating kit for people using OpenAI Codex and ChatGPT across engineering, high-reasoning work, and repeatable office operations.",
66
"engines": {

0 commit comments

Comments
 (0)