CommunityCodierung & Entwicklunggithub.com

typesense-docs

Tücken, überraschende Standardwerte und empfohlene Muster der Typesense-Suchmaschine, destilliert aus der offiziellen Dokumentation. Verwenden Sie diese beim Entwerfen eines Typesense-Collection-Schemas, beim Schreiben von Suchparametern, beim Tuning der Tipptoleranz und des Rankings, beim Aufbau von Vektor-, semantischer oder hybrider Suche, konversationellem RAG und vielem mehr.

Was ist typesense-docs?

Dieses Skill bündelt die entscheidenden, aber leicht übersehenen Details der offiziellen Typesense-Dokumentation, die für den erfolgreichen Einsatz der Suchmaschine unerlässlich sind. Es deckt eine breite Palette von Themen ab, darunter Schema-Design mit RAM-Bewusstsein, Importfallen (immer HTTP 200, Fehler in Ergebniszeilen), Filter-Priorität, Hybrid Search-Gewichtung, die neuen Synonym- und Kurations-Sets (v30) und die korrekte Verwendung von Scoped Search Keys für Multi-Tenancy. Das Skill enthält eine Kurzanleitung mit den wichtigsten Regeln, detaillierte Referenzdateien zu spezifischen Domänen und eine Tabelle mit alten und aktuellen Mustern zur Migration. Jede Behauptung ist mit der Quell-URL aus der offiziellen Doku verknüpft, sodass Entwickler Details direkt nachvollziehen können. Es ist optimiert für Typesense Server 30.2 und den JavaScript-Client und spart wertvolle Zeit, da es häufige Fehler und nicht offensichtliche Konfigurationen aufzeigt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/quentin-autret/claude-skills/tree/main/skills/typesense-docs

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Typesense aus der offiziellen Dokumentation

Übersicht

Dieses Skill enthält, was die Typesense-Dokumentation sagt, aber leicht falsch verstanden werden kann: Was RAM kostet, Import-Ergebnisse, die Fehler hinter HTTP 200 verstecken, Filter-Priorität, Standardwerte, die Ergebnisse aufweichen, Lecks bei Scoped Search Keys, Hybrid Search-Gewichtung und den Wechsel zu Synonym-Sets und Kurations-Sets in v30. Allgemeine Such- und Datenbankhinweise bleiben außen vor. Jede Behauptung enthält die URL der Dokumentation, aus der sie stammt.

Abgedeckte Version

Typesense Server 30.2, mit dem JavaScript-Client für Codebeispiele. Server-Flags gelten für selbst gehostete Server. Typesense Cloud verwaltet sie. Bevor Sie Code für einen älteren Server überprüfen, lesen Sie „Alte Muster“ weiter unten.

Navigation

  1. Lesen Sie die Kurzanleitung unten. Sie behandelt die Regeln, die bei den meisten Aufgaben wichtig sind.
  2. Öffnen Sie die eine Referenzdatei, deren Bereich zur Aufgabe passt, aus der Tabelle am Ende. Jede Datei steht für sich.
  3. Jede Behauptung endet mit ihrer Quell-URL. Rufen Sie sie erneut auf, wenn ein Detail über das Ergebnis entscheidet.

Kurzanleitung

Schema und Speicher

Daten schreiben

Suchen

Vektor- und KI-Suche

Schlüssel und Multi-Tenancy

Betrieb

Alte Muster

AltAktuellQuelle
/collections/{c}/synonyms, synonyms:*-Schlüsselaktionen/synonym_sets, synonym_sets:* und synonym_sets/items:*, verknüpft durch Collection synonym_setshttps://typesense.org/docs/30.2/api/synonyms.html
/collections/{c}/overrides, overrides:*/curation_sets, curation_sets:* und curation_sets/items:*https://typesense.org/docs/30.2/api/curation.html
override_tagscuration_tagshttps://typesense.org/docs/30.2/api/curation.html
Analytics-Regeln mit params.source und params.destinationTop-Level collection, event_type, flache paramshttps://typesense.org/docs/30.2/api/analytics-query-suggestions.html
eine Counter-Regel mit gewichteten source.eventseine Regel pro Ereignistyp mit params.weighthttps://typesense.org/docs/30.2/api/analytics-query-suggestions.html
exaktes found mit group_byungefähr, group_max_candidates für Genauigkeithttps://typesense.org/docs/30.2/api/search.html
LLM-Aufruf in der App zum Erstellen von Filternnl_search_models + nl_query=truehttps://typesense.org/docs/guide/natural-language-search.html
abgeflachte verschachtelte Objekteenable_nested_fieldshttps://typesense.org/docs/guide/tips-for-searching-common-types-of-data.html
eine Collection mit document_type für eine gemischte Listemulti_search mit union: truehttps://typesense.org/docs/guide/faqs.html
altes highlights-Arrayhighlight-Objekt, enable_highlight_v1=falsehttps://typesense.org/docs/30.2/api/search.html

