Skip to content

Conversation

@kzu
Copy link
Member

@kzu kzu commented Oct 29, 2025

If instructions are long and the primary content that defines an agent, using TOML is still an inconvenience. For longer text, markdown is king.

We add support for markdown instructions by just relying on YAML front-matter to provide the section data to go along with it.

Example:

---
id: ai.agents.notes
description: Provides free-form memory
client: Grok
options:
  modelid: grok-4-fast
---
You organize and keep notes for the user

@kzu kzu added the enhancement New feature or request label Oct 29, 2025
If instructions are long and the primary content that defines an agent, using TOML is still an inconvenience. For longer text, markdown is king.

We add support for markdown instructions by just relying on YAML front-matter to provide the section data to go along with it.

Example:

```
---
id: ai.agents.notes
description: Provides free-form memory
client: Grok
options:
  modelid: grok-4-fast
---
You organize and keep notes for the user
```
@kzu kzu force-pushed the dev/YamlInstructions branch from c6b9acb to 1bff22b Compare October 29, 2025 05:16
@kzu kzu enabled auto-merge (rebase) October 29, 2025 05:16
@kzu
Copy link
Member Author

kzu commented Oct 29, 2025

32 passed 32 passed 18 skipped

🧪 Details on Ubuntu 24.04.3 LTS

from dotnet-retest v1.0.0 on .NET 9.0.10 with 💜 by @devlooped

@kzu kzu merged commit 8da697a into main Oct 29, 2025
7 checks passed
@kzu kzu deleted the dev/YamlInstructions branch October 29, 2025 05:18
@devlooped devlooped locked and limited conversation to collaborators Nov 29, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants