Skip to content

docs(agents): add the Skills page and rename Instructions to System Prompt - #352

Merged
NathanFlurry merged 1 commit into
mainfrom
docs/skills-system-prompt
Oct 12, 2026
Merged

NathanFlurry merged 1 commit into
mainfrom
docs/skills-system-prompt

Conversation

@NathanFlurry

Copy link
Copy Markdown
Member

Adds a Skills page and turns Instructions into System Prompt, using Pi Durable's prompt section API (see the Pi Durable post).

  • System Prompt (/agents/docs/system-prompt): how sections render before every model call, undefined and { tag: false }, a throwing section keeping its text, loading AGENTS.md from the workspace through input.env, and how prompt changes are recorded in the transcript and keep the prompt cache valid.
  • Skills (/agents/docs/skills): write a SKILL.md, then load skills with a skills section and a skill tool. Skills ship with the worker because the sandbox and database envs can't list directories.
  • Pi's Known limitations now point to both pages instead of the old workarounds.

The old URL is redirected in rivet-dev/website (separate PR).

Verified: examples/docs type-checks, and the skills extension and AGENTS.md section render as documented.

…rompt

System Prompt covers how sections render, loading AGENTS.md from the
workspace with input.env, and how prompt changes reach the model.
Skills shows how to write a SKILL.md and load skills with a prompt
section and a skill tool.

Amp-Thread-ID: https://ampcode.com/threads/T-e76e608d-7e06-4313-b7e5-eb0a5f650d5f
Co-authored-by: Amp <amp@ampcode.com>
@railway-app

railway-app Bot commented Oct 12, 2026

Copy link
Copy Markdown

🚅 Environment agents-pr-352 in rivet-frontend has no services deployed.

8 services not affected by this PR
  • kitchen-sink
  • mcp-hub
  • website
  • frontend-cloud
  • frontend-cloud-ee
  • sentry-tunnel
  • ladle
  • frontend-inspector

@NathanFlurry
NathanFlurry merged commit 7d85d67 into main Oct 12, 2026
2 of 4 checks passed
@NathanFlurry
NathanFlurry deleted the docs/skills-system-prompt branch October 12, 2026 11:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant