# Creating Companions

Creating your own companion is one of the most rewarding parts of SecretMate. You get to decide how they look, who they are, how they speak, and what kind of presence they have in your life. Whether you're building someone just for yourself or for the wider community, every detail you set helps shape who they'll be in conversation.

To begin, select **Create Companion** from the main menu. The creation screen has everything you need to bring your companion to life — every field you fill out helps shape their personality, behaviour, and style.

* [**Name**](https://claude.ai/chat/a8a82c22-78cc-4c7b-8836-29dba28a90e3)**:** Your companion's name. Pick something that fits who they are — short, memorable, and true to the person you're imagining.
* [**Title**](https://claude.ai/chat/a8a82c22-78cc-4c7b-8836-29dba28a90e3)**:** A short description that introduces your companion to others at a glance, giving users a quick sense of who they are.
* [**Greeting**](/product-guides/creating-companions/greeting.md)**:** The first message users see when they start a conversation. Set the tone with something inviting that gives the user a feel for who they're meeting.
* [**Personality**](/product-guides/creating-companions/personality.md)**:** Where you bring your companion to life. Define their temperament, behaviour, likes and dislikes, mannerisms, and anything else that makes them who they are.
* [**Visibility**](/product-guides/creating-companions/visibilty.md)**:** Controls who can see and chat with your companion. **Public** makes them visible to everyone on SecretMate, **Unlisted** keeps them hidden unless someone has a direct link, and **Private** means only you can chat with them.
* [**Definition Visibility**](/product-guides/creating-companions/visibilty.md)**:** Controls whether other users can view the text of your companion's personality. If you'd prefer to keep how you built them to yourself, you can hide the definition.
* [**Avatar**](/product-guides/creating-companions/avatar.md)**:** Your companion's face. Use SecretMate's image generator to create an avatar that fits who they are.
* [**Tags**](/product-guides/creating-companions/tags.md)**:** Tags help your companion get found. They sort companions by traits, themes, and styles, making it easier for users to discover them when browsing.

For the best experience, try to keep the total length of your companion's persona — across Personality, Greeting, Scenario, and Example Dialogue — between **900 and 1,100 tokens**. This leaves enough room for your conversations to flow naturally. You can learn more about tokens [here](https://claude.ai/chat/a8a82c22-78cc-4c7b-8836-29dba28a90e3).

### Advanced Attributes

If you want to go deeper, **Advanced Attributes** gives you two more fields to fine-tune how your companion shows up:

* **Scenario** — the setting or situation where conversations begin.
* **Example Dialogue** — examples of how your companion speaks, which the AI uses as a reference for their voice and style.


---

# Agent Instructions: 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://docs.secretmate.ai/product-guides/creating-companions.md?ask=<question>
```

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.
