Skip to content

Maia skill writing + improve docs consistency and terminology - #11946

Open
KONRADS098 wants to merge 5 commits into
mendix:developmentfrom
KONRADS098:maia-skill-writing
Open

KONRADS098 wants to merge 5 commits into
mendix:developmentfrom
KONRADS098:maia-skill-writing

Conversation

@KONRADS098

Copy link
Copy Markdown
Contributor

Adds section for Studio Pro 11.15+ ability to create/edit skills directly in the chat. Renames maia-instructions.md to maia-agent-instructions.md (with redirect). Uses consistent "Agent Skills" / "Agent Instructions" naming, adds (SKILLS.md)/(AGENTS.md) suffixes to page titles, and updates all cross-references.

Add a section describing how to create and edit agent skills
directly in chat from Studio Pro 11.15, instead of managing
SKILL.md files manually. Clarify that Maia's own edits sync
automatically, while manual edits still take effect on the next
chat session or via the Sync button. Update the capabilities
table in the Maia Make overview to note the new behavior.
Rename maia-instructions.md to maia-agent-instructions.md with URL
redirect. Use consistent 'Agent Skills' and 'Agent Instructions' naming
throughout, with 'Maia Agent X (STANDARD.md)' in page titles and
(SKILLS.md)/(AGENTS.md) suffixes in index tables. Simplify section
heading to 'Writing Agent Skills with Maia'.
@KONRADS098

KONRADS098 commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor Author

fyi: still being internally reviewed by the team (PM + dev) internal review is done :)

@KONRADS098 KONRADS098 changed the title Maia skill writing + improve docs consistency and terminology Draft: Maia skill writing + improve docs consistency and terminology Sep 21, 2026
@KONRADS098
KONRADS098 marked this pull request as draft September 21, 2026 14:03
@KONRADS098 KONRADS098 changed the title Draft: Maia skill writing + improve docs consistency and terminology Maia skill writing + improve docs consistency and terminology Sep 21, 2026
@KONRADS098
KONRADS098 marked this pull request as ready for review September 22, 2026 06:39
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-agent-skills.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/_index.md Outdated

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants