Assistant Configuration Guide

🤖 AionUi Assistant Configuration Guide

This guide explains how Assistants work in AionUi — how to use the 21 built-in assistants, customize them with Rules and Skills, and create your own.

English | 简体中文

🎯 What is an Assistant?

An Assistant is a focused AI persona built on top of an agent backend. It bundles together:

• A backend agent that runs the work (Built-in Agent powered by aionrs, Claude Code, Codex, Gemini, Qwen, Cursor, etc.)
• A prompt (Rules) in Markdown that tells the agent how to behave
• A set of Skills that give the agent extra capabilities (PPT, Word, Excel, charts, MCP tools, etc.)
• Display metadata: name, avatar (emoji or built-in icon), description

AionUi currently ships with 21 built-in assistants — including Cowork, PPT Creator, Word Creator, Excel Creator, Morph PPT 3D, Pitch Deck Creator, Dashboard Creator, Academic Paper, Financial Model Creator, UI/UX Pro Max, 3D Game, OpenClaw Setup, Beautiful Mermaid, moltbook, Story Roleplay, and AionUi Butler.

Key properties

• Local-first — assistants run on your machine; rules are stored as Markdown files under your data directory
• Pluggable backend — every assistant can pick its own agent (the same Rules/Skills can run on a different model)
• Customizable — built-in assistants let you tweak the backend, rules and skills; custom assistants let you build from scratch
• Stackable Skills — multiple Skills can be enabled at once; a Skill can be built-in, user-imported, or contributed by an extension

---

🚀 Creating a New Assistant

1. Click the Settings icon (⚙️) in the left sidebar
2. Open the Assistants tab
3. Click Create

Configure basic info

Field	Required	Notes
Name	✅	Display name shown in the assistant list
Avatar	—	Pick an emoji (default 🤖)
Description	—	One-liner describing what the assistant does
Backend Agent	✅	Pick from available agents — Built-in Agent, Claude Code, Codex, Gemini, Qwen, Cursor, OpenCode, Snow, etc.

💡 The list of available backends matches what's detected on your machine (Multi-Agent Mode). The Built-in Agent is included and requires no external agent installation. Rules, Skills, tools, and permission behavior can vary by backend.

---

📝 Configuring Rules

Rules are the assistant's system prompt — written in Markdown, stored as a regular .md file inside your data directory (assistant-rules/<id>.<locale>.md). When the assistant runs, AionUi feeds the rules to the backend agent as the system instruction.

What Rules are good for

• Workflows — "When the user asks for X, do A, then B, then C"
• Constraints — "Never modify files outside the project root"
• Domain context — "This codebase uses Bun + Vite; tests are Vitest"
• Output style — "Always answer in Markdown with a TL;DR at the top"

Editing flow

1. Open the assistant → find the Rules section
2. Use the Edit tab to write Markdown
3. Use the Preview tab to see the rendered output
4. Save — the change applies on the next conversation

Example: a File Management assistant

# File Management Assistant

## Path conventions
- All files mentioned by the user live under the current project directory unless explicitly stated
- Use `Glob` to locate files when only the name is given — never ask "where is the file?"
- Avoid creating new files when an existing one can be edited

## Execution principles
- Break complex tasks into steps and report progress
- Confirm destructive operations (delete, overwrite) before executing
- Keep solutions minimal and focused

Best practices

• ✅ Be explicit — short imperative sentences work best
• ✅ Use headings and bullet lists; agents pay attention to structure
• ✅ Provide concrete examples for the cases you most care about
• ❌ Don't dump large reference docs — use Skills for that

---

🛠️ Configuring Skills

Skills extend an assistant with packaged capabilities — file format processors, document generators, MCP tool bundles, domain-specific reference packs. Skills are Markdown documents (SKILL.md) that the agent loads on demand.

Three sources

1. Built-in — bundled with AionUi (PPT, Word, Excel, Morph PPT, Mermaid charts, etc.) — toggle on/off
2. Custom — your own Skills, imported from a folder you point AionUi at
3. Extension — contributed by external agent extensions

Add a built-in Skill

1. Open the Skills section in the assistant editor
2. Expand the Built-in Skills panel
3. Tick the Skills you want — multiple are allowed

Add a custom Skill

1. Open Settings → Skills
2. Import an existing Skill folder or create a new Skill
3. Return to Settings → Assistants and open the target assistant
4. Attach the Skill in the Skills section, then save

Manage Skills

• Toggle — check/uncheck to enable/disable
• Remove a custom Skill — hover the row and click 🗑️
• Built-in Skills — can be disabled but not removed

---

💾 Save & Use

1. Click Save at the bottom of the editor
2. The assistant appears in the welcome screen's assistant list
3. Pick the assistant when starting a new conversation

---

🔧 Editing & Deleting

Edit

• Open the assistant from the list and edit any field
• Save to apply

What you can change on built-in assistants

• ✅ Backend agent
• ✅ Rules
• ✅ Skills
• ✅ Description
• ❌ Name and avatar (locked to keep them recognizable)
• ❌ Cannot be deleted

Custom assistants

• Fully editable, including name and avatar
• Click Delete at the bottom of the editor to remove (cannot be undone)

---

📚 Use Cases

File Management Assistant

Backend: Built-in Agent

Rules:

# File Management Assistant

## Core duties
- Batch rename, smart classification, find duplicates, format conversion

## Working principles
- Verify file location with `Glob` before any operation
- Always make a backup before destructive operations
- Report progress in concise bullet points

Skills: built-in file utilities + your custom file-ops Skills

Code Review Assistant

Backend: Claude Code or Built-in Agent

Rules:

# Code Review Assistant

## Review focus
- Correctness, readability, performance, security, project conventions

## Output format
- Markdown, grouped by severity (High / Medium / Low)
- Quote concrete code locations: `path:line`
- Suggest a fix for every High finding

Skills: code-analysis Skills + your repo's style guide

---

❓ FAQ

Q: Difference between Rules and Skills?

A: Rules tell the agent how to behave (a system prompt). Skills give the agent extra capabilities (file processors, document generators, tool bundles). Rules are always loaded; Skills are loaded on demand.

Q: Can one assistant use multiple Skills at once?

A: Yes — enable as many as you need.

Q: What format does a custom Skill use?

A: A folder containing SKILL.md (Markdown with YAML frontmatter for name and description). Import it from Settings → Skills, then attach it to an assistant.

Q: Can I tell which Skills are enabled?

A: Yes — checked = enabled, unchecked = disabled. The state is per assistant.

Q: Can I edit built-in assistants?

A: You can edit description, Rules, Skills, and the backend agent. Name and avatar are locked, and built-in assistants can't be deleted (only disabled).

Q: What Markdown features do Rules support?

A: Standard CommonMark — headings, lists, code blocks, bold/italic, links, images.

Q: Where are my Rules stored?

A: As .md files under your AionUi data directory: assistant-rules/<assistant-id>.<locale>.md. You can back them up like any text file.

---

🔗 Related Documentation

• Quick Start
• Multi-Agent Mode Setup
• MCP Configuration
• AI Assistants & Skills Ecosystem
• FAQ

---

Need Help?

• 🐛 Report Issues
• 💬 Community Discussions
• 📖 Complete Documentation

Build your own AI specialist — pick a backend, write the Rules, plug in the Skills.