> For the complete documentation index, see [llms.txt](https://support.ariglad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ariglad.com/interactive-modes/instructions-for-your-ai-writer.md). # Instructions for your AI writer ### Overview Instructions View lets you define how Ariglad's AI should improve your knowledge base articles. Write a plain-language instruction once — and Ariglad applies it across your content, generating suggestions you can review before anything goes live. **You stay in full control: no changes are published without your approval.** *** ### What Are Instructions? An instruction is a plain-language directive that tells Ariglad how to update your articles. Instructions are reusable, easy to manage, and applied consistently across your content. **Common examples:** * Replace "Help Center" with "Knowledge Base" across all articles * Make the tone more conversational and less technical * Add a brief summary at the start of each article * Simplify sentences written above a Grade 8 reading level * Fix grammatical errors and inconsistent punctuation {% embed url="" %} *** ### When to Use Instructions View Instructions View is ideal when you need to: * Standardize tone or style across a large article library * Roll out a rebrand or terminology change at scale * Improve readability and clarity without manual rewrites * Fix recurring grammar or formatting issues * Apply consistent structural changes (e.g., adding summaries or headers) *** ### How to Create an Instruction Setting up an instruction takes less than a minute: 1. **Open Instructions.** Click Instructions in the Ariglad sidebar. 2. **Write your instruction.** Use plain language to describe what you want Ariglad to do (e.g., "Make the tone more professional"). 3. **Choose a domain (optional).** Select which group of articles the instruction should apply to. Leave blank to run it across all articles. 4. **Click Save.** Ariglad will start generating suggestions right away. > **Note on domains:** If you haven't configured any domains yet, you won't see this option in step 3 — Ariglad will simply apply the instruction across your entire knowledge base. > 💡 **Tip:** The more specific your instruction, the better the suggestions. *"Simplify sentences over 25 words"* will produce more consistent results than *"Make it simpler."* *** ### Reviewing Suggestions Once Ariglad generates suggestions, you can review each one before it's published: * Each suggestion shows a side-by-side comparison of the original and proposed change. * Review as many or as few suggestions as you like — there's no pressure to action everything at once. For each suggestion, choose one of the following: * ✅ **Approve** — publishes the change to the article. * ❌ **Reject** — discards the suggestion with no changes made. *** ### Managing Instructions You can return to Instructions View at any time to: * Edit an existing instruction to refine how it's applied * Disable instructions you no longer need * Create new instructions as your content strategy evolves *Think of Instructions View as a living system — it grows and adapts alongside your knowledge base.* *** ### Best Practices * **Be specific.** Vague instructions produce inconsistent suggestions. The more precise the directive, the better the output. * **Start broad, then go granular.** Begin with high-impact improvements like tone and clarity before moving to fine-grained rules. * **Review suggestions regularly.** Staying on top of approvals keeps your knowledge base fresh and prevents a backlog. * **Test with a small scope first.** Before applying a sweeping change, check a few suggestions to confirm they match your intent. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://support.ariglad.com/interactive-modes/instructions-for-your-ai-writer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.