thachvd-kit 1.0.18 → 1.0.19

package/bin/cli.js

@@ -140,8 +140,8 @@ ${pc.bold('What gets generated:')}
   CLAUDE.md   Claude Code entry file that imports AGENTS.md
   GEMINI.md   Antigravity entry file that points to AGENTS.md
   .agent/     Shared docs, skills, workflows, agents, and rules
-  .agents/skills/  Selected Codex repo skills copied from .agent/skills
-  .claude/skills/  Selected Claude Code project skills copied from .agent/skills
+  ~/.codex/skills/  Selected Codex skills copied to global user dir (shows in $ menu)
+  .claude/skills/   Selected Claude Code project skills copied from .agent/skills
 
 ${pc.bold('Workflow guide:')}
   Idea is fuzzy            /brainstorm  Explore options, tradeoffs, and recommended direction
@@ -918,8 +918,9 @@ If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the doc
 ## Skill Loading
 
 - Treat \`.agent/skills/\` as the shared source of truth for all kit skills.
-- Codex should discover native repo skills from \`.agents/skills/\`; Claude Code should discover project skills from \`.claude/skills/\`.
-- If native skill discovery is unavailable or stale, fall back to the matching \`.agent/skills/<skill>/SKILL.md\` file.
+- Codex exposes skills from \`~/.codex/skills/\` in the \`$\` menu; \`thachvd-kit\` copies selected skills there on init.
+- Claude Code project skills live in \`.claude/skills/\`.
+- If a skill is missing from the global dir, fall back to the matching \`.agent/skills/<skill>/SKILL.md\` file.
 - Do not load skill bodies by default; load a skill only when the user mentions it, the task clearly matches its description, or \`.agent/docs/project.md\` routes the task to it.
 - Prefer explicit skill mentions for predictable behavior: \`$clean-code\`, \`$systematic-debugging\`, \`$webapp-testing\`, or any skill listed in \`.agent/docs/project.md\`.
 - Run \`thachvd-kit --help\` to see common workflow and skill recommendations.
@@ -939,7 +940,7 @@ If any \`.agent/docs/*.md\` file still contains \`TODO: refine\`, update the doc
 - Project docs: \`.agent/docs/\`
 - Specialist agents: \`.agent/agents/\`
 - Skills: \`.agent/skills/\`
-- Codex native skills: \`.agents/skills/\`
+- Codex global skills: \`~/.codex/skills/\` (installed by thachvd-kit init)
 - Claude Code project skills: \`.claude/skills/\`
 - Workflows: \`.agent/workflows/\`
 - Tooling setup: \`.agent/docs/tooling.md\`
@@ -1121,12 +1122,12 @@ function generateWorkflowDoc() {
 1. Read AGENTS.md.
 2. Read .agent/docs/project.md.
 3. Classify the request: question, survey, simple fix, feature, refactor, debug, UI, security, or deploy.
-4. Read only the relevant docs under .agent/agents, .agent/skills, .agents/skills, .claude/skills, and .agent/workflows.
+4. Read only the relevant docs under .agent/agents, .agent/skills, .claude/skills, and .agent/workflows.
 
 ## Skill Selection
 
 - Prefer native skill discovery when the client exposes it.
-- Codex repo skills live in .agents/skills.
+- Codex global skills live in ~/.codex/skills/ and are visible via the $ menu; thachvd-kit copies selected skills there on init.
 - Claude Code project skills live in .claude/skills.
 - Shared fallback skills live in .agent/skills.
 - Do not load skill bodies by default.
@@ -1281,14 +1282,13 @@ Common local path:
 
 ## Native Skill Folders
 
-The shared kit skills live in \`.agent/skills/\`. Antigravity can use that folder directly, but Codex expects repo skills under \`.agents/skills/\` or user skills under \`~/.agents/skills/\`. Claude Code may require its own native skill location depending on the installed client.
+The shared kit skills live in \`.agent/skills/\`. Antigravity reads that folder directly. Codex shows skills from \`~/.codex/skills/\` in the \`$\` menu. Claude Code reads project skills from \`.claude/skills/\`.
 
-- Codex repo skills: \`.agents/skills/\`
-- Codex user skills: \`~/.agents/skills/\`
-- Codex may also keep installed/system skills under \`$CODEX_HOME/skills\` such as \`~/.codex/skills\`; treat that as local Codex state, not a repo folder to generate or commit.
-- Claude Code project skills commonly live under \`.claude/skills/\`.
-- \`thachvd-kit\` copies selected native skills to \`.agents/skills/\` and \`.claude/skills/\` based on the detected stack.
+- Codex global skills: \`~/.codex/skills/\` — installed by \`thachvd-kit init\`, visible in Codex \`$\` menu
+- Claude Code project skills: \`.claude/skills/\`
+- Antigravity: reads \`.agent/skills/\` directly (no copy needed)
 - Keep \`.agent/skills/\` as the full shared source of truth committed with the repo.
+- Do not commit \`~/.codex/skills/\`; it is local user state.
 
 Recommended candidates to copy first:
 
@@ -1340,10 +1340,15 @@ function copySelectedSkillFolders(data, assumeYes) {
     if (!fs.existsSync(srcSkills)) return { copied: 0, skipped: 0, missing: 0, skills: [] };
 
     const selectedSkills = resolveNativeSkills(data);
-    const destinations = [
-        path.join(targetDir, '.agents', 'skills'),
-        path.join(targetDir, '.claude', 'skills')
-    ];
+
+    // ~/.codex/skills/ — global Codex user skills dir, always visible in the $ menu
+    const codexSkillsDir = homePath('.codex', 'skills');
+    // .claude/skills/ — project-level Claude Code skills
+    const claudeSkillsDir = path.join(targetDir, '.claude', 'skills');
+
+    const destinations = [claudeSkillsDir];
+    if (codexSkillsDir) destinations.push(codexSkillsDir);
+
     let copied = 0;
     let skipped = 0;
     let missing = 0;
@@ -1605,7 +1610,7 @@ async function main() {
 
     const nativeSkills = copySelectedSkillFolders(data, assumeYes);
     if (nativeSkills.copied > 0) {
-        console.log(`  ${pc.green('OK')} Copied native skills to ${pc.bold('.agents/skills/')} and ${pc.bold('.claude/skills/')} (${nativeSkills.skills.join(', ')})`);
+        console.log(`  ${pc.green('OK')} Copied native skills to ${pc.bold('~/.codex/skills/')} and ${pc.bold('.claude/skills/')} (${nativeSkills.skills.join(', ')})`);
     } else if (nativeSkills.skipped > 0) {
         console.log(`  ${pc.yellow('~')} Native skills already exist - ${nativeSkills.skipped} file${nativeSkills.skipped !== 1 ? 's' : ''} skipped`);
     }
@@ -1647,7 +1652,7 @@ async function main() {
     - ${pc.bold('GEMINI.md')} Antigravity entry
     - ${pc.bold('.agent/docs/')} scan-based project rules
     - ${pc.bold('.agent/')} skills, workflows, agents, and rules
-    - ${pc.bold('.agents/skills/')} selected Codex native skills
+    - ${pc.bold('~/.codex/skills/')} selected Codex skills installed globally (visible in $ menu)
     - ${pc.bold('.claude/skills/')} selected Claude Code native skills
 
   ${pc.bold('MCP/tooling setup:')}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.18",
+    "version": "1.0.19",
     "description": "Cross-agent project rules bootstrap kit for Codex, Antigravity, and Claude Code",
     "bin": {
         "thachvd-kit": "./bin/cli.js"