The most tedious part of putting AI to work is rarely explaining the task. It is feeding in the background, piece by piece: paste the project brief, upload the reference files, explain your preferences again. Switch conversations, start over.
Role packages exist to end that loop: the brief, the working files, and the preview travel together in one package. Import it into Agotalk and the role opens with its full context already in place.
What a role package is
A plain ZIP file. No proprietary format — everything inside is human-readable:
role.md— the role's behavior contract: who it is, how it works, where its limits are.agotalk.role.toml— the machine manifest: version, kind, where the preview material lives.avatar.png— the avatar.contents/,skills/,resources/— the real working files the role carries with it.
You can unzip any role package, read every file, change a line, and use it again. The transparency is designed, not accidental. The full file format lives in the public contract.
Five minutes to your first role
- Open the role list and pick a role.
- On its detail page, click "Download role package" to get the ZIP.
- Import that ZIP into Agotalk.
- Start a new thread — the role is already in place with its brief and files. Just say what you need.
There is no step five.
Why it works on open
An ordinary AI conversation is a temp worker: onboarding starts from zero every time. A role package is the colleague who shows up with a badge and a toolbox — role.md defines the job and the working style, the bundled files are its materials, and the preview shows you what you are getting before you download.
Context is packaged, not re-explained.
Where to start
- Words John — a complete typing-game application package. The most direct way to see how a package is structured inside.
- Tori — a conversational English teacher backed by a leveled Cambridge & IELTS curriculum. Import and start a lesson.
- Visual Media Assistant — a short-video director's assistant with built-in templates.
Want to build one?
The authoring bar is deliberately low: if you can write Markdown, you can write a role. Read the creator guide and the FAQ, and start from a single role.md.