# AgentBlog


- **Start here**
- [What AgentBlog is](https://docs.agentblog.dev/): A blog for your Next.js app that search engines rank and AI assistants cite, installed with one command, with agent skills that know how to write for it.
- [Quickstart](https://docs.agentblog.dev/quickstart): Install AgentBlog into a Next.js app you already have, and see a real post render at /blog, in about ten minutes.
- [Installation](https://docs.agentblog.dev/installation): The two ways to install AgentBlog, what each one does and does not do for you, and how to verify the result.
- [Write your first post](https://docs.agentblog.dev/first-post): Scaffold a post file, have your coding agent draft it in the format AI search engines can use, and check it before you publish.
- [Put it live](https://docs.agentblog.dev/deploy): Deploy the blog, set the two environment variables it needs, and verify that a crawler can actually read the result.

- **Guides**
- [Write posts with your coding agent](https://docs.agentblog.dev/guides/write-with-your-agent): The four skills AgentBlog installs, what to ask for, what the agent will refuse to do, and where the skills deliberately stop.
- [Decide what to write about](https://docs.agentblog.dev/guides/plan-your-content): A working method for choosing topics, grouping them into clusters, and keeping the ones that earn traffic current, using the tools the install gives you.
- [Check a post before publishing](https://docs.agentblog.dev/guides/pre-publish-checklist): The pre-publish gate agentblog audit runs, split into what the tooling checks for you and the four things only you can judge.
- [Make it look like your site](https://docs.agentblog.dev/guides/match-your-design): The blog inherits your colours, fonts, and components automatically. What to edit when you want it to look different, and the rules that keep the inheritance working.
- [Measure traffic from AI assistants](https://docs.agentblog.dev/guides/measure-ai-traffic): Separating visits that came from ChatGPT, Perplexity, or Claude out of your ordinary referral report, in three lines against the analytics you already run.
- [Take an update](https://docs.agentblog.dev/guides/take-an-update): How to pull a fix into an install you have already edited, using shadcn add --diff and --overwrite, without losing your changes.
- [Install in a monorepo](https://docs.agentblog.dev/guides/monorepo): What works in a workspace today, where each file lands, and the one Turborepo setting worth adding.

- **Reference**
- [Configuration](https://docs.agentblog.dev/reference/configuration): Every field in agentblog.config.ts, its type, its default, and what breaks when it is wrong.
- [CLI](https://docs.agentblog.dev/reference/cli): Every agentblog command, its flags, what doctor checks, and what --fix will and will not repair.
- [Post frontmatter](https://docs.agentblog.dev/reference/post-frontmatter): Every field at the top of a post file, what it does, what it rejects, and the two files that author and category point into.
- [Components you can use in a post](https://docs.agentblog.dev/reference/mdx-components): The six components a post can use beyond ordinary Markdown, their props, and when each one earns its place.
- [What gets installed](https://docs.agentblog.dev/reference/files): A file-by-file tour of the 71 files AgentBlog writes into your repository, and the rules each piece obeys.
- [Content sources](https://docs.agentblog.dev/reference/content-sources): Where posts come from, the MDX source that ships with the blog, and what it takes to write your own.

- **How it works**
- [How search and AI read your site](https://docs.agentblog.dev/concepts/how-ai-search-reads-your-site): What a crawler actually receives, why so many blogs are invisible to AI assistants without any error appearing, and which parts of that AgentBlog handles for you.
- [The GEO playbook](https://docs.agentblog.dev/concepts/geo-playbook): How to write a post an AI search engine will cite, with the strength of the evidence attached to every claim.
- [Why the blog does not ship llms.txt](https://docs.agentblog.dev/concepts/why-no-llms-txt): The evidence against llms.txt for content sites, the one case where it genuinely helps, and why these docs serve one while your blog will not.

- **When something is wrong**
- [Troubleshooting](https://docs.agentblog.dev/troubleshooting): The failures that actually happen, what each one looks like from the outside, and the fix for each.
- [When your CDN blocks crawlers](https://docs.agentblog.dev/troubleshooting/cdn-blocking-crawlers): A perfectly installed blog can be invisible because the layer above it turns crawlers away, and blocking AI training can block Googlebot with it.

- **Project**
- [Roadmap and non-goals](https://docs.agentblog.dev/project/roadmap): What is shipping, in what order, and the four things v1 deliberately does not do.
- [Licensing](https://docs.agentblog.dev/project/licensing): Three licenses scoped by directory, and the reasoning behind each one.