AI Prompts
Curated prompts for AI coding assistants to help you integrate KalimaLab into your projects faster.
These prompts are designed to give AI coding assistants the right context about KalimaLab's API so they can generate accurate integration code. Copy them into your project's AI instructions file or paste them directly into your assistant.
Where to Place Prompts
Each AI coding tool reads instructions from a specific file in your project root:
| Tool | File |
|---|---|
| Cursor | .cursor/rules/*.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Claude Code | CLAUDE.md |
| Windsurf | guidelines.md |
| Codex | AGENTS.md |
| Gemini CLI | GEMINI.md |
✓Universal approach
Curated Prompts
Arabic Word Search Integration
Use this prompt when building search interfaces that query Arabic words.
# Arabic Word Search IntegrationYou are integrating KalimaLab's Arabic Words API for word search functionality.## API Details- Base URL: https://api.kalimalab.dev/v1- Auth: x-api-key header with klmt_ prefixed key- Endpoint: GET /words?q={query}&limit={limit}&offset={offset}## Requirements- Implement debounced search (300ms) to avoid excessive API calls- Display results in RTL layout with dir="rtl" on the container- Show word, root, pattern, and English meaning for each result- Handle pagination with limit/offset query params- Show loading skeleton while fetching- Handle empty states and API errors gracefully- Cache results for repeated queries using a Map or TanStack QueryArabic Text Analysis
Use this prompt for features that analyze Arabic text content.
# Arabic Text AnalysisYou are building a text analysis feature using KalimaLab's API.## API Details- Base URL: https://api.kalimalab.dev/v1- Auth: x-api-key header with klmt_ prefixed key- Endpoint: POST /text/analyze- Body: { "text": "Arabic text here" }## Response includes- word_count: total words in the text- unique_words: number of distinct words- words: array of identified words with root and pattern info## Requirements- Accept Arabic text input via a textarea with dir="rtl"- Display statistics: total words, unique words, characters- Show a breakdown table of identified words with their roots- Highlight words in the original text when hovering over results- Handle texts up to 5000 charactersRTL UI with Arabic API
Use this prompt to ensure correct right-to-left layout when displaying Arabic data.
# RTL UI with Arabic APIYou are building a UI that displays Arabic language data from KalimaLab.## API Details- Base URL: https://api.kalimalab.dev/v1- Auth: x-api-key header with klmt_ prefixed key## RTL Guidelines- Set dir="rtl" on containers displaying Arabic text- Use logical CSS properties: ps/pe (padding), ms/me (margin), start/end- Use Tailwind RTL modifiers: rtl:rotate-180 for directional icons- Arabic text should use a system Arabic font stack: font-family: "IBM Plex Sans Arabic", "Noto Sans Arabic", system-ui- Mix LTR (code, English) and RTL (Arabic) with proper isolation: use <bdi> or unicode-bidi: isolate for mixed-direction content- Test with both LTR and RTL layoutsKalimaLab MCP Integration
Use this prompt to give your AI assistant full knowledge of all 7 MCP tools and their parameters.
# KalimaLab MCP IntegrationYou have access to the KalimaLab MCP server with the following tools:## Available Tools### search_wordsSearch Arabic words by query string.Params: q (string, required), limit (number), offset (number)### get_wordGet detailed information about a specific word.Params: id (string, required)### get_daily_wordGet the Arabic word of the day.Params: none### get_random_wordsGet random Arabic words for quizzes or discovery.Params: count (number)### analyze_textAnalyze Arabic text for word composition and statistics.Params: text (string, required)### validate_wordsCheck if given strings are valid Arabic words.Params: words (string[], required)### get_statsGet API statistics including total words, roots, and patterns.Params: none## Usage Notes- All responses follow { data, error, meta } envelope format- Arabic text is returned in UTF-8 encoding- Rate limits: check x-ratelimit-* response headersArabic Vocabulary App
Use this prompt when building vocabulary learning or flashcard applications.
# Arabic Vocabulary AppYou are building a vocabulary learning app with KalimaLab's API.## API Details- Base URL: https://api.kalimalab.dev/v1- Auth: x-api-key header with klmt_ prefixed key## Key Endpoints- GET /words/daily — word of the day- GET /words/random?count=10 — random words for quizzes- GET /words/:id — word details (root, pattern, meaning)- GET /words?q={query} — search for specific words- GET /roots — list all Arabic roots- GET /roots/:id — root details with derived words## Features to Implement- Daily word card with pronunciation, root, and meaning- Flashcard mode using random words endpoint- Quiz mode: show Arabic word, pick correct English meaning- Progress tracking with localStorage or a database- Bookmark/favorite words for review- Root explorer: show all words derived from a root- Use spaced repetition algorithm for review scheduling