Schlüssel können nicht aktualisiert werden: Ersetzen Sie alte Schlüssel durch Erstellen neuer. Selbst gehostete Server erstellen vor dem Upgrade einen Snapshot, damit Synonyme und Overrides migrieren. https://typesense.org/docs/30.2/api/synonyms.html

Referenzdateien

DateiLesen Sie sie für
references/schema-and-collections.mdFeldparameter und Standardwerte, Typen, RAM-Kosten, Auto-Schema, verschachtelte Objekte, Alter, Aliase, Clone, Collection-Layout
references/tokenization-locale-stemming.mdtoken_separators, symbols_to_index, Infix, SKU-, E-Mail- und URL-Rezepte, Locale und Diakritika, Stemming-Wörterbücher
references/documents-and-import.mdIDs, Import-Aktionen, Lesen von Import-Ergebnissen, Timeouts, dirty_values, Update, Delete und Export per Abfrage
references/syncing-and-reindexing.mdSync-Strategien aus einer Datenbank, hochvolumige Schreibvorgänge, 503- und Ressourcenfehler, Alias-Neuindizierung
references/search-parameters.mdq, query_by, Tipptoleranz, Token-Dropping, Präfix, max_candidates, Highlighting, Paginierung, Cache, Presets
references/filtering-and-geo.mdfilter_by-Syntax, Priorität, Escaping, Arrays, verschachtelte Objekte, leere Werte, Geo-Filter und -Sortierungen
references/ranking-and-sorting.mdStandard-Ranking, sort_by, text_match_type, Buckets, _eval, Abklingung, fehlende Werte, Anpinnen
references/faceting-grouping-multi-search.mdFacetten und Strategien, group_by, föderierte und Union-Multi-Search, boolesche Tag-Suche
references/synonyms-curation-stopwords.mdSynonym-Sets, Kurations-Sets, Tags, dynamische Regeln, Kuration mit Scoped Search Keys, Stoppwörter
references/vector-and-hybrid-search.mdVektorfelder, Auto-Embedding-Modelle, vector_query, Hybrid-Fusion und alpha, HNSW, Speicher
references/conversational-nl-image-voice.mdRAG-Konversationsmodelle, natürlichsprachliche Suche, Bild- und Sprachabfragen, Empfehlungen
references/api-keys-and-access-control.mdSchlüsseltypen, Aktionen, Scope-Fallstricke, Scoped Search Keys, Multi-Tenancy-Muster, Rotation
references/clients-and-errors.mdClient-Bibliotheken, Knoten- und Load-Balancer-Konfiguration, JS-Tuning, Cache, Fehlercodes, langsame Suchen
references/server-configuration.mdServer-Flags und Standardwerte, CORS, TLS, Logging, Ressourcengrenzen, Analytics-Flags, Installationshinweise
references/cluster-ha-backups-upgrades.mdHA-Cluster, Nodes-Datei, Recovery, Operations-API, Monitoring, Backups, Upgrades, Dimensionierung, CI
references/analytics-and-query-suggestions.mdAnalytics-Regeln und Ereignisse, beliebte und Null-Treffer-Abfragen, Counter, Log-Regeln, Vorschläge
references/joins-and-personalization.mdReferenzfelder, gejointe Includes, Filter und Sortierungen, Left- und Anti-Joins, asynchrone Referenzen, Personalisierung
references/ui-and-algolia-migration.mdInstantSearch-Adapter, Algolia-Unterschiede, Konzeptabbildung, Migrationsschritte

Quellen und Abrufdetails sind in SOURCES.md aufgelistet.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

eslint-docs

