Creating Your First Article

Articles in Clayo are written entirely through your AI coding tool. There's no web editor — just describe what you want and your agent handles the rest.

Writing an article

Ask your agent something like:

"Create a help article explaining how to invite team members to a project."

The agent will use the create_article tool behind the scenes, writing the content in markdown and placing it in the collection you specify.

Articles start as drafts

By default, new articles are created as drafts. This gives you a chance to review the content before it goes live. When you're ready, ask your agent to publish it.

Organizing with collections

Articles live inside collections, which are groups shown in your docs sidebar. You can ask your agent to:

• Create a new collection
• List existing collections
• Place an article in a specific collection

Tips for good docs

• One topic per article — keep articles focused so they're easy to find
• Use clear titles — your title becomes the heading and the search result
• Let the agent iterate — ask it to revise, expand, or simplify after the first draft