ai-assistant

Safely change the schema AI assistant, cloud or local providers, credentials, context construction, streamed patches, retries, validation, or atomic diagram application. Use for AI chat and provider work.

Jump to install

Repository: AHS12/thoth-blueprint
Last source activity: August 11, 2026 at 17:59
Detected SKILL.md language: English
Stars: 623
Forks: 53

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/AHS12/thoth-blueprint --skill ai-assistant

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

diagram-editor

Safely change the React Flow database diagram editor, including table, note, zone, relationship, selection, locking, layout, keyboard, and viewport behavior. Use when changing editor components or diagram mutations.

2026-08-11

import-export

Change SQL, SQLite worker, DBML, JSON, Mermaid, SVG, or database export/import flows while preserving diagram semantics and round trips. Use when adding dialect support or changing parser/exporter behavior.

2026-08-11

migration-codegen

Change Laravel, TypeORM, or Django migration generation and generated SQL parsing. Use when modifying framework code generation, foreign keys, indexes, naming, or migration artifacts.

2026-08-11

View all from this repository

AI Assistant

Read First

src/components/AiChatTab.tsx and src/components/AiProvidersDialog.tsx for UI behavior.

src/lib/ai/buildDiagramContext.ts for context scope and truncation.

src/lib/ai/diagramAssistantInstruction.ts for the model contract.

src/lib/ai/diagramPatchSchema.ts and src/lib/ai/diagramPatchJsonSchema.ts for the patch contract.

src/lib/ai/simulateAiPatch.ts and src/store/store.ts for validation and commit behavior.

src/lib/ai/aiCredentialStorage.ts for credential handling.

Change Rules

Preserve the pipeline: provider request -> streamed response -> parse -> Zod validation -> simulation on a clone -> atomic store commit.

Never apply raw model output or a partially simulated patch. Return an actionable error and leave the current diagram unchanged on failure.

Resolve references with the existing ID/name rules and handle duplicate names deliberately.

Preserve locked diagram and locked zone protections in both direct store actions and AI simulation.

Keep cloud and local providers distinct. Cloud providers receive diagram context; Ollama and LM Studio are intended for local keyless use and may require local CORS configuration.

Never log API keys, decrypted credentials, session secrets, or full schema context. Avoid expanding context beyond what the user selected or the feature requires.

Preserve retry and cancellation behavior for transient provider failures without duplicating a committed patch.

Verification

Test valid patches, malformed JSON, schema-invalid operations, simulation failures, duplicate references, locked diagrams, and streamed/retried responses.

Verify provider setup does not expose secrets in logs or UI errors.

Confirm chat history remains scoped to the selected diagram and persists after reload.

Run the standard type-check, lint, and production build gate.

AI Assistant

Read First

src/components/AiChatTab.tsx and src/components/AiProvidersDialog.tsx for UI behavior.

src/lib/ai/buildDiagramContext.ts for context scope and truncation.

src/lib/ai/diagramAssistantInstruction.ts for the model contract.

src/lib/ai/diagramPatchSchema.ts and src/lib/ai/diagramPatchJsonSchema.ts for the patch contract.

src/lib/ai/simulateAiPatch.ts and src/store/store.ts for validation and commit behavior.

src/lib/ai/aiCredentialStorage.ts for credential handling.

Change Rules

Preserve the pipeline: provider request -> streamed response -> parse -> Zod validation -> simulation on a clone -> atomic store commit.

Never apply raw model output or a partially simulated patch. Return an actionable error and leave the current diagram unchanged on failure.

Resolve references with the existing ID/name rules and handle duplicate names deliberately.

Preserve locked diagram and locked zone protections in both direct store actions and AI simulation.

Keep cloud and local providers distinct. Cloud providers receive diagram context; Ollama and LM Studio are intended for local keyless use and may require local CORS configuration.

Never log API keys, decrypted credentials, session secrets, or full schema context. Avoid expanding context beyond what the user selected or the feature requires.

Preserve retry and cancellation behavior for transient provider failures without duplicating a committed patch.

Verification

Test valid patches, malformed JSON, schema-invalid operations, simulation failures, duplicate references, locked diagrams, and streamed/retried responses.

Verify provider setup does not expose secrets in logs or UI errors.

Confirm chat history remains scoped to the selected diagram and persists after reload.

Run the standard type-check, lint, and production build gate.

name	ai-assistant
description	Safely change the schema AI assistant, cloud or local providers, credentials, context construction, streamed patches, retries, validation, or atomic diagram application. Use for AI chat and provider work.

ai-assistant

Source facts

Install options

Review the source files

More from this repository

More from this repository

AI Assistant

Read First

Change Rules

Verification

AI Assistant

Read First

Change Rules

Verification