Teaches current ESLint 10 practices drawn from the official documentation. Use when writing, reviewing or fixing an eslint.config.js (flat config, defineConfig, files, ignores, globalIgnores, extends, languageOptions, globals, parsers, processors), configuring ESLint rules and severities, disable comments and inline config, running the CLI in CI (--fix, --cache, --quiet, --max-warnings, bulk suppressions, formatters, feature flags, MCP server), writing custom rules (meta, schema, fixes, suggestions, selectors, scope, code paths) and testing them with RuleTester, building plugins, shareable configs, custom parsers, processors or formatters, using the Node.js API (ESLint, Linter), or migrating to ESLint 9 or 10 from eslintrc. Triggers on eslint, eslint.config.js, flat config, .eslintrc, .eslintignore, @eslint/js, js/recommended, eslint-disable, no-unused-vars, no-restricted-imports, no-restricted-syntax, RuleTester, eslint-plugin, eslint-config, FlatCompat, context.getScope is not a function, ESLint 10.

grafana-cloud-docs

Grafana Cloud pitfalls, defaults, limits and current patterns from the Grafana, Mimir, Loki and Tempo docs, each tied to its docs URL. Use when sending OpenTelemetry data to Grafana Cloud, writing PromQL, LogQL or TraceQL, controlling cardinality and cost, designing alert rules, routing notifications, provisioning alerting, building Synthetic Monitoring checks, using the /apis dashboard API, choosing access policy tokens or service accounts, or migrating off API keys, the Loki Exporter and legacy /api routes.

javascript-docs

Teaches current JavaScript (ECMAScript) practice drawn from the MDN JavaScript documentation. Use when writing, reviewing or fixing modern JavaScript, choosing a built-in API, or replacing a deprecated pattern. Covers equality and coercion, let/const and the temporal dead zone, strict mode, ASI, functions, classes and private fields, objects, prototypes, Proxy, Reflect, Symbol, eval, operators (??, ?., spread, BigInt arithmetic), statements, Promise, async/await, Promise.try, iterators and iterator helpers, generators, using/await using, DisposableStack, WeakRef, Array (toSorted, at, groupBy, fromAsync), Map, Set methods, WeakMap, strings and Unicode, encodeURIComponent, RegExp (v flag, RegExp.escape, lastIndex), Number, Math, BigInt, JSON (rawJSON, revivers), typed arrays, ArrayBuffer, base64, SharedArrayBuffer, Atomics, Temporal, Date, Intl (DateTimeFormat, NumberFormat, Collator, Segmenter, PluralRules), errors (cause, Error.isError), ES modules, import attributes, import.meta, dynamic import.

next-intl-docs

Teaches current next-intl 4 practices for internationalizing Next.js apps, drawn from the official documentation. Use when setting up next-intl with the App Router, writing i18n/request.ts, adding a [locale] segment with defineRouting, createMiddleware in proxy.ts (formerly middleware.ts), building locale switchers with createNavigation, translating with useTranslations or getTranslations, passing messages to NextIntlClientProvider, writing ICU messages (plurals, select, rich text), formatting dates, numbers and lists with useFormatter, translating metadata, Server Actions, Route Handlers, localized 404 and error pages, static rendering with next/root-params, type-safe messages through AppConfig, testing with Jest, Vitest, Storybook, or extracting inline messages with useExtracted. Triggers on next-intl, useTranslations, getTranslations, NextIntlClientProvider, getRequestConfig, i18n routing, locale prefix, localePrefix, NEXT_LOCALE, hreflang, setRequestLocale, ICU messages, App Router internationalization.

nodejs-docs

Teaches Node.js practice drawn from the official Node.js API documentation, with pitfalls, surprising defaults, deprecations and replacements, each backed by its nodejs.org URL. Use when writing, reviewing, debugging or upgrading Node.js code, or choosing a built-in module (fs, crypto, streams, http, process, CLI flags, node:test, ESM/CommonJS, package.json exports, TypeScript type stripping, child_process, worker_threads, node:sqlite, deprecations).

playwright-docs

Pitfalls, surprising defaults and recommended patterns of Playwright Test for JavaScript and TypeScript, distilled from the official docs. Use when writing, reviewing, debugging or configuring Playwright tests (@playwright/test, playwright.config.ts, npx playwright test), including flaky tests, locators (getByRole, filter, strict mode), web-first assertions (expect, toHaveText, toBeVisible, expect.poll, toPass), fixtures, storageState authentication, project dependencies, timeouts, retries, network mocking (page.route, routeFromHAR, routeWebSocket), API testing, clock, aria snapshots, toHaveScreenshot, axe accessibility scans, traces, UI mode, reporters, CI, Docker, sharding, test locks, component testing with stories and mount, codegen, Playwright MCP, playwright-cli and migration from Puppeteer, Protractor, Testing Library or older Playwright versions.

