sdtk-kit 0.3.3 → 0.3.5

package/README.md

@@ -36,7 +36,9 @@ sdtk generate --feature-key USER_PROFILE --feature-name "User Profile"
 Initialize SDTK workspace in the current or specified project directory.
 
 ```bash
-sdtk init --runtime <codex|claude> [--project-path <path>] [--force] [--skip-skills]
+sdtk init --runtime <codex|claude> [--project-path <path>] [--force] [--runtime-scope <project|user>] [--skip-runtime-assets]
+
+# Deprecated: --skip-skills (use --skip-runtime-assets instead)
 ```
 
 Creates:
@@ -44,7 +46,9 @@ Creates:
 - `sdtk.config.json` -- project configuration
 - `sdtk.config.profiles.example.json` -- stack profile examples
 - `CODEX.md` or `CLAUDE.md` -- runtime adapter
-- for `--runtime claude`, local `.claude/skills` and `.claude/skills/references` are installed unless `--skip-skills` is used
+- for `--runtime claude`, skill files are installed into `.claude/skills/` (project scope, default) or `~/.claude/skills/` (user scope) unless `--skip-runtime-assets` is used
+- for `--runtime codex`, skill files are installed into `$CODEX_HOME/skills/` or `~/.codex/skills/` (user scope only) unless `--skip-runtime-assets` is used
+- `--skip-skills` is deprecated; use `--skip-runtime-assets` instead
 
 ### `sdtk auth`
 
