Skip to content

Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base

add hints about customization skills

Hugo Richard48f9cbcc64e4
diff --git a/AGENTS.md b/AGENTS.md
index 9d98538..b7342bc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -30,3 +30,15 @@ savoir/
- [Sources](docs/SOURCES.md) - Content sources configuration
- [Coding Guidelines](docs/CODING-GUIDELINES.md) - Code style, patterns
- [Environment](docs/ENVIRONMENT.md) - Environment variables
+- [Customization](docs/CUSTOMIZATION.md) - How to customize the instance
+
+## Local Skills (`.agents/skills/`)
+
+Project-specific guides for AI-assisted customization. When the user asks to add a tool, source, bot adapter, or rename the project, follow the corresponding skill:
+
+| Skill | File | Use when |
+|-------|------|----------|
+| Add Tool | `add-tool.md` | Adding a new AI SDK tool |
+| Add Source | `add-source.md` | Adding a GitHub/YouTube knowledge source |
+| Add Bot Adapter | `add-bot-adapter.md` | Adding a new platform (Slack, Linear, etc.) |
+| Rename Project | `rename-project.md` | Renaming the project from "Savoir" |
diff --git a/README.md b/README.md
index 30f6727..073a1ca 100644
--- a/README.md
+++ b/README.md
@@ -166,6 +166,8 @@ Savoir is designed as a **reusable template**. See the [Customization Guide](./d
- Theme the UI
- Deploy to production
+**AI-assisted customization:** The project includes local skills in [`.agents/skills/`](./.agents/skills) (add-tool, add-source, add-bot-adapter, rename-project). You can delegate these tasks to an AI agent — e.g. *"Follow the rename-project skill to rename this to MyDocs"* — instead of doing them manually.
+
## Configuration
Sources are managed through the **admin interface** at `/admin`. You can add GitHub repositories and YouTube channels as knowledge sources, then trigger a sync from the UI.
diff --git a/docs/CUSTOMIZATION.md b/docs/CUSTOMIZATION.md
index 4614780..7b818a0 100644
--- a/docs/CUSTOMIZATION.md
+++ b/docs/CUSTOMIZATION.md
@@ -4,6 +4,21 @@
Savoir is designed as a reusable template. This guide covers how to customize your instance.
+## AI-Assisted Customization (Agent Skills)
+
+Savoir includes **local project skills** in `.agents/skills/` that guide an AI agent (e.g. Cursor, Claude Code) through common customization tasks. Instead of manually following each step, you can delegate the migration to an agent by referencing these skills.
+
+| Skill | File | Purpose |
+|-------|------|---------|
+| **Add Tool** | `add-tool.md` | Add a new AI SDK tool to the agent (generator pattern, status yields) |
+| **Add Source** | `add-source.md` | Add a knowledge source (GitHub, YouTube) via admin UI or API |
+| **Add Bot Adapter** | `add-bot-adapter.md` | Add a new platform adapter (Slack, Linear, etc.) to the bot system |
+| **Rename Project** | `rename-project.md` | Fully rename the project from "Savoir" to a custom name |
+
+**How to use:** When customizing the project, ask your AI assistant to follow the relevant skill. For example: *"Follow the add-bot-adapter skill to add a Slack adapter"* or *"Use the rename-project skill to rename this to MyDocs"*.
+
+The skills provide step-by-step instructions, file locations, code patterns, and checklists so the agent can perform the changes consistently and completely.
+
## 1. Rename Your Instance
Edit `apps/chat/app/app.config.ts` to change the branding: