Description
The installed agent and skill definitions reference helper scripts and bundled helpers through the {platform_home_dir}/scripts/… template (and {platform_home_dir}/skills/…/*.mjs for bundled helpers), which the install pipeline expands to an absolute path per platform target. Nothing verifies, after install, that those resolved paths actually point at files that exist. A packaging gap, a partial install, or a script renamed in some definitions but not others surfaces only when an agent invokes the path at runtime, often mid-run, where the failure is expensive and hard to attribute.
The existing script-invocation-conventions.test.ts guards that source content uses the correct template prefix, but it does not check that the installed targets resolve to present files. The two concerns are distinct: prefix-correctness is a content convention, whereas file-presence is an install and environment property.
This work was split out while narrowing #697. That ticket's original sixth acceptance criterion wanted an install-time check that fails when a script reference cannot be resolved. The intent is sound but orthogonal to the one-line content fix #697 became, and it is better served by a dedicated, user-runnable validator.
Acceptance criteria
Must have
Should have
Nice to have
Description
The installed agent and skill definitions reference helper scripts and bundled helpers through the
{platform_home_dir}/scripts/…template (and{platform_home_dir}/skills/…/*.mjsfor bundled helpers), which the install pipeline expands to an absolute path per platform target. Nothing verifies, after install, that those resolved paths actually point at files that exist. A packaging gap, a partial install, or a script renamed in some definitions but not others surfaces only when an agent invokes the path at runtime, often mid-run, where the failure is expensive and hard to attribute.The existing
script-invocation-conventions.test.tsguards that source content uses the correct template prefix, but it does not check that the installed targets resolve to present files. The two concerns are distinct: prefix-correctness is a content convention, whereas file-presence is an install and environment property.This work was split out while narrowing #697. That ticket's original sixth acceptance criterion wanted an install-time check that fails when a script reference cannot be resolved. The intent is sound but orthogonal to the one-line content fix #697 became, and it is better served by a dedicated, user-runnable validator.
Acceptance criteria
Must have
Should have
{platform_home_dir}/scripts/*.shreferences and bundled.mjshelper references (for example,derive-session-context.mjs)..claude,.codex, and so on), not just one.Nice to have