v1.0.0 to v2.0.0

---

name: synthesis-llm-setup

description: "Guide for setting up and configuring LLM projects across platforms. Use when setting up a Claude Project, creating a ChatGPT GPT, configuring a Gemini Gem, setting up an AI assistant with custom instructions and knowledge, or configuring any LLM platform with AI Knowledge content."

license: "CC0-1.0"

depends_on: []

metadata:

author: "Rajiv Pant"

source_repo: "github.com/synthesisengineering/synthesis-skills"

source_type: "public"

---

# LLM Setup

Configure Claude Projects, ChatGPT GPTs, Gemini Gems, and other LLM platforms using compiled AI Knowledge content from the ragbot system.

## Configuration

These values are user-specific. Update them for your environment.

| Setting | Value | Description |

|---------|-------|-------------|

| `ai_knowledge_repo` | `ai-knowledge-{name}/` | Your ai-knowledge repository root |

| `compiled_instructions_path` | `compiled/{project}/instructions/` | Path to LLM-specific compiled instructions |

| `knowledge_file` | `all-knowledge.md` | Concatenated knowledge file (auto-generated by CI/CD) |

| `source_dir` | `source/` | Directory to edit directly (knowledge concatenation is automatic) |

## Architecture overview

The AI Knowledge system produces platform-specific content for each LLM's project/custom instruction system.

| Operation | Where | When |

|-----------|-------|------|

| Knowledge concatenation (`all-knowledge.md`) | CI/CD (GitHub Actions) | Every push to `source/` |

| Instruction compilation | Local (`ragbot compile`) | When instructions change (rare) |

| RAG indexing | Local (`ragbot index`) | When content changes and RAG is needed |

## Output structure

```

ai-knowledge-{name}/

├── compiled/

│ └── {project}/

│ └── instructions/ # LLM-specific custom instructions

│ ├── claude.md

│ ├── chatgpt.md

│ └── gemini.md

└── all-knowledge.md # Concatenated knowledge (auto-generated by CI/CD)

```

**Key principle:** Edit `source/` files directly. Knowledge concatenation is automatic.

**Knowledge delivery strategy:**

- Claude: GitHub sync the repo (Claude reads `all-knowledge.md` directly)

- ChatGPT: Upload `all-knowledge.md`

- Gemini: Upload `all-knowledge.md` (works within the 10-file Gem limit)

## Step-by-step workflow

1. **Compile instructions** (only if instructions changed):

```bash

ragbot compile --project {name} --no-llm

```

2. **For each project** (e.g., client-a):

- **Claude**: Create project, copy `compiled/client-a/instructions/claude.md` to custom instructions, GitHub sync the repo

- **ChatGPT**: Create GPT, copy `compiled/client-a/instructions/chatgpt.md` to instructions, upload `all-knowledge.md`

- **Gemini**: Create Gem, copy `compiled/client-a/instructions/gemini.md` to instructions, upload `all-knowledge.md`

3. **Verify** by testing each project with a representative query.

## Updating projects

### When to update

**Knowledge (all-knowledge.md):** Updates automatically via CI/CD on every push to `source/`. No manual step.

**Instructions:** Recompile only when instructions change (rare):

```bash

ragbot compile --project {name} --force

```

**LLM sync:**

- Claude: GitHub sync auto-updates

- ChatGPT/Gemini: Re-upload `all-knowledge.md` after source changes