Skip to content

docs: align custom agent eval docs with skill field#283

Merged
github-actions[bot] merged 2 commits into
mainfrom
spboyer/fix-275-agent-skill-docs
May 23, 2026
Merged

docs: align custom agent eval docs with skill field#283
github-actions[bot] merged 2 commits into
mainfrom
spboyer/fix-275-agent-skill-docs

Conversation

@spboyer

@spboyer spboyer commented May 23, 2026

Copy link
Copy Markdown
Member

Closes #275

Summary

  • Update the custom-agent and eval-yaml guides to use skill: for custom agents, matching the existing eval parser and schema.
  • Remove the misleading separate agent: eval field from the docs.

Validation

  • go test ./...
  • cd site && npm ci
  • cd site && npm run build

Documentation impact

  • site/src/content/docs/guides/custom-agents.mdx
  • site/src/content/docs/guides/eval-yaml.mdx

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 23, 2026 00:44
@github-actions github-actions Bot enabled auto-merge (squash) May 23, 2026 00:46

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the documentation for writing eval.yaml specs so that custom agents are targeted via the existing skill: field (matching the current Go eval spec model and JSON schema), and removes/avoids the misleading agent: field in examples.

Changes:

  • Update eval.yaml reference docs to describe skill: as the single required target field (for both skills and .agent.md custom agents).
  • Update the custom agents guide examples and key points to use skill: when evaluating .agent.md agents.
Show a summary per file
File Description
site/src/content/docs/guides/eval-yaml.mdx Removes agent: from the top-level fields and switches custom-agent targeting examples to skill:.
site/src/content/docs/guides/custom-agents.mdx Updates eval.yaml examples/instructions to target agents using skill: instead of agent:.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 2

Comment thread site/src/content/docs/guides/eval-yaml.mdx Outdated
Comment thread site/src/content/docs/guides/eval-yaml.mdx
…223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot merged commit 1ad1b5b into main May 23, 2026
5 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.

docs: custom-agent guide uses agent: but eval parser/schema require skill:

3 participants