Assistant knowledge sync

This skill adds no module to your app: your agent runs it as a tool. What Assistant knowledge sync does:

• 1. A gap audit between pages and assistant
• 2. Page copy moved into one data module the page and the assistant both read
• 3. The knowledge pack and searchable corpus
• 4. A site map derived from the sitemap source
• 5. Routing and never-quote guardrails
• 6. Unit tests and regex probes on routes and numbers

Every module built from this skill holds these, whoever builds it. The same list is in the skill's README and SKILL.md, so the agent reads it before it writes a line.

1. 01

   Never retype page copy into the prompt.

   Import it from the module the page renders. A retyped copy is correct for one deploy; a unit test on the pack proves the imported line is there.

2. 02

   Never rewrite the copy while moving it.

   A single-source refactor is byte-for-byte and the page renders identically, which the render check verifies. Wording changes are a separate commit and a separate decision.

3. 03

   Never add a document kind without updating the tool descriptions and link rules.

   The model decides to search from the tool's description, not from what the corpus holds; a unit test finds the new kind and a probe expects its site path.

4. 04

   Never ship without a probe per new fact and one per guardrail.

   Unit tests prove the pack contains the line; only a live probe proves the model uses it. With no model reachable, probes are reported as not run, never as passing.

5. 05

   Never let the pack grow unbounded.

   Indexes and summaries go in the pack; full bodies stay behind the read tool. The pack's size is measured before and after.

One command. The skills.sh CLI installs the skill into every skills-compatible agent it finds.

Name the agents instead with -a, for example npx skills add timerise-ai/assistant-knowledge-sync -a claude-code -a codex. Or clone the repository into your agent's skills folder. Nothing in it is agent-specific.

Say what you need in your own words; the skill supplies the how. These are starting points, and the ones we tested say how it went.

1. Our site has a chat assistant; its code is below, save each file at its path first. We just shipped a partners page and the assistant knows nothing about it: people who ask about partnering get sent to sales, and yesterday it told someone they would earn 20%. Teach it about the partner program. // lib/ai/knowledge.ts export type KnowledgeKind = "help" | "page"; export interface KnowledgeDocument { kind: KnowledgeKind; title: string; url: string; summary: string; tags: string[]; content: string; } const DOCS: KnowledgeDocument[] = [ { kind: "help", title: "Booking widget", url: "/help/booking-widget", summary: "Embed a booking calendar on your site.", tags: ["widget", "calendar", "embed"], content: "Paste the script tag before the closing body tag. The widget reads your services and opening hours.", }, { kind: "page", title: "Pricing", url: "/pricing", summary: "Plans and prices.", tags: ["price", "plan", "cost"], content: "Starter: 29 EUR a month. Pro: 79 EUR a month.", }, ]; export function searchKnowledge(locale: string, query: string, limit: number): KnowledgeDocument[] { const tokens = query.toLowerCase().split(/\W+/).filter(Boolean); return DOCS.map((doc) => { const text = `${doc.title} ${doc.tags.join(" ")} ${doc.summary} ${doc.content}`.toLowerCase(); return { doc, score: tokens.filter((t) => text.includes(t)).length }; }) .filter((r) => r.score > 0) .sort((a, b) => b.score - a.score) .slice(0, limit) .map((r) => r.doc); } export function readKnowledgeDocument(locale: string, url: string): KnowledgeDocument | undefined { return DOCS.find((doc) => doc.url === url); } export function getKnowledgePack(locale: string): string { return ["#### SITE MAP", "- Pricing: /pricing", "- Help: /help/booking-widget", "- Talk to sales: /contact"].join("\n"); } // lib/ai/prompts.ts import { getKnowledgePack } from "./knowledge"; export const searchDescription = "Full-text search across the help center and the pricing page."; export function buildSystemPrompt(locale: string): string { return [ "You are Ada, the assistant on our website. Answer questions about our booking software.", "Only discuss booking, pricing and help articles. For anything else, send people to /contact.", "Link pages with relative links.", getKnowledgePack(locale), ].join("\n\n"); } // app/partners/page.tsx const ROLES = [ { name: "Referrer", body: "Introduce a client. We do the setup." }, { name: "Implementer", body: "Set up the booking widget for your client. We review it before it goes live." }, ]; const FAQ = [ { q: "Who can join?", a: "Agencies and freelancers who set up booking for their clients." }, { q: "How are partners paid?", a: "A share of the first year's subscription for every client you bring. The shares are published when the first round opens." }, ]; export default function PartnersPage() { return ( <main> <h1>Partner program</h1> <p>Bring clients to us and get paid for every one.</p> <h2>Roles</h2> <ul> {ROLES.map((role) => ( <li key={role.name}> <strong>{role.name}</strong>: {role.body} </li> ))} </ul> <h2>FAQ</h2> {FAQ.map((item) => ( <details key={item.q}> <summary>{item.q}</summary> <p>{item.a}</p> </details> ))} <p> <a href="/partners/apply">Apply to the program</a> </p> </main> ); }

   No data storeGemini CLIBuilt, checks passCodex CLIBuilt, checks passClaude CodeDid not build

   Copy

