Skip to content

[Agents] Add Agent Skills section - #34717

Merged
irvinebroque merged 4 commits into
productionfrom
agents/skills-section
Oct 29, 2026
Merged

irvinebroque merged 4 commits into
productionfrom
agents/skills-section

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

Summary

Adds an Agents > Skills section for the Agent Skills API that shipped in cloudflare/agents#2771 (Agents SDK v0.32.0, Think v0.23.0). Skills are now files: they load from a Computer Workspace, R2, or code, and every SKILL.md is checked against the Agent Skills specification, following its guide for agents.

Page Content
agents/skills/ Overview: skill layout, sources, tools, validation, use without Think
agents/skills/sources/computer/ skills.workspace(): skills as Workspace files, running scripts with exec
agents/skills/sources/r2/ skills.r2(): bucket layout and options
agents/skills/sources/code/ skills.manifest(): skills defined in code
agents/skills/execution/ Running scripts: Workspace exec, and the experimental script runner (agents/skills/runner). Replaces agents/runtime/execution/agent-skills/
agents/tools/skills/ The skill tools (activate_skill, read_skill_resource, run_skill_script) for Think, Pi Durable, AI SDK, and other harnesses
agents/concepts/agent-skills/ Concept: the open format, progressive disclosure, frontmatter rules, scripts, writing good skills, trust
Changelog Agent Skills are files in your agent's Workspace
  • Removes agents/runtime/execution/, which only held the old Agent Skills page. Both URLs redirect to the new section.
  • Replaces the SkillProvider / load_context section of the memory concept page with a pointer to Agent Skills. That API no longer exists in agents.
  • Updates the Think pages for this release: getSystemPrompt() now renders above context blocks, and skill catalog changes reach the model as a reminder instead of rebuilding the cached system prompt.
  • Updates the Think, Pi, OpenCode, and Agent class links, and the Pi skills() example (manifest() replaces fromManifest()).
  • Changes .gitignore from skills/ to /skills/. The generated skills folder lives at the repository root, and the unanchored pattern also ignored src/content/docs/agents/skills/.

Documentation checklist

@github-actions github-actions Bot added product:changelog product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /agents/runtime/execution/agent-skills/
  • /agents/runtime/execution/

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-agents-skills-section.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://9480c64f.previews.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/agents/concepts/conversation-state-and-memory/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/concepts/conversation-state-and-memory/
https://developers.cloudflare.com/agents/tools/skills/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/tools/skills/
https://developers.cloudflare.com/agents/skills/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/
https://developers.cloudflare.com/agents/skills/sources/computer/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/sources/computer/
https://developers.cloudflare.com/agents/skills/execution/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/execution/
https://developers.cloudflare.com/agents/runtime/execution/agent-skills/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/runtime/execution/agent-skills/
https://developers.cloudflare.com/agents/concepts/agent-skills/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/concepts/agent-skills/
https://developers.cloudflare.com/agents/skills/sources/code/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/sources/code/
https://developers.cloudflare.com/agents/skills/sources/r2/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/sources/r2/
https://developers.cloudflare.com/changelog/post/2026-10-29-agent-skills-from-files/ https://gh-agents-skills-section.previews.developers.cloudflare.com/changelog/post/2026-10-29-agent-skills-from-files/
https://developers.cloudflare.com/agents/skills/sources/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/skills/sources/
https://developers.cloudflare.com/agents/runtime/execution/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/runtime/execution/
https://developers.cloudflare.com/agents/harnesses/think/configuration/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/harnesses/think/configuration/
https://developers.cloudflare.com/agents/harnesses/pi/extensions/ https://gh-agents-skills-section.previews.developers.cloudflare.com/agents/harnesses/pi/extensions/
https://developers.cloudflare.com/changelog/post/2026-10-20-think-computer-workspace/ https://gh-agents-skills-section.previews.developers.cloudflare.com/changelog/post/2026-10-20-think-computer-workspace/

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://agents-skills-section.previews.developers.cloudflare.com (commit b75f2cc)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://58621ef5.previews.developers.cloudflare.com b75f2cc 2026-10-29T17:49:39.869Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
c2ac310 2026-10-29T17:26:18.993Z View logs ↗
  • Build: In progress 🔵

View logs ↗
5922d5a 2026-10-29T17:18:45.797Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://1bbb7ef4.previews.developers.cloudflare.com bae811c 2026-10-29T17:05:17.544Z Visit the dashboard ↗
  • Build: Failed ❌

View logs ↗
810414a 2026-10-29T15:27:50.792Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://c9cd4585.previews.developers.cloudflare.com d1fa60e 2026-10-29T14:15:37.570Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://438db83f.previews.developers.cloudflare.com 779815e 2026-10-29T13:17:01.845Z Visit the dashboard ↗

@mattzcarey
mattzcarey marked this pull request as ready for review October 29, 2026 14:01
@mattzcarey
mattzcarey requested review from a team, irvinebroque and rita3ko as code owners October 29, 2026 14:02
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed b75f2cc · 0 findings · incremental

Not reviewed (2)
  • src/content/docs/agents/runtime/execution/agent-skills.mdx — deleted file
  • src/content/docs/agents/runtime/execution/index.mdx — deleted file
Resolved (4) · Dismissed (0)
  • Resolved: Example references undefined computerWorkspace · Verified at head: tools/skills.mdx now has '// computerWorkspace is a Workspace from @cloudflare/computer.' above the loadSkillCatalog call, matching the skills/index.mdx pattern the finding cited; the placeholder is explained.
  • Resolved: Heading begins with a verb ending in -ing · Verified at head: agent-skills.mdx:103 heading is now '## Write good skills', the imperative form required by the headings rule; the '-ing' form 'Writing good skills' is gone.
  • Resolved: Semicolon joins two independent clauses · Verified at head: pi/extensions.mdx:157 now ends '...give the model a shell or Workspace tool. Refer to Execution.' — the semicolon was replaced by a period, yielding two sentences per the writing style rule.
  • Resolved: Directional word "above" · Verified at head: getting-started.mdx:255 now reads 'The "soul" block in the previous example acts as the system identity'; the directional word 'above' was removed and no rule-listed directional word remains.
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

Comment thread src/content/docs/agents/concepts/agent-skills.mdx Outdated
@mattzcarey
mattzcarey force-pushed the agents/skills-section branch from 5922d5a to c2ac310 Compare October 29, 2026 17:26
@irvinebroque
irvinebroque added this pull request to the merge queue Oct 29, 2026
Merged via the queue into production with commit 1142f56 Oct 29, 2026
13 checks passed
@irvinebroque
irvinebroque deleted the agents/skills-section branch October 29, 2026 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:changelog size/xl

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants