feat: add ChatGPT Work plugin exports and skill routing checks

.github/workflows/ci.yml

@@ -34,6 +34,9 @@ jobs:
       - name: Validate pack structure
         run: node ./scripts/validate-pack.mjs
 
+      - name: Build and test ChatGPT Work plugin exports
+        run: npm run work:test
+
       - name: Smoke install on Unix
         if: runner.os != 'Windows'
         run: |

.github/workflows/release.yml

@@ -35,7 +35,7 @@ jobs:
         run: |
           git archive --format=zip --output "codexkit-source-${GITHUB_REF_NAME}.zip" HEAD
           mkdir -p release/codexkit-starter-pack
-          cp -R skills templates workspaces playbooks automations mcp scripts release/codexkit-starter-pack/
+          cp -R skills templates workspaces playbooks automations mcp scripts config docs tests release/codexkit-starter-pack/
           cp README.md LICENSE NOTICE.md package.json CHANGELOG.md skill-finder.md HUONG-DAN-NHANH.md release/codexkit-starter-pack/
           cp RELEASE-v*.md release/codexkit-starter-pack/ 2>/dev/null || true
           cp START-HERE-WINDOWS.cmd START-HERE.sh release/codexkit-starter-pack/

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-10-11
+
+### Added
+
+- **ChatGPT Work export**: Build portable ZIPs for all 90 skills and 14 curated domain plugins, plus a local marketplace manifest, from the existing CodexKit sources.
+- **Routing coverage checks**: Add positive and near-miss fixtures for each plugin group, with validation of exported metadata, manifests, marketplace entries, and ZIP structure.
+- **ChatGPT Work guide**: Document single-skill uploads, local marketplace setup, explicit and automatic invocation, manual activation checks, and differences between Codex and Work updates.
+
+### Changed
+
+- Normalize CodexKit version and category metadata into Agent Skills fields in exported `SKILL.md` files without changing the Codex source layout.
+- Extend CI and release starter-pack contents to validate and ship the Work export, documentation, and test fixtures.
+- Update skill-authoring guidance for portable Work exports.
+
 ## [0.10.0] - 2026-05-15
 
 ### Added

README.md

@@ -31,7 +31,7 @@ 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.10.0.zip`.
+2. Download `codexkit-starter-pack-v0.11.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.
@@ -96,6 +96,17 @@ If the install completed but the skills do not appear:
 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.
 
+### ChatGPT Work and plugin exports
+
+CodexKit also builds portable skill ZIPs and curated Work plugin packages from the same source skills. This export leaves the Codex install folders unchanged.
+
+```bash
+npm run work:build
+npm run work:test
+```
+
+See [ChatGPT Work and Codex plugin guide](./docs/chatgpt-work.md) for single-skill upload, local marketplace setup, routing design, and manual activation checks. Product access and install options vary by plan, workspace settings, and client surface.
+
 ### 2. Validate the pack
 
 ```bash
@@ -264,26 +275,26 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide.
 - 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.10.0` after validating the pack and docs build.