postgresql-docs

Pitfalls, surprising defaults, PostgreSQL 18 changes and recommended patterns from the official PostgreSQL 18 documentation, each backed by its postgresql.org URL. Use when writing or reviewing PostgreSQL SQL, schema design, migrations and ALTER TABLE locks, indexes, transactions, isolation levels and retries, locking, upsert and MERGE, COPY, JSONB, timestamptz, generated and identity columns, partitioning, EXPLAIN, vacuum, roles, row-level security, PL/pgSQL, full-text search, connection settings, and upgrades to PostgreSQL 18.

react-docs

Writes, reviews and upgrades React 19.3 code from the official react.dev documentation. Use when writing components and Hooks, removing unnecessary useEffect calls, fixing Effect dependencies with useEffectEvent, building forms with Actions (useActionState, useOptimistic, useFormStatus, form action), using Server Components, 'use client', 'use server' and Server Functions, Suspense, use(), useTransition, useDeferredValue, ViewTransition, Activity, adopting React Compiler and eslint-plugin-react-hooks, deciding on useMemo, useCallback and memo, server rendering and hydration (createRoot, hydrateRoot, renderToPipeableStream, prerender), or migrating from React 18 (forwardRef, Context.Provider, ReactDOM.render, propTypes, defaultProps). Triggers on React, JSX, hooks, useState, useEffect, useRef, useContext, Server Components, RSC, Actions, React Compiler, Strict Mode, hydration mismatch, React 19 upgrade.

rust-std-docs

Gives current guidance from the official Rust standard library docs (std 1.99.1 stable) on pitfalls, panics, platform differences, discouraged APIs and newer stable replacements. Use when writing, reviewing or refactoring Rust code that uses std, especially collections (Vec, HashMap, BTreeMap, BinaryHeap, entry, extract_if, sort), Option/Result/error handling (expect, ?, Error, ExitCode, panic), iterators (collect, flatten, Peekable, try_fold), Box/Rc/RefCell/Cow/Pin/mem::take, Arc/Mutex/RwLock/OnceLock/LazyLock/thread::scope/mpsc/Condvar/atomics, String/str/fmt/format!/OsString/CString, io/fs/path (BufWriter, OpenOptions, PathBuf::join), process/env/net/time (Command, set_var, TcpStream, Instant, Duration), From/TryFrom/AsRef/Ord/Drop/Deref/Clone, and unsafe raw pointers, MaybeUninit, transmute, NonNull or integer overflow and float ordering.

socketio-docs

Builds, configures and debugs Socket.IO 4.8 servers and clients from the official Socket.IO v4 documentation. Use when writing a Node.js Socket.IO server (Express, Fastify, Koa, Bun, uWebSockets.js) or a socket.io-client app, emitting events with acknowledgements, timeout() and emitWithAck, broadcasting to rooms and namespaces, authenticating in middleware with the auth option, configuring CORS, reverse proxies and sticky sessions, scaling with the Redis, Redis Streams, Postgres, MongoDB or Cluster adapter, enabling connection state recovery and delivery guarantees, tuning reconnection, writing tests, troubleshooting connection issues, or migrating from Socket.IO v2 or v3. Triggers on Socket.IO, socket.io, socket.io-client, io(), new Server, emit, emitWithAck, acknowledgements, rooms, namespaces, broadcast, io.use, middleware, CORS, Redis adapter, sticky sessions, connection state recovery, reconnection, connect_error, Session ID unknown. Not for plain WebSocket servers such as ws without Socket.IO.

tailwindcss-docs

Teaches current Tailwind CSS v4 practices drawn from the official documentation. Use for any task that touches Tailwind CSS v4, even a small one, because many v3 habits silently break in v4. Use when writing or reviewing Tailwind CSS v4 code (utility classes, variants, arbitrary values, theme variables in @theme, @utility, @custom-variant, @apply, @reference, @source), setting up Tailwind in a framework or build tool (Vite plugin, PostCSS plugin, CLI, Next.js, SvelteKit, Nuxt, Angular, Laravel, Rails), customizing the theme (colors, fonts, breakpoints, spacing, animations), building dark mode with a class or data attribute, or migrating a project from Tailwind v3 (tailwind.config.js, @tailwind directives, darkMode class, safelist, bg-opacity, renamed shadow and outline utilities). Triggers on tailwindcss, @import "tailwindcss", @tailwindcss/vite, @tailwindcss/postcss, @tailwindcss/cli, @theme, @custom-variant dark, npx @tailwindcss/upgrade, upgrade to Tailwind v4.