@@ -83,6 +87,36 @@ sdtk generate --feature-key <UPPER_SNAKE_CASE> --feature-name "<text>" [--projec
 
 Output files include: project initiation, BA spec, flow-action spec, PRD, backlog, architecture design, database spec, API specs (OpenAPI + endpoints + design detail + flow list), UI design layout, implementation plan, test cases, and QA release report.
 
+### `sdtk runtime`
+
+Manage runtime skill assets independently of `sdtk init`.
+
+```bash
+sdtk runtime install --runtime <codex|claude> [--scope <project|user>]
+sdtk runtime uninstall --runtime <codex|claude> [--scope <project|user>]
+sdtk runtime status --runtime <codex|claude>
+```
+
+Scope defaults:
+- `claude`: `project` (installs to `.claude/skills/`); `user` installs to `~/.claude/skills/`
+- `codex`: `user` only (installs to `$CODEX_HOME/skills/` or `~/.codex/skills/`); project scope is not supported (Gate C0)
+
+Examples:
+
+```bash
+# Install Claude skills at project scope (default)
+sdtk runtime install --runtime claude
+
+# Install Claude skills at user scope
+sdtk runtime install --runtime claude --scope user
+
+# Check installed runtime assets
+sdtk runtime status --runtime claude
+
+# Remove runtime assets
+sdtk runtime uninstall --runtime claude --scope project
+```
+
 ### `sdtk --help` / `sdtk --version`
 
 ```bash

package/assets/manifest/toolkit-bundle.manifest.json

@@ -1,5 +1,8 @@
 {
-    "buildTimestamp":  "2026-03-07T00:53:22Z",
+    "version":  "0.3.5",
+    "sourceCommit":  "537f76cfcb2d42882cc5fb19946f0389279e1583",
+    "buildTimestamp":  "2026-03-11T08:51:43Z",
+    "fileCount":  81,
     "files":  [
                   {
                       "path":  "toolkit/AGENTS.md",
@@ -8,8 +11,8 @@
                   },
                   {
                       "path":  "toolkit/install.ps1",
-                      "sha256":  "531da17e88a05b6946a5012f7b13a2871212df1fe0d052720f9511e02aba7e32",
-                      "size":  8830
+                      "sha256":  "e717a2791fb597d7a21f57f4c4790dbc545e954f0af3ca0c47f160f78c8a2474",
+                      "size":  9777
                   },
                   {
                       "path":  "toolkit/runtimes/claude/CLAUDE_TEMPLATE.md",
@@ -26,10 +29,20 @@
                       "sha256":  "5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65",
                       "size":  10557
                   },
+                  {
+                      "path":  "toolkit/scripts/install-claude-skills.ps1",
+                      "sha256":  "8c66c27262ad4abc3c42bbcbe3a97752a5f29956ac93397133e6780354911549",
+                      "size":  4315
+                  },
                   {
                       "path":  "toolkit/scripts/install-codex-skills.ps1",
-                      "sha256":  "68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0",
-                      "size":  9175
+                      "sha256":  "ca64e0c2a0f13137bc6b780a57442de46a3e0551778bbcbadd4eb779c21cb203",
+                      "size":  9427
+                  },
+                  {
+                      "path":  "toolkit/scripts/uninstall-claude-skills.ps1",
+                      "sha256":  "809ffc1f96528ac1cd453214cd1c2d231ca0753f0d3c19b4a20f11835a64a152",
+                      "size":  4482
                   },
                   {
                       "path":  "toolkit/scripts/uninstall-codex-skills.ps1",
@@ -88,8 +101,8 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-api-doc/SKILL.md",
-                      "sha256":  "d93980bc0332f25852a5e4b0e5187bde7185a5ede70c59c8ebaf542afdb42188",
-                      "size":  1966
+                      "sha256":  "2c4bc8edda84f20bf05130fdf19b9abd562dd87b03508301dff9ccd877b52a2f",
+                      "size":  2248
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md",
@@ -118,13 +131,13 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-arch/SKILL.md",
-                      "sha256":  "ddf57e65096fc6f1bdd0f2c829f2580d2d7edb99f79d3cba7a3f68e69d373f46",
-                      "size":  2489
+                      "sha256":  "78275557bbea966134422423fb6910cecdc5468e7bf2abb777ff1c4233345639",
+                      "size":  2597
                   },
                   {
                       "path":  "toolkit/skills/sdtk-ba/SKILL.md",
-                      "sha256":  "7bc02ad898b5e7dc36282026dcc718818600a507d18046a9e80d8e6eba588131",
-                      "size":  1041
+                      "sha256":  "0a7c6aa20be2e29aa2124355264ee45847df76f635437c2d05ddd26f7121f12e",
+                      "size":  1177
                   },
                   {
                       "path":  "toolkit/skills/sdtk-design-layout/SKILL.md",
@@ -158,8 +171,8 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-qa/SKILL.md",
-                      "sha256":  "c221eb80c68ba8672fb8a3c13fd6b36d5b65ccdd9988a32be88c6589c4594498",
-                      "size":  1142
+                      "sha256":  "564c536395227511ac9be215e41a3b5604e2f249da28319417ca75a6bfe8ed3b",
+                      "size":  1459
                   },
                   {
                       "path":  "toolkit/skills/sdtk-screen-design-spec/references/excel-image-export.md",
@@ -208,8 +221,8 @@
                   },
                   {
                       "path":  "toolkit/skills/sdtk-test-case-spec/SKILL.md",
-                      "sha256":  "72ca16e07c286910333243954610e116217ca2abb3a5e276cbe91e92eb826ad5",
-                      "size":  2652
+                      "sha256":  "727a9870a455e9c455b2c405cb52c6b9867f229fa56d8ce9408e66b6f6cae4a5",
+                      "size":  2842
                   },
                   {
                       "path":  "toolkit/skills-claude/api-design-spec/SKILL.md",
@@ -218,18 +231,18 @@
                   },
                   {
                       "path":  "toolkit/skills-claude/api-doc/SKILL.md",
-                      "sha256":  "57176bb3d74e19ef5feb1a8d59d8c7c1714634f67e1d51bf4667d3f189093319",
-                      "size":  2240
+                      "sha256":  "6f6ddb470bc61d286b84418e299b360d5f148e6bed75fa50b6c8f2929e6fe49c",
+                      "size":  2518
                   },
                   {
                       "path":  "toolkit/skills-claude/arch/SKILL.md",
-                      "sha256":  "5ab03dc8a928c6528d1ccaad427a15c686427e8fd9114421da495d9223652337",
-                      "size":  4108
+                      "sha256":  "e293fd71f9fc71ac63e5e53bf55fbfe9c71e186e298b2fd3429c71a4e972a8b1",
+                      "size":  4175
                   },
                   {
                       "path":  "toolkit/skills-claude/ba/SKILL.md",
-                      "sha256":  "1956fd69ff1a0adb54c8abbf06b37bd5c21b7f0ca597b6d8b94dfed0606cd2e4",
-                      "size":  2551
+                      "sha256":  "4dd1db27839c73a8ec0bba2b465b7cacffd55393a325a822ced8f2f209f6b51b",
+                      "size":  2648
                   },
                   {
                       "path":  "toolkit/skills-claude/design-layout/SKILL.md",
@@ -263,8 +276,8 @@
                   },
                   {
                       "path":  "toolkit/skills-claude/qa/SKILL.md",
-                      "sha256":  "eb0a540d28144855b5026e7b40ce965c4049a9b56f6e7ffd9732964006f63d1a",
-                      "size":  2687
+                      "sha256":  "3ab5af1b27aa0947052ef7b76abca132d89b78b74516b8668474c08c344289aa",
+                      "size":  2956
                   },
                   {
                       "path":  "toolkit/skills-claude/screen-design-spec/SKILL.md",
@@ -273,8 +286,8 @@
                   },
                   {
                       "path":  "toolkit/skills-claude/test-case-spec/SKILL.md",
-                      "sha256":  "efd43e2087961f4e30177144c42e06b6c9b3d73f9533dad34f9ce1284fcdf126",
-                      "size":  2625
+                      "sha256":  "c397431a7752fcdee1dbb7720472703d262bfcc8fb543c4562fbc24a79064769",
+                      "size":  2806
                   },
                   {
                       "path":  "toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md",
@@ -396,8 +409,5 @@
                       "sha256":  "2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2",
                       "size":  3255
                   }
-              ],
-    "sourceCommit":  "4437ad41659a38e9e80dcbf32cb03f9b6df64e0d",
-    "version":  "0.3.3",
-    "fileCount":  79
+              ]
 }

package/assets/manifest/toolkit-bundle.sha256.txt

@@ -1,9 +1,11 @@
 868430474b46e4e8d27ed26b780a794936e84cf4f0278f2cc3d061f54877f498  toolkit/AGENTS.md
-531da17e88a05b6946a5012f7b13a2871212df1fe0d052720f9511e02aba7e32  toolkit/install.ps1
+e717a2791fb597d7a21f57f4c4790dbc545e954f0af3ca0c47f160f78c8a2474  toolkit/install.ps1
 0f3e0bfe1b5165250f0da4da5790a9e6220023752713088a0076eb7f17fd6397  toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
 4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62  toolkit/runtimes/codex/CODEX_TEMPLATE.md
 5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65  toolkit/scripts/init-feature.ps1
-68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0  toolkit/scripts/install-codex-skills.ps1
+8c66c27262ad4abc3c42bbcbe3a97752a5f29956ac93397133e6780354911549  toolkit/scripts/install-claude-skills.ps1
+ca64e0c2a0f13137bc6b780a57442de46a3e0551778bbcbadd4eb779c21cb203  toolkit/scripts/install-codex-skills.ps1
+809ffc1f96528ac1cd453214cd1c2d231ca0753f0d3c19b4a20f11835a64a152  toolkit/scripts/uninstall-claude-skills.ps1
 e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f  toolkit/scripts/uninstall-codex-skills.ps1
 de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49  toolkit/sdtk.config.json
 21b1b0212f85c76dc6a89ae5936b39c4c1df7837a333f7a3db337f3039babb7b  toolkit/sdtk.config.profiles.example.json
@@ -15,21 +17,21 @@ c6147e7b01632cb6ffa017af43e4e5c9e1f98d160ed812ade1d087b1f3ca5490  toolkit/skills
 13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/skills/sdtk-api-doc/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
 decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-api-doc/references/FLOWCHART_CREATION_RULES.md
 f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-api-doc/references/YAML_CREATION_RULES.md
-d93980bc0332f25852a5e4b0e5187bde7185a5ede70c59c8ebaf542afdb42188  toolkit/skills/sdtk-api-doc/SKILL.md
+2c4bc8edda84f20bf05130fdf19b9abd562dd87b03508301dff9ccd877b52a2f  toolkit/skills/sdtk-api-doc/SKILL.md
 9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2  toolkit/skills/sdtk-arch/references/API_DESIGN_CREATION_RULES.md
 13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/skills/sdtk-arch/references/API_DESIGN_FLOWCHART_CREATION_RULES.md
 b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0  toolkit/skills/sdtk-arch/references/FLOW_ACTION_SPEC_CREATION_RULES.md
 decffe52425e22b3dd82e9c8f3768aefbb209ec58237107d84f583fee876ea8f  toolkit/skills/sdtk-arch/references/FLOWCHART_CREATION_RULES.md
 f29c6774019ef0789dfb88678e1ab31d4d8eb7b3ab69b2115368ef5d879e5276  toolkit/skills/sdtk-arch/references/YAML_CREATION_RULES.md
-ddf57e65096fc6f1bdd0f2c829f2580d2d7edb99f79d3cba7a3f68e69d373f46  toolkit/skills/sdtk-arch/SKILL.md
-7bc02ad898b5e7dc36282026dcc718818600a507d18046a9e80d8e6eba588131  toolkit/skills/sdtk-ba/SKILL.md
+78275557bbea966134422423fb6910cecdc5468e7bf2abb777ff1c4233345639  toolkit/skills/sdtk-arch/SKILL.md
+0a7c6aa20be2e29aa2124355264ee45847df76f635437c2d05ddd26f7121f12e  toolkit/skills/sdtk-ba/SKILL.md
 8eabb7bdb821a91766ccd5b5fdcc1a4e876b51052cd6c6429b98b4d9946e2b1a  toolkit/skills/sdtk-design-layout/SKILL.md
 7a7f5a799247896a8ddebc5cefec25450bf9284d34044b6b69b13e4535c005a1  toolkit/skills/sdtk-dev/SKILL.md
 4b242b5f86d0074538e14721cc66c0fbaac5757e984796145f5e4477c89c6729  toolkit/skills/sdtk-dev-backend/SKILL.md
 390d895ab5da1fd214efecdbbd13c81e92815d4db157a7e9e8f32c79e09439dd  toolkit/skills/sdtk-dev-frontend/SKILL.md
 e6560b5a0c893d66117eedac3762bb0758553a80bcd1e7c24c84ba91f6ab7f9c  toolkit/skills/sdtk-orchestrator/SKILL.md
 7dd81943172b1d7a96093424b0ba76519db3d713272374d5c4aedb15f37adbe2  toolkit/skills/sdtk-pm/SKILL.md
-c221eb80c68ba8672fb8a3c13fd6b36d5b65ccdd9988a32be88c6589c4594498  toolkit/skills/sdtk-qa/SKILL.md
+564c536395227511ac9be215e41a3b5604e2f249da28319417ca75a6bfe8ed3b  toolkit/skills/sdtk-qa/SKILL.md
 97f65fd84c80e4836c9bbb82d8b7fc81527336c55dbbd82ea5e69672e21b22e4  toolkit/skills/sdtk-screen-design-spec/references/excel-image-export.md
 a9b414a07d76e63331ffc832dea2381357f9a99e2cd82ea74f713b3a9d7acee7  toolkit/skills/sdtk-screen-design-spec/references/figma-mcp.md
 b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0  toolkit/skills/sdtk-screen-design-spec/references/FLOW_ACTION_SPEC_CREATION_RULES.md
@@ -39,20 +41,20 @@ ae0bc9b120c19a142f10cc79168a8f7d6bf8a37e48341fc16cbc74bbdc2e692c  toolkit/skills
 876d546e077ce451082792776360a4a309cc79a34c74234f1b55f80c56b159d1  toolkit/skills/sdtk-screen-design-spec/SKILL.md
 7c21e74f5eee712c6b65665b4f10483ed008113186a92dc0a4673ce1fcd3ef5c  toolkit/skills/sdtk-test-case-spec/references/TEST_CASE_CREATION_RULES.md
 4d1e813908114f2be68007fb7373973e2c6e0aebc5a6305b8b19443d5ae477d0  toolkit/skills/sdtk-test-case-spec/scripts/validate_test_case_spec.py
-72ca16e07c286910333243954610e116217ca2abb3a5e276cbe91e92eb826ad5  toolkit/skills/sdtk-test-case-spec/SKILL.md
+727a9870a455e9c455b2c405cb52c6b9867f229fa56d8ce9408e66b6f6cae4a5  toolkit/skills/sdtk-test-case-spec/SKILL.md
 123873681ff65792a9a269b264155c65a5feb68b23e4eeb1e68cb7da1a137d54  toolkit/skills-claude/api-design-spec/SKILL.md
-57176bb3d74e19ef5feb1a8d59d8c7c1714634f67e1d51bf4667d3f189093319  toolkit/skills-claude/api-doc/SKILL.md
-5ab03dc8a928c6528d1ccaad427a15c686427e8fd9114421da495d9223652337  toolkit/skills-claude/arch/SKILL.md
-1956fd69ff1a0adb54c8abbf06b37bd5c21b7f0ca597b6d8b94dfed0606cd2e4  toolkit/skills-claude/ba/SKILL.md
+6f6ddb470bc61d286b84418e299b360d5f148e6bed75fa50b6c8f2929e6fe49c  toolkit/skills-claude/api-doc/SKILL.md
+e293fd71f9fc71ac63e5e53bf55fbfe9c71e186e298b2fd3429c71a4e972a8b1  toolkit/skills-claude/arch/SKILL.md
+4dd1db27839c73a8ec0bba2b465b7cacffd55393a325a822ced8f2f209f6b51b  toolkit/skills-claude/ba/SKILL.md
 9765f229108c5aff27457489707218570ad83dc362353a79c2f5a78607adf4de  toolkit/skills-claude/design-layout/SKILL.md
 cea9f6512bc805d5b22a84a4ef8dbd229b4f7a3f073f9e125e933e6e79a206d5  toolkit/skills-claude/dev/SKILL.md
 142a8fe088a4b0326ca79e00200cb5f562c53728b7adc83e6b749db6e29f1d0d  toolkit/skills-claude/dev-backend/SKILL.md
 1631bd51bc3d0106c18f4c00412f6279626bdce9f0e310822d5dcdff08063a88  toolkit/skills-claude/dev-frontend/SKILL.md
 c8e8303f1833e71cacdf20b1f398e476b44b3de14fbffad9a404c2a68fa713a3  toolkit/skills-claude/orchestrator/SKILL.md
 b34621fe61957e573c616ad816d591a60a6c8d1333d0bfb71f39f45b93331cb0  toolkit/skills-claude/pm/SKILL.md
-eb0a540d28144855b5026e7b40ce965c4049a9b56f6e7ffd9732964006f63d1a  toolkit/skills-claude/qa/SKILL.md
+3ab5af1b27aa0947052ef7b76abca132d89b78b74516b8668474c08c344289aa  toolkit/skills-claude/qa/SKILL.md
 5686da60872f1a3c6791e9a740897d4a564f40d53d54902a47fbc3165e68a1ec  toolkit/skills-claude/screen-design-spec/SKILL.md
-efd43e2087961f4e30177144c42e06b6c9b3d73f9533dad34f9ce1284fcdf126  toolkit/skills-claude/test-case-spec/SKILL.md
+c397431a7752fcdee1dbb7720472703d262bfcc8fb543c4562fbc24a79064769  toolkit/skills-claude/test-case-spec/SKILL.md
 9adf1e46833411a861fb7426c37baac69689b9e3120a8ed1e4a3224de44a8dd2  toolkit/templates/docs/api/API_DESIGN_CREATION_RULES.md
 d2aa0ee3a7c5351700b3bffb4ba66e8056ed955f55903c744c694624730038cb  toolkit/templates/docs/api/API_DESIGN_DETAIL_TEMPLATE.md
 13f26a3307894b9bfb570d75f6db4ccb61104064d19661ec2a26a1b9984f4c97  toolkit/templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md

package/assets/toolkit/toolkit/install.ps1

@@ -2,9 +2,12 @@ param(
   [string]$ProjectPath,
   [switch]$Force,
   [switch]$SkipSkills,
+  [switch]$SkipRuntimeAssets,
   [switch]$Quiet,
   [ValidateSet('codex', 'claude')]
-  [string]$Runtime = 'codex'
+  [string]$Runtime = 'codex',
+  [ValidateSet('project', 'user', '')]
+  [string]$Scope = ''
 )
 
 $ErrorActionPreference = 'Stop'
@@ -181,6 +184,15 @@ if (-not $ProjectPath) {
 }
 $projectRoot = Resolve-Path -LiteralPath $ProjectPath
 
+# Merge SkipRuntimeAssets and legacy SkipSkills
+if ($SkipRuntimeAssets) { $SkipSkills = $true }
+
+# Default scope: project for Claude, user for Codex
+if (-not $Scope -or $Scope -eq '') {
+  if ($Runtime -eq 'claude') { $Scope = 'project' }
+  else { $Scope = 'user' }
+}
+
 if (-not $Quiet) {
   Write-Host "SDTK toolkit : $toolkitRoot"
   Write-Host "Project root : $projectRoot"
@@ -217,17 +229,29 @@ if (($Runtime -eq 'codex') -and (-not $SkipSkills)) {
   }
 
   Write-Host ""
-  Write-Host "Installing Codex skills globally..."
+  Write-Host "Installing Codex skills (scope: $Scope)..."
   if ($Force) {
-    & $skillInstaller -Force | Out-Host
+    & $skillInstaller -Scope $Scope -Force | Out-Host
   } else {
-    & $skillInstaller | Out-Host
+    & $skillInstaller -Scope $Scope | Out-Host
   }
 }
 elseif (($Runtime -eq 'claude') -and (-not $SkipSkills)) {
-  Write-Host ""
-  Write-Host "Installing Claude Code skills..."
-  Install-ClaudeSkills -ToolkitRoot $toolkitRoot -ProjectRoot $projectRoot -Overwrite ([bool]$Force)
+  $skillInstaller = Join-Path $toolkitRoot 'scripts/install-claude-skills.ps1'
+  if (-not (Test-Path -LiteralPath $skillInstaller)) {
+    # Fallback to inline Install-ClaudeSkills for backward compatibility
+    Write-Host ""
+    Write-Host "Installing Claude Code skills..."
+    Install-ClaudeSkills -ToolkitRoot $toolkitRoot -ProjectRoot $projectRoot -Overwrite ([bool]$Force)
+  } else {
+    Write-Host ""
+    Write-Host "Installing Claude Code skills (scope: $Scope)..."
+    if ($Force) {
+      & $skillInstaller -Scope $Scope -ProjectPath $projectRoot.ToString() -Force | Out-Host
+    } else {
+      & $skillInstaller -Scope $Scope -ProjectPath $projectRoot.ToString() | Out-Host
+    }
+  }
 }
 
 if (-not $Quiet) {

package/assets/toolkit/toolkit/scripts/install-claude-skills.ps1

@@ -0,0 +1,129 @@
+param(
+  [string]$ProjectPath,
+  [ValidateSet('project', 'user')]
+  [string]$Scope = 'project',
+  [switch]$Force
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version Latest
+
+function Copy-File {
+  param(
+    [Parameter(Mandatory = $true)][string]$SourcePath,
+    [Parameter(Mandatory = $true)][string]$DestinationPath,
+    [Parameter(Mandatory = $true)][bool]$Overwrite
+  )
+
+  if (-not (Test-Path -LiteralPath $SourcePath)) {
+    throw "Missing source: $SourcePath"
+  }
+
+  if (Test-Path -LiteralPath $DestinationPath) {
+    if (-not $Overwrite) {
+      Write-Warning "Already exists (skipping). Use -Force to overwrite: $DestinationPath"
+      return
+    }
+  }
+
+  $parent = Split-Path -Parent $DestinationPath
+  if ($parent -and -not (Test-Path -LiteralPath $parent)) {
+    New-Item -ItemType Directory -Force -Path $parent | Out-Null
+  }
+
+  Copy-Item -LiteralPath $SourcePath -Destination $DestinationPath -Force
+}
+
+$toolkitRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
+
+# Resolve destination based on scope
+if ($Scope -eq 'user') {
+  $skillsDest = Join-Path $HOME '.claude/skills'
+  Write-Host "Scope: user (installing to $skillsDest)"
+} else {
+  if (-not $ProjectPath) {
+    $ProjectPath = (Resolve-Path (Join-Path $toolkitRoot '..')).Path
+  }
+  $projectRoot = Resolve-Path -LiteralPath $ProjectPath
+  $skillsDest = Join-Path $projectRoot '.claude/skills'
+  Write-Host "Scope: project (installing to $skillsDest)"
+}
+
+$skillsSource = Join-Path $toolkitRoot 'skills-claude'
+if (-not (Test-Path -LiteralPath $skillsSource)) {
+  throw "Claude skills source not found: $skillsSource"
+}
+
+$skillCount = 0
+foreach ($skillDir in (Get-ChildItem -Path $skillsSource -Directory)) {
+  $srcFile = Join-Path $skillDir.FullName 'SKILL.md'
+  if (-not (Test-Path -LiteralPath $srcFile)) { continue }
+
+  $destFile = Join-Path $skillsDest "$($skillDir.Name)/SKILL.md"
+  Copy-File -SourcePath $srcFile -DestinationPath $destFile -Overwrite ([bool]$Force)
+  $skillCount++
+}
+
+# Install reference files
+$refDest = Join-Path $skillsDest 'references'
+if (-not (Test-Path -LiteralPath $refDest)) {
+  New-Item -ItemType Directory -Force -Path $refDest | Out-Null
+}
+
+$refCount = 0
+$missingRefs = @()
+
+# 6 files from toolkit/templates/docs/
+$templateRefs = @(
+  @{ Src = 'templates/docs/api/YAML_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/FLOWCHART_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/api/API_DESIGN_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md' },
+  @{ Src = 'templates/docs/qa/TEST_CASE_CREATION_RULES.md' }
+)
+
+foreach ($ref in $templateRefs) {
+  $srcPath = Join-Path $toolkitRoot $ref.Src
+  $fileName = Split-Path -Leaf $srcPath
+  $destPath = Join-Path $refDest $fileName
+  if (Test-Path -LiteralPath $srcPath) {
+    Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite ([bool]$Force)
+    $refCount++
+  } else {
+    $missingRefs += $srcPath
+  }
+}
+
+# 3 files from toolkit/skills/sdtk-screen-design-spec/references/
+$screenRefs = @('numbering-rules.md', 'figma-mcp.md', 'excel-image-export.md')
+foreach ($fileName in $screenRefs) {
+  $srcPath = Join-Path $toolkitRoot "skills/sdtk-screen-design-spec/references/$fileName"
+  $destPath = Join-Path $refDest $fileName
+  if (Test-Path -LiteralPath $srcPath) {
+    Copy-File -SourcePath $srcPath -DestinationPath $destPath -Overwrite ([bool]$Force)
+    $refCount++
+  } else {
+    $missingRefs += $srcPath
+  }
+}
+
+# Fail-fast: abort if any reference files are missing
+if ($missingRefs.Count -gt 0) {
+  $list = ($missingRefs | ForEach-Object { "  - $_" }) -join "`n"
+  throw "Claude install failed. Missing reference files:`n$list"
+}
+
+# Strict count assertions
+$expectedSkills = 13
+$expectedRefs = 9
+if ($skillCount -ne $expectedSkills) {
+  throw "Claude install failed. Expected $expectedSkills skills but installed $skillCount."
+}
+if ($refCount -ne $expectedRefs) {
+  throw "Claude install failed. Expected $expectedRefs reference files but installed $refCount."
+}
+
+Write-Host "  Skills installed: $skillCount"
+Write-Host "  Reference files : $refCount"
+Write-Host "  Destination     : $skillsDest"

package/assets/toolkit/toolkit/scripts/install-codex-skills.ps1

@@ -1,7 +1,15 @@
 param(
+  [ValidateSet('project', 'user')]
+  [string]$Scope = 'user',
   [switch]$Force
 )
 
+# Gate C0: Codex does not support project-local skills
+if ($Scope -eq 'project') {
+  Write-Error "Codex does not support project-local skills. Use --scope user instead."
+  exit 1
+}
+
 $ErrorActionPreference = 'Stop'
 Set-StrictMode -Version Latest
 

package/assets/toolkit/toolkit/scripts/uninstall-claude-skills.ps1

@@ -0,0 +1,139 @@
+param(
+  [string]$ProjectPath,
+  [ValidateSet('project', 'user')]
+  [string]$Scope = 'project',
+  [string]$SkillName,
+  [switch]$All,
+  [switch]$BackupExisting,
+  [string]$BackupPath
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version Latest
+
+function Backup-Directory {
+  param(
+    [Parameter(Mandatory = $true)][string]$SourcePath,
+    [Parameter(Mandatory = $true)][string]$BackupRoot,
+    [Parameter(Mandatory = $true)][string]$Name
+  )
+
+  if (-not (Test-Path -LiteralPath $SourcePath)) {
+    return $null
+  }
+
+  New-Item -ItemType Directory -Force -Path $BackupRoot | Out-Null
+  $dest = Join-Path $BackupRoot $Name
+  if (Test-Path -LiteralPath $dest) {
+    Remove-Item -LiteralPath $dest -Recurse -Force
+  }
+  Copy-Item -LiteralPath $SourcePath -Destination $dest -Recurse -Force
+  return $dest
+}
+
+if ($All -and $SkillName) {
+  throw "Use either -All or -SkillName, not both."
+}
+
+$toolkitRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
+$skillsSrc = Join-Path $toolkitRoot 'skills-claude'
+if (-not (Test-Path -LiteralPath $skillsSrc)) {
+  throw "Missing toolkit Claude skills source directory: $skillsSrc"
+}
+
+$managedSkillNames = Get-ChildItem -LiteralPath $skillsSrc -Directory | Select-Object -ExpandProperty Name
+if (-not $managedSkillNames -or $managedSkillNames.Count -eq 0) {
+  throw "No managed Claude skills found in: $skillsSrc"
+}
+
+$targetNames = @()
+if ($SkillName) {
+  if ($managedSkillNames -notcontains $SkillName) {
+    throw "Skill '$SkillName' is not in managed Claude skills list. Known skills: $($managedSkillNames -join ', ')"
+  }
+  $targetNames = @($SkillName)
+} elseif ($All) {
+  $targetNames = @($managedSkillNames)
+} else {
+  $targetNames = @($managedSkillNames)
+}
+
+# Resolve destination based on scope
+if ($Scope -eq 'user') {
+  $skillsDest = Join-Path $HOME '.claude/skills'
+} else {
+  if (-not $ProjectPath) {
+    $ProjectPath = (Resolve-Path (Join-Path $toolkitRoot '..')).Path
+  }
+  $projectRoot = Resolve-Path -LiteralPath $ProjectPath
+  $skillsDest = Join-Path $projectRoot '.claude/skills'
+}
+
+if (-not (Test-Path -LiteralPath $skillsDest)) {
+  Write-Host "Claude skills directory not found: $skillsDest"
+  exit 0
+}
+
+$backupRootResolved = $null
+if ($BackupExisting) {
+  if (-not $BackupPath -or $BackupPath.Trim().Length -eq 0) {
+    $timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+    $parentDir = if ($Scope -eq 'user') { Join-Path $HOME '.claude' } else { $projectRoot }
+    $BackupPath = Join-Path $parentDir (Join-Path 'skills-backups' ("uninstall-" + $timestamp))
+  }
+  New-Item -ItemType Directory -Force -Path $BackupPath | Out-Null
+  $backupRootResolved = (Resolve-Path -LiteralPath $BackupPath).Path
+  Write-Host "Backup mode enabled: $backupRootResolved"
+}
+
+$removed = New-Object System.Collections.Generic.List[string]
+$missing = New-Object System.Collections.Generic.List[string]
+
+foreach ($name in $targetNames) {
+  $dest = Join-Path $skillsDest $name
+  if (-not (Test-Path -LiteralPath $dest)) {
+    $missing.Add($name) | Out-Null
+    Write-Warning "Skill not installed, skipping: $name"
+    continue
+  }
+
+  if ($BackupExisting) {
+    $backupDest = Backup-Directory -SourcePath $dest -BackupRoot $backupRootResolved -Name $name
+    if ($backupDest) {
+      Write-Host "Backed up: $name -> $backupDest"
+    }
+  }
+
+  Remove-Item -LiteralPath $dest -Recurse -Force
+  $removed.Add($name) | Out-Null
+  Write-Host "Uninstalled: $name"
+}
+
+# Also remove references directory if uninstalling all
+if ($All -or (-not $SkillName)) {
+  $refDir = Join-Path $skillsDest 'references'
+  if (Test-Path -LiteralPath $refDir) {
+    if ($BackupExisting) {
+      Backup-Directory -SourcePath $refDir -BackupRoot $backupRootResolved -Name 'references' | Out-Null
+      Write-Host "Backed up: references -> $backupRootResolved/references"
+    }
+    Remove-Item -LiteralPath $refDir -Recurse -Force
+    Write-Host "Removed references directory."
+  }
+}
+
+Write-Host ""
+Write-Host "Uninstall summary:"
+Write-Host "- Scope: $Scope"
+Write-Host "- Destination: $skillsDest"
+Write-Host "- Removed: $($removed.Count)"
+if ($removed.Count -gt 0) {
+  $removed | ForEach-Object { Write-Host "  - $_" }
+}
+Write-Host "- Missing/Skipped: $($missing.Count)"
+if ($missing.Count -gt 0) {
+  $missing | ForEach-Object { Write-Host "  - $_" }
+}
+if ($backupRootResolved) {
+  Write-Host "- Backup directory: $backupRootResolved"
+}

package/assets/toolkit/toolkit/skills/sdtk-api-doc/SKILL.md

@@ -23,16 +23,17 @@ description: Generate OpenAPI 3.x YAML and PlantUML flow diagrams for a feature
 2. Read and apply split API rule sources:
    - `./references/YAML_CREATION_RULES.md` for YAML contract rules
    - `./references/API_DESIGN_FLOWCHART_CREATION_RULES.md` for flow list / flowchart rules
-3. Define endpoints mapped to UC-xx; keep path naming consistent across CRUD/search/list/mst patterns.
+3. Define endpoints mapped to UC-xx; keep path naming consistent across CRUD/search/list/mst patterns and apply `governance/ai/core/SDTK_API_PATH_STYLE_POLICY.md` for canonical resource naming.
 4. For each endpoint, document request/response schema and error cases.
 5. Generate/update endpoint markdown (`[FEATURE_KEY]_ENDPOINTS.md`) with summary tables, API type grouping, and screen-logic mapping.
-6. Generate PlantUML flows including: auth, permission check, validation, main logic, error exits.
+6. Generate PlantUML flows including auth, permission check, validation, main logic, and error exits.
 7. Ensure traceability notes reference UC/BR where relevant.
-8. Validate English output hygiene when generating English artifacts:
+8. For benchmark runs, if the requirement or upstream artifacts mark an OQ as expected OPEN, keep that ambiguity explicit in flow list / endpoint docs instead of silently collapsing it.
+9. Validate English output hygiene when generating English artifacts:
    - no mixed-language leftovers in narrative text
    - no mojibake/encoding corruption markers
    - terminology consistency across endpoint detail, summary tables, and flow labels
-9. If orchestrator mode requires API design detail generation (`apiDesignDetailMode=auto/on`), handoff to `sdtk-api-design-spec` after YAML + flow list are updated.
+10. If orchestrator mode requires API design detail generation (`apiDesignDetailMode=auto/on`), handoff to `sdtk-api-design-spec` after YAML + flow list are updated.
 
 ## Reference
 - Deeper analysis: `docs/specs/API_DOC_SKILL_ANALYSIS.md` (if present).