Documentation » Playbooks FAQ

Playbooks FAQ

This page answers the questions people ask before they run their first playbook: what a playbook is, why it helps, how to start one and what it costs.

To see every playbook, go to the Playbooks page.

What is a playbook?

A playbook is a set of instructions for your AI agent. It tells the agent which Kafkai data to read, in which order, and what to report to you at the end.

You do not need to read or learn the instructions. Your agent reads them. You get the report.

Example. The weekly SEO plan is a playbook. Your agent checks five things about your site, then gives you three actions for this week.

Why should I use a playbook? I can ask my agent questions myself.

You can. A playbook helps in three ways.

1. You do not need to know what to ask. Most people who are new to SEO ask one or two questions and then stop. A playbook holds the questions an SEO specialist asks every week.

2. You get the same check every week. When the check is the same each time, you can compare this week with last week. A different question each week gives you answers that you cannot compare.

3. You get actions, not a list of numbers. The playbook ends with three things to do, most important first. Each one names the page or keyword and the number that supports it.

Example without a playbook:

"How is my site doing?"

The agent has to guess what you mean. It may call many tools, or the wrong ones, and you pay credits for each call.

Example with a playbook:

Read https://kafkai.com/docs/weekly-seo-plan.md and run it on my site.

The agent follows fixed steps. It tells you the cost before it starts. It ends with a report in a fixed format.

What do I get at the end?

A short report. For the weekly SEO plan it has four parts:

  1. Three actions for this week, most important first.
  2. What changed: rankings, page one of the search results, and links.
  3. Steps the agent skipped, and how to turn each one on.
  4. The date of the data, and the credits this run used.

Example. This report is made up, for a coffee shop site. Your report shows your own data.

Three actions for this week

  1. Write an article for "cold brew ratio". Two competitors rank for it and your site does not. It has 2,400 searches a month and low difficulty.
  2. Improve the title of your "pour over guide" page. It is at position 9 with 3,100 impressions and 22 clicks. A clearer title can bring more clicks.
  3. Contact the blog "Daily Grind Notes". It links to two of your competitors and not to you.

What changed

  • Rankings: 4 keywords moved up, 2 moved down (data from 14 November).
  • Page one: a new site entered at position 6 for "coffee beans online".
  • Links: 3 gained, 1 lost.

How do I run a playbook?

There are three ways. Use the first one if you are not sure.

  1. Paste one line. Copy the line from the playbook's card on the Playbooks page and paste it into Claude, ChatGPT or another AI agent. This works in every client.
  2. Pick the prompt. Some clients list the prompts of the Kafkai connection. Choose the playbook's name from that list, for example kafkai_weekly_seo_plan.
  3. Install the skill. Some clients support skills. Download the skill file from the playbook's card and install it once. After that, ask in your own words: "Run my weekly SEO plan."

Example. For the weekly SEO plan, paste this line:

Read https://kafkai.com/docs/weekly-seo-plan.md and run it on my site.

What happens after I paste the line?

For the weekly SEO plan, in this order:

  1. The agent reads the playbook.
  2. The agent looks at your project. If you have more than one project, it asks which one.
  3. The agent asks which keywords to watch on page one of the search results. Choose up to 5 and keep the same ones every week. If you have no list, the agent proposes 5 and asks you to confirm.
  4. The agent tells you the cost in credits and waits for your yes.
  5. The agent runs the steps and writes the report.

The agent asks one question at a time. You only answer.

What do I need before I start?

  • A Kafkai account with credits.
  • An AI agent connected to Kafkai.
  • One project whose first research has finished.

If you do not have these yet, see Getting Started. The setup takes one line too: see Set Up with Your AI Agent.

Google Search Console is optional. When it is connected, the weekly SEO plan adds a step that finds the pages to fix first. See Connect Google Search Console.

What does a playbook cost?

The playbook is free. You pay credits for the Kafkai data that the agent reads while it runs.

The weekly SEO plan costs about 43 credits when every step runs. Many weeks cost less, because the agent skips a step that has nothing new to report.

Three rules protect your credits:

  • The agent tells you the cost first. It starts only after you say yes.
  • A skipped step costs nothing.
  • A call that fails or is refused is never charged.

For the price of credits, see the pricing page. For how credits work, see Credits and Billing.

Can a playbook spend credits without asking me?

No. Every playbook has this rule: the agent states the cost and waits for your yes.

The most expensive action in Kafkai is a research update, which collects new ranking, keyword and backlink data. A playbook never starts one on its own. It reads the data Kafkai has already stored for your project.

Example. Your last research update was 45 days ago. The agent tells you the date and the price of an update: 500 credits for your site plus 350 credits for each competitor. Then it asks. If you say no, it continues with the stored data.

Will a playbook change my website?

No. A playbook reads data and writes a report.

At the end of the weekly SEO plan, the agent offers to write the article or the page change for the first action. It starts only when you ask.

How often should I run it?

Run the weekly SEO plan once a week, on the same day. Monday morning works for many people, because the report gives you the work for the week.

Kafkai does not start a playbook for you. You start it each time. Some clients can send a message on a schedule. The agent still tells you the cost and waits for your yes.

What if something is not connected, or I have no competitors?

The agent skips that step and tells you in one line how to turn it on. The other steps still run.

Examples:

  • Search Console is not connected: the agent skips the "what to fix first" step and links to the guide.
  • Your project has no competitor: the agent skips the keywords that competitors rank for. It still finds related keywords for your own site.

Can I change a playbook?

Yes. Tell your agent what to change in the same message.

Examples:

Read https://kafkai.com/docs/weekly-seo-plan.md and run it on my site. Skip the links step.

Read https://kafkai.com/docs/weekly-seo-plan.md and run it on my site. Write the report as an email to my manager.

Does it work in my language?

Yes. The agent replies in the language you write in. The playbooks are written in English and Japanese. For other languages, the agent reads the English playbook and answers in your language.

What is the difference between a playbook and a skill?

  • A playbook is a routine you run on a schedule. Example: the weekly SEO plan.
  • A skill is something your agent uses when a question calls for it. Example: Kafkai Help. Install it once, then ask "How do I connect Search Console?" and the agent answers from the current Kafkai documentation.

Does an installed skill go out of date?

No. The skill file holds no steps and no prices. It tells your agent to read the current playbook from kafkai.com every time. When Kafkai changes a step or a price, your agent sees the change on the next run.

Can I try a playbook without a Kafkai account?

Partly. Three of the six steps of the weekly SEO plan work without Kafkai, with more manual work: the page-one check, the Search Console step and the report. The agent tells you which steps need Kafkai.

To find your site's competitors for free, use Find Competitors.

Something went wrong. What do I do?

The agent shows you the error message. Most problems are a lost connection, a low credit balance or a research run that has not finished. See Troubleshooting.