Knowledge Templates

Knowledge Templates control the structure and formatting of articles that Brainfish generates from your source material — video uploads, file imports, and other inputs that flow into your self-generating knowledge system. Instead of asking the Brainfish team for custom instructions, you can now create reusable templates yourself for things like how-to guides, troubleshooting steps, feature overviews, and reference docs.

When to use a template

Reach for a Knowledge Template whenever you want the AI to produce articles in a consistent shape across a topic or content type. A few common patterns:

• A support team that wants every troubleshooting article to follow the same "Symptoms → Cause → Fix" structure.
• A product team turning short product videos into how-to guides with predictable headings.
• A customer success team converting onboarding calls into reference docs for the help center.

Once a template exists, Brainfish applies it when generating articles from matching sources. Going forward, the Brainfish agent will also automatically pick the most relevant template based on the content of the source — so you can set templates up once and let Brainfish handle the routing.

Where to find Knowledge Templates

Open Settings → Knowledge Templates, or jump straight to app.brainfi.sh/settings/knowledge-creation-templates.

The list view shows each template's name, article depth, who created it, and when it was last updated. Click New Template in the top-right to start building one.

Create a template

Clicking New Template opens the template editor.

Start from a preset (optional)

The fastest way to get going is to start from a preset. Brainfish ships six starter templates that follow the Diátaxis documentation framework, so you have a solid foundation for the most common article types:

• Brainfish Standard — sensible defaults that work for most knowledge bases.
• Tutorial — learning-oriented, walks a new user through a complete example.
• How-To Guide — task-oriented, gets a user from problem to result.
• Troubleshooting Guide — diagnose-and-fix structure for support content.
• Feature Overview — explanation-oriented, focused on context and "why."
• Reference — information-oriented, structured for lookup.

Selecting a preset pre-fills the name, description, instructions, and sample output. You can edit anything before saving, so treat presets as a starting point rather than a final answer.

Name and description

The Name appears in the templates list and is how you'll refer to the template elsewhere in Brainfish. The Description is a one-liner that explains when this template should be used — e.g. "Use for product walkthroughs generated from Loom recordings." Keep it tight; both you and the AI use this to decide which template fits a given source.

Article Depth

Article Depth controls how much content the AI generates from each piece of source material. Pick the option that matches the level of detail your readers expect.

• Detailed — comprehensive, multi-section articles with full detail. Best for how-to guides and feature overviews where readers expect the full picture.
• Brief — shorter articles that stick to the essentials. Good for quick references and FAQ-style content.
• Single Article — produces one consolidated article from the source rather than splitting it into multiple pieces.

Instructions

The Instructions field is where you tell the AI how to write. Think of it as a mini style guide for this template: structure, tone, voice, required sections, and anything else that makes an article feel "on brand" for your team. Markdown is supported, so you can use headings, lists, and bold text to keep the prompt readable.

A good Instructions block usually covers:

• The overall structure the AI should follow (e.g. Title → Summary → Steps → Troubleshooting).
• Voice and tense (e.g. "active voice, present tense, second person").
• Any rules you want enforced (e.g. "Use sentence case in headings," "Never include pricing").

You can toggle between Write and Preview to check how your Markdown will render.

Sample Output (optional)

Sample Output lets you paste in an example of a well-formatted article. The AI uses it as a concrete reference for tone and structure, which tends to lift output quality more than instructions alone. If you have a "gold standard" article that captures how you want everything to read, drop it here.

Set as default

Flip the Set as default template toggle if you want this template applied by default to new generations when no other template is auto-selected. Only one template can be the default at a time — turning it on for a new template will replace the previous default.

Click Create to save the template. It'll appear in the list on the main Knowledge Templates page and become available to your knowledge generation pipelines.

Tips for great templates

A few things we've seen work well across customer teams:

• Start narrow. One template per content type is usually better than one big template that tries to handle everything.
• Lead with structure. The AI will follow an explicit section list far more reliably than a vague description of "how the article should feel."
• Always include a Sample Output if you can. It anchors the model on real examples and is the single biggest lever for consistency.
• Iterate. Generate a few articles, see where the output drifts, and tighten the Instructions or Sample Output to close the gap.

What's next

Brainfish will soon auto-select the most relevant template based on each piece of source content, removing the need to manually pick one before generating. In the meantime, building out a handful of templates that cover your main article types is the fastest way to get consistent, high-quality knowledge from every source you import.

If you run into anything that isn't working as expected, ping the Brainfish team and we'll help you dial it in.