diff --git a/.changeset/skill-reference-urls.md b/.changeset/skill-reference-urls.md new file mode 100644 index 000000000..310548ad8 --- /dev/null +++ b/.changeset/skill-reference-urls.md @@ -0,0 +1,5 @@ +--- +"@qawolf/cli": patch +--- + +Point the `qawolf-cli` skill's reference files at absolute raw URLs, so a harness that loads `SKILL.md` without its surrounding directory can still reach `references/runner.md` and `references/run-results.md`. diff --git a/skills/qawolf-cli/SKILL.md b/skills/qawolf-cli/SKILL.md index 67632f30a..03d3faa92 100644 --- a/skills/qawolf-cli/SKILL.md +++ b/skills/qawolf-cli/SKILL.md @@ -81,7 +81,9 @@ artifact URLs expire, its failure fields are absent from a passing run, and its `traceUrl` downloads a Playwright trace that you can read as JSON without opening the trace viewer. **Read [`references/run-results.md`](references/run-results.md) before reporting on a -run's outcome or opening its trace.** +run's outcome or opening its trace.** If that path is not on your filesystem, +fetch it: +`https://raw.githubusercontent.com/qawolf/cli/main/skills/qawolf-cli/references/run-results.md`. ## Safety: reads vs writes @@ -199,4 +201,5 @@ The full workflow is its own guide: how a runner is billed, why the first call must be a run, the order the commands go in, the see-and-act loop, `exec`, the recorder, reading history, staying alive, and an end-to-end example. **Read [`references/runner.md`](references/runner.md) before driving a runner for the -first time.** +first time.** If that path is not on your filesystem, fetch it: +`https://raw.githubusercontent.com/qawolf/cli/main/skills/qawolf-cli/references/runner.md`. diff --git a/src/commands/qawolfCliSkill.template.md b/src/commands/qawolfCliSkill.template.md index a4250c36a..1e6acbb60 100644 --- a/src/commands/qawolfCliSkill.template.md +++ b/src/commands/qawolfCliSkill.template.md @@ -81,7 +81,9 @@ artifact URLs expire, its failure fields are absent from a passing run, and its `traceUrl` downloads a Playwright trace that you can read as JSON without opening the trace viewer. **Read [`references/run-results.md`](references/run-results.md) before reporting on a -run's outcome or opening its trace.** +run's outcome or opening its trace.** If that path is not on your filesystem, +fetch it: +`https://raw.githubusercontent.com/qawolf/cli/main/skills/qawolf-cli/references/run-results.md`. ## Safety: reads vs writes @@ -141,4 +143,5 @@ The full workflow is its own guide: how a runner is billed, why the first call must be a run, the order the commands go in, the see-and-act loop, `exec`, the recorder, reading history, staying alive, and an end-to-end example. **Read [`references/runner.md`](references/runner.md) before driving a runner for the -first time.** +first time.** If that path is not on your filesystem, fetch it: +`https://raw.githubusercontent.com/qawolf/cli/main/skills/qawolf-cli/references/runner.md`.