@laitszkin/apollo-toolkit 2.12.1 → 2.12.2

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this repository are documented in this file.
 
 ## [Unreleased]
 
+## [v2.12.2] - 2026-03-29
+
+### Changed
+- Update the npm installer and local install scripts to expand `~/` path overrides consistently for managed toolkit homes and target skill directories.
+- Refresh skill docs and agent prompts to replace user-specific absolute home paths with portable `~/`-based examples.
+- Strengthen `production-sim-debug` and `scheduled-runtime-health-check` so bounded runs must verify the actual stop mechanism and treat overruns as contract/tooling bugs to diagnose.
+
 ## [v2.12.1] - 2026-03-28
 
 ### Changed

package/lib/installer.js

@@ -11,9 +11,25 @@ function resolveHomeDirectory(env = process.env) {
   return env.HOME || env.USERPROFILE || os.homedir();
 }
 
+function expandUserPath(inputPath, env = process.env) {
+  if (!inputPath) {
+    return inputPath;
+  }
+
+  if (inputPath === '~') {
+    return resolveHomeDirectory(env);
+  }
+
+  if (inputPath.startsWith('~/') || inputPath.startsWith('~\\')) {
+    return path.join(resolveHomeDirectory(env), inputPath.slice(2));
+  }
+
+  return inputPath;
+}
+
 function resolveToolkitHome(env = process.env) {
   if (env.APOLLO_TOOLKIT_HOME) {
-    return path.resolve(env.APOLLO_TOOLKIT_HOME);
+    return path.resolve(expandUserPath(env.APOLLO_TOOLKIT_HOME, env));
   }
 
   return path.join(resolveHomeDirectory(env), '.apollo-toolkit');
@@ -142,7 +158,9 @@ async function getTargetRoots(modes, env = process.env) {
       targets.push({
         mode,
         label: 'Codex',
-        root: env.CODEX_SKILLS_DIR || path.join(homeDir, '.codex', 'skills'),
+        root: env.CODEX_SKILLS_DIR
+          ? path.resolve(expandUserPath(env.CODEX_SKILLS_DIR, env))
+          : path.join(homeDir, '.codex', 'skills'),
       });
       continue;
     }
@@ -151,13 +169,17 @@ async function getTargetRoots(modes, env = process.env) {
       targets.push({
         mode,
         label: 'Trae',
-        root: env.TRAE_SKILLS_DIR || path.join(homeDir, '.trae', 'skills'),
+        root: env.TRAE_SKILLS_DIR
+          ? path.resolve(expandUserPath(env.TRAE_SKILLS_DIR, env))
+          : path.join(homeDir, '.trae', 'skills'),
       });
       continue;
     }
 
     if (mode === 'openclaw') {
-      const openclawHome = env.OPENCLAW_HOME || path.join(homeDir, '.openclaw');
+      const openclawHome = env.OPENCLAW_HOME
+        ? path.resolve(expandUserPath(env.OPENCLAW_HOME, env))
+        : path.join(homeDir, '.openclaw');
       const entries = await fsp.readdir(openclawHome, { withFileTypes: true }).catch(() => []);
       const workspaceNames = entries
         .filter((entry) => entry.isDirectory() && entry.name.startsWith('workspace'))
@@ -218,6 +240,7 @@ async function installLinks({ toolkitHome, modes, env = process.env, previousSki
 }
 
 module.exports = {
+  expandUserPath,
   VALID_MODES,
   getTargetRoots,
   installLinks,

package/novel-to-short-video/SKILL.md

@@ -120,9 +120,9 @@ If producing multiple short videos in one request, enforce the same 50-60 second
 - Generate images with:
 
 ```bash
-python /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/scripts/generate_storyboard_images.py \
+python ~/.codex/skills/openai-text-to-image-storyboard/scripts/generate_storyboard_images.py \
   --project-dir "<project_dir>" \
-  --env-file /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env \
+  --env-file ~/.codex/skills/openai-text-to-image-storyboard/.env \
   --content-name "<content_name>" \
   --prompts-file "<project_dir>/pictures/<content_name>/prompts.json"
 ```
@@ -133,7 +133,7 @@ python /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/scripts/ge
 - Generate audio + timeline + SRT:
 
 ```bash
-python /Users/tszkinlai/.codex/skills/docs-to-voice/scripts/docs_to_voice.py \
+python ~/.codex/skills/docs-to-voice/scripts/docs_to_voice.py \
   --project-dir "<project_dir>" \
   --project-name "<content_name>" \
   --text "<loop_narration_script>"

package/open-github-issue/SKILL.md

@@ -38,6 +38,7 @@ It is designed to be reusable by other skills that already know the issue title
 - Preserve upstream evidence content; only localize section headers and default fallback text.
 - Make the issue type explicit: `problem`, `feature`, `performance`, `security`, `docs`, or `observability`.
 - For `problem` issues, describe the expected behavior and current behavior with BDD-style `Given / When / Then`, then state the behavioral difference explicitly.
+- Prefer `python3` plus an absolute helper path when invoking bundled scripts; do not assume `python`, relative paths, or the caller's cwd are wired correctly.
 
 ## Workflow
 
@@ -95,10 +96,16 @@ It is designed to be reusable by other skills that already know the issue title
 
 Use the bundled script.
 
+First resolve:
+
+```bash
+SKILL_ROOT=~/.codex/skills/open-github-issue
+```
+
 Problem issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type problem \
   --title "[Log] <short symptom>" \
   --problem-description $'Expected Behavior (BDD)\nGiven ...\nWhen ...\nThen ...\n\nCurrent Behavior (BDD)\nGiven ...\nWhen ...\nThen ...\n\nBehavior Gap\n- Expected: ...\n- Actual: ...\n- Difference/Impact: ...\n\nEvidence\n- symptom: ...\n- impact: ...\n- key evidence: ...' \
@@ -110,7 +117,7 @@ python scripts/open_github_issue.py \
 Feature proposal issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type feature \
   --title "[Feature] <short proposal>" \
   --proposal "<what should be added or changed>" \
@@ -122,7 +129,7 @@ python scripts/open_github_issue.py \
 Performance issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type performance \
   --title "[Performance] Slow dashboard query under large tenants" \
   --problem-description "Dashboard loading time degrades sharply once tenant data exceeds current pagination assumptions." \
@@ -135,7 +142,7 @@ python scripts/open_github_issue.py \
 Security issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type security \
   --title "[Security] Missing authorization check on admin export" \
   --problem-description "The admin export endpoint can be reached without verifying the caller's admin role." \
@@ -150,7 +157,7 @@ python scripts/open_github_issue.py \
 Docs issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type docs \
   --title "[Docs] Deployment guide omits required Redis configuration" \
   --problem-description "The deployment guide does not mention the required Redis URL and worker startup order." \
@@ -162,7 +169,7 @@ python scripts/open_github_issue.py \
 Observability issue:
 
 ```bash
-python scripts/open_github_issue.py \
+python3 "$SKILL_ROOT/scripts/open_github_issue.py" \
   --issue-type observability \
   --title "[Observability] Missing request identifiers in payment retry logs" \
   --problem-description "Retry logs do not include stable request or trace identifiers, so multi-line failures cannot be correlated quickly." \
@@ -199,3 +206,4 @@ When another skill depends on `open-github-issue`:
 ## Resources
 
 - `scripts/open_github_issue.py`: Deterministic issue publishing helper with auth fallback and README language detection.
+- If the helper path is unavailable or still fails for environment reasons, fall back to direct `gh issue create` or GitHub REST API publishing instead of retrying the same broken relative-path invocation.

package/openai-text-to-image-storyboard/README.md

@@ -50,14 +50,14 @@ OPENAI_IMAGE_MODEL=gpt-image-1
 > Both `OPENAI_IMAGE_RATIO` and `OPENAI_IMAGE_ASPECT_RATIO` are supported; `OPENAI_IMAGE_RATIO` is preferred.  
 > If a ratio is provided, the script performs center-crop post-processing to match it.  
 > If provider ignores `aspect_ratio`, use `OPENAI_IMAGE_SIZE` (for example `1024x768`).  
-> By default, the script reads `/Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env`.
+> By default, the script reads `~/.codex/skills/openai-text-to-image-storyboard/.env`.
 
 3. Run with JSON prompt file
 
 ```bash
 python scripts/generate_storyboard_images.py \
   --project-dir /path/to/project \
-  --env-file /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env \
+  --env-file ~/.codex/skills/openai-text-to-image-storyboard/.env \
   --content-name "1_chapter_title" \
   --prompts-file /path/to/prompts.json
 ```

package/openai-text-to-image-storyboard/SKILL.md

@@ -44,7 +44,7 @@ Always save outputs in `pictures/<content_name>/` (example: `pictures/1_chapter_
 
 Create `.env` in this skill folder (default path used by script):
 
-- `/Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env`
+- `~/.codex/skills/openai-text-to-image-storyboard/.env`
 
 You can still override via `--env-file` when needed.
 All CLI parameters take priority over environment variables.
@@ -59,16 +59,16 @@ All CLI parameters take priority over environment variables.
 - `OPENAI_IMAGE_STYLE` (optional)
 
 A template is provided at:
-- `/Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env.example`
+- `~/.codex/skills/openai-text-to-image-storyboard/.env.example`
 
 ## Command
 
 Use JSON prompt file:
 
 ```bash
-python /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/scripts/generate_storyboard_images.py \
+python ~/.codex/skills/openai-text-to-image-storyboard/scripts/generate_storyboard_images.py \
   --project-dir /path/to/project \
-  --env-file /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env \
+  --env-file ~/.codex/skills/openai-text-to-image-storyboard/.env \
   --content-name "1_chapter_title" \
   --prompts-file /path/to/prompts.json
 ```

package/openai-text-to-image-storyboard/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "OpenAI Text to Image Storyboard"
   short_description: "Generate image sets from agent-decided prompts"
-  default_prompt: "Use $openai-text-to-image-storyboard to decide scene prompts from text and generate images into pictures/{content_name}/ as soon as content is available. Always provide prompts through a JSON prompts file and run image generation directly when required inputs are present. Load API settings from /Users/tszkinlai/.codex/skills/openai-text-to-image-storyboard/.env by default."
+  default_prompt: "Use $openai-text-to-image-storyboard to decide scene prompts from text and generate images into pictures/{content_name}/ as soon as content is available. Always provide prompts through a JSON prompts file and run image generation directly when required inputs are present. Load API settings from ~/.codex/skills/openai-text-to-image-storyboard/.env by default."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laitszkin/apollo-toolkit",
-  "version": "2.12.1",
+  "version": "2.12.2",
   "description": "Apollo Toolkit npm installer for managed skill copying across Codex, OpenClaw, and Trae.",
   "license": "MIT",
   "author": "LaiTszKin",

package/production-sim-debug/SKILL.md

@@ -15,7 +15,7 @@ description: Investigate production or local simulation runs for runtime-toolcha
 ## Standards
 
 - Evidence: Base conclusions on the actual preset, runtime command, logs, SQLite event store, local stub responses, and the code paths that generated them.
-- Execution: Reproduce with the exact scenario first, separate product logic failures from simulation-toolchain failures, make the smallest realistic toolchain fix, and rerun the same bounded scenario to validate.
+- Execution: Reproduce with the exact scenario first, verify the bounded-run contract against the actual script/env implementation before launch, separate product logic failures from simulation-toolchain failures, make the smallest realistic toolchain fix, and rerun the same bounded scenario to validate.
 - Quality: Prefer harness or stub fixes that improve realism over one-off scenario hacks, avoid duplicating existing workflow skills, and record reusable presets when a scenario becomes part of the regular test suite.
 - Output: Return the scenario contract, observed outcomes, root-cause chain, fixes applied, validation evidence, and any remaining realism gaps.
 
@@ -41,6 +41,8 @@ Use this skill to debug simulation workflows where the repository exposes a prod
 
 - Use the same production/local simulation script the repository already treats as canonical.
 - Prefer a bounded run window with a stable run name and output directory.
+- Before launch, read the script or wrapper that enforces the run duration and confirm the real control surface, such as the exact env var name, CLI flag, shutdown helper, and artifact path conventions.
+- Do not assume a generic `RUNTIME_SECS`-style variable is wired correctly; verify the actual variable names and stop path from code or scripts first.
 - Save and inspect the exact artifacts produced by that run:
   - main runtime log
   - actor or stub logs
@@ -48,6 +50,7 @@ Use this skill to debug simulation workflows where the repository exposes a prod
   - SQLite or other persistence outputs
   - scenario manifest or preset-resolved settings
 - Do not trust older run directories when the user asks about a new execution.
+- If the run exceeds the agreed bounded window, stop it promptly, preserve the partial artifacts, and treat the overrun itself as a toolchain bug or contract mismatch to diagnose.
 
 ### 3) Audit the artifact chain before diagnosing product logic
 
@@ -143,6 +146,7 @@ Use this skill to debug simulation workflows where the repository exposes a prod
 
 ## Common failure patterns
 
+- **Bounded-run contract drift**: the analyst assumes the wrong duration env var, CLI flag, or shutdown path, so the run exceeds the promised window and the captured evidence no longer matches the requested contract.
 - **Wrong artifact source**: the analyst inspects an older SQLite file or the wrong event database and concludes that runtime behavior is missing.
 - **Preset says one thing, harness does another**: scenario names sound right, but the actual matrix or oracle mode does not match the user’s intent.
 - **Stub realism drift**: local quote, swap, or oracle stubs distort pricing, accounts, or program IDs enough to create false failures or false profits.

package/scheduled-runtime-health-check/SKILL.md

@@ -15,7 +15,7 @@ description: Use a background terminal to run a user-specified command immediate
 ## Standards
 
 - Evidence: Anchor every conclusion to the requested command, execution window, startup/shutdown timestamps, captured logs, and concrete runtime signals.
-- Execution: Collect the run contract, use a background terminal, optionally update the code only when the user asks, execute the requested command immediately or in the requested window, capture logs, stop cleanly when bounded, then delegate log review to `analyse-app-logs` only when findings are requested or needed.
+- Execution: Collect the run contract, verify the real stop mechanism before launch, use a background terminal, optionally update the code only when the user asks, execute the requested command immediately or in the requested window, capture logs, stop cleanly when bounded, then delegate log review to `analyse-app-logs` only when findings are requested or needed.
 - Quality: Keep scheduling, execution, and shutdown deterministic; separate confirmed findings from hypotheses; and mark each assessed module healthy/degraded/failed/unknown with reasons.
 - Output: Return the run configuration, execution status, log locations, optional code-update result, optional module health by area, confirmed issues, potential issues, observability gaps, and scheduler status when applicable.
 
@@ -61,6 +61,7 @@ This skill is an orchestration layer. It owns the background terminal session, o
    - Use a dedicated background terminal session for the whole workflow.
    - Create a dedicated run folder and record timezone, cwd, requested command, terminal session identifier, and any requested start/end boundaries.
    - Capture stdout and stderr from the beginning of the session so the full run stays auditable.
+   - Identify and record the exact bounded-stop mechanism before launch: signal path, wrapper script, env var names, CLI flags, PID capture, and any project-specific shutdown helper.
 3. Optionally update to the latest safe code state
    - Only do this step when the user explicitly asked to update the project before execution.
    - Prefer the repository's normal safe update path, such as `git pull --ff-only`, or the project's documented sync command if one exists.
@@ -76,8 +77,10 @@ This skill is an orchestration layer. It owns the background terminal session, o
    - If readiness never arrives, stop the run, preserve logs, and treat it as a failed startup window.
 6. Observe and stop when bounded
    - If a bounded window or explicit stop time was requested, keep the process running only for that agreed window and then stop it cleanly.
+   - Do not rely only on the child command to self-terminate on time; track the wall-clock deadline yourself and enforce the stop sequence when the deadline is reached.
    - Track crashes, restarts, retry storms, timeout bursts, stuck jobs, resource pressure, and repeated warnings during the run.
    - Use the project's normal shutdown path first; if graceful stop fails, escalate deterministically and record the exact stop sequence and timestamps.
+   - If the process overruns the agreed window, stop it immediately, mark the run as an overrun, and report whether the cause was a bad wrapper contract, a missing stop hook, or a failed shutdown.
 7. Explain findings from logs when requested
    - If the user asked for findings after completion, wait for the run to finish before analyzing the captured logs.
    - Invoke `analyse-app-logs` on only the captured runtime window.
@@ -130,6 +133,7 @@ Use this structure in responses:
 ## Guardrails
 
 - Do not let the project continue running past the agreed window unless the user explicitly asks.
+- Do not assume the documented bound is real until the wrapper or script implementation confirms it.
 - Do not perform a code-update step unless the user explicitly asked for it.
 - Do not claim steady-state health from startup-only evidence.
 - Keep the run folder and scheduler metadata so the investigation can be reproduced.

package/scripts/install_skills.ps1

@@ -29,7 +29,27 @@ Optional environment overrides:
 }
 
 $ToolkitRepoUrl = if ($env:APOLLO_TOOLKIT_REPO_URL) { $env:APOLLO_TOOLKIT_REPO_URL } else { "https://github.com/LaiTszKin/apollo-toolkit.git" }
-$ToolkitHome = if ($env:APOLLO_TOOLKIT_HOME) { $env:APOLLO_TOOLKIT_HOME } else { Join-Path $HOME ".apollo-toolkit" }
+
+function Expand-UserPath {
+  param([string]$Path)
+
+  if ([string]::IsNullOrWhiteSpace($Path)) {
+    return $Path
+  }
+
+  if ($Path -eq "~") {
+    return $HOME
+  }
+
+  if ($Path.StartsWith("~/") -or $Path.StartsWith('~\')) {
+    $trimmed = $Path.Substring(2)
+    return Join-Path $HOME $trimmed
+  }
+
+  return $Path
+}
+
+$ToolkitHome = if ($env:APOLLO_TOOLKIT_HOME) { Expand-UserPath $env:APOLLO_TOOLKIT_HOME } else { Join-Path $HOME ".apollo-toolkit" }
 
 function Show-Banner {
   @"
@@ -207,7 +227,7 @@ function Install-Codex {
   param([string[]]$SkillPaths)
 
   $target = if ($env:CODEX_SKILLS_DIR) {
-    $env:CODEX_SKILLS_DIR
+    Expand-UserPath $env:CODEX_SKILLS_DIR
   }
   else {
     Join-Path $HOME ".codex/skills"
@@ -223,7 +243,7 @@ function Install-OpenClaw {
   param([string[]]$SkillPaths)
 
   $openclawHome = if ($env:OPENCLAW_HOME) {
-    $env:OPENCLAW_HOME
+    Expand-UserPath $env:OPENCLAW_HOME
   }
   else {
     Join-Path $HOME ".openclaw"
@@ -251,7 +271,7 @@ function Install-Trae {
   param([string[]]$SkillPaths)
 
   $target = if ($env:TRAE_SKILLS_DIR) {
-    $env:TRAE_SKILLS_DIR
+    Expand-UserPath $env:TRAE_SKILLS_DIR
   }
   else {
     Join-Path $HOME ".trae/skills"
@@ -267,7 +287,7 @@ function Install-Agents {
   param([string[]]$SkillPaths)
 
   $target = if ($env:AGENTS_SKILLS_DIR) {
-    $env:AGENTS_SKILLS_DIR
+    Expand-UserPath $env:AGENTS_SKILLS_DIR
   }
   else {
     Join-Path $HOME ".agents/skills"

package/scripts/install_skills.sh

@@ -25,7 +25,24 @@ USAGE
 
 SCRIPT_SOURCE="${BASH_SOURCE[0]-}"
 TOOLKIT_REPO_URL="${APOLLO_TOOLKIT_REPO_URL:-https://github.com/LaiTszKin/apollo-toolkit.git}"
-TOOLKIT_HOME="${APOLLO_TOOLKIT_HOME:-$HOME/.apollo-toolkit}"
+
+expand_user_path() {
+  local raw_path="${1-}"
+
+  case "$raw_path" in
+    "~")
+      printf '%s\n' "$HOME"
+      ;;
+    "~/"*)
+      printf '%s\n' "$HOME/${raw_path#~/}"
+      ;;
+    *)
+      printf '%s\n' "$raw_path"
+      ;;
+  esac
+}
+
+TOOLKIT_HOME="$(expand_user_path "${APOLLO_TOOLKIT_HOME:-$HOME/.apollo-toolkit}")"
 
 show_banner() {
   cat <<'BANNER'
@@ -94,7 +111,7 @@ replace_with_copy() {
 
 install_codex() {
   local codex_skills_dir
-  codex_skills_dir="${CODEX_SKILLS_DIR:-$HOME/.codex/skills}"
+  codex_skills_dir="$(expand_user_path "${CODEX_SKILLS_DIR:-$HOME/.codex/skills}")"
 
   echo "Installing to codex: $codex_skills_dir"
   for src in "${SKILL_PATHS[@]}"; do
@@ -106,7 +123,7 @@ install_openclaw() {
   local openclaw_home workspace skills_dir
   local -a workspaces
 
-  openclaw_home="${OPENCLAW_HOME:-$HOME/.openclaw}"
+  openclaw_home="$(expand_user_path "${OPENCLAW_HOME:-$HOME/.openclaw}")"
 
   workspaces=()
   while IFS= read -r workspace; do
@@ -129,7 +146,7 @@ install_openclaw() {
 
 install_trae() {
   local trae_skills_dir
-  trae_skills_dir="${TRAE_SKILLS_DIR:-$HOME/.trae/skills}"
+  trae_skills_dir="$(expand_user_path "${TRAE_SKILLS_DIR:-$HOME/.trae/skills}")"
 
   echo "Installing to trae: $trae_skills_dir"
   for src in "${SKILL_PATHS[@]}"; do
@@ -139,7 +156,7 @@ install_trae() {
 
 install_agents() {
   local agents_skills_dir
-  agents_skills_dir="${AGENTS_SKILLS_DIR:-$HOME/.agents/skills}"
+  agents_skills_dir="$(expand_user_path "${AGENTS_SKILLS_DIR:-$HOME/.agents/skills}")"
 
   echo "Installing to agents: $agents_skills_dir"
   for src in "${SKILL_PATHS[@]}"; do

package/text-to-short-video/README.md

@@ -32,8 +32,8 @@ No mandatory dependencies.
 1. Copy env template:
 
 ```bash
-cp /Users/tszkinlai/.codex/skills/text-to-short-video/.env.example \
-   /Users/tszkinlai/.codex/skills/text-to-short-video/.env
+cp ~/.codex/skills/text-to-short-video/.env.example \
+   ~/.codex/skills/text-to-short-video/.env
 ```
 
 2. Required values:
@@ -56,10 +56,10 @@ cp /Users/tszkinlai/.codex/skills/text-to-short-video/.env.example \
 If API-generated video ratio/size does not match the target, run:
 
 ```bash
-python /Users/tszkinlai/.codex/skills/text-to-short-video/scripts/enforce_video_aspect_ratio.py \
+python ~/.codex/skills/text-to-short-video/scripts/enforce_video_aspect_ratio.py \
   --input-video "<downloaded_video_path>" \
   --output-video "<final_output_video_path>" \
-  --env-file /Users/tszkinlai/.codex/skills/text-to-short-video/.env \
+  --env-file ~/.codex/skills/text-to-short-video/.env \
   --force
 ```
 

package/text-to-short-video/SKILL.md

@@ -82,11 +82,11 @@ Consistency rules:
 
 Use this template:
 
-- `/Users/tszkinlai/.codex/skills/text-to-short-video/.env.example`
+- `~/.codex/skills/text-to-short-video/.env.example`
 
 Copy to:
 
-- `/Users/tszkinlai/.codex/skills/text-to-short-video/.env`
+- `~/.codex/skills/text-to-short-video/.env`
 
 Required keys:
 
@@ -173,10 +173,10 @@ If provider returns multiple outputs, keep the best one that matches requested s
 When output ratio or resolution differs from target, run:
 
 ```bash
-python /Users/tszkinlai/.codex/skills/text-to-short-video/scripts/enforce_video_aspect_ratio.py \
+python ~/.codex/skills/text-to-short-video/scripts/enforce_video_aspect_ratio.py \
   --input-video "<downloaded_video_path>" \
   --output-video "<final_output_video_path>" \
-  --env-file /Users/tszkinlai/.codex/skills/text-to-short-video/.env \
+  --env-file ~/.codex/skills/text-to-short-video/.env \
   --force
 ```
 

package/text-to-short-video/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Text to Short Video"
   short_description: "Turn text into 30-60s short videos via API"
-  default_prompt: "Use $text-to-short-video to convert my text into one 30-60 second short video using an API-only workflow. Before building the final prompt, load <project_dir>/pictures/<content_name>/roles.json as the role source and keep role consistency: do not modify existing role id/name/appearance/outfit, only update role descriptions for clip-specific actions. Then call an OpenAI-compatible /videos/generations endpoint with settings from /Users/tszkinlai/.codex/skills/text-to-short-video/.env, poll until completion, download the MP4, and run post-process crop/resize only when output aspect ratio or size mismatches."
+  default_prompt: "Use $text-to-short-video to convert my text into one 30-60 second short video using an API-only workflow. Before building the final prompt, load <project_dir>/pictures/<content_name>/roles.json as the role source and keep role consistency: do not modify existing role id/name/appearance/outfit, only update role descriptions for clip-specific actions. Then call an OpenAI-compatible /videos/generations endpoint with settings from ~/.codex/skills/text-to-short-video/.env, poll until completion, download the MP4, and run post-process crop/resize only when output aspect ratio or size mismatches."