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

English | 简体中文

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 Aion CLI, 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 ships with 21+ built-in assistants — the headline ones include Cowork, PPT Creator, Word Creator, Excel Creator, Morph PPT 3D, Pitch Deck Creator, Dashboard Creator, Academic Paper Writer, Financial Model Creator, UI/UX Pro Max, 3D Game, OpenClaw Setup, Beautiful Mermaid, Moltbook, Story Roleplay, and more.

• 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

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

💡 The list of available backends matches what's detected on your machine (Multi-Agent Mode). The Built-in Aion CLI is always available with no install required.

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.

• 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"

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

# 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

• ✅ 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

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.

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

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

Option A — Quick scan

1. Click Add Skills
2. Pick a common path that AionUi auto-detects (e.g., ~/.claude/skills, ~/skills)
3. Confirm

Option B — Manual path

1. Click Add Skills
2. Paste an absolute path, or multiple paths separated by commas: /path/to/skills, /another/path
3. Confirm — AionUi scans the folder for SKILL.md files

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

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

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

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

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

Backend: Built-in Aion CLI

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

Backend: Claude Code or Built-in Aion CLI

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

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.

A: Yes — enable as many as you need.

A: A folder containing SKILL.md (Markdown with YAML frontmatter for name, description). AionUi scans the folder you point it at.

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

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).

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

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

• 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.