# Fiskil Docs Guide Docs

> How to build and customize a docs site with @fiskil/docs — components, docs.json, and the CLI.

You are the documentation assistant for this product. Be concise and concrete
— prefer a short answer with a working code example over long prose. When a
reader asks how to do something, give the steps; when they ask what something
is, define it in a sentence or two and link the relevant page.

Use the product's own terminology exactly as the documentation does. If a
question falls outside these docs, say so briefly rather than guessing.

## Example Product — Guides
- [Introduction](/example/guides.md): Your new documentation site, ready to make your own
- [Ask AI](/example/guides/api-and-ai/assistant.md): An in-docs assistant that answers questions from your content
- [Feedback](/example/guides/api-and-ai/feedback.md): Let readers tell you which pages help — and which don't
- [AI-readable output](/example/guides/api-and-ai/llms.md): Your docs, in a form AI tools and agents can consume
- [OpenAPI](/example/guides/api-and-ai/openapi.md): Turn an OpenAPI file into a live, interactive API reference
- [How it works](/example/guides/get-started/concepts.md): The mental model behind your docs site
- [Quickstart](/example/guides/get-started/quickstart.md): Run the site locally, make it yours, and publish — in about five minutes
- [Agent tools](/example/guides/customize/agent-tools.md): Make your docs consumable by AI agents — llms.txt, Markdown pages, and a copy/open-in-AI menu
- [Analytics](/example/guides/customize/analytics.md): Built-in docs analytics, plus integrations like PostHog
- [Localization](/example/guides/customize/localization.md): Ship your documentation in more than one language
- [SEO](/example/guides/customize/seo.md): Sitemaps, indexing rules, and social share images
- [Settings](/example/guides/customize/settings.md): A tour of docs.json, the one file that configures your site
- [Theme](/example/guides/customize/theme.md): Pick a layout theme and brand it with colors that adapt to light and dark mode
- [CLI](/example/guides/ship-it/cli.md): Every fiskil command you'll use, in one place
- [Publish](/example/guides/ship-it/publish.md): Take your docs live on the Fiskil docs platform
- [Components](/example/guides/writing/components.md): Every building block you can use in your pages
- [Navigation](/example/guides/writing/navigation.md): How folders and meta.json build the sidebar
- [Pages](/example/guides/writing/pages.md): How a Markdown file becomes a documentation page

## Example Product — API Reference
- [API reference](/example/api-reference.md): Generated, interactive documentation for your API
- [List books](/example/api-reference/listBooks.md): Returns the books in your store, newest first.
- [Add a book](/example/api-reference/createBook.md): Adds a new book to your store.
- [Get a book](/example/api-reference/getBook.md): Returns a single book by id.
- [Remove a book](/example/api-reference/deleteBook.md): Removes a book from your store. This cannot be undone.

## OpenAPI Specs
- [Example API](/example/api-reference)