Articles in this section

[Admin & Rep Guide] How to create a Spek

You can create a Spek from the Spekit Web App, the Chrome Extension, or a connected AI tool through MCP.

 

1. Before you start

You need an Account Admin, Team Admin, or Expert role to create Speks.

New to this? Read Spek overview and setup first. It explains what a Spek is and what each setting does. For formatting, tables, and embeds, see How to use Spekit's Rich Text Editor.

 

2. Create from the Web App

There are 2 ways.

From the +New button

  1. Open the Spekit Web App.
  2. Click + New in the top navigation bar.
  3. Click Create a Spek.
step 1.gif

From a Topic

  1. Open the Spekit Web App.
  2. Click Hub, then Topics.
  3. Open the Topic you want to add content to.
  4. Click Add New.
  5. Click Spek.
step 2.gif

💡 Pro Tip: Starting from the Topic saves you a step. The Topic is filled in for you, and Topics is a required field.

 

3. Create from the Chrome Extension

From the sidebar

  1. Open the Chrome Extension, also called Sidekick. Click the Dock to open the sidebar, or click the Spekit icon in your toolbar.
  2. Click + New in the top navigation bar.
  3. Click Spek.
step 3.gif

For an existing Salesforce field, picklist, or object

Spekit creates empty Speks for Salesforce fields you have imported. You fill them in rather than creating something new.

  1. Open the Chrome Extension.
  2. Search for the field in the sidebar, or highlight the field label and press Shift + Command + S on Mac.step 4.gif
  3. Search for the name and filter by Speks. You can also filter by Only show undocumented Speks.
  4. Turn on Only show empty Speks.
  5. Open the Spek you want and click Edit to add content.
step 5.gif

ℹ️ Note: Import the object and sync it with Salesforce after the field was added, or it will not appear in Spekit.

 

4. Create from a connected AI tool

If your organization uses the Spekit MCP connector, you can create a Spek from a connected AI tool such as Claude, without opening Spekit.

Ask your AI tool to create the content and tell it which Topic to file it under.

⚠️ The Topic has to already exist. If no Topic name matches, nothing is created. Ask your AI tool to list your Topics first, or create the Topic before the Spek.

ℹ️ Note: Write tools run as you. If your Spekit role does not let you create content in the web app, it will not let you do it through an AI tool either.

💡 Pro Tip: Ask for the draft first, read it, then ask your AI tool to create it. Drafting and creating are separate steps, so that gives you a review point before anything lands in Spekit.

For the full detail, including templates, updating existing content, and building a set of content in 1 request, see [Admin & Rep Guide] Create and update content with Spekit MCP.

 

5. Best practices

These habits save rework later, whichever entry point you use.

Practice Why it matters
Start in the Topic where it belongs Topics decide who can see the Spek, and the field is required anyway
Save as a draft first Nothing reaches a rep before you meant it to
Check the Similar tab If a Spek already covers it, updating that one beats creating a second
Pick Doc or Slides before you write A Spek saved as Slides cannot be turned back into a Doc
Answer the Slack question properly first A good Slack answer becomes a good Spek. A rushed one becomes a bad Spek you have to rewrite
Was this article helpful?
0 out of 0 found this helpful