tauri-docs

Tauri 2 apps, tauri.conf.json, capabilities and permissions, commands and invoke, events and channels, plugins, bundling, signing and the updater, migration from Tauri 1. Guides Tauri 2 work from the official v2 documentation, including scopes, managed state, plugin authoring, CSP and the isolation pattern, testing and debugging, Linux, Windows and macOS packages, and mobile and store releases. Use when writing or reviewing a Tauri 2 app, adding a plugin or a capability, fixing a "not allowed" or "forbidden path" error, wiring IPC between Rust and the webview, packaging, signing or publishing a desktop or mobile build, or upgrading a Tauri 1 or 2.0 beta project.

tokio-docs

Gives current guidance from the official tokio documentation (tokio 1.54.1) on async Rust pitfalls, cancel safety, blocking code, surprising defaults and deprecated APIs. Use when writing, reviewing or debugging async Rust code that uses tokio, especially the runtime (#[tokio::main], #[tokio::test], Builder, enable_all, block_on, current_thread, LocalRuntime, shutdown, feature flags), tasks (spawn, JoinHandle, JoinSet, abort, spawn_blocking, block_in_place, LocalSet, spawn_local, task_local), select!, join!, try_join!, cancellation and graceful shutdown, sync primitives (Mutex across .await, RwLock, Semaphore, Notify, OnceCell), channels (mpsc backpressure, oneshot, broadcast lag, watch), time (sleep, interval, MissedTickBehavior, timeout, paused time, start_paused), I/O and networking (AsyncReadExt, BufWriter flush, split, io::copy, framing, TcpListener, TcpStream, UdpSocket), tokio::fs, process (Command, kill_on_drop, Child), signals (ctrl_c, Windows console events) and Windows named pipes.

typescript-docs

Configures, writes and upgrades TypeScript 6.0 code and tsconfig.json from the official TypeScript documentation. Use when upgrading from TypeScript 5.x to 6.0 (strict, types, rootDir, baseUrl, moduleResolution node, target es5, outFile, esModuleInterop), choosing module and moduleResolution, writing package.json exports and imports, fixing ESM and CommonJS interop, enabling verbatimModuleSyntax or erasableSyntaxOnly, setting up project references and tsc --build, writing .d.ts files, checking JavaScript with JSDoc, or debugging narrowing, generics, mapped types, decorators and enums. Triggers on TypeScript, tsc, tsconfig, TS5112, ignoreDeprecations, nodenext, bundler, .d.ts, @ts-check, TypeScript 6 upgrade.

vite-docs

Teaches current Vite 8 practices drawn from the official documentation. Use when writing or fixing a vite.config, migrating from Vite 7 (Rolldown and Oxc replacing Rollup and esbuild), configuring the dev server, proxy or HMR, handling import.meta.env and modes, tuning the production build, library mode, SSR, writing a Vite plugin, using the HMR or JavaScript API, or the Environment API. Triggers on vite.config, defineConfig, rolldownOptions, import.meta.env, loadEnv, optimizeDeps, ssrLoadModule, ModuleRunner, this.environment, upgrade to Vite 8.

vitest-docs

Teaches current Vitest 5 practices drawn from the official documentation. Use when writing, reviewing or fixing Vitest tests (test, describe, expect, test.for, fixtures with test.extend, hooks, snapshots), mocking with vi (vi.fn, vi.spyOn, vi.mock, vi.when, fake timers, stubGlobal, stubEnv), configuring vitest.config or projects, choosing an environment or pool, filtering and running tests in CI, measuring coverage with v8 or istanbul, debugging slow or flaky suites, testing components in browser mode with Playwright, or migrating from Jest, Mocha or Vitest 4. Triggers on vitest, vi.mock, vi.fn, vitest.config, toMatchSnapshot, expect.poll, coverage thresholds, browser mode, @vitest/browser-playwright, jsdom, happy-dom, migrate Jest to Vitest, upgrade Vitest 5.

Verwandte Skills

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More Codierung & Entwicklung skills