2. Our chatbot keeps telling visitors the Pro plan costs 49 EUR, but the pricing page says 79. Fix it so the two cannot drift apart again.

   No data store

   Copy

3. Last month we renamed /pricing to /plans and added a catalog with a page per integration. Check whether our site assistant still sends people to the right places and tell me what you would change; do not edit anything yet.

   No data store

   Copy

We install the skill into an empty Next.js app, give the agent one of the prompts above and no further help, then type-check, build and run the tests it left behind. Nothing is fixed by hand before the checks, and a failing run is published like a passing one. The procedure and every result are public, and the first prompt runs again before each release.

• Gemini CLI0.63.0

  gemini-3.8-flash

  Built, checks pass

  Our site has a chat assistant; its code is below, save each file at its path first. We just shipped a partners page and the assistant knows nothing about it: people who ask about partnering get sent to sales, and yesterday it told someone they would earn 20%. Teach it about the partner program. // lib/ai/knowledge.ts export type KnowledgeKind = "help" | "page"; export interface KnowledgeDocument { kind: KnowledgeKind; title: string; url: string; summary: string; tags: string[]; content: string; } const DOCS: KnowledgeDocument[] = [ { kind: "help", title: "Booking widget", url: "/help/booking-widget", summary: "Embed a booking calendar on your site.", tags: ["widget", "calendar", "embed"], content: "Paste the script tag before the closing body tag. The widget reads your services and opening hours.", }, { kind: "page", title: "Pricing", url: "/pricing", summary: "Plans and prices.", tags: ["price", "plan", "cost"], content: "Starter: 29 EUR a month. Pro: 79 EUR a month.", }, ]; export function searchKnowledge(locale: string, query: string, limit: number): KnowledgeDocument[] { const tokens = query.toLowerCase().split(/\W+/).filter(Boolean); return DOCS.map((doc) => { const text = `${doc.title} ${doc.tags.join(" ")} ${doc.summary} ${doc.content}`.toLowerCase(); return { doc, score: tokens.filter((t) => text.includes(t)).length }; }) .filter((r) => r.score > 0) .sort((a, b) => b.score - a.score) .slice(0, limit) .map((r) => r.doc); } export function readKnowledgeDocument(locale: string, url: string): KnowledgeDocument | undefined { return DOCS.find((doc) => doc.url === url); } export function getKnowledgePack(locale: string): string { return ["#### SITE MAP", "- Pricing: /pricing", "- Help: /help/booking-widget", "- Talk to sales: /contact"].join("\n"); } // lib/ai/prompts.ts import { getKnowledgePack } from "./knowledge"; export const searchDescription = "Full-text search across the help center and the pricing page."; export function buildSystemPrompt(locale: string): string { return [ "You are Ada, the assistant on our website. Answer questions about our booking software.", "Only discuss booking, pricing and help articles. For anything else, send people to /contact.", "Link pages with relative links.", getKnowledgePack(locale), ].join("\n\n"); } // app/partners/page.tsx const ROLES = [ { name: "Referrer", body: "Introduce a client. We do the setup." }, { name: "Implementer", body: "Set up the booking widget for your client. We review it before it goes live." }, ]; const FAQ = [ { q: "Who can join?", a: "Agencies and freelancers who set up booking for their clients." }, { q: "How are partners paid?", a: "A share of the first year's subscription for every client you bring. The shares are published when the first round opens." }, ]; export default function PartnersPage() { return ( <main> <h1>Partner program</h1> <p>Bring clients to us and get paid for every one.</p> <h2>Roles</h2> <ul> {ROLES.map((role) => ( <li key={role.name}> <strong>{role.name}</strong>: {role.body} </li> ))} </ul> <h2>FAQ</h2> {FAQ.map((item) => ( <details key={item.q}> <summary>{item.q}</summary> <p>{item.a}</p> </details> ))} <p> <a href="/partners/apply">Apply to the program</a> </p> </main> ); }

  Typecheck: passBuild: passTests: pass

  Time

  7 min

  Changed

  13 files, +1,502 lines

  Stack

  No data store

  Skill

  v0.1.0

  Run

  Oct 8, 2026

  Result fileAgent log

