diff --git a/changelog.mdx b/changelog.mdx
index 2cf6bfc87..ca602f390 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -5,6 +5,28 @@ rss: true
noindex: true
---
+
+
+ ## `skill.md` auto-generation
+
+ Documentation sites now auto-generate a `skill.md` file based on your API references, guides, and features to give AI agents a comprehensive skills file with context on how to help people use your product. `skill.md` replaces the `install.md` approach with more structured capabilities and wider adoption. If you have a custom `skills.md` file at the root of your documentation repository, it replaces the auto-generated version. See [skill.md](/ai/skillmd) for more information.
+
+ ## Audit logs for authentication events
+
+ Events are now tracked in [audit logs](/dashboard/audit-logs) for visibility and compliance.
+
+ ## Markdown export for agents
+
+ Documentation pages now serve raw markdown when the `Accept: text/markdown` header is sent, which enables better AI agent consumption of content.
+
+ ## Improvements
+
+ - Combined authentication, partial authentication, and personalization into a single authentication experience. See [Authentication setup](/deploy/authentication-setup) for more information.
+ - Hidden pages now automatically receive `noindex` meta tags for better SEO control.
+ - Added markdown support for image captions.
+
+
+
## `install.md` auto-generation