Repository navigation
feat(agents): load Skillist skills into Cloudflare Agents - #199
Open
blakebauman wants to merge 1 commit into
Open
blakebauman wants to merge 1 commit into
blakebauman wants to merge 1 commit into
Conversation
Add @skillist/agents, a SkillSource for the Agents SDK's experimental
agents/skills API. skillist({ skills: ["org/repo", "org/repo@1.2.0"] })
plugs into Think's getSkills() or loadSkillCatalog() and reads skills
from the public /{org}/{repo}/bundle delivery route.
Each list() revalidates unpinned refs with If-None-Match against the
versionId ETag, so an unchanged skill costs a KV read and a 304 while a
new publish reaches the agent on its next turn. A 404 (missing, private,
or retracted) drops the skill immediately; transport errors keep serving
the last good copy. Resource reads come from the bundle fetched at the
last list, so the model reads the version it was shown.
Public skills only for now. Also adds the package to the npm publish
workflow; its first release needs a manual publish to set up trusted
publishing.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
@skillist/agents, aSkillSourcefor Cloudflare's experimental Agent Skills API in the Agents SDK (agents/skills, targetingagents0.33.x). It plugs into Think'sgetSkills()orloadSkillCatalog()the same way the SDK's built-inworkspace(),r2()andmanifest()sources do:How it works
It reads the existing public
GET /{org}/{repo}/bundleroute, which is already a KV-meta + R2 hot path with a versionId ETag. No API changes.list()before every turn. Each call revalidates unpinned refs withIf-None-Match: an unchanged skill gets a 304, and a new publish reaches the agent on its next turn.@1.2.0) are fetched once and never rechecked.list()returnsSkillSourceError, and the SDK catalog keeps its previous listing.readResource()serves files from the bundle fetched at the lastlist().Also in this PR
publish-packages.ymlgets a publish step for@skillist/agents, afterskill-format, which it depends on.CLAUDE.mdlists the new package in the monorepo layout.Before the first publish
@skillist/agentsdoesn't exist on npm yet, so trusted publishing can't be configured for it. The first release needs a manualnpm publish(a dry-runpnpm packproduced the right tarball:@skillist/skill-format: 0.3.0, peeragents: ^0.33.0). Then add the trusted publisher on npmjs.com. Until that's done, the new step will fail when the workflow runs.Not in scope
skills.runner()contract. The README documents this.Testing
loadSkillCatalog().pnpm check,pnpm typecheckandpnpm check:catalogpass.skillist/cloudflare-deploy: first list ~600 ms, revalidation 55 ms (304), a missing ref skipped with one warning, and a reference file read through the catalog.🤖 Generated with Claude Code