oh-my-agent-commandcode 0.0.0-stage → 20.38.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/README.md +35 -2
  2. package/filter-test-output.sh +52 -0
  3. package/mods/oma.ts +347 -0
  4. package/package.json +30 -4
  5. package/skills/_shared/conditional/experiment-ledger.md +28 -0
  6. package/skills/_shared/conditional/exploration-loop.md +22 -0
  7. package/skills/_shared/conditional/quality-score.md +33 -0
  8. package/skills/_shared/core/anti-ai-prose.md +191 -0
  9. package/skills/_shared/core/api-contracts/README.md +28 -0
  10. package/skills/_shared/core/api-contracts/template.md +90 -0
  11. package/skills/_shared/core/clarification-protocol.md +23 -0
  12. package/skills/_shared/core/code-intelligence.md +46 -0
  13. package/skills/_shared/core/collaboration-policy.md +28 -0
  14. package/skills/_shared/core/common-checklist.md +28 -0
  15. package/skills/_shared/core/context-budget.md +22 -0
  16. package/skills/_shared/core/context-loading.md +34 -0
  17. package/skills/_shared/core/difficulty-guide.md +26 -0
  18. package/skills/_shared/core/execution-policy.md +31 -0
  19. package/skills/_shared/core/lessons-learned.md +33 -0
  20. package/skills/_shared/core/prompt-structure.md +18 -0
  21. package/skills/_shared/core/quality-principles.md +11 -0
  22. package/skills/_shared/core/session-metrics.md +35 -0
  23. package/skills/_shared/core/skill-routing.md +39 -0
  24. package/skills/_shared/core/test-approach.md +54 -0
  25. package/skills/_shared/core/vendor-detection.md +52 -0
  26. package/skills/_shared/runtime/memory-protocol.md +118 -0
  27. package/skills/_shared/runtime/result-contract.md +64 -0
  28. package/skills/_shared/ui-interaction-quality.md +133 -0
  29. package/skills/oma-academic-writing/SKILL.md +181 -0
  30. package/skills/oma-academic-writing/resources/abstract-guide.md +51 -0
  31. package/skills/oma-academic-writing/resources/academic-verb-tiers.md +42 -0
  32. package/skills/oma-academic-writing/resources/anti-ai-checklist.md +52 -0
  33. package/skills/oma-academic-writing/resources/hedging-guide.md +132 -0
  34. package/skills/oma-academic-writing/resources/sentence-structure-reference.md +151 -0
  35. package/skills/oma-architecture/SKILL.md +203 -0
  36. package/skills/oma-architecture/resources/api-evolution.md +41 -0
  37. package/skills/oma-architecture/resources/checklist.md +42 -0
  38. package/skills/oma-architecture/resources/execution-protocol.md +115 -0
  39. package/skills/oma-architecture/resources/methodology-selection.md +92 -0
  40. package/skills/oma-architecture/resources/migration-patterns.md +28 -0
  41. package/skills/oma-architecture/resources/output-templates.md +111 -0
  42. package/skills/oma-architecture/resources/stakeholder-synthesis.md +80 -0
  43. package/skills/oma-backend/SKILL.md +202 -0
  44. package/skills/oma-backend/resources/checklist.md +45 -0
  45. package/skills/oma-backend/resources/error-playbook.md +97 -0
  46. package/skills/oma-backend/resources/execution-protocol.md +39 -0
  47. package/skills/oma-backend/resources/orm-reference.md +61 -0
  48. package/skills/oma-backend/variants/node/api-template.ts +315 -0
  49. package/skills/oma-backend/variants/node/snippets.md +475 -0
  50. package/skills/oma-backend/variants/node/stack.yaml +21 -0
  51. package/skills/oma-backend/variants/node/tech-stack.md +33 -0
  52. package/skills/oma-backend/variants/python/api-template.py +378 -0
  53. package/skills/oma-backend/variants/python/snippets.md +199 -0
  54. package/skills/oma-backend/variants/python/stack.yaml +18 -0
  55. package/skills/oma-backend/variants/python/tech-stack.md +45 -0
  56. package/skills/oma-backend/variants/rust/api-template.rs +635 -0
  57. package/skills/oma-backend/variants/rust/snippets.md +471 -0
  58. package/skills/oma-backend/variants/rust/stack.yaml +20 -0
  59. package/skills/oma-backend/variants/rust/tech-stack.md +36 -0
  60. package/skills/oma-backend/variants/stack.schema.json +73 -0
  61. package/skills/oma-brainstorm/SKILL.md +166 -0
  62. package/skills/oma-brainstorm/resources/triz-lite.md +117 -0
  63. package/skills/oma-coordination/SKILL.md +171 -0
  64. package/skills/oma-db/SKILL.md +201 -0
  65. package/skills/oma-db/resources/anti-patterns.md +177 -0
  66. package/skills/oma-db/resources/checklist.md +67 -0
  67. package/skills/oma-db/resources/document-templates.md +107 -0
  68. package/skills/oma-db/resources/error-playbook.md +50 -0
  69. package/skills/oma-db/resources/examples.md +170 -0
  70. package/skills/oma-db/resources/execution-protocol.md +127 -0
  71. package/skills/oma-db/resources/iso-controls.md +98 -0
  72. package/skills/oma-db/resources/migration-playbook.md +93 -0
  73. package/skills/oma-db/resources/query-tuning.md +57 -0
  74. package/skills/oma-db/resources/vector-db.md +159 -0
  75. package/skills/oma-debug/SKILL.md +146 -0
  76. package/skills/oma-debug/resources/bug-report-template.md +327 -0
  77. package/skills/oma-debug/resources/checklist.md +31 -0
  78. package/skills/oma-debug/resources/common-patterns.md +734 -0
  79. package/skills/oma-debug/resources/debugging-checklist.md +364 -0
  80. package/skills/oma-debug/resources/error-playbook.md +94 -0
  81. package/skills/oma-debug/resources/execution-protocol.md +40 -0
  82. package/skills/oma-design/SKILL.md +135 -0
  83. package/skills/oma-design/resources/asset-strategy.md +34 -0
  84. package/skills/oma-design/resources/checklist.md +63 -0
  85. package/skills/oma-design/resources/data-grid.md +48 -0
  86. package/skills/oma-design/resources/design-md-spec.md +107 -0
  87. package/skills/oma-design/resources/design-tokens.md +53 -0
  88. package/skills/oma-design/resources/error-playbook.md +18 -0
  89. package/skills/oma-design/resources/execution-protocol.md +95 -0
  90. package/skills/oma-design/resources/external-design-skills.md +130 -0
  91. package/skills/oma-design/resources/getdesign-fetcher.md +104 -0
  92. package/skills/oma-design/resources/product-interface-review.md +59 -0
  93. package/skills/oma-design/resources/redesign-protocol.md +52 -0
  94. package/skills/oma-design/resources/stitch-integration.md +244 -0
  95. package/skills/oma-dev-workflow/SKILL.md +375 -0
  96. package/skills/oma-dev-workflow/resources/affected-checks.py +58 -0
  97. package/skills/oma-dev-workflow/resources/api-workflows.md +58 -0
  98. package/skills/oma-dev-workflow/resources/database-patterns.md +107 -0
  99. package/skills/oma-dev-workflow/resources/i18n-patterns.md +63 -0
  100. package/skills/oma-dev-workflow/resources/release-coordination.md +240 -0
  101. package/skills/oma-dev-workflow/resources/tooling-profiles.md +217 -0
  102. package/skills/oma-dev-workflow/resources/troubleshooting.md +78 -0
  103. package/skills/oma-dev-workflow/resources/validation-pipeline.md +246 -0
  104. package/skills/oma-docs/SKILL.md +77 -0
  105. package/skills/oma-docs/resources/commands.md +76 -0
  106. package/skills/oma-explanation/SKILL.md +212 -0
  107. package/skills/oma-explanation/resources/document-structure.md +115 -0
  108. package/skills/oma-explanation/resources/draft-format.md +199 -0
  109. package/skills/oma-explanation/resources/html-contract.md +102 -0
  110. package/skills/oma-frontend/SKILL.md +227 -0
  111. package/skills/oma-frontend/resources/angular-rules.md +110 -0
  112. package/skills/oma-frontend/resources/checklist.md +76 -0
  113. package/skills/oma-frontend/resources/error-playbook.md +125 -0
  114. package/skills/oma-frontend/resources/execution-protocol.md +46 -0
  115. package/skills/oma-frontend/resources/snippets.md +354 -0
  116. package/skills/oma-frontend/resources/specialized-visual-implementation.md +193 -0
  117. package/skills/oma-frontend/resources/tailwind-rules.md +83 -0
  118. package/skills/oma-frontend/resources/tech-stack.md +156 -0
  119. package/skills/oma-hwp/SKILL.md +166 -0
  120. package/skills/oma-hwp/config/hwp-config.yaml +35 -0
  121. package/skills/oma-hwp/resources/balanced-tables.ts +39 -0
  122. package/skills/oma-hwp/resources/execution-protocol.md +145 -0
  123. package/skills/oma-hwp/resources/flatten-tables.ts +101 -0
  124. package/skills/oma-hwp/resources/package.json +13 -0
  125. package/skills/oma-hwp/resources/troubleshooting.md +70 -0
  126. package/skills/oma-hwp/resources/tsconfig.json +10 -0
  127. package/skills/oma-hwp/resources/turndown-plugin-gfm.d.ts +9 -0
  128. package/skills/oma-image/SKILL.md +142 -0
  129. package/skills/oma-image/config/image-config.yaml +70 -0
  130. package/skills/oma-image/resources/checklist.md +18 -0
  131. package/skills/oma-image/resources/execution-protocol.md +117 -0
  132. package/skills/oma-image/resources/invocation.md +105 -0
  133. package/skills/oma-image/resources/prompt-tips.md +71 -0
  134. package/skills/oma-image/resources/vendor-matrix.md +90 -0
  135. package/skills/oma-market/SKILL.md +142 -0
  136. package/skills/oma-market/resources/checklist.md +12 -0
  137. package/skills/oma-market/resources/error-playbook.md +12 -0
  138. package/skills/oma-market/resources/execution-protocol.md +60 -0
  139. package/skills/oma-market/resources/frameworks/pestel.md +101 -0
  140. package/skills/oma-market/resources/frameworks/porters-5f.md +90 -0
  141. package/skills/oma-market/resources/frameworks/swot.md +61 -0
  142. package/skills/oma-market/resources/intent-rules.md +35 -0
  143. package/skills/oma-market/resources/output-laws.md +53 -0
  144. package/skills/oma-mobile/SKILL.md +168 -0
  145. package/skills/oma-mobile/resources/checklist.md +77 -0
  146. package/skills/oma-mobile/resources/error-playbook.md +198 -0
  147. package/skills/oma-mobile/resources/execution-protocol.md +47 -0
  148. package/skills/oma-mobile/resources/screen-template.dart +331 -0
  149. package/skills/oma-mobile/resources/screen-template.swift +239 -0
  150. package/skills/oma-mobile/resources/screen-template.tsx +179 -0
  151. package/skills/oma-mobile/resources/tech-stack.md +69 -0
  152. package/skills/oma-mobile/variants/README.md +45 -0
  153. package/skills/oma-mobile/variants/flutter/api-template.dart +461 -0
  154. package/skills/oma-mobile/variants/flutter/snippets.md +1353 -0
  155. package/skills/oma-mobile/variants/flutter/stack.yaml +21 -0
  156. package/skills/oma-mobile/variants/flutter/tech-stack.md +201 -0
  157. package/skills/oma-mobile/variants/kotlin-android/api-template.kt +182 -0
  158. package/skills/oma-mobile/variants/kotlin-android/snippets.md +871 -0
  159. package/skills/oma-mobile/variants/kotlin-android/stack.yaml +32 -0
  160. package/skills/oma-mobile/variants/kotlin-android/tech-stack.md +159 -0
  161. package/skills/oma-mobile/variants/react-native/api-template.ts +531 -0
  162. package/skills/oma-mobile/variants/react-native/snippets.md +1014 -0
  163. package/skills/oma-mobile/variants/react-native/stack.yaml +22 -0
  164. package/skills/oma-mobile/variants/react-native/tech-stack.md +192 -0
  165. package/skills/oma-mobile/variants/stack.schema.json +68 -0
  166. package/skills/oma-mobile/variants/swift-ios/api-template.swift +165 -0
  167. package/skills/oma-mobile/variants/swift-ios/snippets.md +1028 -0
  168. package/skills/oma-mobile/variants/swift-ios/stack.yaml +25 -0
  169. package/skills/oma-mobile/variants/swift-ios/tech-stack.md +174 -0
  170. package/skills/oma-observability/SKILL.md +225 -0
  171. package/skills/oma-observability/resources/anti-patterns.md +555 -0
  172. package/skills/oma-observability/resources/boundaries/cross-application.md +348 -0
  173. package/skills/oma-observability/resources/boundaries/multi-tenant.md +290 -0
  174. package/skills/oma-observability/resources/boundaries/release.md +372 -0
  175. package/skills/oma-observability/resources/boundaries/slo.md +225 -0
  176. package/skills/oma-observability/resources/checklist.md +123 -0
  177. package/skills/oma-observability/resources/examples.md +448 -0
  178. package/skills/oma-observability/resources/execution-protocol.md +166 -0
  179. package/skills/oma-observability/resources/incident-forensics.md +348 -0
  180. package/skills/oma-observability/resources/intent-rules.md +307 -0
  181. package/skills/oma-observability/resources/layers/L3-network.md +281 -0
  182. package/skills/oma-observability/resources/layers/L4-transport.md +299 -0
  183. package/skills/oma-observability/resources/layers/L7-application/crash-analytics.md +359 -0
  184. package/skills/oma-observability/resources/layers/L7-application/mobile-rum.md +278 -0
  185. package/skills/oma-observability/resources/layers/L7-application/waf.md +246 -0
  186. package/skills/oma-observability/resources/layers/L7-application/web-rum.md +350 -0
  187. package/skills/oma-observability/resources/layers/mesh.md +368 -0
  188. package/skills/oma-observability/resources/matrix.md +177 -0
  189. package/skills/oma-observability/resources/meta-observability.md +605 -0
  190. package/skills/oma-observability/resources/observability-as-code.md +666 -0
  191. package/skills/oma-observability/resources/signals/audit.md +310 -0
  192. package/skills/oma-observability/resources/signals/cost.md +303 -0
  193. package/skills/oma-observability/resources/signals/logs.md +263 -0
  194. package/skills/oma-observability/resources/signals/metrics.md +478 -0
  195. package/skills/oma-observability/resources/signals/privacy.md +351 -0
  196. package/skills/oma-observability/resources/signals/profiles.md +245 -0
  197. package/skills/oma-observability/resources/signals/traces.md +360 -0
  198. package/skills/oma-observability/resources/standards.md +214 -0
  199. package/skills/oma-observability/resources/transport/collector-topology.md +308 -0
  200. package/skills/oma-observability/resources/transport/otlp-grpc-vs-http.md +256 -0
  201. package/skills/oma-observability/resources/transport/sampling-recipes.md +297 -0
  202. package/skills/oma-observability/resources/transport/udp-statsd-mtu.md +167 -0
  203. package/skills/oma-observability/resources/vendor-categories.md +352 -0
  204. package/skills/oma-orchestration/SKILL.md +302 -0
  205. package/skills/oma-orchestration/config/cli-config.yaml +92 -0
  206. package/skills/oma-orchestration/resources/memory-schema.md +232 -0
  207. package/skills/oma-orchestration/resources/subagent-prompt-template.md +30 -0
  208. package/skills/oma-orchestration/scripts/parallel-run.sh +6 -0
  209. package/skills/oma-orchestration/scripts/spawn-agent.sh +5 -0
  210. package/skills/oma-orchestration/scripts/verify.sh +20 -0
  211. package/skills/oma-orchestration/templates/backend-task.md +19 -0
  212. package/skills/oma-orchestration/templates/debug-task.md +16 -0
  213. package/skills/oma-orchestration/templates/frontend-task.md +18 -0
  214. package/skills/oma-orchestration/templates/mobile-task.md +18 -0
  215. package/skills/oma-orchestration/templates/qa-task.md +16 -0
  216. package/skills/oma-orchestration/templates/tasks-example.yaml +15 -0
  217. package/skills/oma-pdf/SKILL.md +162 -0
  218. package/skills/oma-pdf/config/pdf-config.yaml +27 -0
  219. package/skills/oma-pdf/resources/execution-protocol.md +127 -0
  220. package/skills/oma-pm/SKILL.md +157 -0
  221. package/skills/oma-pm/resources/error-playbook.md +75 -0
  222. package/skills/oma-pm/resources/examples.md +439 -0
  223. package/skills/oma-pm/resources/execution-protocol.md +62 -0
  224. package/skills/oma-pm/resources/iso-planning.md +110 -0
  225. package/skills/oma-pm/resources/plan-phase-protocol.md +66 -0
  226. package/skills/oma-pm/resources/task-template.json +86 -0
  227. package/skills/oma-qa/SKILL.md +141 -0
  228. package/skills/oma-qa/resources/checklist.md +339 -0
  229. package/skills/oma-qa/resources/error-playbook.md +98 -0
  230. package/skills/oma-qa/resources/execution-protocol.md +169 -0
  231. package/skills/oma-qa/resources/iso-quality.md +82 -0
  232. package/skills/oma-qa/resources/verify-ship-protocol.md +116 -0
  233. package/skills/oma-recap/SKILL.md +245 -0
  234. package/skills/oma-recap/resources/output-formats.md +83 -0
  235. package/skills/oma-refactor/SKILL.md +184 -0
  236. package/skills/oma-refactor/resources/definition.md +108 -0
  237. package/skills/oma-refactor/resources/governance.md +33 -0
  238. package/skills/oma-refactor/resources/hotspots.py +44 -0
  239. package/skills/oma-refactor/resources/measurement.md +93 -0
  240. package/skills/oma-scholar/SKILL.md +276 -0
  241. package/skills/oma-scholar/config/scholar-config.yaml +79 -0
  242. package/skills/oma-scholar/resources/api-endpoints.md +174 -0
  243. package/skills/oma-scholar/resources/checklist.md +92 -0
  244. package/skills/oma-scholar/resources/execution-protocol.md +224 -0
  245. package/skills/oma-scholar/resources/fallback-providers.md +143 -0
  246. package/skills/oma-scholar/resources/setup-openalex.md +85 -0
  247. package/skills/oma-scholar/resources/sidecar-spec.md +341 -0
  248. package/skills/oma-scholar/resources/upstream-spec-cache.md +972 -0
  249. package/skills/oma-scm/SKILL.md +103 -0
  250. package/skills/oma-scm/resources/cm-operations.md +56 -0
  251. package/skills/oma-scm/resources/codeowners-playbook.md +45 -0
  252. package/skills/oma-scm/resources/conventional-commits.md +108 -0
  253. package/skills/oma-scm/resources/merge-risk.md +76 -0
  254. package/skills/oma-scm/resources/onboarding-risk-signals.md +71 -0
  255. package/skills/oma-search/SKILL.md +125 -0
  256. package/skills/oma-search/resources/checklist.md +36 -0
  257. package/skills/oma-search/resources/error-playbook.md +66 -0
  258. package/skills/oma-search/resources/examples.md +80 -0
  259. package/skills/oma-search/resources/execution-protocol.md +86 -0
  260. package/skills/oma-search/resources/intent-rules.md +47 -0
  261. package/skills/oma-search/resources/trust-registry.md +53 -0
  262. package/skills/oma-security/SKILL.md +172 -0
  263. package/skills/oma-security/resources/artex.md +108 -0
  264. package/skills/oma-security/resources/ci.md +134 -0
  265. package/skills/oma-security/resources/cisco-source.md +108 -0
  266. package/skills/oma-security/resources/deepsec-config.md +45 -0
  267. package/skills/oma-security/resources/deepsec-matchers.md +35 -0
  268. package/skills/oma-security/resources/deepsec-scanning.md +45 -0
  269. package/skills/oma-security/resources/deepsec-setup.md +41 -0
  270. package/skills/oma-security/resources/findings-contract.md +408 -0
  271. package/skills/oma-security/resources/mcp-scanning.md +122 -0
  272. package/skills/oma-security/resources/skill-scanning.md +106 -0
  273. package/skills/oma-security/resources/validation.md +71 -0
  274. package/skills/oma-skill-creation/SKILL.md +84 -0
  275. package/skills/oma-skill-creation/resources/prompt-evaluation.md +36 -0
  276. package/skills/oma-skill-creation/resources/ssl-lite-template.md +108 -0
  277. package/skills/oma-skill-creation/resources/validation-checklist.md +101 -0
  278. package/skills/oma-slide/SKILL.md +277 -0
  279. package/skills/oma-slide/resources/animation-patterns.md +245 -0
  280. package/skills/oma-slide/resources/assets/deck-stage.js +514 -0
  281. package/skills/oma-slide/resources/assets/viewport-base.css +257 -0
  282. package/skills/oma-slide/resources/canva-integration.md +203 -0
  283. package/skills/oma-slide/resources/checklist.md +46 -0
  284. package/skills/oma-slide/resources/design-doctrine.md +260 -0
  285. package/skills/oma-slide/resources/fixed-stage.md +232 -0
  286. package/skills/oma-slide/resources/generation-protocol.md +393 -0
  287. package/skills/oma-slide/resources/native-pptx.md +84 -0
  288. package/skills/oma-slide/resources/selection-index.json +461 -0
  289. package/skills/oma-slide/resources/style-presets.LICENSE +10 -0
  290. package/skills/oma-slide/resources/style-presets.md +520 -0
  291. package/skills/oma-tf-infra/SKILL.md +201 -0
  292. package/skills/oma-tf-infra/resources/checklist.md +53 -0
  293. package/skills/oma-tf-infra/resources/cost-optimization.md +574 -0
  294. package/skills/oma-tf-infra/resources/error-playbook.md +68 -0
  295. package/skills/oma-tf-infra/resources/examples.md +38 -0
  296. package/skills/oma-tf-infra/resources/execution-protocol.md +129 -0
  297. package/skills/oma-tf-infra/resources/iso-42001-infra.md +229 -0
  298. package/skills/oma-tf-infra/resources/multi-cloud-examples.md +241 -0
  299. package/skills/oma-tf-infra/resources/policy-testing-examples.md +332 -0
  300. package/skills/oma-translation/SKILL.md +229 -0
  301. package/skills/oma-translation/resources/anti-ai-patterns.md +104 -0
  302. package/skills/oma-translation/resources/lang/_template.md +73 -0
  303. package/skills/oma-translation/resources/lang/en.md +123 -0
  304. package/skills/oma-translation/resources/lang/ja.md +274 -0
  305. package/skills/oma-translation/resources/lang/ko.md +228 -0
  306. package/skills/oma-translation/resources/lang/zh.md +285 -0
  307. package/skills/oma-translation/resources/style-skills.md +104 -0
  308. package/skills/oma-translation/resources/translation-rubric.md +126 -0
  309. package/skills/oma-video/SKILL.md +229 -0
  310. package/skills/oma-video/config/video-config.yaml +60 -0
  311. package/skills/oma-video/resources/checklist.md +26 -0
  312. package/skills/oma-video/resources/execution-protocol.md +122 -0
  313. package/skills/oma-video/resources/existing-media.md +185 -0
  314. package/skills/oma-video/resources/hyperframes-authoring/README.md +44 -0
  315. package/skills/oma-video/resources/hyperframes-authoring/demo.md +31 -0
  316. package/skills/oma-video/resources/hyperframes-authoring/explainer.md +10 -0
  317. package/skills/oma-video/resources/hyperframes-authoring/shorts.md +10 -0
  318. package/skills/oma-video/resources/motion-principles.md +81 -0
  319. package/skills/oma-video/resources/mpt/driver.py +301 -0
  320. package/skills/oma-video/resources/prompt-tips.md +75 -0
  321. package/skills/oma-video/resources/script-schema.md +81 -0
  322. package/skills/oma-video/resources/sound-design.md +127 -0
  323. package/skills/oma-video/resources/strudel/package.json +11 -0
  324. package/skills/oma-video/resources/strudel/page.html +87 -0
  325. package/skills/oma-video/resources/strudel/render.mjs +295 -0
  326. package/skills/oma-video/resources/vendor-matrix.md +124 -0
  327. package/skills/oma-voice/SKILL.md +249 -0
  328. package/skills/oma-voice/config/voice-config.yaml +30 -0
  329. package/skills/oma-voice/resources/audio-processing.md +119 -0
  330. package/skills/oma-voice/resources/checklist.md +47 -0
  331. package/skills/oma-voice/resources/execution-protocol.md +215 -0
  332. package/skills/oma-voice/resources/prompt-tips.md +43 -0
  333. package/skills/oma-voice/resources/voice-matrix.md +51 -0
  334. package/skills/oma-voice/resources/voicestudio.md +87 -0
@@ -0,0 +1,228 @@
1
+ # Korean Target-Language Profile (`ko`)
2
+
3
+ Load this profile when the **target** primary language subtag is `ko`, including
4
+ `ko-KR`. Read it with `../translation-rubric.md` for substantive content or
5
+ review. For substantive prose style, follow `../style-skills.md`.
6
+
7
+ This profile owns Korean grammar, register, and project conventions.
8
+
9
+ All examples are illustrative pairs in `bad → good` form. Do not translate the
10
+ rule text itself into the output.
11
+
12
+ ---
13
+
14
+ ## Register
15
+
16
+ Korean forces a sentence-ending choice on every sentence. Pick once per
17
+ document and never drift.
18
+
19
+ | Style | Ending | Use for |
20
+ |---|---|---|
21
+ | 합니다체 | `-습니다` / `-ㅂ니다` | reports, user-facing docs, release notes, agent output |
22
+ | 해요체 | `-어요` / `-아요` | conversational UI, onboarding microcopy, casual product voice |
23
+ | 한다체 (평서체) | `-다` / `-이다` | reference docs, specs, academic prose, changelog bodies |
24
+
25
+ Resolution order:
26
+
27
+ 1. Match the dominant ending of sibling files in the same directory.
28
+ 2. If no siblings exist, map from `translation_voice` in `.agents/oma-config.yaml`:
29
+ `formal` → 합니다체, `balanced` → 합니다체 for prose and 한다체 for reference
30
+ tables, `interpreter` → 합니다체 with shorter sentences and permitted
31
+ label-position fragments.
32
+ 3. If the source is dialogue or subtitle content, follow the speaker relationship
33
+ in the source rather than the file convention.
34
+
35
+ Never mix 합니다체 with 한다체 inside one document. Headings and table cells are
36
+ exempt because they carry no ending at all.
37
+
38
+ **Honorific target**: raise the listener (`-시-`, `-께서`, 공손 어휘) only when the
39
+ source addresses a person directly or the project already does so. Do not add
40
+ `사용자님`-class honorifics to documentation that addresses a generic reader.
41
+
42
+ ---
43
+
44
+ ## Korean-only rules
45
+
46
+ ### KO-1. Do not drop particles or endings
47
+
48
+ Compressed agent Korean drops 조사 and 어미 to save tokens, which strips out the
49
+ grammatical relations that carry the meaning. Restore them. Use 부사, 보조사,
50
+ 선어말어미, and 보조 용언 actively rather than treating them as optional padding.
51
+
52
+ ```
53
+ 이 결정은 이후 중요 정책이 갈리는 자리. 컨텍스트 압축 전 신중 반영한다.
54
+ → 이 결정은 이후 중요한 정책에 지속적으로 영향을 주기 때문에, 컨텍스트가
55
+ 압축되기 전에 신중히 반영합니다.
56
+ ```
57
+
58
+ This is a restoration of grammar, not an addition of meaning. It must not
59
+ introduce facts, opinions, or emphasis that the source does not carry.
60
+
61
+ ### KO-2. Genitive `의` chains hide dropped sentence elements
62
+
63
+ `의` linking two or more nouns is a diagnostic signal, not merely a style
64
+ preference: the predicate and the particles that belong in that position have
65
+ been deleted. Two `의` in one noun phrase is a hard flag; three is a block.
66
+
67
+ ```
68
+ 사본의 문구는 작업의 상황을
69
+ → 사본에 기재된 문구는 작업이 진행되는 상황을
70
+
71
+ 지출 비용 추론 용도의 토큰 카운트 함수의 오류 상황에서
72
+ → 지출한 비용을 추론하는 토큰 카운트 함수에 오류가 발생하면
73
+ ```
74
+
75
+ Also delete `의` that entered as a calque of Japanese `の` or English `of` where
76
+ Korean would use no particle at all: `최대의 성능` → `최대 성능`,
77
+ `두 개의 파일` → `파일 두 개`.
78
+
79
+ A genitive chain can hide a dropped predicate even when it has fewer than three
80
+ modifiers.
81
+
82
+ ### KO-3. Finish the sentence
83
+
84
+ End body sentences with a predicate and a final ending. Three failure shapes:
85
+
86
+ | Shape | Bad | Good |
87
+ |---|---|---|
88
+ | Noun ending | `lint 실패.` | `lint가 실패했습니다.` |
89
+ | Adverbial ending | `설정 파일을 읽지 못한 채로.` | `설정 파일을 읽지 못한 채로 종료했습니다.` |
90
+ | Connective ending | `캐시를 비우고 다시 실행했으며,` | `캐시를 비우고 다시 실행했습니다.` |
91
+
92
+ Exempt positions: headings, list items that act as labels, table cells, and
93
+ `key: value` pairs. `결과: lint 실패` is correct; a bare `lint 실패.` sitting in a
94
+ paragraph is not.
95
+
96
+ **Trailing negation calque**: English tacks short negation fragments onto a
97
+ sentence end (`..., no guessing`). Calquing this produces `..., 추측 없이`, which
98
+ is a noun fragment in Korean body text.
99
+
100
+ ```
101
+ 선택된 항목에서 옵션이 나옵니다, 추측 없이.
102
+ → 선택된 항목에서 바로 옵션을 가져오므로 사용자가 추측할 필요가 없습니다.
103
+ ```
104
+
105
+ ### KO-4. Sino-Korean vocabulary is not the problem; bare Sino-Korean nouns are
106
+
107
+ Keep precise Sino-Korean terms and supply the particles and inflections they
108
+ need. A bare Sino-Korean noun with no particle or verb ending can hide the action.
109
+
110
+ ```
111
+ 지출 비용 추론 용도의 토큰 카운트 함수의 오류 상황에서 (no particles, relations unclear)
112
+ 쓴 비용을 구하는 토큰 카운트 함수에 문제가 생기면 (over-nativized, imprecise)
113
+ → 지출한 비용을 추론하는 토큰 카운트 함수에 오류가 발생하면
114
+ ```
115
+
116
+ `발생하면`, `추론하는`, `지출한` are all Sino-Korean and all correct, because each
117
+ carries an ending.
118
+
119
+ ### KO-5. No noun-pinned verbs
120
+
121
+ Pinning a verb into Korean as a bare noun, whether an English loanword or a
122
+ stiff Sino-Korean noun, reads as jargon.
123
+
124
+ ```
125
+ skill을 로드 → skill을 불러옵니다
126
+ 프로젝트에 시드 → 프로젝트에 심습니다
127
+ `<HARD-GATE>` 발동 → `<HARD-GATE>`가 걸렸습니다
128
+ 마이그레이션 진행 → 마이그레이션을 실행했습니다
129
+ ```
130
+
131
+ ### KO-6. No figurative substitution for plain vocabulary
132
+
133
+ Do not introduce figurative Korean vocabulary when the source uses a plain noun
134
+ or verb. It changes the meaning.
135
+
136
+ ```
137
+ 분석의 플로우 → 분석의 흐름
138
+ 코드로 박는 자리 → 코드에 명시하는 위치
139
+ 요청을 수신합니다 → 요청을 받습니다
140
+ 테스트를 태웁니다 → 테스트를 실행합니다
141
+ ```
142
+
143
+ Keep expressions that are already established idiom in the field and would sound
144
+ stilted if flattened (`병목`, `롤백`, `핫픽스`).
145
+
146
+ ### KO-8. Korean translation-ese constructions
147
+
148
+ | Pattern | Bad | Good |
149
+ |---|---|---|
150
+ | 이중 피동 | `보여집니다`, `불려집니다`, `되어집니다` | `보입니다`, `불립니다`, `됩니다` |
151
+ | `~에 대한` overuse | `설정에 대한 검토를 했습니다` | `설정을 검토했습니다` |
152
+ | `~에 있어서` (JA `における`) | `배포에 있어서 중요한 것은` | `배포에서 중요한 점은` |
153
+ | `~로부터` (JA `から`) | `서버로부터 응답을 받았습니다` | `서버에서 응답을 받았습니다` |
154
+ | `~에 의해` (EN passive) | `팀에 의해 개발되었습니다` | `팀이 개발했습니다` |
155
+ | `~적(的)` stacking | `구조적, 기능적 개선` | `구조와 기능을 개선` |
156
+ | `~들` plural forcing | `파일들을 모두 삭제했습니다` | `파일을 모두 삭제했습니다` |
157
+ | `~하는 것이 가능하다` | `재시도하는 것이 가능합니다` | `재시도할 수 있습니다` |
158
+ | `~화(化)` nominalizing | `자동화를 진행합니다` | `자동으로 처리합니다` |
159
+
160
+ Korean marks plurality with quantifiers and context. Use `들` only when the
161
+ plural reading would otherwise be lost.
162
+
163
+ ### KO-9. Typography and spacing
164
+
165
+ - **Inline code + particle**: no space between a backtick span and the particle
166
+ that follows. `` `prompt` 로 `` → `` `prompt`로 ``.
167
+ - **Counters**: no space between numeral and counter. `5 개` → `5개`, `3 번째` →
168
+ `3번째`. Units keep a space: `10 MB`, `200 ms`.
169
+ - **Em dash**: reconstruct the clause in Korean body prose rather than replacing
170
+ the dash with another punctuation mark.
171
+ - **Quotes**: straight `"` and `'`, or `「」` only when the project already uses
172
+ them. Do not emit curly quotes.
173
+ - **Parentheses**: halfwidth `()` with no leading space when attached to a term:
174
+ `하네스(harness)`.
175
+ - **Ellipsis**: `...` rather than `…` unless the source file already uses `…`.
176
+ - **Middle dot**: `·` for tight coordination in headings (`설치·설정`), commas in
177
+ body text.
178
+
179
+ ### KO-10. Loanword orthography (외래어 표기법)
180
+
181
+ Use the standard form. Frequent misspellings in machine output:
182
+
183
+ ```
184
+ 컨텐츠 → 콘텐츠 메세지 → 메시지 데이타 → 데이터
185
+ 윈도우즈 → 윈도우 타겟 → 타깃 레퍼런스 → 레퍼런스 (ok)
186
+ 쉐이더 → 셰이더 플래폼 → 플랫폼 비지니스 → 비즈니스
187
+ 어플리케이션 → 애플리케이션 스케쥴 → 스케줄
188
+ ```
189
+
190
+ When the project's existing translations consistently use a non-standard form,
191
+ follow the project and note the conflict once.
192
+
193
+ ### KO-11. Numbers, dates, units
194
+
195
+ - Dates: `2026년 8월 20일` in prose, `2026-08-20` in tables and logs.
196
+ - Ranges: `3~5개` in prose, `3-5` inside code or config values.
197
+ - Large numbers: comma grouping (`12,000`), and `만`/`억` only when the source
198
+ uses a comparable scale word.
199
+ - Percent: `40%` with no space.
200
+
201
+ ### KO-12. Subagent and multi-hop Korean
202
+
203
+ When Korean text will be consumed by another agent rather than by a person
204
+ (subagent prompts, intermediate result files, handoff summaries), apply `KO-1`
205
+ through `KO-3` before handing it off. Quality loss compounds at every hop in
206
+ `orchestrate`, `ultrawork`, and `ralph`, and a dropped particle in a stage-1
207
+ prompt becomes a wrong decision in stage 3.
208
+
209
+ Internal status keywords, workflow markers, and log levels stay in English per
210
+ `.agents/rules/i18n-guide.md`.
211
+
212
+ ---
213
+
214
+ ## Korean self-check
215
+
216
+ Check source-to-Korean grammar and project conventions before delivery.
217
+
218
+ - [ ] One sentence-ending style throughout; no 합니다체 / 한다체 mixing
219
+ - [ ] No dropped 조사 or 어미 in body text (`KO-1`)
220
+ - [ ] No noun phrase with two or more chained `의` (`KO-2`)
221
+ - [ ] No body sentence ending in a noun, adverbial, or connective (`KO-3`)
222
+ - [ ] No bare Sino-Korean or loanword noun standing in for a verb (`KO-4`, `KO-5`)
223
+ - [ ] No invented figurative vocabulary where the source was plain (`KO-6`)
224
+ - [ ] No 이중 피동, `~에 대한`, `~에 있어서`, `~들` forcing (`KO-8`)
225
+ - [ ] No space between inline code and its particle; no space in `5개` (`KO-9`)
226
+ - [ ] No `—`, no curly quotes (`KO-9`)
227
+ - [ ] Loanwords follow 외래어 표기법 or the project's established forms (`KO-10`)
228
+ - [ ] Korean handed to another agent passes `KO-1`–`KO-3` (`KO-12`)
@@ -0,0 +1,285 @@
1
+ # Chinese Target-Language Profile (`zh`)
2
+
3
+ Load this file whenever the **target** language is Chinese. It is read together
4
+ with `../translation-rubric.md` for substantive content or review. For prose style
5
+ review, also load `../../../_shared/core/anti-ai-prose.md` (common taxonomy) and
6
+ `../anti-ai-patterns.md` (translation exceptions and grammar diagnostics).
7
+
8
+ - **Localizations** of shared anti-AI patterns.
9
+ - **Chinese-only rules** (`ZH-1`–`ZH-9`).
10
+
11
+ ---
12
+
13
+ ## Variant resolution (do this first)
14
+
15
+ `zh` is not a single target. Resolve the variant before translating a single
16
+ string, because script, vocabulary, and punctuation all diverge.
17
+
18
+ | Locale | Script | Region vocabulary |
19
+ |---|---|---|
20
+ | `zh-CN` / `zh-Hans` | 简体 | 软件, 网络, 程序, 服务器, 内存, 视频 |
21
+ | `zh-TW` / `zh-Hant-TW` | 繁體 | 軟體, 網路, 程式, 伺服器, 記憶體, 影片 |
22
+ | `zh-HK` / `zh-Hant-HK` | 繁體 | mostly TW vocabulary, HK-specific terms where established |
23
+
24
+ Resolution order: explicit locale in the file path or user request → dominant
25
+ script of sibling files → ask. If bare `zh` is requested with no signal, default
26
+ to `zh-CN` and say so once in the output notes. Never mix scripts in one file,
27
+ and never convert 简体 to 繁體 by character substitution alone: the vocabulary
28
+ must be converted too (`软件` → `軟體`, not `軟件`).
29
+
30
+ ## Register
31
+
32
+ Chinese has no obligatory sentence-ending register system, so consistency lives
33
+ in vocabulary and sentence length instead.
34
+
35
+ | Voice | Effect |
36
+ |---|---|
37
+ | `formal` | 书面语, full sentences, 您 for the reader, no fragments |
38
+ | `balanced` | 书面语 in prose, fragments allowed in table cells and labels |
39
+ | `interpreter` | shorter clauses, 你 acceptable in product UI, spoken cadence |
40
+
41
+ Use `您` in enterprise and formal docs, `你` in developer-facing and product UI
42
+ when the project already does. Do not switch mid-document.
43
+
44
+ ---
45
+
46
+ ## Chinese-only rules
47
+
48
+ ### ZH-1. `的` overuse (的的不休)
49
+
50
+ Chinese drops `的` far more readily than English drops `of`. Two `的` in one
51
+ noun phrase is a flag; three is a block.
52
+
53
+ ```
54
+ Bad: 这是一个用于处理用户的请求的高性能的服务
55
+ Good: 这是处理用户请求的高性能服务
56
+
57
+ Bad: 系统的性能的提升
58
+ Good: 系统性能提升
59
+ ```
60
+
61
+ Drop `的` between a monosyllabic modifier and its noun (`红花`, not `红的花`),
62
+ and after established compounds (`用户体验`, not `用户的体验`).
63
+
64
+ ### ZH-2. `一个` as an indefinite article calque
65
+
66
+ English `a/an` has no Chinese equivalent. Insert a measure word only when the
67
+ count matters.
68
+
69
+ ```
70
+ Bad: 这是一个强大的工具
71
+ Good: 这是强大的工具 / 这个工具很强大
72
+ ```
73
+
74
+ ### ZH-3. `们` plural forcing
75
+
76
+ Chinese marks plurality with context and quantifiers. `们` attaches only to
77
+ human nouns, and even then only when the plural reading would be lost.
78
+
79
+ ```
80
+ Bad: 删除所有的文件们
81
+ Good: 删除所有文件
82
+ ```
83
+
84
+ ### ZH-4. Empty verbs (`进行` / `做出` / `实施` / `予以`)
85
+
86
+ ```
87
+ 进行了讨论 → 讨论了
88
+ 做出了改进 → 改进了
89
+ 实施优化 → 优化
90
+ 予以处理 → 处理
91
+ ```
92
+
93
+ ### ZH-5. `关于` / `对于` overuse
94
+
95
+ ```
96
+ Bad: 关于配置的检查已经完成
97
+ Good: 配置检查已完成
98
+
99
+ Bad: 对于这个问题,我们进行了修复
100
+ Good: 我们修复了这个问题
101
+ ```
102
+
103
+ ### ZH-6. Long pre-nominal modifiers
104
+
105
+ Chinese places modifiers before the noun, so English relative clauses pile up
106
+ into unreadable strings. Split into separate clauses or use a 把 / 被 pivot.
107
+
108
+ ```
109
+ Bad: 基于 AI 的支持云端部署的实时数据监控系统
110
+ Good: 一套用 AI 在云端做实时数据监控的系统
111
+ ```
112
+
113
+ Rule: more than about 12 characters of pre-nominal modifier → restructure.
114
+
115
+ ### ZH-7. Punctuation and spacing
116
+
117
+ - **Fullwidth punctuation**: `,` `。` `、` `:` `;` `?` `!`. Never halfwidth in
118
+ Chinese body text.
119
+ - **Enumeration comma**: `、` between list items inside a sentence, `,` between
120
+ clauses. These are not interchangeable.
121
+ - **Quotes**: `“”` and `‘’` for `zh-CN`, `「」` and `『』` for `zh-TW` / `zh-HK`.
122
+ This is the one target where curly quotes are correct; the shared curly-quote
123
+ check must not strip them.
124
+ - **Brackets**: fullwidth `()` around Chinese content, halfwidth `()` around
125
+ ASCII-only content.
126
+ - **Em dash**: Chinese uses `——` (double-width, two ems) for a genuine break,
127
+ which is not the same mark as `—`. Prefer restructuring; do not carry the
128
+ English `—` through.
129
+ - **Latin spacing**: follow the project convention for a space between Chinese
130
+ and ASCII runs. Read three sibling files before choosing; do not switch
131
+ mid-file.
132
+ - **Ellipsis**: `……` (six dots, two characters), not `...`.
133
+
134
+ ### ZH-8. Abstract suffix overuse (`性` / `化` / `度`)
135
+
136
+ ```
137
+ 提高了系统的可用性和稳定性 → 系统更稳定、更少出问题
138
+ 进行自动化处理 → 自动处理
139
+ ```
140
+
141
+ Keep the suffix when it is established terminology (`可用性`, `幂等性`,
142
+ `向后兼容性`).
143
+
144
+ ### ZH-9. Numbers, dates, units
145
+
146
+ - Dates: `2026年8月20日` in prose, `2026-08-20` in tables and logs.
147
+ - Numerals: halfwidth (`5 个`, `12,000`).
148
+ - Percent: `40%` with no space.
149
+ - Ranges: `3~5 个` or `3 到 5 个`; do not use `—`.
150
+ - Measure words must match the noun (`个`, `台`, `条`, `项`, `次`).
151
+
152
+ ---
153
+
154
+ ## Localizations of shared rules
155
+
156
+ ### `-ing` participle phrases
157
+
158
+ See [Superficial analysis](../../../_shared/core/anti-ai-prose.md#superficial-analysis).
159
+
160
+ ```
161
+ EN: The update improves performance, ensuring a seamless experience
162
+ Bad: 这次更新提升了性能,确保了无缝的体验
163
+ Good: 这次更新提升了性能,用起来更顺畅
164
+ ```
165
+
166
+ ### AI vocabulary overuse
167
+
168
+ See [Vocabulary clustering](../../../_shared/core/anti-ai-prose.md#vocabulary-clustering).
169
+
170
+ | Watch | Prefer |
171
+ |---|---|
172
+ | 此外 / 另外 (sentence-initial, repeated) | restructure or drop |
173
+ | 关键的 / 至关重要的 | only when the source emphasizes |
174
+ | 利用 | 用, 使用 |
175
+ | 各种各样的 | usually delete |
176
+ | 通过...来 | restructure the clause |
177
+ | 优化 / 最大化 | match the source's intensity |
178
+
179
+ ### rule of three
180
+
181
+ See [Mechanical triples](../../../_shared/core/anti-ai-prose.md#mechanical-triples).
182
+
183
+ ```
184
+ EN: a fast, reliable, and intuitive experience
185
+ Bad: 快速的、可靠的、直观的体验
186
+ Good: 快速、可靠且直观的体验
187
+ ```
188
+
189
+ Preserve every source quality. A real three-item list is valid when all three carry meaning.
190
+
191
+ ### synonym cycling
192
+
193
+ See [Synonym cycling](../../../_shared/core/anti-ai-prose.md#synonym-cycling).
194
+
195
+ If `用户` is right, use `用户` throughout. Do not rotate through `使用者`,
196
+ `客户`, `终端用户`.
197
+
198
+ ### compound stacking
199
+
200
+ See [Compound adjective stacking](../../../_shared/core/anti-ai-prose.md#compound-adjective-stacking) and [Abstract noun and adjective stacking](../../../_shared/core/anti-ai-prose.md#abstract-noun-and-adjective-stacking).
201
+
202
+ ```
203
+ Bad: 一个 AI 驱动的、基于云的、企业级的解决方案
204
+ Good: 一套跑在云上的企业级 AI 方案
205
+ ```
206
+
207
+ ### mechanical punctuation swap
208
+
209
+ See [Mechanical punctuation swaps](../../../_shared/core/anti-ai-prose.md#mechanical-punctuation-swaps).
210
+
211
+ ```
212
+ Source: Documentation drift checks — broken refs and diff-affected docs
213
+ Lazy: 文档漂移检查:损坏的引用和受 diff 影响的文档
214
+ Better: 检查引用是否失效,并找出受改动影响的文档
215
+ ```
216
+
217
+ ### unnecessary connectives
218
+
219
+ See [Unnecessary Connectives](../anti-ai-patterns.md#unnecessary-connectives).
220
+
221
+ ```
222
+ Bad: 性能提升了。因此,用户体验变好了。
223
+ Good: 性能提升了,用户体验也跟着变好。
224
+ ```
225
+
226
+ Watch 因此, 然而, 此外, 另外, 同时, 综上所述.
227
+
228
+ ### passive voice
229
+
230
+ See [Passive Voice Abuse](../anti-ai-patterns.md#passive-voice-abuse).
231
+
232
+ ```
233
+ Bad: 这个功能被团队开发了
234
+ Good: 团队开发了这个功能
235
+ ```
236
+
237
+ `被` is correct when the outcome is adverse or the agent is genuinely unknown
238
+ (`文件被删除了`). It is wrong as a blanket rendering of English passive.
239
+
240
+ ### noun pile-up
241
+
242
+ See [Noun Pile-up (Long Modifier Chains)](../anti-ai-patterns.md#noun-pile-up-long-modifier-chains).
243
+
244
+ See `ZH-6`.
245
+
246
+ ### over-nominalization
247
+
248
+ See [Over-nominalization](../anti-ai-patterns.md#over-nominalization).
249
+
250
+ See `ZH-4`.
251
+
252
+ ### forced pronouns
253
+
254
+ See [Awkward Pronoun Insertion](../anti-ai-patterns.md#awkward-pronoun-insertion).
255
+
256
+ ```
257
+ Bad: 我们推出了这个功能,我们得到了好的反馈
258
+ Good: 推出这个功能后,反馈不错
259
+ ```
260
+
261
+ ### cleft calques
262
+
263
+ See [Cleft Sentence Calques](../anti-ai-patterns.md#cleft-sentence-calques).
264
+
265
+ ```
266
+ Bad: 重要的是用户体验
267
+ Good: 用户体验重要
268
+ ```
269
+
270
+ ---
271
+
272
+ ## Chinese self-check
273
+
274
+ - [ ] Variant resolved (`zh-CN` / `zh-TW` / `zh-HK`); script and vocabulary both
275
+ converted, never script alone
276
+ - [ ] No noun phrase with two or more `的` (`ZH-1`)
277
+ - [ ] No `一个` inserted as an article (`ZH-2`)
278
+ - [ ] No `们` on non-human or contextually plural nouns (`ZH-3`)
279
+ - [ ] No `进行` / `做出` / `实施` empty verbs (`ZH-4`)
280
+ - [ ] No `关于` / `对于` sentence openers that add nothing (`ZH-5`)
281
+ - [ ] No pre-nominal modifier longer than about 12 characters (`ZH-6`)
282
+ - [ ] Fullwidth punctuation; `、` vs `,` used correctly; `……` not `...` (`ZH-7`)
283
+ - [ ] Quote style matches the variant; curly quotes preserved for `zh-CN`
284
+ - [ ] No English `—` carried through (`ZH-7`)
285
+ - [ ] `被` used only for adverse or agentless outcomes (shared `20`)
@@ -0,0 +1,104 @@
1
+ # Selected prose-style skills
2
+
3
+ Use after drafting substantive translated prose or when reviewing its style.
4
+ Select from the **target** BCP 47 primary language subtag, case-insensitively.
5
+ Source language and English code snippets do not select this route. Short
6
+ independent UI strings retain the lightweight path in the owning SKILL.md.
7
+
8
+ | Target | Skill | Upstream |
9
+ |---|---|---|
10
+ | `en`, including `en-US` and `en-GB` | `humanizer` | [blader/humanizer](https://github.com/blader/humanizer) |
11
+ | `ko`, including `ko-KR` | `humanize-korean` | [epoko77-ai/im-not-ai](https://github.com/epoko77-ai/im-not-ai) |
12
+
13
+ ## Resolve and load
14
+
15
+ 1. Look up the selected skill in the runtime's skill catalog and read its actual
16
+ SKILL.md in full. Confirm the entry corresponds to the listed upstream. A
17
+ namespaced catalog entry is acceptable. Reuse an installed bundle or an
18
+ existing upstream checkout; do not infer a path from a skill name.
19
+ 2. Load the upstream references required by the selected mode from that bundle.
20
+ OMA owns the translation boundary below, not a copy of either pattern catalog.
21
+ 3. If the selected skill is absent, use the Skills CLI through Bun to load its
22
+ instructions and supporting files into a temporary directory:
23
+
24
+ ```bash
25
+ bunx skills use blader/humanizer@humanizer
26
+ ```
27
+
28
+ For Korean on Codex, select its runtime-specific entry explicitly:
29
+
30
+ ```bash
31
+ bunx skills use https://github.com/epoko77-ai/im-not-ai/tree/main/codex/skills/humanize-korean
32
+ ```
33
+
34
+ Read the generated prompt and its supporting-files directory. Omit `--agent`:
35
+ the current executor consumes the instructions. That flag launches another
36
+ interactive agent; it does not choose a Korean package variant. These commands
37
+ load instructions; the executor still performs the requested style pass.
38
+ Reuse the resolved content for the session.
39
+ 4. Korean execution requires references, role contracts and runnable Python
40
+ scripts. Resolve the matching package from upstream's
41
+ [installation guide](https://github.com/epoko77-ai/im-not-ai/blob/main/INSTALL.md):
42
+
43
+ | Runtime | Entry relative to the upstream checkout |
44
+ |---|---|
45
+ | Codex | `codex/skills/humanize-korean/SKILL.md` |
46
+ | Claude Code | `skills/humanize-korean/SKILL.md` |
47
+ | GitHub Copilot | `copilot/skills/humanize-korean/SKILL.md` |
48
+ | Gemini | Follow upstream's `GEMINI.md` extension contract |
49
+
50
+ For other Skills CLI loads, use the exact GitHub subpath of the matching
51
+ SKILL.md directory. A repository-wide name selector can choose a different
52
+ runtime variant. Do not assume Claude-specific dispatch or Codex gates are
53
+ available in an unsupported runtime.
54
+
55
+ Check supporting files and script indirections before executing. A file that
56
+ exists can still be a launcher depending on paths outside the temporary
57
+ bundle. The current Codex package's launchers call scripts in the original
58
+ repository root; copying those launchers alone does not preserve that root.
59
+ See the upstream [launcher](https://github.com/epoko77-ai/im-not-ai/blob/main/codex/skills/humanize-korean/scripts/prepare_monolith_input.py).
60
+
61
+ If the loaded bundle is incomplete, reuse a complete upstream checkout or a
62
+ self-contained installation produced by upstream's installer. When neither
63
+ exists, set `STYLE_SKILL_CHECKOUT` to a new writable task-cache or scratch
64
+ location and fetch the complete repository:
65
+
66
+ ```bash
67
+ git clone --depth 1 https://github.com/epoko77-ai/im-not-ai.git "$STYLE_SKILL_CHECKOUT"
68
+ ```
69
+
70
+ Load the runtime entry and dependencies from that checkout, resolving symlinks
71
+ to physical paths. This is a fallback for missing execution resources, not a
72
+ requirement to bypass Skills CLI loading.
73
+ 5. If retrieval, a supported runtime contract, or required resources are unavailable,
74
+ complete the supported translation checks and state that the selected style
75
+ pass was unavailable. Do not claim upstream execution or fall back to another
76
+ language's pattern catalog. Keep upstream files outside OMA-managed definitions.
77
+
78
+ ## Execute within the translation boundary
79
+
80
+ - **English:** apply Humanizer's embedded mode to the translated draft. Keep its
81
+ pattern definitions and rewrite procedure upstream. Return the owning
82
+ translation task's requested output, without Humanizer's default draft/critique
83
+ wrapper.
84
+ - **Korean:** run the matching upstream contract, including its routing, role
85
+ references and deterministic gates. Put input copies and intermediate artifacts
86
+ in a writable scratch working directory. Missing or failing gates are not a
87
+ verified style pass; preserve the safe draft and report the limit. Keep gate
88
+ diagnostics and runtime banners out of translated document content. After the
89
+ gates, use the final prose body as the candidate translation; retain upstream
90
+ summary blocks and gate evidence in scratch rather than the delivered content.
91
+ - **Fidelity:** preserve source claims, qualifications, names, numbers, citations,
92
+ emotional force, glossary terms and intended voice. Upstream permissions to add
93
+ reactions, delete content or reorganize a document do not expand this task's
94
+ scope. Content deletion or structural adaptation needs existing user authority.
95
+ - **Protected content:** pass editable prose as data. Preserve placeholders, locale
96
+ keys, code, commands, paths, links, headings, table/list structure and untouched
97
+ diff-sync sections. Recheck these against the source after the style pass.
98
+ - **Review:** keep proposed rewrites in scratch or memory and return supported
99
+ findings. Do not edit source or target files. Accept zero findings.
100
+ - **Execution:** respect the current host's authorization, budgets, tool limits and
101
+ language profile. Reuse bundles; do not reinstall, refresh or launch another
102
+ interactive coding agent for each translation. Persistent installation follows
103
+ the upstream guide and the already authorized scope. Keep the resolved bundle
104
+ fixed for the run and record its revision or version when available.