+- Tag `v0.11.0` after validating the pack, Work exports, 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.10.0`
-5. Push the tag: `git push origin v0.10.0`
-6. GitHub Actions publishes:
-   `codexkit-source-v0.10.0.zip`
-   `codexkit-starter-pack-v0.10.0.zip`
+1. Update `package.json`, `web/package.json`, `CHANGELOG.md`, and `RELEASE-v0.11.0.md`.
+2. Run `npm run check` (including `npm run work:test`).
+3. Merge the validated release candidate into `main`.
+4. Create the tag from the release commit: `git tag v0.11.0`
+5. Push the tag: `git push origin v0.11.0`
+6. GitHub Actions validates the release and publishes:
+   `codexkit-source-v0.11.0.zip`
+   `codexkit-starter-pack-v0.11.0.zip`
 
 ## Related files
 
 - [CONTRIBUTING.md](./CONTRIBUTING.md)
 - [SECURITY.md](./SECURITY.md)
 - [NOTICE.md](./NOTICE.md)
-- [RELEASE-v0.10.0.md](./RELEASE-v0.10.0.md)
+- [RELEASE-v0.11.0.md](./RELEASE-v0.11.0.md)
 - [templates/project-brief.md](./templates/project-brief.md)
 - [templates/release-checklist.md](./templates/release-checklist.md)
 - [workspaces/README.md](./workspaces/README.md)

RELEASE-v0.11.0.md

@@ -0,0 +1,39 @@
+# CodexKit v0.11.0 — ChatGPT Work exports
+
+> Portable Work plugin packages and skill ZIPs, with routing and packaging checks, built from the existing CodexKit skill library.
+
+## Summary
+
+v0.11.0 makes CodexKit skills easier to use across Codex and ChatGPT Work. It adds an export pipeline for individual skill ZIPs, curated domain plugins, and a local marketplace manifest while preserving the existing Codex source layout.
+
+## Added
+
+- Portable ZIP exports for all 90 skills.
+- 14 curated plugin packages and a local marketplace manifest.
+- Routing fixtures for each plugin group, including near-miss cases.
+- Documentation for Work installation, invocation, activation checks, and update differences.
+
+## Improved
+
+- Exported `SKILL.md` files normalize CodexKit version and category metadata into Agent Skills fields.
+- CI validates plugin manifests, metadata, ZIP contents, and routing fixture coverage on Ubuntu and Windows.
+- Release starter packs include the Work export, documentation, and tests.
+
+## Validation
+
+The release workflow runs:
+
+```bash
+npm run check
+```
+
+This validates the source pack, builds and tests the Work exports, lints the documentation app, and builds the production docs site.
+
+## Upgrade notes
+
+No migration is required. Existing Codex users can update as usual. ChatGPT Work users can use the guide at [docs/chatgpt-work.md](./docs/chatgpt-work.md) to upload a skill or configure the local marketplace. Product access and installation options depend on the account, workspace settings, and client surface.
+
+## Release assets
+
+- `codexkit-source-v0.11.0.zip`
+- `codexkit-starter-pack-v0.11.0.zip`

config/chatgpt-work-groups.json

@@ -0,0 +1,100 @@
+{
+  "📬 Daily Office & Communication": {
+    "slug": "daily-office",
+    "displayName": "CodexKit: Daily Office",
+    "description": "Draft and organize everyday work communication, meeting follow-ups, briefings, reports, and presentations.",
+    "shortDescription": "Clear everyday communication and meeting workflows",
+    "keywords": ["communication", "meetings", "office", "reports"]
+  },
+  "📊 Project Management": {
+    "slug": "project-management",
+    "displayName": "CodexKit: Project Management",
+    "description": "Plan and govern projects, improve backlogs and team flow, manage risks, and coordinate delivery work.",
+    "shortDescription": "Practical project and portfolio management workflows",
+    "keywords": ["project-management", "delivery", "agile", "risk"]
+  },
+  "💰 Finance": {
+    "slug": "finance",
+    "displayName": "CodexKit: Finance",
+    "description": "Explain financial performance, coordinate close, assess statements, and build forecasts and scenarios.",
+    "shortDescription": "Finance analysis, close, and planning workflows",
+    "keywords": ["finance", "forecasting", "budget", "analysis"]
+  },
+  "⚖️ Legal & Compliance": {
+    "slug": "legal-compliance",
+    "displayName": "CodexKit: Legal & Compliance",
+    "description": "Structure legal intake, review contracts and compliance gaps, and prepare risk-aware legal work products.",
+    "shortDescription": "Legal intake, contract, and compliance workflows",
+    "keywords": ["legal", "compliance", "contracts", "risk"]
+  },
+  "👥 HR & Talent": {
+    "slug": "hr-talent",
+    "displayName": "CodexKit: HR & Talent",
+    "description": "Support hiring, onboarding, performance feedback, interviews, and talent review with structured workflows.",
+    "shortDescription": "Hiring, onboarding, and talent workflows",
+    "keywords": ["hr", "hiring", "talent", "onboarding"]
+  },
+  "📈 Strategy & Executive": {
+    "slug": "strategy-executive",
+    "displayName": "CodexKit: Strategy",
+    "description": "Turn market, operating, and performance evidence into strategy options, executive briefs, and scorecards.",
+    "shortDescription": "Strategy, executive briefs, and scorecards",
+    "keywords": ["strategy", "executive", "leadership", "analysis"]
+  },
+  "🏭 Operations & Supply Chain": {
+    "slug": "operations-supply-chain",
+    "displayName": "CodexKit: Operations",
+    "description": "Improve operating processes, supplier decisions, S&OP, KPI reviews, and continuous improvement.",
+    "shortDescription": "Operations and supply chain workflows",
+    "keywords": ["operations", "supply-chain", "process", "procurement"]
+  },
+  "🎯 Marketing & Customer Success": {
+    "slug": "marketing-customer-success",
+    "displayName": "CodexKit: Marketing & CX",
+    "description": "Plan positioning, go-to-market, campaigns, customer journeys, support, and customer success reviews.",
+    "shortDescription": "Marketing, customer success, and CX workflows",
+    "keywords": ["marketing", "customer-success", "cx", "sales"]
+  },
+  "📊 Data & Analytics": {
+    "slug": "data-analytics",
+    "displayName": "CodexKit: Data & Analytics",
+    "description": "Design experiments, analyze survey and KPI data, improve data quality, and create reliable SQL queries.",
+    "shortDescription": "Reliable analysis and data workflows",
+    "keywords": ["data", "analytics", "sql", "experiments"]
+  },
+  "🔧 Engineering & Code": {
+    "slug": "engineering-code",
+    "displayName": "CodexKit: Engineering",
+    "description": "Understand repositories, review code and APIs, investigate bugs, harden tests, and improve technical delivery.",
+    "shortDescription": "Engineering, code review, and repo workflows",
+    "keywords": ["engineering", "code", "testing", "developer-tools"]
+  },
+  "🖥️ IT & Admin": {
+    "slug": "it-admin",
+    "displayName": "CodexKit: IT & Admin",
+    "description": "Compare vendors and plan organizational change for IT and administrative operations.",
+    "shortDescription": "IT and administrative decision workflows",
+    "keywords": ["it", "admin", "vendors", "change-management"]
+  },
+  "🎓 Training & Development": {
+    "slug": "training-development",
+    "displayName": "CodexKit: Learning & Development",
+    "description": "Identify workforce learning needs and design structured workshops and development activities.",
+    "shortDescription": "Training needs and workshop workflows",
+    "keywords": ["training", "development", "learning", "workshops"]
+  },
+  "🔗 Cross-Functional": {
+    "slug": "cross-functional",
+    "displayName": "CodexKit: Cross-Functional",
+    "description": "Create decision records, business cases, policy documents, and crisis communications across teams.",
+    "shortDescription": "Decision, policy, and cross-team workflows",
+    "keywords": ["decisions", "policy", "business-case", "communication"]
+  },
+  "📐 Skill Authoring": {
+    "slug": "skill-authoring",
+    "displayName": "CodexKit: Skill Authoring",
+    "description": "Author and review focused, reusable CodexKit skills with clear triggers, workflows, and verification.",
+    "shortDescription": "Create and review reusable skills",
+    "keywords": ["skills", "authoring", "workflows", "codex"]
+  }
+}

docs/chatgpt-work.md

@@ -0,0 +1,49 @@
+# CodexKit for ChatGPT Work and Codex
+
+CodexKit keeps its source skills in the repository's existing format. The Work export is generated from those source files so the Codex install flow is not changed. Build it after pulling the latest repository changes:
+
+```bash
+npm run work:build
+npm run work:test
+```
+
+The build creates:
+
+- `dist/work/skill-zips/`: one portable ZIP per skill, with a single top-level skill directory.
+- `dist/work/plugin-zips/`: one ZIP per curated domain plugin.
+- `dist/work/plugins/`: unpacked plugin packages for local testing.
+- `.agents/plugins/marketplace.json`: a local marketplace manifest referencing the generated plugin directories.
+
+## Choose an install route
+
+**For one skill:** use the ChatGPT Skills interface and upload the corresponding ZIP from `dist/work/skill-zips/`. This keeps the installation small and focused. If your account does not show Skills, access may depend on plan, workspace settings, or rollout availability.
+
+**For a domain bundle:** in ChatGPT desktop Work mode or Codex, add the repository as a plugin marketplace using the supported plugin flow, then install only the plugin you need. The generated marketplace references local paths, so it is intended for a checkout on your machine and is not itself a public hosted marketplace. Restart or refresh the client if the newly installed skills do not appear.
+
+**For teams:** commit the selected unpacked plugin package to a repository or publish it through the product's supported marketplace process. Do not distribute `.env` files, tokens, or other credentials with a skills package.
+
+The installation and update behavior differs by route: a copied skill folder is editable and must be refreshed from a newer CodexKit release manually; a marketplace plugin may be managed by the host client. Avoid installing the same skills through multiple routes in the same agent, because duplicate copies make it harder to tell which version was invoked.
+
+## Keep routing predictable
+
+A skill's frontmatter description is its trigger contract. Keep it concise and concrete: state the task it handles and the useful input or desired output. Avoid vague descriptions that overlap with many unrelated skills. The generated ZIP keeps each skill's original instructions and converts CodexKit's `version` and `category` fields into standard `metadata` entries for portable consumers.
+
+CodexKit's source files already mark some skills as explicit-only in `agents/openai.yaml`. Preserve that choice for workflows where accidental invocation would be confusing or risky. For other skills, use descriptions that make the intended request easy to recognize.
+
+Use two invocation patterns deliberately:
+
+- **User-invoked:** the user asks for a named workflow or types the skill name. These skills can coordinate a multi-step flow or gather missing setup choices.
+- **Model-invoked:** the assistant can select the skill when a request clearly matches its scope. These skills should be narrow, reusable procedures that work as one part of a larger task.
+
+A user-invoked workflow can call reusable model-invoked procedures; keep the call direction one-way to avoid circular skill chains. Prefer a few focused skills that compose through clear handoffs over one skill that tries to own an entire project lifecycle.
+
+## Evaluate routing and output
+
+`tests/skill-routing-evals.json` is a lightweight, human-reviewed set of examples for each Work plugin group. It includes positive examples and near-miss prompts that should not route to that group. The checker verifies coverage and schema; it does not run an LLM or claim to measure model quality. When changing descriptions or group membership:
+
+1. Update the relevant positive and negative prompts.
+2. Run `npm run work:test`.
+3. In the target client, manually check whether representative prompts select a useful skill and whether near-misses stay out of scope.
+4. Record any observed false activations or missed activations in the PR so future edits can compare against them.
+
+When a workflow has meaningful failure modes, add examples and verification materials to the skill itself. Keep instructions short enough to follow, and use focused reference files for longer domain material.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexkit",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "private": true,
   "repository": {
     "type": "git",
@@ -29,10 +29,12 @@
     "productivity"
   ],
   "scripts": {
-    "check": "node scripts/validate-pack.mjs && npm --prefix web run lint && npm --prefix web run build",
+    "check": "node scripts/validate-pack.mjs && npm run work:test && npm --prefix web run lint && npm --prefix web run build",
     "dev": "npm --prefix web run dev",
     "build": "npm --prefix web run build",
     "lint": "npm --prefix web run lint",
-    "validate": "node scripts/validate-pack.mjs"
+    "validate": "node scripts/validate-pack.mjs",
+    "work:build": "node ./scripts/build-work-plugins.mjs",
+    "work:test": "npm run work:build && node ./scripts/test-work-plugins.mjs"
   }
 }