@litfamily/litcodex 1.0.39 → 1.0.40

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 (40) hide show
  1. package/README-Ko-KR.md +35 -13
  2. package/README.md +35 -13
  3. package/dist/cli.js +13 -0
  4. package/dist/install/extensions-notice.d.ts +13 -0
  5. package/dist/install/extensions-notice.js +26 -6
  6. package/dist/install/extensions.d.ts +74 -0
  7. package/dist/install/extensions.js +856 -0
  8. package/dist/install/generated-skill-payload-hashes.d.ts +8 -8
  9. package/dist/install/generated-skill-payload-hashes.js +8 -8
  10. package/dist/install/index.js +7 -1
  11. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  12. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  15. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-schematic.md +5 -3
  16. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-scientific-visualization.md +5 -3
  17. package/marketplace/plugins/litcodex/components/lit-loop/dist/route-heads.js +1 -2
  18. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  19. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  20. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  21. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  22. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  23. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  24. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/SKILL.md +6 -4
  25. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/SKILL.md +6 -4
  26. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +6 -4
  27. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +6 -4
  28. package/marketplace/plugins/litcodex/skills/lit-schematic/SKILL.md +6 -4
  29. package/marketplace/plugins/litcodex/skills/lit-scientific-visualization/SKILL.md +6 -4
  30. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/SKILL.md +6 -4
  31. package/marketplace/plugins/litcodex/skills/readme-studio/SKILL.md +6 -4
  32. package/marketplace/plugins/litcodex/skills/visual-qa/SKILL.md +6 -4
  33. package/node_modules/@litcodex/lit-loop/directives/lit-schematic.md +5 -3
  34. package/node_modules/@litcodex/lit-loop/directives/lit-scientific-visualization.md +5 -3
  35. package/node_modules/@litcodex/lit-loop/dist/route-heads.js +1 -2
  36. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  37. package/node_modules/@litcodex/lit-loop/skills/lit-schematic/SKILL.md +6 -4
  38. package/node_modules/@litcodex/lit-loop/skills/lit-scientific-visualization/SKILL.md +6 -4
  39. package/package.json +2 -2
  40. package/readme-assets/badge-version.svg +1 -1
@@ -9,7 +9,7 @@ export declare const BROWSER_DRIVE_PAYLOAD_HASHES: {
9
9
  readonly "scripts/capability-probe.mjs": "086a19a5df2d1a5887d2df0c130eb4baf228ac00429248e90775f289e181e633";
10
10
  };
11
11
  export declare const FRONTEND_UIUX_PAYLOAD_HASHES: {
12
- readonly "SKILL.md": "87df0e44ec4a9da49df67aba2501fe4aac047d3ec6770850feb0bf41cac2b760";
12
+ readonly "SKILL.md": "1216f545edeeff4202eef872f5d92c852f7a9a056599d7be84e150c506915378";
13
13
  };
14
14
  export declare const HUMANIZER_PAYLOAD_HASHES: {
15
15
  readonly NOTICE: "f1587efda830c594a727d651da82265c565e178a4665eb7327c0c07f516673f0";
@@ -82,10 +82,10 @@ export declare const HUMANIZER_PAYLOAD_HASHES: {
82
82
  readonly "scripts/test-ko-metrics.mjs": "75e1e23486f3beca247922a8c37564670c043eb29b22148a71e1ce2b67374b28";
83
83
  };
84
84
  export declare const README_STUDIO_PAYLOAD_HASHES: {
85
- readonly "SKILL.md": "9f4851534d9d948228ec0a47f5a5c95f4c541fdf3ce25b520089954d5d25a2bb";
85
+ readonly "SKILL.md": "da31c724c7c70bc84a2ad414899f781e3d1d4395214432e381dca61e638a194e";
86
86
  };
87
87
  export declare const VISUAL_QA_PAYLOAD_HASHES: {
88
- readonly "SKILL.md": "59eccd59181876928c26e9ccba556fc0ee0c275830e6bfa2f2d7dc1acad8be66";
88
+ readonly "SKILL.md": "5c34fbc7174f4f9b9bda63ba75449b7f909770dcb1f3553aaa6e80c6e4d642ae";
89
89
  };
90
90
  export declare const STRUCTURAL_SEARCH_PAYLOAD_HASHES: {
91
91
  readonly "SKILL.md": "7f36bba0ccb78bacc803e08a30c127926ce56b249b1938e4d1c186c9d1478aa0";
@@ -100,19 +100,19 @@ export declare const CODING_SESSION_AUDIT_PAYLOAD_HASHES: {
100
100
  readonly "references/session-formats.md": "5c35e9148db2eac84c240702382c31e7e9ff875b9f5036f45b642a209335fbd8";
101
101
  };
102
102
  export declare const DIAGRAM_DRAWER_PAYLOAD_HASHES: {
103
- readonly "SKILL.md": "e92a084a8c3bf8ef28b3cbb365340109fb59ff22c2847c8e90946ae3a7cce172";
103
+ readonly "SKILL.md": "3cf29db5e8e12753671ff8ebca7fe7cec68d73d72c02b7362641fe1cc7020ec8";
104
104
  readonly "agents/openai.yaml": "705f4a2078a9ac0a357218b762c9baee9731663ca86111ecb55d7d3528b379cf";
105
105
  };
106
106
  export declare const DOCX_PAYLOAD_HASHES: {
107
- readonly "SKILL.md": "b286a827a45a3ed56f5ae1944f0b7af32e0239fcc21ace605c74f3abe3447a0f";
107
+ readonly "SKILL.md": "e98b3248dc429e92b50bd1acda3e825147e24e00cc2f574a90c893f9bfbffaad";
108
108
  readonly "agents/openai.yaml": "a8a0c0dc807f992075d73123dbe14124d45c9f13d7dcce1ab5403723f222f68c";
109
109
  };
110
110
  export declare const PPTX_PAYLOAD_HASHES: {
111
- readonly "SKILL.md": "fe1a108e94758de788fd20c22136585bc77f88d6faeeeb1bc928a06c0ae906d7";
111
+ readonly "SKILL.md": "8f6032634ee8597bddc56b82f30df7d1365ec626cd852851b21cc5d98dbf7b6c";
112
112
  readonly "agents/openai.yaml": "2d07a60a4742faaac628338b82dc2b185f1813018cbf1c2b974909cf20266618";
113
113
  };
114
114
  export declare const SCHEMATIC_PAYLOAD_HASHES: {
115
- readonly "SKILL.md": "647d99828dcc13cc10ee3e60df8f6e2889e3aa4d12a6d085a71b0b96b0781a32";
115
+ readonly "SKILL.md": "4b7ec8b14a27b02f622cabe350224be630d5f366b8aa62e0bd61f21363f8e42d";
116
116
  readonly "agents/openai.yaml": "60743b930cf6728cd261fe0b09c218e5981b315c94065bb3179702b0e531d305";
117
117
  };
118
118
  export declare const HIJACK_PAYLOAD_HASHES: {
@@ -126,7 +126,7 @@ export declare const HIJACK_PAYLOAD_HASHES: {
126
126
  readonly "scripts/hijack.mjs": "8a802d795900ca0471e93549863386c3da1d465ede19bbb056eb0fe2dd0eeb27";
127
127
  };
128
128
  export declare const MOTION_PAYLOAD_HASHES: {
129
- readonly "SKILL.md": "f288455485ec6a326f0411c0f56234a30051e27660ceb2fd392ab6b3d97f32d5";
129
+ readonly "SKILL.md": "d1e882c49a56b10ab0d111fbcc9daeeeb8087697e1b682dc2548df021a89e86b";
130
130
  readonly "agents/openai.yaml": "903236ce200da815aff7affb3cc78c8f9b821bb4d8e56cca9d4464c20999e7f0";
131
131
  };
132
132
  export declare const AUTORESEARCH_PAYLOAD_HASHES: {
@@ -10,7 +10,7 @@ export const BROWSER_DRIVE_PAYLOAD_HASHES = {
10
10
  "scripts/capability-probe.mjs": "086a19a5df2d1a5887d2df0c130eb4baf228ac00429248e90775f289e181e633",
11
11
  };
12
12
  export const FRONTEND_UIUX_PAYLOAD_HASHES = {
13
- "SKILL.md": "87df0e44ec4a9da49df67aba2501fe4aac047d3ec6770850feb0bf41cac2b760",
13
+ "SKILL.md": "1216f545edeeff4202eef872f5d92c852f7a9a056599d7be84e150c506915378",
14
14
  };
15
15
  export const HUMANIZER_PAYLOAD_HASHES = {
16
16
  NOTICE: "f1587efda830c594a727d651da82265c565e178a4665eb7327c0c07f516673f0",
@@ -83,10 +83,10 @@ export const HUMANIZER_PAYLOAD_HASHES = {
83
83
  "scripts/test-ko-metrics.mjs": "75e1e23486f3beca247922a8c37564670c043eb29b22148a71e1ce2b67374b28",
84
84
  };
85
85
  export const README_STUDIO_PAYLOAD_HASHES = {
86
- "SKILL.md": "9f4851534d9d948228ec0a47f5a5c95f4c541fdf3ce25b520089954d5d25a2bb",
86
+ "SKILL.md": "da31c724c7c70bc84a2ad414899f781e3d1d4395214432e381dca61e638a194e",
87
87
  };
88
88
  export const VISUAL_QA_PAYLOAD_HASHES = {
89
- "SKILL.md": "59eccd59181876928c26e9ccba556fc0ee0c275830e6bfa2f2d7dc1acad8be66",
89
+ "SKILL.md": "5c34fbc7174f4f9b9bda63ba75449b7f909770dcb1f3553aaa6e80c6e4d642ae",
90
90
  };
91
91
  export const STRUCTURAL_SEARCH_PAYLOAD_HASHES = {
92
92
  "SKILL.md": "7f36bba0ccb78bacc803e08a30c127926ce56b249b1938e4d1c186c9d1478aa0",
@@ -101,19 +101,19 @@ export const CODING_SESSION_AUDIT_PAYLOAD_HASHES = {
101
101
  "references/session-formats.md": "5c35e9148db2eac84c240702382c31e7e9ff875b9f5036f45b642a209335fbd8",
102
102
  };
103
103
  export const DIAGRAM_DRAWER_PAYLOAD_HASHES = {
104
- "SKILL.md": "e92a084a8c3bf8ef28b3cbb365340109fb59ff22c2847c8e90946ae3a7cce172",
104
+ "SKILL.md": "3cf29db5e8e12753671ff8ebca7fe7cec68d73d72c02b7362641fe1cc7020ec8",
105
105
  "agents/openai.yaml": "705f4a2078a9ac0a357218b762c9baee9731663ca86111ecb55d7d3528b379cf",
106
106
  };
107
107
  export const DOCX_PAYLOAD_HASHES = {
108
- "SKILL.md": "b286a827a45a3ed56f5ae1944f0b7af32e0239fcc21ace605c74f3abe3447a0f",
108
+ "SKILL.md": "e98b3248dc429e92b50bd1acda3e825147e24e00cc2f574a90c893f9bfbffaad",
109
109
  "agents/openai.yaml": "a8a0c0dc807f992075d73123dbe14124d45c9f13d7dcce1ab5403723f222f68c",
110
110
  };
111
111
  export const PPTX_PAYLOAD_HASHES = {
112
- "SKILL.md": "fe1a108e94758de788fd20c22136585bc77f88d6faeeeb1bc928a06c0ae906d7",
112
+ "SKILL.md": "8f6032634ee8597bddc56b82f30df7d1365ec626cd852851b21cc5d98dbf7b6c",
113
113
  "agents/openai.yaml": "2d07a60a4742faaac628338b82dc2b185f1813018cbf1c2b974909cf20266618",
114
114
  };
115
115
  export const SCHEMATIC_PAYLOAD_HASHES = {
116
- "SKILL.md": "647d99828dcc13cc10ee3e60df8f6e2889e3aa4d12a6d085a71b0b96b0781a32",
116
+ "SKILL.md": "4b7ec8b14a27b02f622cabe350224be630d5f366b8aa62e0bd61f21363f8e42d",
117
117
  "agents/openai.yaml": "60743b930cf6728cd261fe0b09c218e5981b315c94065bb3179702b0e531d305",
118
118
  };
119
119
  export const HIJACK_PAYLOAD_HASHES = {
@@ -127,7 +127,7 @@ export const HIJACK_PAYLOAD_HASHES = {
127
127
  "scripts/hijack.mjs": "8a802d795900ca0471e93549863386c3da1d465ede19bbb056eb0fe2dd0eeb27",
128
128
  };
129
129
  export const MOTION_PAYLOAD_HASHES = {
130
- "SKILL.md": "f288455485ec6a326f0411c0f56234a30051e27660ceb2fd392ab6b3d97f32d5",
130
+ "SKILL.md": "d1e882c49a56b10ab0d111fbcc9daeeeb8087697e1b682dc2548df021a89e86b",
131
131
  "agents/openai.yaml": "903236ce200da815aff7affb3cc78c8f9b821bb4d8e56cca9d4464c20999e7f0",
132
132
  };
133
133
  export const AUTORESEARCH_PAYLOAD_HASHES = {
@@ -17,6 +17,7 @@ import { codexSpawnInvocation, resolveCodexHome } from "./codex.js";
17
17
  import { doctorScopeFor, renderDoctorText, runDoctor } from "./doctor.js";
18
18
  import { exitCodeForInstallError, InstallError, toErrorJson } from "./errors.js";
19
19
  import { executeInstallPlan } from "./execute.js";
20
+ import { extensionsDoctorLine, extensionsNoticeLine } from "./extensions.js";
20
21
  import { announceExtensions } from "./extensions-notice.js";
21
22
  import { listPayloadEntries, readRegularFileBuffer } from "./file-walk.js";
22
23
  import { promptModelRoute, renderModelRouteSummary, waitForModelRouteConfirmation } from "./install-model-prompt.js";
@@ -398,6 +399,7 @@ export async function runInstallCli(args, io = defaultIo()) {
398
399
  env: io.env,
399
400
  json: opts.json,
400
401
  write: (text) => io.stdout.write(text),
402
+ ...checkLineFor(io),
401
403
  });
402
404
  }
403
405
  return result.ok ? 0 : 3;
@@ -418,9 +420,13 @@ export function runDoctorCli(args, io = defaultIo()) {
418
420
  if (json)
419
421
  io.stdout.write(`${JSON.stringify(report)}\n`);
420
422
  else
421
- io.stdout.write(`${renderDoctorText(report)}\n`);
423
+ io.stdout.write(`${renderDoctorText(report)}\n${extensionsDoctorLine({ env: io.env, cwd: io.repoRoot })}\n`);
422
424
  return report.ok ? 0 : 4;
423
425
  }
426
+ function checkLineFor(io) {
427
+ const checkLine = extensionsNoticeLine({ env: io.env, cwd: io.repoRoot });
428
+ return checkLine === undefined ? {} : { checkLine };
429
+ }
424
430
  /** Shared text for a `--dry-run` of a state-changing route: the title, then numbered steps. */
425
431
  export function renderDryRunPlan(title, steps) {
426
432
  return `${title} plan (dry run: nothing was changed)\n${steps.map((step, index) => `${index + 1}. ${step}`).join("\n")}\n`;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litcodex",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "author": {
5
5
  "name": "LitCodex Authors"
6
6
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/auto-update",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex foreground update barrier for the SessionStart and management lifecycles.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/comment-checker",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex Comment-Checker hook: flags low-value / AI-slop comments introduced by edits.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/git-bash",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex Git-Bash hook: reminds Windows sessions to prefer the git_bash MCP before the built-in shell.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -65,11 +65,13 @@ This directive is an LLM-facing contract injected by the LitCodex Codex plugin,
65
65
 
66
66
  ```bash
67
67
  git clone https://github.com/wjgoarxiv/wjgoarxiv-skills
68
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
69
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "${CODEX_HOME:-$HOME/.codex}/skills/lit-schematic"
68
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-schematic" ] && echo "found: $d/lit-schematic"; done; echo "check done"
69
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-schematic" ] && mv "$cx/skills/lit-schematic" "$b/lit-schematic" && echo "moved aside: $b/lit-schematic"; fi
70
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then echo "stopped: $cx/skills/lit-schematic still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$cx/skills/lit-schematic"; fi
71
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-schematic/SKILL.md" ] && printf '{"id":"lit-schematic","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-schematic/.litfamily-extension.json"
70
72
  ```
71
73
 
72
- wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). After copying, the user starts a new Codex session.
74
+ wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). The lines check for same-name skills, move an old copy whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-schematic` and write a receipt; running them again updates. `litcodex extensions install lit-schematic` does the same steps (a plan first, `--yes` to run). After copying, the user starts a new Codex session.
73
75
 
74
76
  ## #contract.outputs
75
77
 
@@ -51,11 +51,13 @@ This directive is an LLM-facing contract injected by the LitCodex Codex plugin,
51
51
 
52
52
  ```bash
53
53
  git clone https://github.com/wjgoarxiv/wjgoarxiv-skills
54
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
55
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "${CODEX_HOME:-$HOME/.codex}/skills/lit-scientific-visualization"
54
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-scientific-visualization" ] && echo "found: $d/lit-scientific-visualization"; done; echo "check done"
55
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-scientific-visualization" ] && mv "$cx/skills/lit-scientific-visualization" "$b/lit-scientific-visualization" && echo "moved aside: $b/lit-scientific-visualization"; fi
56
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then echo "stopped: $cx/skills/lit-scientific-visualization still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$cx/skills/lit-scientific-visualization"; fi
57
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-scientific-visualization/SKILL.md" ] && printf '{"id":"lit-scientific-visualization","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-scientific-visualization/.litfamily-extension.json"
56
58
  ```
57
59
 
58
- wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). After copying, the user starts a new Codex session.
60
+ wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). The lines check for same-name skills, move an old copy whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-scientific-visualization` and write a receipt; running them again updates. `litcodex extensions install lit-scientific-visualization` does the same steps (a plan first, `--yes` to run). After copying, the user starts a new Codex session.
59
61
  4. The authored scientific-visualization source ships inside that one folder (`vendor/scientific-visualization/`), so no second copy is needed. The scoped `$litcodex:lit-scientific-visualization` and the picker stay native Codex skill-discovery routes to the stub.
60
62
 
61
63
  ## #contract.outputs
@@ -216,8 +216,7 @@ const LIT_SCHEMATIC = [
216
216
  BLOCKED,
217
217
  "",
218
218
  "1. Read the stub {skill:lit-schematic}. When the session's skill list has a separate `lit-schematic` copy (normally under `$CODEX_HOME/skills/`, where `$CODEX_HOME` defaults to `~/.codex`), open that file and let it handle the request.",
219
- "2. Otherwise say what lit-schematic makes, that it is a LitFamily extension in wjgoarxiv-skills, and give the stub's install lines unchanged, for example:",
220
- ' `cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$CODEX_HOME/skills/lit-schematic"`, then a new Codex session.',
219
+ "2. Otherwise say what lit-schematic makes, that it is a LitFamily extension in wjgoarxiv-skills, and give the stub's four install lines unchanged: a check for same-name skills, a move-aside of an old copy into `$CODEX_HOME/extension-backups/`, the copy from `<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic`, and a receipt (or `litcodex extensions install lit-schematic --yes`); then a new Codex session.",
221
220
  "3. Draw nothing by hand and do not imitate the moved procedure. Stop after the notice.",
222
221
  ];
223
222
  const LIT_HIJACK = [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lsp",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex LSP hook (inert placeholder): post-edit diagnostics + cache reset, no-op until an LSP daemon is provided.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/rules",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex rules: injects project rule files (AGENTS.md etc.) into model context through lifecycle hooks.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/start-work-continuation",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex Start-Work continuation hook: resumes in-flight start-work state on root Stop.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/telemetry",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "LitCodex telemetry: a deliberately inert, local-only SessionStart hook (NO network, NO data collection).",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/wikify-knowledge",
3
- "version": "1.0.39",
3
+ "version": "1.0.40",
4
4
  "description": "Local review-gated knowledge records for the LitCodex Wikify surface.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install frontend-ui-ux` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/frontend-ui-ux" "${CODEX_HOME:-$HOME/.codex}/skills/frontend-ui-ux"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/frontend-ui-ux" ] && echo "found: $d/frontend-ui-ux"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/frontend-ui-ux" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/frontend-ui-ux" ] && mv "$cx/skills/frontend-ui-ux" "$b/frontend-ui-ux" && echo "moved aside: $b/frontend-ui-ux"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/frontend-ui-ux" ]; then echo "stopped: $cx/skills/frontend-ui-ux still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/frontend-ui-ux" "$cx/skills/frontend-ui-ux"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/frontend-ui-ux/SKILL.md" ] && printf '{"id":"frontend-ui-ux","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/frontend-ui-ux" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/frontend-ui-ux/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `frontend-ui-ux` beside this stub (`litcodex:frontend-ui-ux`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/frontend-ui-ux`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/frontend-ui-ux`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `frontend-ui-ux` beside this stub (`litcodex:frontend-ui-ux`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-diagram-drawer` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-diagram-drawer" "${CODEX_HOME:-$HOME/.codex}/skills/lit-diagram-drawer"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-diagram-drawer" ] && echo "found: $d/lit-diagram-drawer"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-diagram-drawer" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-diagram-drawer" ] && mv "$cx/skills/lit-diagram-drawer" "$b/lit-diagram-drawer" && echo "moved aside: $b/lit-diagram-drawer"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-diagram-drawer" ]; then echo "stopped: $cx/skills/lit-diagram-drawer still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-diagram-drawer" "$cx/skills/lit-diagram-drawer"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-diagram-drawer/SKILL.md" ] && printf '{"id":"lit-diagram-drawer","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-diagram-drawer" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-diagram-drawer/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-diagram-drawer` beside this stub (`litcodex:lit-diagram-drawer`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-diagram-drawer`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-diagram-drawer`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-diagram-drawer` beside this stub (`litcodex:lit-diagram-drawer`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-docx` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-docx" "${CODEX_HOME:-$HOME/.codex}/skills/lit-docx"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-docx" ] && echo "found: $d/lit-docx"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-docx" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-docx" ] && mv "$cx/skills/lit-docx" "$b/lit-docx" && echo "moved aside: $b/lit-docx"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-docx" ]; then echo "stopped: $cx/skills/lit-docx still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-docx" "$cx/skills/lit-docx"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-docx/SKILL.md" ] && printf '{"id":"lit-docx","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-docx" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-docx/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-docx` beside this stub (`litcodex:lit-docx`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-docx`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-docx`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-docx` beside this stub (`litcodex:lit-docx`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-pptx` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-pptx" "${CODEX_HOME:-$HOME/.codex}/skills/lit-pptx"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-pptx" ] && echo "found: $d/lit-pptx"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-pptx" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-pptx" ] && mv "$cx/skills/lit-pptx" "$b/lit-pptx" && echo "moved aside: $b/lit-pptx"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-pptx" ]; then echo "stopped: $cx/skills/lit-pptx still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-pptx" "$cx/skills/lit-pptx"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-pptx/SKILL.md" ] && printf '{"id":"lit-pptx","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-pptx" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-pptx/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-pptx` beside this stub (`litcodex:lit-pptx`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-pptx`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-pptx`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-pptx` beside this stub (`litcodex:lit-pptx`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-schematic` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "${CODEX_HOME:-$HOME/.codex}/skills/lit-schematic"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-schematic" ] && echo "found: $d/lit-schematic"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-schematic" ] && mv "$cx/skills/lit-schematic" "$b/lit-schematic" && echo "moved aside: $b/lit-schematic"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then echo "stopped: $cx/skills/lit-schematic still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$cx/skills/lit-schematic"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-schematic/SKILL.md" ] && printf '{"id":"lit-schematic","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-schematic/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-schematic` beside this stub (`litcodex:lit-schematic`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-schematic`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-schematic`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-schematic` beside this stub (`litcodex:lit-schematic`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-scientific-visualization` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "${CODEX_HOME:-$HOME/.codex}/skills/lit-scientific-visualization"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-scientific-visualization" ] && echo "found: $d/lit-scientific-visualization"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-scientific-visualization" ] && mv "$cx/skills/lit-scientific-visualization" "$b/lit-scientific-visualization" && echo "moved aside: $b/lit-scientific-visualization"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then echo "stopped: $cx/skills/lit-scientific-visualization still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$cx/skills/lit-scientific-visualization"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-scientific-visualization/SKILL.md" ] && printf '{"id":"lit-scientific-visualization","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-scientific-visualization/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-scientific-visualization` beside this stub (`litcodex:lit-scientific-visualization`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-scientific-visualization`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-scientific-visualization`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-scientific-visualization` beside this stub (`litcodex:lit-scientific-visualization`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install lit-typographic-motion` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-typographic-motion" "${CODEX_HOME:-$HOME/.codex}/skills/lit-typographic-motion"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-typographic-motion" ] && echo "found: $d/lit-typographic-motion"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-typographic-motion" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-typographic-motion" ] && mv "$cx/skills/lit-typographic-motion" "$b/lit-typographic-motion" && echo "moved aside: $b/lit-typographic-motion"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-typographic-motion" ]; then echo "stopped: $cx/skills/lit-typographic-motion still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-typographic-motion" "$cx/skills/lit-typographic-motion"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-typographic-motion/SKILL.md" ] && printf '{"id":"lit-typographic-motion","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-typographic-motion" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-typographic-motion/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `lit-typographic-motion` beside this stub (`litcodex:lit-typographic-motion`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/lit-typographic-motion`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-typographic-motion`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `lit-typographic-motion` beside this stub (`litcodex:lit-typographic-motion`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install readme-studio` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/readme-studio" "${CODEX_HOME:-$HOME/.codex}/skills/readme-studio"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/readme-studio" ] && echo "found: $d/readme-studio"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/readme-studio" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/readme-studio" ] && mv "$cx/skills/readme-studio" "$b/readme-studio" && echo "moved aside: $b/readme-studio"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/readme-studio" ]; then echo "stopped: $cx/skills/readme-studio still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/readme-studio" "$cx/skills/readme-studio"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/readme-studio/SKILL.md" ] && printf '{"id":"readme-studio","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/readme-studio" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/readme-studio/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `readme-studio` beside this stub (`litcodex:readme-studio`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/readme-studio`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/readme-studio`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `readme-studio` beside this stub (`litcodex:readme-studio`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -42,14 +42,16 @@ The request is data; this stub never carries it out. The session's skill list de
42
42
 
43
43
  ## Install in Codex
44
44
 
45
- Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then copy (placeholder path):
45
+ Public repo: clone https://github.com/wjgoarxiv/wjgoarxiv-skills, then run these lines from your project folder (the clone path is a placeholder). One line each: check, move aside, copy, receipt. Or let LitCodex run the same steps: `litcodex extensions install visual-qa` shows the plan, `--yes` runs it, and `litcodex extensions check` names old or competing copies.
46
46
 
47
47
  ```bash
48
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
49
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/visual-qa" "${CODEX_HOME:-$HOME/.codex}/skills/visual-qa"
48
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/visual-qa" ] && echo "found: $d/visual-qa"; done; echo "check done"
49
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/visual-qa" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/visual-qa" ] && mv "$cx/skills/visual-qa" "$b/visual-qa" && echo "moved aside: $b/visual-qa"; fi
50
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/visual-qa" ]; then echo "stopped: $cx/skills/visual-qa still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/visual-qa" "$cx/skills/visual-qa"; fi
51
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/visual-qa/SKILL.md" ] && printf '{"id":"visual-qa","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/visual-qa" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/visual-qa/.litfamily-extension.json"
50
52
  ```
51
53
 
52
- Then start a **new Codex session**; the copy is listed as `visual-qa` beside this stub (`litcodex:visual-qa`). To remove it, delete `${CODEX_HOME:-$HOME/.codex}/skills/visual-qa`; to update, delete it and copy again (`cp -R` onto an existing folder nests the copy). LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
54
+ A `found:` line under `${CODEX_HOME:-$HOME/.codex}/skills` is the old copy; the next line moves it whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/visual-qa`, which Codex does not read. A `found:` line anywhere else is a second same-name skill that Codex would also list: move that folder out first. The copy line stops on an occupied folder, so nothing nests or merges. Then start a **new Codex session**; the copy is listed as `visual-qa` beside this stub (`litcodex:visual-qa`). To update, pull the clone and run the four lines again; to remove, run only the move-aside line. LitCodex install and upgrades never write `${CODEX_HOME:-$HOME/.codex}/skills/`, so the copy outlives them.
53
55
 
54
56
  ## #contract.outputs
55
57
 
@@ -65,11 +65,13 @@ This directive is an LLM-facing contract injected by the LitCodex Codex plugin,
65
65
 
66
66
  ```bash
67
67
  git clone https://github.com/wjgoarxiv/wjgoarxiv-skills
68
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
69
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "${CODEX_HOME:-$HOME/.codex}/skills/lit-schematic"
68
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-schematic" ] && echo "found: $d/lit-schematic"; done; echo "check done"
69
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-schematic" ] && mv "$cx/skills/lit-schematic" "$b/lit-schematic" && echo "moved aside: $b/lit-schematic"; fi
70
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-schematic" ]; then echo "stopped: $cx/skills/lit-schematic still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$cx/skills/lit-schematic"; fi
71
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-schematic/SKILL.md" ] && printf '{"id":"lit-schematic","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-schematic" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-schematic/.litfamily-extension.json"
70
72
  ```
71
73
 
72
- wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). After copying, the user starts a new Codex session.
74
+ wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). The lines check for same-name skills, move an old copy whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-schematic` and write a receipt; running them again updates. `litcodex extensions install lit-schematic` does the same steps (a plan first, `--yes` to run). After copying, the user starts a new Codex session.
73
75
 
74
76
  ## #contract.outputs
75
77
 
@@ -51,11 +51,13 @@ This directive is an LLM-facing contract injected by the LitCodex Codex plugin,
51
51
 
52
52
  ```bash
53
53
  git clone https://github.com/wjgoarxiv/wjgoarxiv-skills
54
- mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
55
- cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "${CODEX_HOME:-$HOME/.codex}/skills/lit-scientific-visualization"
54
+ cx="${CODEX_HOME:-$HOME/.codex}"; p="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"; for d in "$cx/skills" "$HOME/.agents/skills" "$p/.agents/skills" "$p/.codex/skills"; do [ -e "$d/lit-scientific-visualization" ] && echo "found: $d/lit-scientific-visualization"; done; echo "check done"
55
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then b="$cx/extension-backups/$(date +%Y%m%d-%H%M%S)"; mkdir -p "$b" && [ ! -e "$b/lit-scientific-visualization" ] && mv "$cx/skills/lit-scientific-visualization" "$b/lit-scientific-visualization" && echo "moved aside: $b/lit-scientific-visualization"; fi
56
+ cx="${CODEX_HOME:-$HOME/.codex}"; if [ -e "$cx/skills/lit-scientific-visualization" ]; then echo "stopped: $cx/skills/lit-scientific-visualization still exists"; else mkdir -p "$cx/skills" && cp -R "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$cx/skills/lit-scientific-visualization"; fi
57
+ cx="${CODEX_HOME:-$HOME/.codex}"; [ -f "$cx/skills/lit-scientific-visualization/SKILL.md" ] && printf '{"id":"lit-scientific-visualization","source":"%s","variant":"litcodex","installed_at":"%s"}\n' "<path to your wjgoarxiv-skills clone>/variants/litcodex/lit-scientific-visualization" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$cx/skills/lit-scientific-visualization/.litfamily-extension.json"
56
58
  ```
57
59
 
58
- wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). After copying, the user starts a new Codex session.
60
+ wjgoarxiv-skills is public at https://github.com/wjgoarxiv/wjgoarxiv-skills; the copy reads from the user's clone of it (the path is a placeholder). The lines check for same-name skills, move an old copy whole to `${CODEX_HOME:-$HOME/.codex}/extension-backups/<date-time>/lit-scientific-visualization` and write a receipt; running them again updates. `litcodex extensions install lit-scientific-visualization` does the same steps (a plan first, `--yes` to run). After copying, the user starts a new Codex session.
59
61
  4. The authored scientific-visualization source ships inside that one folder (`vendor/scientific-visualization/`), so no second copy is needed. The scoped `$litcodex:lit-scientific-visualization` and the picker stay native Codex skill-discovery routes to the stub.
60
62
 
61
63
  ## #contract.outputs