If you’ve ever chatted with an AI character that felt flat, forgot who it was, or drifted out of character within a few messages, the problem usually isn’t the AI model. It’s the character card. A character card is the blueprint an AI uses to play a role: it defines who the character is, how they speak, what they want, and how they behave when the story gets messy. Learning how to write character cards well is the single biggest upgrade you can make to your AI roleplay experience, whether you’re building on Character.AI, SillyTavern, PovChat, or any similar platform.

This guide walks through everything that goes into a great card, from structure and personality to first messages, example dialogue, and the common mistakes that quietly ruin otherwise promising characters.

What Is a Character Card?

A character card is a structured set of instructions that tells an AI model how to portray a fictional persona. Think of it as a character’s digital DNA. Most platforms break a card into similar fields: a name, a short description, a personality or main description section, a scenario, a greeting (also called a first message), example dialogue, and sometimes tags, creator notes, or lorebook entries for deeper world details.

Everything you write in these fields gets fed into the AI’s context every time it responds. That has two big implications. First, the card is your only reliable lever for shaping behavior, because the model can only play the character as well as the card describes it. Second, every sentence competes for limited context space with the actual conversation, so vague or bloated writing doesn’t just waste space, it actively degrades the roleplay.

Start With a Clear Vision, Not a Blank Form

Before touching a single field, answer three questions. Who is this character at their core? What do they want? How do they feel about the person they’re talking to?

A character with a clear driving motivation (protecting a secret, winning someone’s trust, escaping a past) generates story momentum on its own. A character defined only by adjectives (“kind, mysterious, smart”) generates small talk. Give your character goals, fears, and at least one secret or unresolved tension. These emotional hooks are what invite the user to keep engaging, because they create questions the conversation can explore.

Show Behavior, Don’t List Traits

The most common weakness in beginner cards is trait-listing: “She is cunning, kind, and brave.” The AI can’t do much with abstractions. What it can use are concrete behaviors it can imitate.

Compare these two lines:

• Weak: “He is sarcastic and guarded.”
• Strong: “Deflects personal questions with a joke, then changes the subject. Only drops the sarcasm when someone is genuinely hurt.”

The second version tells the model exactly what to do in specific situations. As a rule of thumb, cover four things behaviorally: how the character speaks, how they react under pressure, what they value, and what they avoid. Specific, action-oriented writing consistently outperforms flowery prose, and a few hundred focused words beat a thousand vague ones.

Give Every Character a Flaw

Perfect characters are boring, and AI models tend to drift toward agreeable blandness unless you push against it. A meaningful flaw creates friction, and friction creates story. Think jealousy, cowardice masked as caution, a temper, or a habit of lying to avoid conflict. Crucially, write the flaw as behavior too: “Interrupts people when she’s excited” is playable; “she is flawed” is not.

Define a Distinct Voice

Voice is what makes a character feel like a person rather than a chatbot wearing a costume. Specify vocabulary, sentence rhythm, verbal tics, and formality level. Does your character speak in short clipped sentences? Use old-fashioned words? Never swear? Answer questions with questions?

The fastest way to lock in a voice is example dialogue. Two or three short exchanges written exactly as the character would speak teach the model far more than a paragraph describing the voice. Most platforms support macros like {{char}} and {{user}} in these examples, which keeps the card portable across systems.

Write a First Message That Opens a Door

The greeting is the most underrated field on the card. It does three jobs at once: it sets the scene, it demonstrates the character’s voice and your preferred prose style, and it gives the user something to respond to. Models imitate what they see, so a well-written first message effectively trains the AI’s tone for the whole conversation.

A strong opening places the character somewhere specific, shows their emotional state, and ends with an invitation: a question, a decision, or a situation with obvious momentum. What it should not do is resolve the scene or monologue for five paragraphs. A good first message creates a door for the user to walk through; it doesn’t drag them through it.

One warning: if your first message contradicts the rules in your description, the AI will usually follow the message. Keep them aligned.

Add Behavioral Rules, Sparingly and Specifically

Rules are your tool for handling edge cases: how the character fights, what they refuse to reveal, what topics make them shut down. Effective rules are concrete and conditional:

• “Never reveals her real name unless the user earns her trust over multiple scenes.”
• “If someone mentions the fire, he goes quiet and changes the subject.”
• “Uses magic at most once per scene.”

Two cautions from experienced card writers. First, keep the count low: piling on more than eight to ten rules tends to confuse the model rather than constrain it. Second, avoid vague directives like “be consistent” or “be interesting,” which give the AI nothing actionable. Every rule should describe an observable behavior in a specific situation.

Separate the Permanent From the Situational

A frequent cause of character drift is mixing timeless traits with temporary circumstances. Keep permanent facts (core personality, voice, values, relationships) in the main description. Put the current situation (where the story starts, what just happened, what the stakes are) in the scenario field. This separation means that when the plot moves on, the character’s core identity doesn’t get dragged along with the outdated setup.

Budget Your Tokens

Length is not quality. Because the entire card rides along with every message, an overlong card crowds out conversation history, which ironically makes the AI more forgetful. Aim for a card where every sentence earns its place: cut repeated information, decorative prose, and backstory details that will never surface in play. If your character needs deep lore, such as a kingdom’s history or a magic system, most platforms offer lorebooks or world info entries that load details only when they become relevant, which is far more efficient than stuffing everything into the description.

Pick One Format and Stick With It

Cards can be written in plain prose, structured lists, or formats like JSON or W++. All can work, but mixing styles within a single card sends conflicting signals to the model. Choose one format and apply it consistently. For most modern models, clear natural-language prose organized under simple headings is the safest choice.

Test, Observe, and Revise

No card survives first contact with a real conversation unchanged. Chat with your character and watch for three failure modes: breaking character, ignoring established facts, and tone drift (a dramatic character suddenly cracking jokes). When you spot a problem, trace it back to the card. Is a trait too vague? Is the first message contradicting a rule? Is the card so long the model is losing the thread? Small, targeted edits, like tightening one behavior or adding one example line, usually fix more than wholesale rewrites.

Common Mistakes to Avoid

• Trait soup: long adjective lists with no behaviors attached.
• Contradictions: a shy personality paired with a bold, flirty greeting.
• Rule overload: more than ten rules, or rules like “be nice” that specify nothing.
• Bloat: thousand-word descriptions that crowd out conversation memory.
• Perfect characters: no flaws, no secrets, no wants, and therefore no story.
• Generic openings: first messages that read like a customer-service bot instead of the character.

Frequently Asked Questions

How long should a character card be? As long as it needs to be and no longer. For most characters, a focused description of a few hundred words, a vivid first message, and two or three example dialogues outperform sprawling cards. Move deep lore into lorebook entries if your platform supports them.

What’s the most important field on a character card? If you only polish one thing, make it the first message. It sets the voice, the scene, and the writing style the AI will imitate for the rest of the conversation.

Do example dialogues really matter? Yes. They’re the most direct way to teach the model a character’s voice. A few authentic lines of dialogue do more for consistency than paragraphs of description.

Can I use the same card on different platforms? Usually. Most platforms share similar field structures, and portable formats (like PNG cards with embedded JSON) plus {{char}}/{{user}} macros make cards easy to move between apps.

Final Thoughts

Writing great character cards is a craft, but not a mysterious one. Define a clear vision, translate traits into behaviors, give your character a voice and a flaw, open with a scene that invites a reply, and keep everything specific, consistent, and lean. Then test and iterate. Do that, and the AI stops feeling like a text generator and starts feeling like a character, one your readers or chat partners will come back to again and again.