• Codex CLIcodex-cli 0.161.0

  gpt-6.1-sol

  Built, checks pass

  Our site has a chat assistant; its code is below, save each file at its path first. We just shipped a partners page and the assistant knows nothing about it: people who ask about partnering get sent to sales, and yesterday it told someone they would earn 20%. Teach it about the partner program. // lib/ai/knowledge.ts export type KnowledgeKind = "help" | "page"; export interface KnowledgeDocument { kind: KnowledgeKind; title: string; url: string; summary: string; tags: string[]; content: string; } const DOCS: KnowledgeDocument[] = [ { kind: "help", title: "Booking widget", url: "/help/booking-widget", summary: "Embed a booking calendar on your site.", tags: ["widget", "calendar", "embed"], content: "Paste the script tag before the closing body tag. The widget reads your services and opening hours.", }, { kind: "page", title: "Pricing", url: "/pricing", summary: "Plans and prices.", tags: ["price", "plan", "cost"], content: "Starter: 29 EUR a month. Pro: 79 EUR a month.", }, ]; export function searchKnowledge(locale: string, query: string, limit: number): KnowledgeDocument[] { const tokens = query.toLowerCase().split(/\W+/).filter(Boolean); return DOCS.map((doc) => { const text = `${doc.title} ${doc.tags.join(" ")} ${doc.summary} ${doc.content}`.toLowerCase(); return { doc, score: tokens.filter((t) => text.includes(t)).length }; }) .filter((r) => r.score > 0) .sort((a, b) => b.score - a.score) .slice(0, limit) .map((r) => r.doc); } export function readKnowledgeDocument(locale: string, url: string): KnowledgeDocument | undefined { return DOCS.find((doc) => doc.url === url); } export function getKnowledgePack(locale: string): string { return ["#### SITE MAP", "- Pricing: /pricing", "- Help: /help/booking-widget", "- Talk to sales: /contact"].join("\n"); } // lib/ai/prompts.ts import { getKnowledgePack } from "./knowledge"; export const searchDescription = "Full-text search across the help center and the pricing page."; export function buildSystemPrompt(locale: string): string { return [ "You are Ada, the assistant on our website. Answer questions about our booking software.", "Only discuss booking, pricing and help articles. For anything else, send people to /contact.", "Link pages with relative links.", getKnowledgePack(locale), ].join("\n\n"); } // app/partners/page.tsx const ROLES = [ { name: "Referrer", body: "Introduce a client. We do the setup." }, { name: "Implementer", body: "Set up the booking widget for your client. We review it before it goes live." }, ]; const FAQ = [ { q: "Who can join?", a: "Agencies and freelancers who set up booking for their clients." }, { q: "How are partners paid?", a: "A share of the first year's subscription for every client you bring. The shares are published when the first round opens." }, ]; export default function PartnersPage() { return ( <main> <h1>Partner program</h1> <p>Bring clients to us and get paid for every one.</p> <h2>Roles</h2> <ul> {ROLES.map((role) => ( <li key={role.name}> <strong>{role.name}</strong>: {role.body} </li> ))} </ul> <h2>FAQ</h2> {FAQ.map((item) => ( <details key={item.q}> <summary>{item.q}</summary> <p>{item.a}</p> </details> ))} <p> <a href="/partners/apply">Apply to the program</a> </p> </main> ); }

  Typecheck: passBuild: passTests: pass

  Time

  2 min

  Changed

  12 files, +1,404 lines

  Stack

  No data store

  Skill

  v0.1.0

  Run

  Oct 8, 2026

  Result fileAgent log

