Skip to content

docs: add agents.md, an entrypoint for coding agents - #3429

Merged
bartlomieju merged 3 commits into
mainfrom
agents-md
Jul 29, 2026
Merged

docs: add agents.md, an entrypoint for coding agents#3429
bartlomieju merged 3 commits into
mainfrom
agents-md

Conversation

@bartlomieju

@bartlomieju bartlomieju commented Jul 29, 2026

Copy link
Copy Markdown
Member

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.json has to go. We already maintain agent skills that correct
all 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 as
text/markdown by the existing markdown-source middleware. The URL we intend
to advertise is deno.com/agents.md; a companion dotcom PR serves this content
there, and a deno PR adds the link to deno --help.

@bartlomieju bartlomieju changed the title docs: add agents.md, an onboarding guide for coding agents docs: add agents.md, an entrypoint for coding agents Jul 29, 2026
Comment thread static/agents.md Outdated
dependency:

```sh
npx skills add denoland/skills --skill deno

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If agent installs Deno as the first step this should probably say dx skills ...

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@bartlomieju
bartlomieju merged commit 8c74c44 into main Jul 29, 2026
3 checks passed
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