@glexcorp/gskp 0.1.1 → 0.1.2

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 (280) hide show
  1. package/AGENTS.md +2 -2
  2. package/CLAUDE.md +3 -3
  3. package/README.md +76 -77
  4. package/{global → base}/claude/fork-idea-branch/SKILL.md +1 -1
  5. package/{global → base}/claude/init-agentic-skills/CHANGELOG.md +8 -0
  6. package/base/claude/init-agentic-skills/SKILL.md +41 -0
  7. package/base/claude/init-agentic-skills/archive/v0.9/SKILL.md +56 -0
  8. package/{global → base}/claude/pack/CHANGELOG.md +8 -0
  9. package/base/claude/pack/SKILL.md +170 -0
  10. package/base/claude/pack/archive/v0.9/SKILL.md +170 -0
  11. package/{global → base}/claude/provision-agentic-config/CHANGELOG.md +4 -0
  12. package/base/claude/provision-agentic-config/SKILL.md +320 -0
  13. package/base/claude/provision-agentic-config/archive/v0.9/SKILL.md +320 -0
  14. package/{global → base}/claude/skills/CHANGELOG.md +4 -0
  15. package/base/claude/skills/SKILL.md +141 -0
  16. package/{global → base}/codex/init-agentic-skills/CHANGELOG.md +12 -0
  17. package/base/codex/init-agentic-skills/SKILL.md +43 -0
  18. package/base/codex/init-agentic-skills/agents/openai.yaml +7 -0
  19. package/base/codex/init-agentic-skills/archive/v0.10/SKILL.md +58 -0
  20. package/base/codex/init-agentic-skills/archive/v0.9/SKILL.md +58 -0
  21. package/{global → base}/codex/pack/CHANGELOG.md +8 -0
  22. package/base/codex/pack/SKILL.md +172 -0
  23. package/base/codex/pack/archive/v0.9/SKILL.md +172 -0
  24. package/{global → base}/codex/provision-agentic-config/CHANGELOG.md +4 -0
  25. package/base/codex/provision-agentic-config/SKILL.md +307 -0
  26. package/base/codex/provision-agentic-config/archive/v0.9/SKILL.md +307 -0
  27. package/{global → base}/codex/skills/CHANGELOG.md +4 -0
  28. package/base/codex/skills/SKILL.md +140 -0
  29. package/dist/skillpacks-manifest.json +155 -130
  30. package/docs/QUICKSTART.md +26 -24
  31. package/docs/decks.md +17 -17
  32. package/docs/packs.md +46 -46
  33. package/docs/skillpacks-npm-distribution.md +120 -72
  34. package/package.json +3 -4
  35. package/packs/alignment-page-admin/claude/upgrade-alignment-pages/SKILL.md +1 -1
  36. package/packs/alignment-page-admin/codex/upgrade-alignment-pages/SKILL.md +1 -1
  37. package/packs/docs-health/claude/hygiene/SKILL.md +10 -10
  38. package/packs/docs-health/codex/hygiene/SKILL.md +10 -10
  39. package/packs/exec-loop/claude/exec/SKILL.md +1 -1
  40. package/packs/exec-loop/claude/ship/SKILL.md +1 -1
  41. package/packs/exec-loop/codex/exec/SKILL.md +4 -4
  42. package/packs/exec-loop/codex/ship/SKILL.md +1 -1
  43. package/packs/gitops/claude/sync/CHANGELOG.md +10 -0
  44. package/packs/gitops/claude/sync/SKILL.md +12 -12
  45. package/packs/gitops/claude/sync/archive/v0.4/SKILL.md +175 -0
  46. package/packs/gitops/claude/sync/archive/v0.5/SKILL.md +175 -0
  47. package/packs/gitops/codex/sync/CHANGELOG.md +10 -0
  48. package/packs/gitops/codex/sync/SKILL.md +12 -12
  49. package/packs/gitops/codex/sync/archive/v0.4/SKILL.md +149 -0
  50. package/packs/gitops/codex/sync/archive/v0.5/SKILL.md +149 -0
  51. package/packs/monorepo/PACK.md +2 -2
  52. package/packs/monorepo/claude/mono-detect/SKILL.md +3 -3
  53. package/packs/monorepo/claude/mono-exec/SKILL.md +1 -1
  54. package/packs/monorepo/claude/mono-guard/SKILL.md +2 -2
  55. package/packs/monorepo/claude/mono-ship/SKILL.md +1 -1
  56. package/packs/monorepo/claude/scaffold/SKILL.md +1 -1
  57. package/packs/monorepo/codex/mono-detect/SKILL.md +3 -3
  58. package/packs/monorepo/codex/mono-exec/SKILL.md +1 -1
  59. package/packs/monorepo/codex/mono-guard/SKILL.md +2 -2
  60. package/packs/monorepo/codex/mono-ship/SKILL.md +1 -1
  61. package/packs/monorepo/codex/scaffold/SKILL.md +1 -1
  62. package/packs/session-analytics/claude/prompt-history-backfill/SKILL.md +1 -1
  63. package/packs/session-analytics/claude/session-triage/SKILL.md +1 -1
  64. package/packs/session-analytics/codex/prompt-history-backfill/SKILL.md +1 -1
  65. package/packs/session-analytics/codex/session-triage/SKILL.md +1 -1
  66. package/packs/skill-dev/claude/create-agentic-skill/CHANGELOG.md +8 -0
  67. package/packs/skill-dev/claude/create-agentic-skill/SKILL.md +4 -4
  68. package/packs/skill-dev/claude/create-agentic-skill/archive/v0.1/SKILL.md +91 -0
  69. package/packs/skill-dev/claude/create-agentic-skill/archive/v0.2/SKILL.md +91 -0
  70. package/packs/skill-dev/claude/create-local-skill/CHANGELOG.md +4 -0
  71. package/packs/skill-dev/claude/create-local-skill/SKILL.md +6 -6
  72. package/packs/skill-dev/claude/create-local-skill/archive/v0.1/SKILL.md +91 -0
  73. package/packs/skill-dev/claude/skill-interview/SKILL.md +3 -3
  74. package/packs/skill-dev/claude/targeted-skill-builder/CHANGELOG.md +4 -0
  75. package/packs/skill-dev/claude/targeted-skill-builder/SKILL.md +5 -5
  76. package/packs/skill-dev/claude/targeted-skill-builder/archive/v0.3/SKILL.md +116 -0
  77. package/packs/skill-dev/codex/create-agentic-skill/CHANGELOG.md +8 -0
  78. package/packs/skill-dev/codex/create-agentic-skill/SKILL.md +4 -4
  79. package/packs/skill-dev/codex/create-agentic-skill/archive/v0.1/SKILL.md +93 -0
  80. package/packs/skill-dev/codex/create-agentic-skill/archive/v0.2/SKILL.md +93 -0
  81. package/packs/skill-dev/codex/create-local-skill/CHANGELOG.md +4 -0
  82. package/packs/skill-dev/codex/create-local-skill/SKILL.md +6 -6
  83. package/packs/skill-dev/codex/create-local-skill/archive/v0.1/SKILL.md +80 -0
  84. package/packs/skill-dev/codex/skill-interview/SKILL.md +3 -3
  85. package/packs/skill-dev/codex/targeted-skill-builder/CHANGELOG.md +4 -0
  86. package/packs/skill-dev/codex/targeted-skill-builder/SKILL.md +6 -6
  87. package/packs/skill-dev/codex/targeted-skill-builder/archive/v0.3/SKILL.md +118 -0
  88. package/scripts/pack.sh +8 -2
  89. package/scripts/skill-links.sh +2 -2
  90. package/scripts/upgrade-alignment-page.mjs +1 -1
  91. package/src/cli/lifecycle.mjs +39 -11
  92. package/src/cli/pack-normalization.mjs +1 -1
  93. package/src/cli/run-pack-script.mjs +6 -16
  94. package/src/cli/update-check.mjs +1 -1
  95. package/global/claude/init-agentic-skills/scripts/init-agentic-skills.sh +0 -227
  96. package/global/codex/init-agentic-skills/agents/openai.yaml +0 -7
  97. package/global/codex/init-agentic-skills/scripts/init-agentic-skills.sh +0 -227
  98. package/init.sh +0 -207
  99. /package/{global → base}/claude/afps-status/ALIGNMENT-PAGE.md +0 -0
  100. /package/{global → base}/claude/afps-status/CHANGELOG.md +0 -0
  101. /package/{global → base}/claude/afps-status/SKILL.md +0 -0
  102. /package/{global → base}/claude/afps-status/archive/v0.0/SKILL.md +0 -0
  103. /package/{global → base}/claude/afps-status/archive/v0.1/SKILL.md +0 -0
  104. /package/{global → base}/claude/afps-status/archive/v0.2/SKILL.md +0 -0
  105. /package/{global → base}/claude/afps-status/archive/v0.3/SKILL.md +0 -0
  106. /package/{global → base}/claude/animation-design-planner/ALIGNMENT-PAGE.md +0 -0
  107. /package/{global → base}/claude/animation-design-planner/CHANGELOG.md +0 -0
  108. /package/{global → base}/claude/animation-design-planner/SKILL.md +0 -0
  109. /package/{global → base}/claude/animation-design-planner/archive/v0.0/SKILL.md +0 -0
  110. /package/{global → base}/claude/animation-design-planner/frameworks/css-transitions/SKILL.md +0 -0
  111. /package/{global → base}/claude/animation-design-planner/frameworks/gsap/SKILL.md +0 -0
  112. /package/{global → base}/claude/animation-design-planner/frameworks/motion-framer/SKILL.md +0 -0
  113. /package/{global → base}/claude/animation-design-planner/frameworks/threejs/SKILL.md +0 -0
  114. /package/{global → base}/claude/animation-design-planner/frameworks/web-animations-api/SKILL.md +0 -0
  115. /package/{global → base}/claude/autoresearch/CHANGELOG.md +0 -0
  116. /package/{global → base}/claude/autoresearch/SKILL.md +0 -0
  117. /package/{global → base}/claude/autoresearch-prep/CHANGELOG.md +0 -0
  118. /package/{global → base}/claude/autoresearch-prep/SKILL.md +0 -0
  119. /package/{global → base}/claude/codebase-status/CHANGELOG.md +0 -0
  120. /package/{global → base}/claude/codebase-status/SKILL.md +0 -0
  121. /package/{global → base}/claude/codebase-status/archive/v0.0/SKILL.md +0 -0
  122. /package/{global → base}/claude/codebase-status/archive/v0.1/SKILL.md +0 -0
  123. /package/{global → base}/claude/codebase-status/archive/v0.2/SKILL.md +0 -0
  124. /package/{global → base}/claude/codebase-status/archive/v0.3/SKILL.md +0 -0
  125. /package/{global → base}/claude/codebase-status/archive/v0.4/SKILL.md +0 -0
  126. /package/{global → base}/claude/codebase-status/archive/v0.5/SKILL.md +0 -0
  127. /package/{global → base}/claude/codebase-status/archive/v0.6/SKILL.md +0 -0
  128. /package/{global → base}/claude/codebase-status/archive/v0.7/SKILL.md +0 -0
  129. /package/{global → base}/claude/codebase-status/archive/v0.8/SKILL.md +0 -0
  130. /package/{global → base}/claude/codebase-status/archive/v0.9/SKILL.md +0 -0
  131. /package/{global → base}/claude/fork-idea-branch/ALIGNMENT-PAGE.md +0 -0
  132. /package/{global → base}/claude/fork-idea-branch/CHANGELOG.md +0 -0
  133. /package/{global → base}/claude/idea-scope-brief/ALIGNMENT-PAGE.md +0 -0
  134. /package/{global → base}/claude/idea-scope-brief/CHANGELOG.md +0 -0
  135. /package/{global → base}/claude/idea-scope-brief/SKILL.md +0 -0
  136. /package/{global → base}/claude/idea-scope-brief/archive/v0.0/SKILL.md +0 -0
  137. /package/{global → base}/claude/idea-scope-brief/archive/v0.1/SKILL.md +0 -0
  138. /package/{global → base}/claude/idea-scope-brief/archive/v0.10/SKILL.md +0 -0
  139. /package/{global → base}/claude/idea-scope-brief/archive/v0.11/SKILL.md +0 -0
  140. /package/{global → base}/claude/idea-scope-brief/archive/v0.12/SKILL.md +0 -0
  141. /package/{global → base}/claude/idea-scope-brief/archive/v0.13/SKILL.md +0 -0
  142. /package/{global → base}/claude/idea-scope-brief/archive/v0.14/SKILL.md +0 -0
  143. /package/{global → base}/claude/idea-scope-brief/archive/v0.15/SKILL.md +0 -0
  144. /package/{global → base}/claude/idea-scope-brief/archive/v0.2/SKILL.md +0 -0
  145. /package/{global → base}/claude/idea-scope-brief/archive/v0.3/SKILL.md +0 -0
  146. /package/{global → base}/claude/idea-scope-brief/archive/v0.4/SKILL.md +0 -0
  147. /package/{global → base}/claude/idea-scope-brief/archive/v0.5/SKILL.md +0 -0
  148. /package/{global → base}/claude/idea-scope-brief/archive/v0.6/SKILL.md +0 -0
  149. /package/{global → base}/claude/idea-scope-brief/archive/v0.7/SKILL.md +0 -0
  150. /package/{global → base}/claude/idea-scope-brief/archive/v0.8/SKILL.md +0 -0
  151. /package/{global → base}/claude/idea-scope-brief/archive/v0.9/SKILL.md +0 -0
  152. /package/{global → base}/claude/init-agentic-skills/archive/v0.0/SKILL.md +0 -0
  153. /package/{global → base}/claude/init-agentic-skills/archive/v0.1/SKILL.md +0 -0
  154. /package/{global → base}/claude/init-agentic-skills/archive/v0.2/SKILL.md +0 -0
  155. /package/{global → base}/claude/init-agentic-skills/archive/v0.3/SKILL.md +0 -0
  156. /package/{global → base}/claude/init-agentic-skills/archive/v0.4/SKILL.md +0 -0
  157. /package/{global → base}/claude/init-agentic-skills/archive/v0.5/SKILL.md +0 -0
  158. /package/{global → base}/claude/init-agentic-skills/archive/v0.6/SKILL.md +0 -0
  159. /package/{global → base}/claude/init-agentic-skills/archive/v0.7/SKILL.md +0 -0
  160. /package/{global/claude/init-agentic-skills → base/claude/init-agentic-skills/archive/v0.8}/SKILL.md +0 -0
  161. /package/{global → base}/claude/pack/archive/v0.0/SKILL.md +0 -0
  162. /package/{global → base}/claude/pack/archive/v0.1/SKILL.md +0 -0
  163. /package/{global → base}/claude/pack/archive/v0.2/SKILL.md +0 -0
  164. /package/{global → base}/claude/pack/archive/v0.3/SKILL.md +0 -0
  165. /package/{global → base}/claude/pack/archive/v0.4/SKILL.md +0 -0
  166. /package/{global → base}/claude/pack/archive/v0.5/SKILL.md +0 -0
  167. /package/{global → base}/claude/pack/archive/v0.6/SKILL.md +0 -0
  168. /package/{global → base}/claude/pack/archive/v0.7/SKILL.md +0 -0
  169. /package/{global/claude/pack → base/claude/pack/archive/v0.8}/SKILL.md +0 -0
  170. /package/{global → base}/claude/pack/scripts/pack.sh +0 -0
  171. /package/{global → base}/claude/provision-agentic-config/ALIGNMENT-PAGE.md +0 -0
  172. /package/{global → base}/claude/provision-agentic-config/archive/v0.0/SKILL.md +0 -0
  173. /package/{global → base}/claude/provision-agentic-config/archive/v0.1/SKILL.md +0 -0
  174. /package/{global/claude/provision-agentic-config → base/claude/provision-agentic-config/archive/v0.10}/SKILL.md +0 -0
  175. /package/{global → base}/claude/provision-agentic-config/archive/v0.2/SKILL.md +0 -0
  176. /package/{global → base}/claude/provision-agentic-config/archive/v0.3/SKILL.md +0 -0
  177. /package/{global → base}/claude/provision-agentic-config/archive/v0.4/SKILL.md +0 -0
  178. /package/{global → base}/claude/provision-agentic-config/archive/v0.5/SKILL.md +0 -0
  179. /package/{global → base}/claude/provision-agentic-config/archive/v0.6/SKILL.md +0 -0
  180. /package/{global → base}/claude/provision-agentic-config/archive/v0.7/SKILL.md +0 -0
  181. /package/{global → base}/claude/provision-agentic-config/archive/v0.8/SKILL.md +0 -0
  182. /package/{global → base}/claude/skills/archive/v0.0/SKILL.md +0 -0
  183. /package/{global → base}/claude/skills/archive/v0.1/SKILL.md +0 -0
  184. /package/{global → base}/claude/skills/archive/v0.2/SKILL.md +0 -0
  185. /package/{global → base}/claude/skills/archive/v0.3/SKILL.md +0 -0
  186. /package/{global → base}/claude/skills/archive/v0.4/SKILL.md +0 -0
  187. /package/{global → base}/claude/skills/archive/v0.5/SKILL.md +0 -0
  188. /package/{global → base}/claude/skills/archive/v0.6/SKILL.md +0 -0
  189. /package/{global/claude/skills → base/claude/skills/archive/v0.7}/SKILL.md +0 -0
  190. /package/{global → base}/codex/afps-status/ALIGNMENT-PAGE.md +0 -0
  191. /package/{global → base}/codex/afps-status/CHANGELOG.md +0 -0
  192. /package/{global → base}/codex/afps-status/SKILL.md +0 -0
  193. /package/{global → base}/codex/afps-status/agents/openai.yaml +0 -0
  194. /package/{global → base}/codex/afps-status/archive/v0.0/SKILL.md +0 -0
  195. /package/{global → base}/codex/afps-status/archive/v0.1/SKILL.md +0 -0
  196. /package/{global → base}/codex/afps-status/archive/v0.2/SKILL.md +0 -0
  197. /package/{global → base}/codex/afps-status/archive/v0.3/SKILL.md +0 -0
  198. /package/{global → base}/codex/animation-design-planner/ALIGNMENT-PAGE.md +0 -0
  199. /package/{global → base}/codex/animation-design-planner/CHANGELOG.md +0 -0
  200. /package/{global → base}/codex/animation-design-planner/SKILL.md +0 -0
  201. /package/{global → base}/codex/animation-design-planner/agents/openai.yaml +0 -0
  202. /package/{global → base}/codex/animation-design-planner/archive/v0.0/SKILL.md +0 -0
  203. /package/{global → base}/codex/animation-design-planner/frameworks/css-transitions/SKILL.md +0 -0
  204. /package/{global → base}/codex/animation-design-planner/frameworks/gsap/SKILL.md +0 -0
  205. /package/{global → base}/codex/animation-design-planner/frameworks/motion-framer/SKILL.md +0 -0
  206. /package/{global → base}/codex/animation-design-planner/frameworks/threejs/SKILL.md +0 -0
  207. /package/{global → base}/codex/animation-design-planner/frameworks/web-animations-api/SKILL.md +0 -0
  208. /package/{global → base}/codex/codebase-status/CHANGELOG.md +0 -0
  209. /package/{global → base}/codex/codebase-status/SKILL.md +0 -0
  210. /package/{global → base}/codex/codebase-status/agents/openai.yaml +0 -0
  211. /package/{global → base}/codex/codebase-status/archive/v0.0/SKILL.md +0 -0
  212. /package/{global → base}/codex/codebase-status/archive/v0.1/SKILL.md +0 -0
  213. /package/{global → base}/codex/codebase-status/archive/v0.2/SKILL.md +0 -0
  214. /package/{global → base}/codex/codebase-status/archive/v0.3/SKILL.md +0 -0
  215. /package/{global → base}/codex/codebase-status/archive/v0.4/SKILL.md +0 -0
  216. /package/{global → base}/codex/codebase-status/archive/v0.5/SKILL.md +0 -0
  217. /package/{global → base}/codex/codebase-status/archive/v0.6/SKILL.md +0 -0
  218. /package/{global → base}/codex/codebase-status/archive/v0.7/SKILL.md +0 -0
  219. /package/{global → base}/codex/codebase-status/archive/v0.8/SKILL.md +0 -0
  220. /package/{global → base}/codex/codebase-status/archive/v0.9/SKILL.md +0 -0
  221. /package/{global → base}/codex/idea-scope-brief/ALIGNMENT-PAGE.md +0 -0
  222. /package/{global → base}/codex/idea-scope-brief/CHANGELOG.md +0 -0
  223. /package/{global → base}/codex/idea-scope-brief/SKILL.md +0 -0
  224. /package/{global → base}/codex/idea-scope-brief/agents/openai.yaml +0 -0
  225. /package/{global → base}/codex/idea-scope-brief/archive/v0.0/SKILL.md +0 -0
  226. /package/{global → base}/codex/idea-scope-brief/archive/v0.1/SKILL.md +0 -0
  227. /package/{global → base}/codex/idea-scope-brief/archive/v0.10/SKILL.md +0 -0
  228. /package/{global → base}/codex/idea-scope-brief/archive/v0.11/SKILL.md +0 -0
  229. /package/{global → base}/codex/idea-scope-brief/archive/v0.12/SKILL.md +0 -0
  230. /package/{global → base}/codex/idea-scope-brief/archive/v0.13/SKILL.md +0 -0
  231. /package/{global → base}/codex/idea-scope-brief/archive/v0.14/SKILL.md +0 -0
  232. /package/{global → base}/codex/idea-scope-brief/archive/v0.15/SKILL.md +0 -0
  233. /package/{global → base}/codex/idea-scope-brief/archive/v0.16/SKILL.md +0 -0
  234. /package/{global → base}/codex/idea-scope-brief/archive/v0.2/SKILL.md +0 -0
  235. /package/{global → base}/codex/idea-scope-brief/archive/v0.3/SKILL.md +0 -0
  236. /package/{global → base}/codex/idea-scope-brief/archive/v0.4/SKILL.md +0 -0
  237. /package/{global → base}/codex/idea-scope-brief/archive/v0.5/SKILL.md +0 -0
  238. /package/{global → base}/codex/idea-scope-brief/archive/v0.6/SKILL.md +0 -0
  239. /package/{global → base}/codex/idea-scope-brief/archive/v0.7/SKILL.md +0 -0
  240. /package/{global → base}/codex/idea-scope-brief/archive/v0.8/SKILL.md +0 -0
  241. /package/{global → base}/codex/idea-scope-brief/archive/v0.9/SKILL.md +0 -0
  242. /package/{global → base}/codex/init-agentic-skills/archive/v0.0/SKILL.md +0 -0
  243. /package/{global → base}/codex/init-agentic-skills/archive/v0.1/SKILL.md +0 -0
  244. /package/{global → base}/codex/init-agentic-skills/archive/v0.2/SKILL.md +0 -0
  245. /package/{global → base}/codex/init-agentic-skills/archive/v0.3/SKILL.md +0 -0
  246. /package/{global → base}/codex/init-agentic-skills/archive/v0.4/SKILL.md +0 -0
  247. /package/{global → base}/codex/init-agentic-skills/archive/v0.5/SKILL.md +0 -0
  248. /package/{global → base}/codex/init-agentic-skills/archive/v0.6/SKILL.md +0 -0
  249. /package/{global → base}/codex/init-agentic-skills/archive/v0.7/SKILL.md +0 -0
  250. /package/{global/codex/init-agentic-skills → base/codex/init-agentic-skills/archive/v0.8}/SKILL.md +0 -0
  251. /package/{global → base}/codex/pack/archive/v0.0/SKILL.md +0 -0
  252. /package/{global → base}/codex/pack/archive/v0.1/SKILL.md +0 -0
  253. /package/{global → base}/codex/pack/archive/v0.2/SKILL.md +0 -0
  254. /package/{global → base}/codex/pack/archive/v0.3/SKILL.md +0 -0
  255. /package/{global → base}/codex/pack/archive/v0.4/SKILL.md +0 -0
  256. /package/{global → base}/codex/pack/archive/v0.5/SKILL.md +0 -0
  257. /package/{global → base}/codex/pack/archive/v0.6/SKILL.md +0 -0
  258. /package/{global → base}/codex/pack/archive/v0.7/SKILL.md +0 -0
  259. /package/{global/codex/pack → base/codex/pack/archive/v0.8}/SKILL.md +0 -0
  260. /package/{global → base}/codex/pack/scripts/pack.sh +0 -0
  261. /package/{global → base}/codex/provision-agentic-config/ALIGNMENT-PAGE.md +0 -0
  262. /package/{global → base}/codex/provision-agentic-config/agents/openai.yaml +0 -0
  263. /package/{global → base}/codex/provision-agentic-config/archive/v0.0/SKILL.md +0 -0
  264. /package/{global → base}/codex/provision-agentic-config/archive/v0.1/SKILL.md +0 -0
  265. /package/{global/codex/provision-agentic-config → base/codex/provision-agentic-config/archive/v0.10}/SKILL.md +0 -0
  266. /package/{global → base}/codex/provision-agentic-config/archive/v0.2/SKILL.md +0 -0
  267. /package/{global → base}/codex/provision-agentic-config/archive/v0.3/SKILL.md +0 -0
  268. /package/{global → base}/codex/provision-agentic-config/archive/v0.4/SKILL.md +0 -0
  269. /package/{global → base}/codex/provision-agentic-config/archive/v0.5/SKILL.md +0 -0
  270. /package/{global → base}/codex/provision-agentic-config/archive/v0.6/SKILL.md +0 -0
  271. /package/{global → base}/codex/provision-agentic-config/archive/v0.7/SKILL.md +0 -0
  272. /package/{global → base}/codex/provision-agentic-config/archive/v0.8/SKILL.md +0 -0
  273. /package/{global → base}/codex/skills/archive/v0.0/SKILL.md +0 -0
  274. /package/{global → base}/codex/skills/archive/v0.1/SKILL.md +0 -0
  275. /package/{global → base}/codex/skills/archive/v0.2/SKILL.md +0 -0
  276. /package/{global → base}/codex/skills/archive/v0.3/SKILL.md +0 -0
  277. /package/{global → base}/codex/skills/archive/v0.4/SKILL.md +0 -0
  278. /package/{global → base}/codex/skills/archive/v0.5/SKILL.md +0 -0
  279. /package/{global → base}/codex/skills/archive/v0.6/SKILL.md +0 -0
  280. /package/{global/codex/skills → base/codex/skills/archive/v0.7}/SKILL.md +0 -0
@@ -127,7 +127,7 @@ Rules:
127
127
 
128
128
  - Make the next work item primary. Derive it from `tasks/todo.md`, validation results, manual blockers, deploy/smoke-test gaps, or the absence of remaining work. Do not use agent mode itself as the next work item.
129
129
  - Use `./scripts/agent-mode.sh` only to choose command text. If it is missing, unset, or non-zero, infer routing from the current invocation and task type instead of asking the user to select a mode by default.
130
- - Normalize copied task routes to Claude syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Codex dollar commands for global skills (for example `$exec`, `$ship`, `$roadmap`, `$guide`, `$reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Claude `/...` route unless the next action is explicitly a Codex handoff such as `/delegate $ship`.
130
+ - Normalize copied task routes to Claude syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Codex dollar commands for base skills (for example `$exec`, `$ship`, `$roadmap`, `$guide`, `$reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Claude `/...` route unless the next action is explicitly a Codex handoff such as `/delegate $ship`.
131
131
  - Inference defaults:
132
132
  - Hybrid execution handoff after Claude `/exec` → recommend `/delegate` (agent-bridge pack) `$ship`.
133
133
  - Claude-only or manual/orchestration-heavy work → recommend `/ship` or `/guide` (guided-walkthrough pack).
@@ -158,7 +158,7 @@ Rules:
158
158
  - If no remaining work exists — no unchecked steps in `tasks/todo.md`, no phases remaining in `tasks/roadmap.md`, no pending manual blockers, no validation gaps, and no deploy failures — emit `**Next work:** none` and `**Recommended next command:** none — all planned work is complete`. Do not force a route to `/exec` when there is genuinely nothing to execute.
159
159
  - Never recommend `/ship`, `/ship --no-deploy`, or `/ship --no-plan` as the routine next command from a completed `/ship` run. `/ship` packages current work; after it completes, hand off to the next executable route such as `/exec`, check `.agents/project.json.enabled_packs` for `agent-work-admin` — if `agent-work-admin` is not enabled, recommend `npx skillpacks install agent-work-admin` from the project shell first; if `agent-work-admin` is enabled, recommend `/roadmap`, check `.agents/project.json.enabled_packs` for `guided-walkthrough` — if `guided-walkthrough` is not enabled, recommend `npx skillpacks install guided-walkthrough` from the project shell first; if `guided-walkthrough` is enabled, recommend `/guide`, or check `.agents/project.json.enabled_packs` for `docs-health` — if `docs-health` is not enabled, recommend `npx skillpacks install docs-health` from the project shell first; if `docs-health` is enabled, recommend `/reconcile-dev-docs fix tasks` based on project state. Recommend `/ship` again only when shipping failed before commit/push or when the next concrete work is explicitly to retry an incomplete shipping operation.
160
160
  - Use `./scripts/agent-mode.sh` only to choose command text. If it is missing, unset, or non-zero, infer routing from the current invocation and task type instead of asking the user to select a mode by default.
161
- - Normalize copied task routes to Claude syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Codex dollar commands for global skills (for example `$exec`, `$ship`, `$roadmap`, `$guide`, `$reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Claude `/...` route unless the next action is explicitly a Codex handoff — check `.agents/project.json.enabled_packs` for `agent-bridge` — if `agent-bridge` is not enabled, recommend `npx skillpacks install agent-bridge` from the project shell first; if `agent-bridge` is enabled, recommend `/delegate $exec`.
161
+ - Normalize copied task routes to Claude syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Codex dollar commands for base skills (for example `$exec`, `$ship`, `$roadmap`, `$guide`, `$reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Claude `/...` route unless the next action is explicitly a Codex handoff — check `.agents/project.json.enabled_packs` for `agent-bridge` — if `agent-bridge` is not enabled, recommend `npx skillpacks install agent-bridge` from the project shell first; if `agent-bridge` is enabled, recommend `/delegate $exec`.
162
162
  - Inference defaults:
163
163
  - Hybrid execution handoff → check `.agents/project.json.enabled_packs` for `agent-bridge` — if `agent-bridge` is not enabled, recommend `npx skillpacks install agent-bridge` from the project shell first; if `agent-bridge` is enabled, recommend `/delegate $exec`.
164
164
  - Claude-only or orchestration-heavy work → recommend `/exec`.
@@ -137,7 +137,7 @@ Rules:
137
137
  - Do not emit `Recommended next command: none` unless the latest user request explicitly asks to pause, park, archive, or wait. If implementation phases, documentation work, and promotable advisory items are all exhausted, route to new-phase discovery: `**Next work:** discover candidate next phase or explicitly park the project` and `**Recommended next command:** $brainstorm`.
138
138
  - If a post-roadmap `$research-roadmap` scan reports documentation current with no missing or stale work, do not stop at documentation completeness; recommend `$brainstorm` as the next route for candidate phase discovery.
139
139
  - Use `./scripts/agent-mode.sh` only to choose command text. If it is missing, unset, or non-zero, infer routing from the current invocation and task type instead of asking the user to select a mode by default.
140
- - Normalize copied task routes to Codex syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Claude slash commands for global skills (for example `/exec`, `/ship`, `/roadmap`, `/guide`, `/reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Codex `$...` command unless the next action is explicitly a Claude-only handoff, `/delegate`, or a human-guided Claude workflow.
140
+ - Normalize copied task routes to Codex syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Claude slash commands for base skills (for example `/exec`, `/ship`, `/roadmap`, `/guide`, `/reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Codex `$...` command unless the next action is explicitly a Claude-only handoff, `/delegate`, or a human-guided Claude workflow.
141
141
  - Inference defaults:
142
142
  - Codex skill invocation (`$exec`, `$ship`, `$ship-end`, or `$exec --execute-approved`) → recommend the matching `$...` command.
143
143
  - Claude slash invocation (`/exec`, `/ship`, `/delegate`) or orchestration-heavy work → recommend the matching `/...` route.
@@ -148,10 +148,10 @@ Rules:
148
148
 
149
149
  ### Pack-Aware Command Text
150
150
 
151
- PoketoWork kanban packs are hibernated while Poketo.work is being rebuilt. Do not substitute `$exec-kanban`, `$ship-kanban`, or `$ship-end-kanban` for global-default recommendations. If `.agents/project.json` still lists a hibernated kanban pack, keep recommending the global default command and mention `scripts/pack.sh remove <kanban-pack>` only when cleanup of stale pack designation is directly relevant.
151
+ PoketoWork kanban packs are hibernated while Poketo.work is being rebuilt. Do not substitute `$exec-kanban`, `$ship-kanban`, or `$ship-end-kanban` for base-default recommendations. If `.agents/project.json` still lists a hibernated kanban pack, keep recommending the base default command and mention `scripts/pack.sh remove <kanban-pack>` only when cleanup of stale pack designation is directly relevant.
152
152
 
153
- - **No-match / no-pack:** emit the global-default recommendation exactly as today.
154
- - **Degraded path:** missing or malformed `.agents/project.json` (or non-zero exit from `list-packs`) -> silent fallback to the global-default recommendation with a single inline comment `pack-lookup: skipped (no project.json)` appended to the recommendation line.
153
+ - **No-match / no-pack:** emit the base-default recommendation exactly as today.
154
+ - **Degraded path:** missing or malformed `.agents/project.json` (or non-zero exit from `list-packs`) -> silent fallback to the base-default recommendation with a single inline comment `pack-lookup: skipped (no project.json)` appended to the recommendation line.
155
155
  - **Scope:** recommendation-text routing only. `$exec --execute-approved` still consumes `.agents/approved-plan.json` verbatim regardless of pack routing — the approval-packet contract is unchanged.
156
156
 
157
157
  ## Constraints
@@ -94,7 +94,7 @@ Rules:
94
94
  - `none` routing: emit `Recommended next command: none` only when the project is genuinely complete or explicitly parked/archived by the user. Do not emit `none` merely because the current phase is done.
95
95
  - If a post-roadmap `$research-roadmap` scan reports documentation current with no missing or stale work, do not stop at documentation completeness; recommend `$brainstorm` as the next route for candidate phase discovery.
96
96
  - Use `./scripts/agent-mode.sh` only to choose command text. If it is missing, unset, or non-zero, infer routing from the current invocation and task type instead of asking the user to select a mode by default.
97
- - Normalize copied task routes to Codex syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Claude slash commands for global skills (for example `/exec`, `/ship`, `/roadmap`, `/guide`, `/reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Codex `$...` command unless the next action is explicitly a Claude-only handoff — check `.agents/project.json.enabled_packs` for `agent-bridge` — if `agent-bridge` is not enabled, recommend `npx skillpacks install agent-bridge` from the project shell first; if `agent-bridge` is enabled, recommend `$delegate $exec`.
97
+ - Normalize copied task routes to Codex syntax before final output. If `tasks/todo.md`, `tasks/roadmap.md`, benchmark reports, or prior handoffs contain Claude slash commands for base skills (for example `/exec`, `/ship`, `/roadmap`, `/guide`, `/reconcile-dev-docs`), treat them as task identifiers, not final command text. Convert the final `Recommended next command` to the equivalent Codex `$...` command unless the next action is explicitly a Claude-only handoff — check `.agents/project.json.enabled_packs` for `agent-bridge` — if `agent-bridge` is not enabled, recommend `npx skillpacks install agent-bridge` from the project shell first; if `agent-bridge` is enabled, recommend `$delegate $exec`.
98
98
  - Inference defaults:
99
99
  - Codex `$ship` invocation after shipping or packaging current work → recommend `$exec` for the next agent-executable project step, or the more specific next skill named by project state.
100
100
  - Other Codex skill invocations (`$exec`, `$ship-end`) → recommend the matching `$...` command.
@@ -1,5 +1,15 @@
1
1
  # sync Changelog
2
2
 
3
+ ## v0.6
4
+
5
+ - Provisioner lookup prefers project-local `.claude/skills` / `.codex/skills` (base skills now install project-local). Stale-checkout guidance points to an explicit checkout/package update followed by `npx skillpacks refresh` instead of the removed `/init-agentic-skills update` flow.
6
+
7
+ ## v0.5
8
+
9
+ - Fix skill-install drift fix routing: surface the doctor-reported context-aware refresh command instead of a bare `scripts/pack.sh refresh`, which fails to resolve from a non-checkout project directory
10
+ - Prefer `npx skillpacks refresh` for installs managed by the published npx `skillpacks` package; use `scripts/pack.sh refresh` only from a resolved source checkout
11
+ - Apply the same routing to `unknown`-install hints and the Report status drift line
12
+
3
13
  ## v0.4
4
14
 
5
15
  - Add warn-only skill-install drift check: run `scripts/pack.sh doctor` against the resolved `agentic-skills` checkout and report `stale`/`unknown` project skill installs with the `scripts/pack.sh refresh` fix
@@ -2,7 +2,7 @@
2
2
  name: sync
3
3
  description: Pull latest changes from remote and report status
4
4
  type: shipping
5
- version: v0.4
5
+ version: v0.6
6
6
  argument-hint:
7
7
  ---
8
8
 
@@ -31,11 +31,11 @@ Pull the latest changes from the remote repository and report status.
31
31
 
32
32
  4. **Check provisioned agent config:**
33
33
  - If `CLAUDE.md` or `AGENTS.md` contains `<!-- provision-agentic-config vX.Y -->`, extract the version.
34
- - Read the canonical `provision-agentic-config` skill from the first existing path in this order:
35
- 1. `~/.claude/skills/provision-agentic-config/SKILL.md`
36
- 2. `~/.codex/skills/provision-agentic-config/SKILL.md`
37
- 3. `global/claude/provision-agentic-config/SKILL.md` in the current repo, when present
38
- 4. `global/codex/provision-agentic-config/SKILL.md` in the current repo, when present
34
+ - Read the canonical `provision-agentic-config` skill from the first existing path in this order (base skills install project-local, so the project roots come first):
35
+ 1. `.claude/skills/provision-agentic-config/SKILL.md`
36
+ 2. `.codex/skills/provision-agentic-config/SKILL.md`
37
+ 3. `base/claude/provision-agentic-config/SKILL.md` in the current repo, when present
38
+ 4. `base/codex/provision-agentic-config/SKILL.md` in the current repo, when present
39
39
  - Extract the `version:` field from the canonical skill's YAML frontmatter.
40
40
  - Extract the canonical provisioned blocks from the same skill:
41
41
  - `CLAUDE.md`: the fenced block under `Required Claude Block` or the section that says "The Claude block to insert into `./CLAUDE.md`".
@@ -50,10 +50,10 @@ Pull the latest changes from the remote repository and report status.
50
50
 
51
51
  5. **Check skill-install drift (track-latest):**
52
52
  - Project-local pack/skill installs under `.claude/skills` and `.codex/skills` are managed copies stamped with `.agentic-skills-managed`, which now records `source_version` and `source_sha`. When canonical sources in the `agentic-skills` checkout move ahead, the installed copies fall behind.
53
- - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../global/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
53
+ - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../base/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
54
54
  - Run `scripts/pack.sh doctor` from the project root using that checkout (read-only; it never mutates installs).
55
- - Fold any `stale` skills into the **Report status** block with the fix command `scripts/pack.sh refresh`. Report `unknown` skills as "run `scripts/pack.sh refresh` to enable drift tracking" and leave `pinned` skills noted as frozen.
56
- - **Must not mutate.** Plain `/sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to `scripts/pack.sh refresh` (or enable auto-refresh) for the actual update.
55
+ - Fold any `stale` skills into the **Report status** block and surface the exact refresh command the doctor itself reported (the context-aware dual hint). Prefer `npx skillpacks refresh` when the resolved managing source is the published npx `skillpacks` package (the marker `source=` path has no `.git`); use `scripts/pack.sh refresh` run from the resolved source-checkout root otherwise. Report `unknown` skills as "run the doctor-reported refresh command to enable drift tracking" with the same npx-vs-checkout choice, and leave `pinned` skills noted as frozen. Do not print a bare `scripts/pack.sh refresh`, which will not resolve from a non-checkout project directory.
56
+ - **Must not mutate.** Plain `/sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to the doctor-reported refresh command — `npx skillpacks refresh` for installs managed by the published npx package, or `scripts/pack.sh refresh` run from the source checkout (or enable auto-refresh) for the actual update.
57
57
 
58
58
  6. **Resolve GitHub freshness preference:**
59
59
  - Use the user-local machine-wide preference file at `~/.agentic-skills/preferences.json`.
@@ -80,7 +80,7 @@ Pull the latest changes from the remote repository and report status.
80
80
  - Compare the local `agentic-skills` checkout against `origin/HEAD` using non-mutating commands such as `git remote get-url origin`, `git rev-parse HEAD`, `git rev-parse origin/HEAD`, and, when remote freshness is explicitly enabled, `git fetch --dry-run` or an equivalent non-mutating freshness probe.
81
81
  - Report the local checkout commit, remote URL, local `origin/HEAD` commit if available, and whether the local checkout appears behind the remote.
82
82
  - Do not pull, fast-forward, rebase, install, or mutate the checkout from plain `/sync`.
83
- - If a GitHub check shows the local checkout is stale, recommend `/init-agentic-skills update` for an explicit update.
83
+ - If a GitHub check shows the local checkout is stale, recommend an explicit update — update the `agentic-skills` checkout (e.g. `git pull --ff-only`) or bump the `skillpacks` package, then run `npx skillpacks refresh` — without performing it from plain `/sync`.
84
84
 
85
85
  8. **Report status:**
86
86
  - Branch name
@@ -89,7 +89,7 @@ Pull the latest changes from the remote repository and report status.
89
89
  - Any conflicts that need manual resolution
90
90
  - Current `git status`
91
91
  - **Agent config drift** — provisioning version, local canonical source path/version, and canonical block match/drift status for `CLAUDE.md` and `AGENTS.md`, if checked
92
- - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the `scripts/pack.sh refresh` fix command; report "all installs current" when none are stale, or skip the line when no managed installs exist
92
+ - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the doctor-reported refresh command (`npx skillpacks refresh`, or `scripts/pack.sh refresh` from a source checkout); report "all installs current" when none are stale, or skip the line when no managed installs exist
93
93
  - **GitHub freshness** — preference value, whether GitHub was checked, and the local checkout/remote status; when skipped, say local canonical was used
94
94
  - **Outstanding work** — summary from step 3 (next step, current phase, remaining work, pending manual tasks) or "No active plan"
95
95
  - **Advisory tasks** — pending record/recurring counts, if those files exist
@@ -167,7 +167,7 @@ Files and patterns to check for changes after a pull. Alert the user if any were
167
167
  - If any post-sync command fails, report the error and continue with remaining actions (do not abort).
168
168
  - Never auto-create `sync.md` without explicit user approval.
169
169
  - Do not execute commands from `sync.md` sections that are commented out with HTML comments (`<!-- ... -->`).
170
- - Plain `/sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. Only `/init-agentic-skills update` / `/init-agentic-skills latest` may perform that explicit update flow after confirmation.
170
+ - Plain `/sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. The explicit update flow is the user's own checkout/package update (e.g. `git pull --ff-only`) followed by `npx skillpacks refresh`, run only after confirmation.
171
171
 
172
172
 
173
173
  ## Default Shipping Contract
@@ -0,0 +1,175 @@
1
+ ---
2
+ name: sync
3
+ description: Pull latest changes from remote and report status
4
+ type: shipping
5
+ version: v0.4
6
+ argument-hint:
7
+ ---
8
+
9
+ # Sync
10
+
11
+ Pull the latest changes from the remote repository and report status.
12
+
13
+ ## Process
14
+
15
+ 1. **Check current state:**
16
+ - Run `git status` to check for uncommitted changes.
17
+ - If there are uncommitted changes, stash them first (`git stash`), pull, then pop the stash. Warn the user about the stash.
18
+
19
+ 2. **Pull from remote:**
20
+ - Run `git pull --rebase origin <current-branch>`.
21
+ - If rebase conflicts occur, abort the rebase (`git rebase --abort`), try `git pull --no-rebase` instead, and report any merge conflicts for the user to resolve.
22
+
23
+ 3. **Check for outstanding work:**
24
+ - Check if `tasks/roadmap.md` exists for the full plan, and `tasks/todo.md` for the current phase.
25
+ - If `tasks/todo.md` exists, read it and look for unchecked items (`- [ ]`).
26
+ - If there are incomplete items, summarise: which phase is current, what the next step is, and how many steps/phases remain.
27
+ - If `tasks/manual-todo.md` exists, count unchecked manual tasks and include in the summary.
28
+ - If `tasks/record-todo.md` or `tasks/recurring-todo.md` exists, count unchecked advisory items and include those counts separately. Do not treat them as active plan steps.
29
+ - If all items are checked, report that the plan is complete.
30
+ - If neither file exists, note that there is no active plan.
31
+
32
+ 4. **Check provisioned agent config:**
33
+ - If `CLAUDE.md` or `AGENTS.md` contains `<!-- provision-agentic-config vX.Y -->`, extract the version.
34
+ - Read the canonical `provision-agentic-config` skill from the first existing path in this order:
35
+ 1. `~/.claude/skills/provision-agentic-config/SKILL.md`
36
+ 2. `~/.codex/skills/provision-agentic-config/SKILL.md`
37
+ 3. `base/claude/provision-agentic-config/SKILL.md` in the current repo, when present
38
+ 4. `base/codex/provision-agentic-config/SKILL.md` in the current repo, when present
39
+ - Extract the `version:` field from the canonical skill's YAML frontmatter.
40
+ - Extract the canonical provisioned blocks from the same skill:
41
+ - `CLAUDE.md`: the fenced block under `Required Claude Block` or the section that says "The Claude block to insert into `./CLAUDE.md`".
42
+ - `AGENTS.md`: the fenced block under `Required AGENTS Block` or the section that says "The AGENTS block to insert into `./AGENTS.md`".
43
+ - Compare each existing project file against its corresponding canonical block after normalizing line endings and trimming only leading/trailing whitespace around the block. Do not ignore changed bullets, headings, command examples, or policy text.
44
+ - If the installed skill version is newer than the provisioned version in either file, warn: `⚠ CLAUDE.md provisioned with vX.Y but provision-agentic-config is at vX.Y — consider re-running /provision-agentic-config`
45
+ - If the version comment is missing from `CLAUDE.md` or `AGENTS.md`, note: `ℹ No provision version found in CLAUDE.md/AGENTS.md — run /provision-agentic-config to add version tracking`
46
+ - If a project file has the current version comment but the provisioned block content differs from the canonical block, warn: `⚠ CLAUDE.md provisioned block differs from the canonical provision-agentic-config vX.Y block — re-run /provision-agentic-config`
47
+ - If a canonical block cannot be extracted, fall back to the version-only check and note: `ℹ Could not extract canonical provision-agentic-config block; checked version comment only`
48
+ - If none of the canonical skill files exists, skip this check silently.
49
+ - Always report the local canonical source path used and its `version:` field when this check runs.
50
+
51
+ 5. **Check skill-install drift (track-latest):**
52
+ - Project-local pack/skill installs under `.claude/skills` and `.codex/skills` are managed copies stamped with `.agentic-skills-managed`, which now records `source_version` and `source_sha`. When canonical sources in the `agentic-skills` checkout move ahead, the installed copies fall behind.
53
+ - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../base/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
54
+ - Run `scripts/pack.sh doctor` from the project root using that checkout (read-only; it never mutates installs).
55
+ - Fold any `stale` skills into the **Report status** block with the fix command `scripts/pack.sh refresh`. Report `unknown` skills as "run `scripts/pack.sh refresh` to enable drift tracking" and leave `pinned` skills noted as frozen.
56
+ - **Must not mutate.** Plain `/sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to `scripts/pack.sh refresh` (or enable auto-refresh) for the actual update.
57
+
58
+ 6. **Resolve GitHub freshness preference:**
59
+ - Use the user-local machine-wide preference file at `~/.agentic-skills/preferences.json`.
60
+ - Read `sync.github_freshness_check`, whose only allowed values are `"ask"`, `"always"`, and `"never"`.
61
+ - If the file or key is missing, ask the user once which default to remember:
62
+ - Always check GitHub during sync
63
+ - Never check GitHub during sync
64
+ - Ask each time
65
+ - Create `~/.agentic-skills/preferences.json` if needed and save the selected value as:
66
+ ```json
67
+ {
68
+ "sync": {
69
+ "github_freshness_check": "ask"
70
+ }
71
+ }
72
+ ```
73
+ - If the value is `"always"`, check GitHub remote freshness automatically.
74
+ - If the value is `"never"`, skip GitHub freshness checks and report that local canonical `provision-agentic-config` was used without a GitHub check.
75
+ - If the value is `"ask"`, ask before checking GitHub for this sync.
76
+ - Treat malformed JSON or an unsupported value as missing preference and ask again before writing one of the allowed values.
77
+
78
+ 7. **Optional GitHub freshness check:**
79
+ - Only run this check when the resolved preference or explicit user approval says to check GitHub.
80
+ - Compare the local `agentic-skills` checkout against `origin/HEAD` using non-mutating commands such as `git remote get-url origin`, `git rev-parse HEAD`, `git rev-parse origin/HEAD`, and, when remote freshness is explicitly enabled, `git fetch --dry-run` or an equivalent non-mutating freshness probe.
81
+ - Report the local checkout commit, remote URL, local `origin/HEAD` commit if available, and whether the local checkout appears behind the remote.
82
+ - Do not pull, fast-forward, rebase, install, or mutate the checkout from plain `/sync`.
83
+ - If a GitHub check shows the local checkout is stale, recommend `/init-agentic-skills update` for an explicit update.
84
+
85
+ 8. **Report status:**
86
+ - Branch name
87
+ - Commits pulled (if any) — show short log of new commits
88
+ - Whether stashed changes were re-applied
89
+ - Any conflicts that need manual resolution
90
+ - Current `git status`
91
+ - **Agent config drift** — provisioning version, local canonical source path/version, and canonical block match/drift status for `CLAUDE.md` and `AGENTS.md`, if checked
92
+ - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the `scripts/pack.sh refresh` fix command; report "all installs current" when none are stale, or skip the line when no managed installs exist
93
+ - **GitHub freshness** — preference value, whether GitHub was checked, and the local checkout/remote status; when skipped, say local canonical was used
94
+ - **Outstanding work** — summary from step 3 (next step, current phase, remaining work, pending manual tasks) or "No active plan"
95
+ - **Advisory tasks** — pending record/recurring counts, if those files exist
96
+
97
+ 9. **Post-sync actions:**
98
+
99
+ a) Check if `sync.md` exists at the project root.
100
+
101
+ b) **If `sync.md` exists** — parse and execute it:
102
+ - Read `sync.md` and identify sections by H2 headings.
103
+ - **Dependencies** (aliases: "Deps", "Dependency Management"):
104
+ Execute shell commands found in fenced code blocks (e.g., `npm install`). Report output briefly.
105
+ - **Conflict Resolution** (aliases: "Conflicts"):
106
+ If the pull introduced merge conflicts (from step 2), apply the guidance in this section. For example, if it says "accept theirs for lockfiles", run the appropriate `git checkout --theirs` command. If no conflicts exist, skip silently.
107
+ - **Custom** (aliases: "Project-Specific", "Scripts", "Setup"):
108
+ Execute shell commands found in fenced code blocks in order. Report output briefly.
109
+ - **Notifications** (aliases: "Awareness", "Alerts", "Watch"):
110
+ For each bullet point, check if the mentioned file or directory was modified in the pulled commits (use `git diff --name-only` against the pre-pull HEAD). If any match, print a prominent alert with the bullet's description.
111
+ - Sections with unrecognised headings: skip with a note ("Skipped unknown sync.md section: <heading>").
112
+ - Report a summary of all post-sync actions taken.
113
+
114
+ c) **If `sync.md` does not exist** — suggest creating one:
115
+ - Analyse the project to detect:
116
+ - Package manager (look for `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `Pipfile.lock`, `requirements.txt`, `go.sum`, `Cargo.lock`, `Gemfile.lock`, `composer.lock`)
117
+ - Common scripts (check `package.json` scripts, `Makefile`, `Justfile` for build/codegen/migrate targets)
118
+ - Config templates (`.env.example`, `docker-compose.yml`, `config/`)
119
+ - Present a suggested `sync.md` to the user with detected actions pre-filled, following the format in the **sync.md format** section below.
120
+ - Ask: "Would you like me to create this `sync.md`? You can customise it anytime."
121
+ - **Only create the file if the user approves.**
122
+
123
+ ## sync.md format
124
+
125
+ The `sync.md` file lives at the project root. It uses H2 sections as categories. Shell commands go in fenced code blocks; prose guidance goes in bullet points.
126
+
127
+ ```markdown
128
+ # Post-Sync Actions
129
+
130
+ ## Dependencies
131
+
132
+ Commands to run after pulling to keep local dependencies up to date.
133
+
134
+ ```sh
135
+ npm install
136
+ ```
137
+
138
+ ## Conflict Resolution
139
+
140
+ Project-specific guidance for handling merge conflicts.
141
+
142
+ - Always accept theirs for `package-lock.json` — regenerate via install command above
143
+ - For `generated/` files, regenerate with `npm run codegen` instead of resolving manually
144
+
145
+ ## Custom
146
+
147
+ Project-specific scripts or commands to run after sync.
148
+
149
+ ```sh
150
+ npm run codegen
151
+ ```
152
+
153
+ ## Notifications
154
+
155
+ Files and patterns to check for changes after a pull. Alert the user if any were modified.
156
+
157
+ - `.env.example` — check for new environment variables you may need to add to `.env`
158
+ - `CLAUDE.md` — review if project conventions were updated
159
+ - `config/` — warn about config schema changes
160
+ ```
161
+
162
+ ## Constraints
163
+ - Do not force-push or rewrite history.
164
+ - Do not auto-resolve merge conflicts — report them and let the user decide. However, if `sync.md` has a **Conflict Resolution** section, follow its guidance for the specific files/patterns it covers.
165
+ - If stash pop fails due to conflicts, leave the stash intact and report it.
166
+ - Post-sync commands from `sync.md` run in the project root directory.
167
+ - If any post-sync command fails, report the error and continue with remaining actions (do not abort).
168
+ - Never auto-create `sync.md` without explicit user approval.
169
+ - Do not execute commands from `sync.md` sections that are commented out with HTML comments (`<!-- ... -->`).
170
+ - Plain `/sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. Only `/init-agentic-skills update` / `/init-agentic-skills latest` may perform that explicit update flow after confirmation.
171
+
172
+
173
+ ## Default Shipping Contract
174
+
175
+ Follow the shared shipping contract convention in CLAUDE.md.
@@ -0,0 +1,175 @@
1
+ ---
2
+ name: sync
3
+ description: Pull latest changes from remote and report status
4
+ type: shipping
5
+ version: v0.5
6
+ argument-hint:
7
+ ---
8
+
9
+ # Sync
10
+
11
+ Pull the latest changes from the remote repository and report status.
12
+
13
+ ## Process
14
+
15
+ 1. **Check current state:**
16
+ - Run `git status` to check for uncommitted changes.
17
+ - If there are uncommitted changes, stash them first (`git stash`), pull, then pop the stash. Warn the user about the stash.
18
+
19
+ 2. **Pull from remote:**
20
+ - Run `git pull --rebase origin <current-branch>`.
21
+ - If rebase conflicts occur, abort the rebase (`git rebase --abort`), try `git pull --no-rebase` instead, and report any merge conflicts for the user to resolve.
22
+
23
+ 3. **Check for outstanding work:**
24
+ - Check if `tasks/roadmap.md` exists for the full plan, and `tasks/todo.md` for the current phase.
25
+ - If `tasks/todo.md` exists, read it and look for unchecked items (`- [ ]`).
26
+ - If there are incomplete items, summarise: which phase is current, what the next step is, and how many steps/phases remain.
27
+ - If `tasks/manual-todo.md` exists, count unchecked manual tasks and include in the summary.
28
+ - If `tasks/record-todo.md` or `tasks/recurring-todo.md` exists, count unchecked advisory items and include those counts separately. Do not treat them as active plan steps.
29
+ - If all items are checked, report that the plan is complete.
30
+ - If neither file exists, note that there is no active plan.
31
+
32
+ 4. **Check provisioned agent config:**
33
+ - If `CLAUDE.md` or `AGENTS.md` contains `<!-- provision-agentic-config vX.Y -->`, extract the version.
34
+ - Read the canonical `provision-agentic-config` skill from the first existing path in this order:
35
+ 1. `~/.claude/skills/provision-agentic-config/SKILL.md`
36
+ 2. `~/.codex/skills/provision-agentic-config/SKILL.md`
37
+ 3. `base/claude/provision-agentic-config/SKILL.md` in the current repo, when present
38
+ 4. `base/codex/provision-agentic-config/SKILL.md` in the current repo, when present
39
+ - Extract the `version:` field from the canonical skill's YAML frontmatter.
40
+ - Extract the canonical provisioned blocks from the same skill:
41
+ - `CLAUDE.md`: the fenced block under `Required Claude Block` or the section that says "The Claude block to insert into `./CLAUDE.md`".
42
+ - `AGENTS.md`: the fenced block under `Required AGENTS Block` or the section that says "The AGENTS block to insert into `./AGENTS.md`".
43
+ - Compare each existing project file against its corresponding canonical block after normalizing line endings and trimming only leading/trailing whitespace around the block. Do not ignore changed bullets, headings, command examples, or policy text.
44
+ - If the installed skill version is newer than the provisioned version in either file, warn: `⚠ CLAUDE.md provisioned with vX.Y but provision-agentic-config is at vX.Y — consider re-running /provision-agentic-config`
45
+ - If the version comment is missing from `CLAUDE.md` or `AGENTS.md`, note: `ℹ No provision version found in CLAUDE.md/AGENTS.md — run /provision-agentic-config to add version tracking`
46
+ - If a project file has the current version comment but the provisioned block content differs from the canonical block, warn: `⚠ CLAUDE.md provisioned block differs from the canonical provision-agentic-config vX.Y block — re-run /provision-agentic-config`
47
+ - If a canonical block cannot be extracted, fall back to the version-only check and note: `ℹ Could not extract canonical provision-agentic-config block; checked version comment only`
48
+ - If none of the canonical skill files exists, skip this check silently.
49
+ - Always report the local canonical source path used and its `version:` field when this check runs.
50
+
51
+ 5. **Check skill-install drift (track-latest):**
52
+ - Project-local pack/skill installs under `.claude/skills` and `.codex/skills` are managed copies stamped with `.agentic-skills-managed`, which now records `source_version` and `source_sha`. When canonical sources in the `agentic-skills` checkout move ahead, the installed copies fall behind.
53
+ - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../base/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
54
+ - Run `scripts/pack.sh doctor` from the project root using that checkout (read-only; it never mutates installs).
55
+ - Fold any `stale` skills into the **Report status** block and surface the exact refresh command the doctor itself reported (the context-aware dual hint). Prefer `npx skillpacks refresh` when the resolved managing source is the published npx `skillpacks` package (the marker `source=` path has no `.git`); use `scripts/pack.sh refresh` run from the resolved source-checkout root otherwise. Report `unknown` skills as "run the doctor-reported refresh command to enable drift tracking" with the same npx-vs-checkout choice, and leave `pinned` skills noted as frozen. Do not print a bare `scripts/pack.sh refresh`, which will not resolve from a non-checkout project directory.
56
+ - **Must not mutate.** Plain `/sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to the doctor-reported refresh command — `npx skillpacks refresh` for installs managed by the published npx package, or `scripts/pack.sh refresh` run from the source checkout (or enable auto-refresh) — for the actual update.
57
+
58
+ 6. **Resolve GitHub freshness preference:**
59
+ - Use the user-local machine-wide preference file at `~/.agentic-skills/preferences.json`.
60
+ - Read `sync.github_freshness_check`, whose only allowed values are `"ask"`, `"always"`, and `"never"`.
61
+ - If the file or key is missing, ask the user once which default to remember:
62
+ - Always check GitHub during sync
63
+ - Never check GitHub during sync
64
+ - Ask each time
65
+ - Create `~/.agentic-skills/preferences.json` if needed and save the selected value as:
66
+ ```json
67
+ {
68
+ "sync": {
69
+ "github_freshness_check": "ask"
70
+ }
71
+ }
72
+ ```
73
+ - If the value is `"always"`, check GitHub remote freshness automatically.
74
+ - If the value is `"never"`, skip GitHub freshness checks and report that local canonical `provision-agentic-config` was used without a GitHub check.
75
+ - If the value is `"ask"`, ask before checking GitHub for this sync.
76
+ - Treat malformed JSON or an unsupported value as missing preference and ask again before writing one of the allowed values.
77
+
78
+ 7. **Optional GitHub freshness check:**
79
+ - Only run this check when the resolved preference or explicit user approval says to check GitHub.
80
+ - Compare the local `agentic-skills` checkout against `origin/HEAD` using non-mutating commands such as `git remote get-url origin`, `git rev-parse HEAD`, `git rev-parse origin/HEAD`, and, when remote freshness is explicitly enabled, `git fetch --dry-run` or an equivalent non-mutating freshness probe.
81
+ - Report the local checkout commit, remote URL, local `origin/HEAD` commit if available, and whether the local checkout appears behind the remote.
82
+ - Do not pull, fast-forward, rebase, install, or mutate the checkout from plain `/sync`.
83
+ - If a GitHub check shows the local checkout is stale, recommend `/init-agentic-skills update` for an explicit update.
84
+
85
+ 8. **Report status:**
86
+ - Branch name
87
+ - Commits pulled (if any) — show short log of new commits
88
+ - Whether stashed changes were re-applied
89
+ - Any conflicts that need manual resolution
90
+ - Current `git status`
91
+ - **Agent config drift** — provisioning version, local canonical source path/version, and canonical block match/drift status for `CLAUDE.md` and `AGENTS.md`, if checked
92
+ - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the doctor-reported refresh command (`npx skillpacks refresh`, or `scripts/pack.sh refresh` from a source checkout); report "all installs current" when none are stale, or skip the line when no managed installs exist
93
+ - **GitHub freshness** — preference value, whether GitHub was checked, and the local checkout/remote status; when skipped, say local canonical was used
94
+ - **Outstanding work** — summary from step 3 (next step, current phase, remaining work, pending manual tasks) or "No active plan"
95
+ - **Advisory tasks** — pending record/recurring counts, if those files exist
96
+
97
+ 9. **Post-sync actions:**
98
+
99
+ a) Check if `sync.md` exists at the project root.
100
+
101
+ b) **If `sync.md` exists** — parse and execute it:
102
+ - Read `sync.md` and identify sections by H2 headings.
103
+ - **Dependencies** (aliases: "Deps", "Dependency Management"):
104
+ Execute shell commands found in fenced code blocks (e.g., `npm install`). Report output briefly.
105
+ - **Conflict Resolution** (aliases: "Conflicts"):
106
+ If the pull introduced merge conflicts (from step 2), apply the guidance in this section. For example, if it says "accept theirs for lockfiles", run the appropriate `git checkout --theirs` command. If no conflicts exist, skip silently.
107
+ - **Custom** (aliases: "Project-Specific", "Scripts", "Setup"):
108
+ Execute shell commands found in fenced code blocks in order. Report output briefly.
109
+ - **Notifications** (aliases: "Awareness", "Alerts", "Watch"):
110
+ For each bullet point, check if the mentioned file or directory was modified in the pulled commits (use `git diff --name-only` against the pre-pull HEAD). If any match, print a prominent alert with the bullet's description.
111
+ - Sections with unrecognised headings: skip with a note ("Skipped unknown sync.md section: <heading>").
112
+ - Report a summary of all post-sync actions taken.
113
+
114
+ c) **If `sync.md` does not exist** — suggest creating one:
115
+ - Analyse the project to detect:
116
+ - Package manager (look for `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `Pipfile.lock`, `requirements.txt`, `go.sum`, `Cargo.lock`, `Gemfile.lock`, `composer.lock`)
117
+ - Common scripts (check `package.json` scripts, `Makefile`, `Justfile` for build/codegen/migrate targets)
118
+ - Config templates (`.env.example`, `docker-compose.yml`, `config/`)
119
+ - Present a suggested `sync.md` to the user with detected actions pre-filled, following the format in the **sync.md format** section below.
120
+ - Ask: "Would you like me to create this `sync.md`? You can customise it anytime."
121
+ - **Only create the file if the user approves.**
122
+
123
+ ## sync.md format
124
+
125
+ The `sync.md` file lives at the project root. It uses H2 sections as categories. Shell commands go in fenced code blocks; prose guidance goes in bullet points.
126
+
127
+ ```markdown
128
+ # Post-Sync Actions
129
+
130
+ ## Dependencies
131
+
132
+ Commands to run after pulling to keep local dependencies up to date.
133
+
134
+ ```sh
135
+ npm install
136
+ ```
137
+
138
+ ## Conflict Resolution
139
+
140
+ Project-specific guidance for handling merge conflicts.
141
+
142
+ - Always accept theirs for `package-lock.json` — regenerate via install command above
143
+ - For `generated/` files, regenerate with `npm run codegen` instead of resolving manually
144
+
145
+ ## Custom
146
+
147
+ Project-specific scripts or commands to run after sync.
148
+
149
+ ```sh
150
+ npm run codegen
151
+ ```
152
+
153
+ ## Notifications
154
+
155
+ Files and patterns to check for changes after a pull. Alert the user if any were modified.
156
+
157
+ - `.env.example` — check for new environment variables you may need to add to `.env`
158
+ - `CLAUDE.md` — review if project conventions were updated
159
+ - `config/` — warn about config schema changes
160
+ ```
161
+
162
+ ## Constraints
163
+ - Do not force-push or rewrite history.
164
+ - Do not auto-resolve merge conflicts — report them and let the user decide. However, if `sync.md` has a **Conflict Resolution** section, follow its guidance for the specific files/patterns it covers.
165
+ - If stash pop fails due to conflicts, leave the stash intact and report it.
166
+ - Post-sync commands from `sync.md` run in the project root directory.
167
+ - If any post-sync command fails, report the error and continue with remaining actions (do not abort).
168
+ - Never auto-create `sync.md` without explicit user approval.
169
+ - Do not execute commands from `sync.md` sections that are commented out with HTML comments (`<!-- ... -->`).
170
+ - Plain `/sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. Only `/init-agentic-skills update` / `/init-agentic-skills latest` may perform that explicit update flow after confirmation.
171
+
172
+
173
+ ## Default Shipping Contract
174
+
175
+ Follow the shared shipping contract convention in CLAUDE.md.
@@ -1,5 +1,15 @@
1
1
  # sync Changelog
2
2
 
3
+ ## v0.6
4
+
5
+ - Provisioner lookup prefers project-local `.codex/skills` / `.claude/skills` (base skills now install project-local). Stale-checkout guidance points to an explicit checkout/package update followed by `npx skillpacks refresh` instead of the removed `$init-agentic-skills update` flow.
6
+
7
+ ## v0.5
8
+
9
+ - Fix skill-install drift fix routing: surface the doctor-reported context-aware refresh command instead of a bare `scripts/pack.sh refresh`, which fails to resolve from a non-checkout project directory
10
+ - Prefer `npx skillpacks refresh` for installs managed by the published npx `skillpacks` package; use `scripts/pack.sh refresh` only from a resolved source checkout
11
+ - Apply the same routing to `unknown`-install hints and the Report status drift line
12
+
3
13
  ## v0.4
4
14
 
5
15
  - Add warn-only skill-install drift check: run `scripts/pack.sh doctor` against the resolved `agentic-skills` checkout and report `stale`/`unknown` project skill installs with the `scripts/pack.sh refresh` fix
@@ -2,7 +2,7 @@
2
2
  name: sync
3
3
  description: Pull latest changes from remote and report status
4
4
  type: shipping
5
- version: v0.4
5
+ version: v0.6
6
6
  ---
7
7
 
8
8
  # Sync
@@ -29,11 +29,11 @@ Pull the latest changes from the remote repository and report status.
29
29
  - If neither file exists, note that there is no active plan.
30
30
  4. Check provisioned agent config:
31
31
  - If `CLAUDE.md` or `AGENTS.md` contains `<!-- provision-agentic-config vX.Y -->`, extract the version.
32
- - Read the canonical `provision-agentic-config` skill from the first existing path in this order:
33
- 1. `~/.codex/skills/provision-agentic-config/SKILL.md`
34
- 2. `~/.claude/skills/provision-agentic-config/SKILL.md`
35
- 3. `global/codex/provision-agentic-config/SKILL.md` in the current repo, when present
36
- 4. `global/claude/provision-agentic-config/SKILL.md` in the current repo, when present
32
+ - Read the canonical `provision-agentic-config` skill from the first existing path in this order (base skills install project-local, so the project roots come first):
33
+ 1. `.codex/skills/provision-agentic-config/SKILL.md`
34
+ 2. `.claude/skills/provision-agentic-config/SKILL.md`
35
+ 3. `base/codex/provision-agentic-config/SKILL.md` in the current repo, when present
36
+ 4. `base/claude/provision-agentic-config/SKILL.md` in the current repo, when present
37
37
  - Extract the `version:` field from the canonical skill's YAML frontmatter.
38
38
  - Extract the canonical provisioned blocks from the same skill:
39
39
  - `CLAUDE.md`: the fenced block under `Required Claude Block` or the section that says "The Claude block to insert into `./CLAUDE.md`".
@@ -47,10 +47,10 @@ Pull the latest changes from the remote repository and report status.
47
47
  - Always report the local canonical source path used and its `version:` field when this check runs.
48
48
  5. Check skill-install drift (track-latest):
49
49
  - Project-local pack/skill installs under `.claude/skills` and `.codex/skills` are managed copies stamped with `.agentic-skills-managed`, which now records `source_version` and `source_sha`. When canonical sources in the `agentic-skills` checkout move ahead, the installed copies fall behind.
50
- - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../global/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
50
+ - Resolve the `agentic-skills` checkout from any install marker's `source=` path (the parent above `.../packs/..` or `.../base/..` is the repo root). If no managed install exists or the checkout cannot be resolved, skip this check silently.
51
51
  - Run `scripts/pack.sh doctor` from the project root using that checkout (read-only; it never mutates installs).
52
- - Fold any `stale` skills into the Report status block with the fix command `scripts/pack.sh refresh`. Report `unknown` skills as "run `scripts/pack.sh refresh` to enable drift tracking" and leave `pinned` skills noted as frozen.
53
- - Must not mutate. Plain `$sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to `scripts/pack.sh refresh` (or enable auto-refresh) for the actual update.
52
+ - Fold any `stale` skills into the Report status block and surface the exact refresh command the doctor itself reported (the context-aware dual hint). Prefer `npx skillpacks refresh` when the resolved managing source is the published npx `skillpacks` package (the marker `source=` path has no `.git`); use `scripts/pack.sh refresh` run from the resolved source-checkout root otherwise. Report `unknown` skills as "run the doctor-reported refresh command to enable drift tracking" with the same npx-vs-checkout choice, and leave `pinned` skills noted as frozen. Do not print a bare `scripts/pack.sh refresh`, which will not resolve from a non-checkout project directory.
53
+ - Must not mutate. Plain `$sync` only warns; it never runs `refresh`, re-copies, or otherwise changes installs. Direct the user to the doctor-reported refresh command — `npx skillpacks refresh` for installs managed by the published npx package, or `scripts/pack.sh refresh` run from the source checkout (or enable auto-refresh) for the actual update.
54
54
  6. Resolve GitHub freshness preference:
55
55
  - Use the user-local machine-wide preference file at `~/.agentic-skills/preferences.json`.
56
56
  - Read `sync.github_freshness_check`, whose only allowed values are `"ask"`, `"always"`, and `"never"`.
@@ -75,7 +75,7 @@ Pull the latest changes from the remote repository and report status.
75
75
  - Compare the local `agentic-skills` checkout against `origin/HEAD` using non-mutating commands such as `git remote get-url origin`, `git rev-parse HEAD`, `git rev-parse origin/HEAD`, and, when remote freshness is explicitly enabled, `git fetch --dry-run` or an equivalent non-mutating freshness probe.
76
76
  - Report the local checkout commit, remote URL, local `origin/HEAD` commit if available, and whether the local checkout appears behind the remote.
77
77
  - Do not pull, fast-forward, rebase, install, or mutate the checkout from plain `$sync`.
78
- - If a GitHub check shows the local checkout is stale, recommend `$init-agentic-skills update` for an explicit update.
78
+ - If a GitHub check shows the local checkout is stale, recommend an explicit update — update the `agentic-skills` checkout (e.g. `git pull --ff-only`) or bump the `skillpacks` package, then run `npx skillpacks refresh` — without performing it from plain `$sync`.
79
79
  8. Report status:
80
80
  - Branch name
81
81
  - Commits pulled (if any) — show short log of new commits
@@ -83,7 +83,7 @@ Pull the latest changes from the remote repository and report status.
83
83
  - Any conflicts that need manual resolution
84
84
  - Current `git status`
85
85
  - **Agent config drift** — provisioning version, local canonical source path/version, and canonical block match/drift status for `CLAUDE.md` and `AGENTS.md`, if checked
86
- - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the `scripts/pack.sh refresh` fix command; report "all installs current" when none are stale, or skip the line when no managed installs exist
86
+ - **Skill-install drift** — any `stale` project skill installs (with `vOld → vNew`), `unknown` installs needing a refresh to enable tracking, and the doctor-reported refresh command (`npx skillpacks refresh`, or `scripts/pack.sh refresh` from a source checkout); report "all installs current" when none are stale, or skip the line when no managed installs exist
87
87
  - **GitHub freshness** — preference value, whether GitHub was checked, and the local checkout/remote status; when skipped, say local canonical was used
88
88
  - **Outstanding work** — summary from step 3 (next step, current phase, remaining work, pending manual tasks) or "No active plan"
89
89
  - **Advisory tasks** — pending record/recurring counts, if those files exist
@@ -141,7 +141,7 @@ npm run codegen
141
141
  - If any post-sync command fails, report the error and continue with remaining actions.
142
142
  - Never auto-create `sync.md` without explicit user approval.
143
143
  - Do not execute commented-out sections (`<!-- ... -->`).
144
- - Plain `$sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. Only `$init-agentic-skills update` / `$init-agentic-skills latest` may perform that explicit update flow after confirmation.
144
+ - Plain `$sync` must not update the `agentic-skills` checkout, pull from GitHub for the local canonical source, or reinstall skills. The explicit update flow is the user's own checkout/package update (e.g. `git pull --ff-only`) followed by `npx skillpacks refresh`, run only after confirmation.
145
145
 
146
146
 
147
147
  ## Default Shipping Contract