feat(skills): add 15 Wave 1 deep sub-skills, bump to v0.5.0

- PM (5): scrum-retrospective, backlog-refiner, okr-writer, risk-register, kanban-flow-analyzer
- Finance (2): fpa-scenario-modeling, financial-statement-analyzer
- Legal (2): contract-drafter, legal-memo-writer
- HR (2): job-description-writer, performance-review-writer
- Marketing (1): go-to-market-planner
- Operations (2): process-mapper, root-cause-analyzer
- CX (1): customer-journey-mapper

Total skills: 36 -> 51
Updated: README, CHANGELOG, package.json (x2), skill-finder, launchers

Author: Hoa Dang DNA PC

CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-03-20
+
+### Added
+
+- **15 new deep sub-skills** (Wave 1 — high-impact professional skills):
+  - **PM Domain (5)**: `codexkit-scrum-retrospective` (5 retro formats by maturity), `codexkit-backlog-refiner` (INVEST + Given/When/Then), `codexkit-okr-writer` (cascade + check-in), `codexkit-risk-register` (P×I scoring + ROAM), `codexkit-kanban-flow-analyzer` (Little's Law + Monte Carlo).
+  - **Finance (2)**: `codexkit-fpa-scenario-modeling` (Base/Bull/Bear + sensitivity), `codexkit-financial-statement-analyzer` (ratio analysis + DuPont).
+  - **Legal (2)**: `codexkit-contract-drafter` (clause library + risk calibration), `codexkit-legal-memo-writer` (IRAC framework).
+  - **HR (2)**: `codexkit-job-description-writer` (SHRM + inclusive language), `codexkit-performance-review-writer` (SBI feedback + bias check).
+  - **Marketing (1)**: `codexkit-go-to-market-planner` (TAM/SAM/SOM + positioning + launch timeline).
+  - **Operations (2)**: `codexkit-process-mapper` (swimlane + 8 Lean Wastes), `codexkit-root-cause-analyzer` (5 Whys + Fishbone + Pareto + CAPA).
+  - **CX (1)**: `codexkit-customer-journey-mapper` (7 stages + Moments of Truth + emotion curve).
+
+### Changed
+
+- Skill count increased from 36 to 51.
+- `skill-finder.md` updated to include all 51 skills across 8 categories.
+- README updated with new skill descriptions and v0.5.0 references.
+
 ## [0.4.0] - 2026-03-20
 
 ### Added
@@ -74,9 +93,11 @@ 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.4.0...HEAD
+[Unreleased]: https://example.com/codexkit/compare/v0.5.0...HEAD
+[0.5.0]: https://example.com/codexkit/releases/tag/v0.5.0
 [0.4.0]: https://example.com/codexkit/releases/tag/v0.4.0
 [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
+

README.md

@@ -2,11 +2,11 @@
 
 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.
 
-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, strategy, analytics, marketing, and customer success. It follows the official Codex Skills layout with `SKILL.md`, optional `agents/openai.yaml`, and standard `.agents/skills` discovery paths.
+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, strategy, analytics, marketing, and customer success. It includes deep sub-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.
 
 ## What is included
 
-- `skills/`: 36 installable Codex Skills across engineering, high-reasoning business work, and low-reasoning office automation.
+- `skills/`: 51 installable Codex Skills across engineering, high-reasoning business work, and low-reasoning office automation.
 - `playbooks/`: copy-ready prompts for clarify, execute, review, decision, delegation, and release work.
 - `automations/`: recurring task recipes for engineering plus weekly business, close, hiring, legal intake, operations, and marketing routines.
 - `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
 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.4.0.zip`.
+2. Download `codexkit-starter-pack-v0.5.0.zip`.
 3. Unzip it anywhere on your computer.
 4. On Windows, double-click `START-HERE-WINDOWS.cmd`.
    - If Codex is not installed, the script will show installation instructions.
 5. Restart Codex.
-6. In Codex, type `/skills` to confirm all 36 skills appear.
+6. In Codex, type `/skills` to confirm all 51 skills appear.
 7. Open `skill-finder.md` to browse skills by situation.
 7. Optional: double-click `CREATE-WORKSPACE-WINDOWS.cmd` to create a starter workspace.
 
@@ -189,19 +189,19 @@ CodexKit/
 - Replace placeholder maintainer details where needed.
 - Add screenshots or a short demo GIF to the docs site.
 - Commit and push the release candidate branch or `main`.
-- Tag `v0.4.0` after validating the pack and docs build.
+- Tag `v0.5.0` 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.4.0`
-5. Push the tag: `git push origin v0.4.0`
+4. Create the tag: `git tag v0.5.0`
+5. Push the tag: `git push origin v0.5.0`
 6. GitHub Actions publishes:
-   `codexkit-source-v0.4.0.zip`
-   `codexkit-starter-pack-v0.4.0.zip`
+   `codexkit-source-v0.5.0.zip`
+   `codexkit-starter-pack-v0.5.0.zip`
 
 ## Related files
 

START-HERE-WINDOWS.cmd

@@ -1,17 +1,17 @@
 @echo off
 setlocal
 cd /d "%~dp0"
-title CodexKit v0.4.0
+title CodexKit v0.5.0
 
 echo.
 echo ================================================
-echo    CodexKit v0.4.0 - Work Operating Kit
+echo    CodexKit v0.5.0 - Work Operating Kit
 echo ================================================
 echo.
 echo    Turn Codex and ChatGPT into disciplined
 echo    specialists for your daily work.
 echo.
-echo    36 skills  ^|  9 playbooks  ^|  10 templates
+echo    51 skills  ^|  9 playbooks  ^|  10 templates
 echo    10 automations  ^|  6 starter workspaces
 echo.
 echo ================================================
@@ -63,7 +63,7 @@ echo.
 echo  Next steps:
 echo.
 echo    1. Restart Codex (or close and reopen the terminal)
-echo    2. Type /skills in Codex to confirm all 36 skills
+echo    2. Type /skills in Codex to confirm all 51 skills
 echo    3. Open skill-finder.md to browse skills by situation
 echo    4. Optional: double-click CREATE-WORKSPACE-WINDOWS.cmd
 echo       to scaffold a department workspace

START-HERE.sh

@@ -5,13 +5,13 @@ ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 echo ""
 echo "================================================"
-echo "   CodexKit v0.4.0 — Work Operating Kit"
+echo "   CodexKit v0.5.0 — Work Operating Kit"
 echo "================================================"
 echo ""
 echo "   Turn Codex and ChatGPT into disciplined"
 echo "   specialists for your daily work."
 echo ""
-echo "   36 skills  |  9 playbooks  |  10 templates"
+echo "   51 skills  |  9 playbooks  |  10 templates"
 echo "   10 automations  |  6 starter workspaces"
 echo ""
 echo "================================================"
@@ -51,7 +51,7 @@ echo ""
 echo "  Next steps:"
 echo ""
 echo "    1. Restart Codex (or close and reopen the terminal)"
-echo "    2. Type /skills in Codex to confirm all 36 skills"
+echo "    2. Type /skills in Codex to confirm all 51 skills"
 echo "    3. Open skill-finder.md to browse skills by situation"
 echo "    4. Optional: bash ./CREATE-WORKSPACE.sh"
 echo "       to scaffold a department workspace"

package.json

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

skill-finder.md

@@ -1,6 +1,6 @@
 # Skill Finder — "I need to… → Use this skill"
 
-> Quick reference for all 36 CodexKit skills grouped by what you're trying to accomplish.
+> Quick reference for all 51 CodexKit skills grouped by what you're trying to accomplish.
 
 ---
 
@@ -25,6 +25,11 @@
 | Set up project governance / charter | `codexkit-project-governance-pilot` | Charter, decision rights, stakeholder map, RAID, PMBOK 8 |
 | Build a portfolio risk view | `codexkit-portfolio-risk-radar` | Multi‑project RAID / RAG across milestones and dependencies |
 | Plan a sprint | `codexkit-sprint-planning-assistant` | Backlog organization, effort estimation, sprint commitment |
+| Refine backlog items into user stories | `codexkit-backlog-refiner` | INVEST criteria, Given/When/Then acceptance criteria, story points |
+| Run a sprint retrospective | `codexkit-scrum-retrospective` | 5 retro formats by team maturity, action items, health tracking |
+| Write and cascade OKRs | `codexkit-okr-writer` | Outcome-based KRs, cascade alignment, check-in templates |
+| Build a project risk register | `codexkit-risk-register` | P×I scoring, response strategies, ROAM board integration |
+| Analyze Kanban flow metrics | `codexkit-kanban-flow-analyzer` | Cycle time, throughput, WIP, bottlenecks, Monte Carlo forecast |
 | Create an execution plan | `codexkit-execution-planner` | Assumptions, sequence, acceptance checks, rollback |
 | Design a recurring automation | `codexkit-automation-designer` | Safe Codex automations with schedules and gating |
 | Delegate work to Codex tasks | `codexkit-cloud-delegation` | Bounded tasks with ownership and integration checkpoints |
@@ -38,6 +43,8 @@
 | Explain budget vs actual variance | `codexkit-finance-variance-story` | Management‑ready narrative with drivers and actions |
 | Explain my budget numbers in plain English | `codexkit-budget-variance-explainer` | Plain‑language variance explanations with actions for non‑finance managers |
 | Coordinate month‑end / quarter‑end close | `codexkit-finance-close-coordinator` | Close blockers, reconciliations, owners, evidence |
+| Build scenario financial models | `codexkit-fpa-scenario-modeling` | Base/Bull/Bear P&L, cash flow, sensitivity analysis |
+| Analyze financial statements | `codexkit-financial-statement-analyzer` | Ratio analysis, DuPont decomposition, trend, red flags |
 
 ---
 
@@ -48,6 +55,8 @@
 | Review a contract for risks | `codexkit-contract-risk-review` | Red flags, obligations, fallback positions |
 | Route an incoming contract request | `codexkit-contract-intake-router` | Request type, missing info, priority, review queue |
 | Check compliance against a framework | `codexkit-compliance-gap-review` | Gap matrix, control checklist, remediation priorities |
+| Draft a new contract from scratch | `codexkit-contract-drafter` | Clause library, risk calibration, negotiation guide |
+| Write a legal analysis memo | `codexkit-legal-memo-writer` | IRAC framework, risk-tiered conclusions, actionable advice |
 
 ---
 
@@ -57,6 +66,8 @@
 |---|---|---|
 | Prepare talent review / 9-box calibration | `codexkit-talent-review-calibrator` | Performance, potential, readiness, risks, dev actions |
 | Coordinate hiring operations | `codexkit-hiring-ops-coordinator` | Interview loops, schedules, feedback, next steps |
+| Write a job description | `codexkit-job-description-writer` | SHRM competency alignment, inclusive language check |
+| Write a performance review | `codexkit-performance-review-writer` | SBI feedback model, SMART goals, bias check |
 
 ---
 
@@ -77,6 +88,8 @@
 | Run S&OP / business planning cycle | `codexkit-sandop-facilitator` | Demand, supply, inventory, capacity alignment |
 | Package operations KPIs | `codexkit-ops-kpi-packager` | KPI snapshots, exception flags, owner follow‑ups |
 | Run a Lean Six Sigma improvement | `codexkit-dmaic-improvement-charter` | DMAIC charter, SIPOC, baseline, improvement path |
+| Map a business process end-to-end | `codexkit-process-mapper` | Swimlane diagrams, 8 Lean Wastes, process efficiency |
+| Find root cause of recurring problems | `codexkit-root-cause-analyzer` | 5 Whys, Fishbone, Pareto, CAPA corrective actions |
 
 ---
 
@@ -86,7 +99,9 @@
 |---|---|---|
 | Build brand positioning | `codexkit-brand-positioning-canvas` | Audience, category, differentiators, messaging pillars |
 | Assemble a content calendar | `codexkit-content-calendar-assembler` | Structured calendar and workback plan from inputs |
+| Plan a go‑to‑market launch | `codexkit-go-to-market-planner` | TAM/SAM/SOM, positioning, messaging, channel strategy |
 | Prepare a customer QBR | `codexkit-cx-qbr-preparer` | Outcome tracking, adoption health, ROI, next‑quarter plan |
+| Map the customer journey | `codexkit-customer-journey-mapper` | 7 lifecycle stages, Moments of Truth, emotion curve |
 
 ---
 

skills/codexkit-backlog-refiner/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: codexkit-backlog-refiner
+description: Refine Product Backlog Items to meet INVEST criteria. Write User Stories with Acceptance Criteria in Given/When/Then format, estimate with Story Points, and flag dependencies. Use before sprint planning when backlog items need grooming. Do not use to prioritize the backlog — that is the Product Owner's decision.
+version: 1.0.0
+---
+
+# Backlog Refiner
+
+## Purpose
+
+Transform raw backlog items into sprint-ready User Stories that meet INVEST criteria, with clear Acceptance Criteria and reliable estimates.
+
+## When to use
+
+- mid-sprint refinement sessions (preparing items for the next sprint)
+- when backlog items are vague, oversized, or lack acceptance criteria
+- when the team needs help decomposing epics into estimable stories
+- when onboarding a new Product Owner who needs story-writing structure
+
+## When not to use
+
+- prioritizing backlog order (Product Owner responsibility)
+- strategic roadmap discussions or feature discovery
+- items already refined and ready for sprint planning
+
+## Inputs
+
+- raw backlog items (titles, rough descriptions, business context)
+- product goal or current product increment theme
+- team's story point calibration reference (what does 1 point mean?)
+- known technical constraints or dependencies
+- Definition of Done for the product
+
+## Procedure
+
+1. **Review each item** against INVEST checklist:
+   - I — Independent: not blocked by other stories
+   - N — Negotiable: details can be discussed with PO
+   - V — Valuable: delivers clear value to user or business
+   - E — Estimable: team can estimate the effort
+   - S — Small: completable within one sprint
+   - T — Testable: has verifiable acceptance criteria
+2. **Write User Story** using 3C template:
+   - Card: "As a [persona], I want [action] so that [benefit]"
+   - Conversation: context, questions for clarification
+   - Confirmation: Acceptance Criteria in Given/When/Then
+3. **Estimate effort** using Planning Poker reference scale:
+   - 1 pt ≈ 4h | 2 pt ≈ 1 day | 3 pt ≈ 1.5 days | 5 pt ≈ 3 days
+   - 8 pt = needs breakdown | 13+ pt = Epic, must split
+4. **Flag items** that are too large — recommend split strategies.
+5. **Identify dependencies** on other teams, services, or external parties.
+6. **Document risks** or unknowns that could block the story.
+
+## Output
+
+- refined User Stories with INVEST checklist scores
+- Acceptance Criteria (3–5 per story, Given/When/Then format)
+- Story Point estimates with rationale
+- split recommendations for oversized items
+- dependency and risk flags
+
+## Definition of done
+
+- every story passes all 6 INVEST criteria
+- every story has at least 3 Acceptance Criteria in Given/When/Then
+- no story exceeds 8 story points without a split recommendation
+- dependencies are explicitly documented
+
+## Examples
+
+- "Refine these 8 raw feature requests into sprint-ready user stories."
+- "This epic 'User Authentication' is too big — help me split it into stories."
+- "Write acceptance criteria for the 'Password Reset' story."

skills/codexkit-backlog-refiner/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Backlog Refiner"
+  short_description: "Write INVEST user stories with acceptance criteria and story point estimates."
+  brand_color: "#0F766E"

skills/codexkit-contract-drafter/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: codexkit-contract-drafter
+description: Draft commercial contracts from scratch by contract type — NDAs, service agreements, vendor contracts, employment agreements, and licensing deals. Follow a clause library approach with risk-balanced terms. Use when creating new contracts. Do not replace legal counsel sign-off on finalized agreements. For reviewing existing contracts, use contract-risk-review instead.
+version: 1.0.0
+---
+
+# Contract Drafter
+
+## Purpose
+
+Generate well-structured contracts using a clause library approach — producing balanced terms that protect both parties while reflecting business intent.
+
+## When to use
+
+- creating a new NDA, service agreement, or vendor contract from scratch
+- drafting a partnership or licensing agreement
+- creating an employment contract or consulting agreement
+- when no internal template exists for the contract type needed
+
+## When not to use
+
+- reviewing or redlining an existing contract (use contract-risk-review)
+- high-value M&A transactions (requires specialized legal counsel)
+- jurisdictions with specific regulatory requirements without local counsel input
+
+## Inputs
+
+- contract type (NDA / Service Agreement / Vendor Agreement / Employment / License / Partnership)
+- parties involved (names, roles, jurisdictions)
+- key commercial terms (scope, duration, pricing, payment terms)
+- specific requirements or non-standard terms
+- governing law preference
+- risk tolerance (conservative / balanced / aggressive)
+
+## Procedure
+
+1. **Select contract template structure** based on type:
+   - Recitals (background and purpose)
+   - Definitions section
+   - Core commercial terms
+   - Protective clauses
+   - Standard boilerplate
+2. **Draft core clauses** — each with balanced terms:
+   - Scope of Work / Services: clear deliverables + acceptance criteria
+   - Payment Terms: milestones, net days, late payment interest
+   - Term and Renewal: fixed term, auto-renewal notice period
+   - Termination: for cause + for convenience, notice period, wind-down
+3. **Draft protective clauses**:
+   - IP Ownership: background IP protected, work product assignment
+   - Confidentiality: duration, permitted disclosures, return of info
+   - Liability Cap: mutual cap at contract value (or last 12 months fees)
+   - Indemnification: mutual, limited to direct damages
+   - Force Majeure: modern clause including pandemic, cyber attack
+   - Dispute Resolution: escalation path → mediation → arbitration/court
+4. **Add boilerplate**:
+   - Entire Agreement, Severability, Waiver, Assignment, Notices
+5. **Risk-calibrate** based on tolerance:
+   - Conservative: more protections, lower caps, stricter terms
+   - Balanced: mutual obligations, reasonable caps
+   - Aggressive: fewer restrictions, higher risk acceptance
+6. **Flag missing clauses** that the other party may request.
+
+## Output
+
+- complete contract draft organized by sections
+- clause-by-clause commentary explaining purpose and risk level
+- missing clauses checklist (what might need adding)
+- negotiation guide: which clauses are negotiable vs. firm
+- recommended next steps (legal review, counterparty review)
+
+## Definition of done
+
+- contract contains all sections appropriate for its type
+- every clause has a risk-level annotation
+- IP, liability, and confidentiality clauses are present
+- governing law and dispute resolution are specified
+
+## Examples
+
+- "Draft a mutual NDA between our company and a potential partner."
+- "Create a service agreement for a 6-month consulting engagement."
+- "Write an employment contract for a remote senior developer in Vietnam."