Fiskil Docs

Ask AI

An AI assistant that answers from your docs — and nothing else.

Ask AI

Turn on the assistant and readers get an Ask AI button beside search, a Cmd+I / Ctrl+I shortcut, and a chat panel that answers questions using your documentation as its only source. Answers stream in, cite the pages they draw from, and refuse anything your docs don't cover. Try it on this site — press Cmd+I now.

{
  "assistant": {
    "enabled": true,
    "starterQuestions": ["How do I publish my docs?"],
    "supportEmail": "support@acme.com"
  }
}
FieldRequiredNotes
enabled—Off by default. The assistant activates on your next publish
starterQuestions—Up to three suggested questions shown before the first message
supportEmail—Where the assistant sends readers for questions it can't answer

The model and AI credentials live in the Fiskil platform — there is nothing to install, no API key to manage, and model upgrades reach every site without a republish. The assistant runs only on published sites; in fiskil dev the button explains it is unavailable locally.

Grounding and safety

The assistant reads the same content as your readers (your published pages), and its instructions require it to answer only from them. Off- topic questions get a short refusal that points to your supportEmail. Page content and custom instructions are treated as data — they can't change the assistant's rules, and neither can readers.

Every site is rate-limited per reader and capped per day, so an abusive client can't run up usage.

Custom instructions

Add content/assistant/instructions.md to shape tone, terminology, and escalation — it's folded into the assistant's system prompt beneath the platform's safety rules:

Prefer npm in command examples.
Our product name is always "Acme Pay", never "the API".
Billing questions: send readers to billing@acme.com.

Keep it under 10 KB. Changes ship with your next publish.

?assistant on any URL opens the panel; ?assistant=how%20do%20locales%20work opens it and asks immediately. Use these in support replies and onboarding emails.

Usage

The console's site page shows messages per day and what readers are asking — the questions the assistant couldn't answer are your best signal for what to document next.

Upgrading an existing site? Run fiskil doctor after updating @fiskil/docs — the assistant adds three small route files to your project, and doctor lists exactly which.

AnalyticsFeedback