docs: add agents.md, an entrypoint for coding agents - #3429
Merged
Conversation
bartlomieju
commented
Jul 29, 2026
| dependency: | ||
|
|
||
| ```sh | ||
| npx skills add denoland/skills --skill deno |
Member
Author
There was a problem hiding this comment.
If agent installs Deno as the first step this should probably say dx skills ...
Member
Author
There was a problem hiding this comment.
Good catch — fixed. Switched to dx skills add denoland/skills --skill deno, since section 1 has just installed Deno and dx ships with the binary, so this no longer assumes Node is present. Verified dx skills resolves and runs the CLI. Left npx skills add ... mentioned as the identical Node alternative.
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.
Coding agents arrive at a Deno project carrying wrong priors: that Deno is a
separate ecosystem, that adopting it means rewriting imports or moving to JSR,
that
package.jsonhas to go. We already maintain agent skills that correctall of this, but an agent only benefits from them once they are installed, and
nothing in the CLI or the docs currently tells it they exist.
So this page is deliberately an entrypoint rather than a guide. It orients the
agent, states the Node assumptions to unlearn, and then hands off to the skills
in denoland/skills, which stay the single source of truth for the command
surface, permissions, configuration layout, and migration. For agents that
cannot install skills it links the raw SKILL.md files, which are always
current, so nothing here needs restating and there is no second copy to drift.
The file lives in
static/, so it is copied verbatim and served astext/markdownby the existing markdown-source middleware. The URL we intendto advertise is deno.com/agents.md; a companion dotcom PR serves this content
there, and a deno PR adds the link to
deno --help.