♻️ refactor(playbook): streamline agents and refresh tsl docs

scripts/install_codex_skills.bat

@@ -8,6 +8,7 @@ rem
 rem Usage:
 rem   install_codex_skills.bat
 rem   install_codex_skills.bat style-cleanup code-review-workflow
+rem   install_codex_skills.bat --local
 rem
 rem Notes:
 rem - Codex loads skills at startup; restart `codex` after installation.
@@ -17,7 +18,13 @@ set "SCRIPT_DIR=%~dp0"
 for %%I in ("%SCRIPT_DIR%..") do set "SRC=%%~fI"
 set "SKILLS_SRC_ROOT=%SRC%\\codex\\skills"
 
+set "LOCAL_MODE=0"
+if /I "%~1"=="--local" set "LOCAL_MODE=1"
+if /I "%~1"=="-l" set "LOCAL_MODE=1"
+if "%LOCAL_MODE%"=="1" shift
+
 set "CODEX_HOME=%CODEX_HOME%"
+if "%LOCAL_MODE%"=="1" if "%CODEX_HOME%"=="" set "CODEX_HOME=%CD%\\.codex"
 if "%CODEX_HOME%"=="" set "CODEX_HOME=%USERPROFILE%\\.codex"
 set "SKILLS_DST_ROOT=%CODEX_HOME%\\skills"
 

scripts/install_codex_skills.ps1

@@ -5,6 +5,7 @@
 # Usage:
 #   powershell -File scripts/install_codex_skills.ps1
 #   powershell -File scripts/install_codex_skills.ps1 style-cleanup code-review-workflow
+#   powershell -File scripts/install_codex_skills.ps1 -Local
 #
 # Notes:
 # - Codex loads skills at startup; restart `codex` after installation.
@@ -12,6 +13,7 @@
 
 [CmdletBinding()]
 param(
+  [switch]$Local,
   [Parameter(Mandatory = $false, ValueFromRemainingArguments = $true)]
   [string[]]$Skills
 )
@@ -26,6 +28,10 @@ if (-not (Test-Path $SkillsSrcRoot)) {
 }
 
 $CodexHome = $env:CODEX_HOME
+if ($Local) {
+  $localHome = Join-Path (Get-Location) ".codex"
+  if (-not $CodexHome) { $CodexHome = $localHome }
+}
 if (-not $CodexHome) {
   $homeDir = $HOME
   if (-not $homeDir) { $homeDir = $env:USERPROFILE }
@@ -67,4 +73,3 @@ if ($Skills -and $Skills.Count -gt 0) {
 }
 
 Write-Host "Done. Skills installed to: $SkillsDstRoot"
-

scripts/install_codex_skills.sh

@@ -8,6 +8,7 @@ set -eu
 # Usage:
 #   sh scripts/install_codex_skills.sh            # install all skills
 #   sh scripts/install_codex_skills.sh style-cleanup code-review-workflow
+#   sh scripts/install_codex_skills.sh --local    # install to <cwd>/.codex
 #
 # Notes:
 # - Codex loads skills at startup; restart `codex` after installation.
@@ -17,6 +18,17 @@ SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)"
 SRC="$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd -P)"
 SKILLS_SRC_ROOT="$SRC/codex/skills"
 
+LOCAL_MODE=0
+if [ "${1:-}" = "--local" ] || [ "${1:-}" = "-l" ]; then
+  LOCAL_MODE=1
+  shift
+fi
+
+if [ "$LOCAL_MODE" -eq 1 ]; then
+  LOCAL_CODEX_HOME="$(pwd -P)/.codex"
+  CODEX_HOME="${CODEX_HOME:-$LOCAL_CODEX_HOME}"
+fi
+
 CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
 SKILLS_DST_ROOT="$CODEX_HOME/skills"
 
@@ -61,4 +73,3 @@ else
 fi
 
 echo "Done. Skills installed to: $SKILLS_DST_ROOT"
-