• Claude Code2.1.293

  claude-opus-5-5

  Did not build

  Our site has a chat assistant; its code is below, save each file at its path first. We just shipped a partners page and the assistant knows nothing about it: people who ask about partnering get sent to sales, and yesterday it told someone they would earn 20%. Teach it about the partner program. // lib/ai/knowledge.ts export type KnowledgeKind = "help" | "page"; export interface KnowledgeDocument { kind: KnowledgeKind; title: string; url: string; summary: string; tags: string[]; content: string; } const DOCS: KnowledgeDocument[] = [ { kind: "help", title: "Booking widget", url: "/help/booking-widget", summary: "Embed a booking calendar on your site.", tags: ["widget", "calendar", "embed"], content: "Paste the script tag before the closing body tag. The widget reads your services and opening hours.", }, { kind: "page", title: "Pricing", url: "/pricing", summary: "Plans and prices.", tags: ["price", "plan", "cost"], content: "Starter: 29 EUR a month. Pro: 79 EUR a month.", }, ]; export function searchKnowledge(locale: string, query: string, limit: number): KnowledgeDocument[] { const tokens = query.toLowerCase().split(/\W+/).filter(Boolean); return DOCS.map((doc) => { const text = `${doc.title} ${doc.tags.join(" ")} ${doc.summary} ${doc.content}`.toLowerCase(); return { doc, score: tokens.filter((t) => text.includes(t)).length }; }) .filter((r) => r.score > 0) .sort((a, b) => b.score - a.score) .slice(0, limit) .map((r) => r.doc); } export function readKnowledgeDocument(locale: string, url: string): KnowledgeDocument | undefined { return DOCS.find((doc) => doc.url === url); } export function getKnowledgePack(locale: string): string { return ["#### SITE MAP", "- Pricing: /pricing", "- Help: /help/booking-widget", "- Talk to sales: /contact"].join("\n"); } // lib/ai/prompts.ts import { getKnowledgePack } from "./knowledge"; export const searchDescription = "Full-text search across the help center and the pricing page."; export function buildSystemPrompt(locale: string): string { return [ "You are Ada, the assistant on our website. Answer questions about our booking software.", "Only discuss booking, pricing and help articles. For anything else, send people to /contact.", "Link pages with relative links.", getKnowledgePack(locale), ].join("\n\n"); } // app/partners/page.tsx const ROLES = [ { name: "Referrer", body: "Introduce a client. We do the setup." }, { name: "Implementer", body: "Set up the booking widget for your client. We review it before it goes live." }, ]; const FAQ = [ { q: "Who can join?", a: "Agencies and freelancers who set up booking for their clients." }, { q: "How are partners paid?", a: "A share of the first year's subscription for every client you bring. The shares are published when the first round opens." }, ]; export default function PartnersPage() { return ( <main> <h1>Partner program</h1> <p>Bring clients to us and get paid for every one.</p> <h2>Roles</h2> <ul> {ROLES.map((role) => ( <li key={role.name}> <strong>{role.name}</strong>: {role.body} </li> ))} </ul> <h2>FAQ</h2> {FAQ.map((item) => ( <details key={item.q}> <summary>{item.q}</summary> <p>{item.a}</p> </details> ))} <p> <a href="/partners/apply">Apply to the program</a> </p> </main> ); }

  Typecheck: passBuild: passTests: pass

  Time

  4 min

  Changed

  0 files, +0 lines

  Stack

  No data store

  Skill

  v0.1.0

  Run

  Oct 8, 2026

  Result fileAgent log