# seo: Expand /docs/ai/tools examples \+ cross-link from external-agents \(\#49758\) · gitcafe/zed

[View on GitCafe](https://git.cafe/gitcafe/zed/commit/165c033896a95ac12704705e0a61ba5bb01ed660)

Repository: [gitcafe/zed](https://git.cafe/gitcafe/zed)

Visibility: public

Requested revision: 165c033896a95ac12704705e0a61ba5bb01ed660

Requested commit: 165c033896a95ac12704705e0a61ba5bb01ed660

Commit: 165c033896a95ac12704705e0a61ba5bb01ed660

Tree: 47d9edd7f3d79ca68a2720a73c453fccd7d22e27

Author: Katie Geer

Committer: GitHub

## Message

```
seo: Expand /docs/ai/tools examples + cross-link from external-agents (#49758)

Two changes to support pushing `/docs/ai/tools` into the top 10 for
"agent tools" (8,900 monthly volume, currently position 11).

**`docs/src/ai/tools.md`** — adds a concrete usage example to 7 tools:
`diagnostics`, `grep`, `fetch`, `edit_file`, `terminal`, `web_search`,
and `subagent`. Each example shows a realistic scenario rather than
restating the description.

**`docs/src/ai/external-agents.md`** — adds a single sentence
cross-linking to `tools.md` after the supported-agents intro paragraph,
for users who land on that page looking for what the built-in agent can
do.
```

## Parents

- [db362f5ba68b7f63e2bce43592e03c64e206b174](https://git.cafe/gitcafe/zed/commit/db362f5ba68b7f63e2bce43592e03c64e206b174?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zed/tree/165c033896a95ac12704705e0a61ba5bb01ed660?format=markdown)