Skip to content

docs: teach the flow skill to save and read artifacts - #9575

Merged
Gabe Milani (gabemilani) merged 1 commit into
mainfrom
docs/artifacts
Nov 19, 2026
Merged

Gabe Milani (gabemilani) merged 1 commit into
mainfrom
docs/artifacts

Conversation

@gabemilani

Copy link
Copy Markdown
Member

Summary

Follow up from #9551 to teach the flow skill to save and read artifacts.

@strix-security

strix-security Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Strix Security Review

✅ No open security findings.

PR summary: Documents how a flow author saves an agent's output as a named artifact and passes a previously saved artifact into an agent's input files, adding a toggle to suppress that guidance and tests for it.

Review summary

This PR only adds documentation to the flow-authoring skill: two guidance bullets about saving and reusing artifacts in the flow-definition Jinja template (behind a new include flag), the same field documentation in the declarative-flow AGENTS.md template, one boolean added to the template context, and two tests. The rendered skill text is trusted Markdown built from constant and schema-derived values, with no user-controlled input and no runtime sink in this repository, and the artifact fields it describes already exist on main. No security issues were identified in the changed code.

Ruled out (1)
  • Do the new artifact instructions lead an agent to publish its own HTML output at a shareable URL, enabling stored XSS?
    The change adds prose and a boolean template gate only; the artifact fields already exist on main, and the only artifact store in this repository writes local files and returns a file:​// URI, so no in-repo code renders agent-controlled HTML.

Review 1 on this PR · fc49de7 · requested Nov 19 16:48 UTC when the PR was opened


Reviewed by Strix
Re-run review · Configure security review settings · Try a deeper review with @strix-security /deep

@gabemilani
Gabe Milani (gabemilani) merged commit 17d9ec3 into main Nov 19, 2026
59 checks passed
@gabemilani
Gabe Milani (gabemilani) deleted the docs/artifacts branch November 19, 2026 16:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants