# crmkit/skills architecture

> Architecture diagram of the GitHub repository crmkit/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crmkit/skills
- Repository: https://github.com/crmkit/skills

## Overview

crmkit Skills is a collection of runnable recipes for an AI agent operating a CRM over HTTP. The main workflows are generating a digest, importing CSV data, backing up CRM collections, and logging email interactions. Each recipe has an instruction file and a script; the README says recipes defer request syntax to the CRM server’s operating manual. Source excerpts were not available, so the graph includes only relationships documented in the README.

Main entry points: [`crmkit-digest/digest.sh`](https://github.com/crmkit/skills/blob/main/crmkit-digest/digest.sh) (Build digest), [`crmkit-backup/backup.sh`](https://github.com/crmkit/skills/blob/main/crmkit-backup/backup.sh) (Export collections), [`crmkit-import/import.sh`](https://github.com/crmkit/skills/blob/main/crmkit-import/import.sh) (Import CSV), [`crmkit-inbox-sync/SKILL.md`](https://github.com/crmkit/skills/blob/main/crmkit-inbox-sync/SKILL.md) (Inbox recipe)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_recipes["Recipe workflows"]
  node_digest_skill["Digest recipe<br/>[SKILL.md]"]
  node_digest_script["Build digest<br/>[digest.sh]"]
  node_digest_result["Briefing"]
  node_import_skill["Import recipe<br/>[SKILL.md]"]
  node_import_script["Import CSV<br/>[import.sh]"]
  node_backup_skill["Backup recipe<br/>[SKILL.md]"]
  node_backup_script["Export collections<br/>[backup.sh]"]
  node_backup_result["JSON backup"]
  node_inbox_skill["Inbox recipe<br/>[SKILL.md]"]
  node_interaction_script["Log interaction<br/>[log-interaction.sh]"]
end

subgraph group_crm["CRM service"]
  node_crm_api["CRM API"]
  node_manual["Operating manual"]
  node_activity[("Logged activity")]
end

node_agent(("AI agent"))
node_csv["CSV data"]
node_email_tool["Email tool"]

node_agent -->|"uses recipe"| node_digest_skill
node_digest_skill -->|"runs"| node_digest_script
node_digest_script -->|"requests data"| node_crm_api
node_digest_script -->|"defers syntax"| node_manual
node_digest_script -->|"produces briefing"| node_digest_result
node_agent -->|"uses recipe"| node_import_skill
node_import_skill -->|"runs"| node_import_script
node_csv -->|"supplies rows"| node_import_script
node_import_script -->|"upserts records"| node_crm_api
node_import_script -->|"defers syntax"| node_manual
node_agent -->|"uses recipe"| node_backup_skill
node_backup_skill -->|"runs"| node_backup_script
node_backup_script -->|"pages collections"| node_crm_api
node_backup_script -->|"defers syntax"| node_manual
node_backup_script -->|"exports JSON"| node_backup_result
node_agent -->|"uses recipe"| node_inbox_skill
node_inbox_skill -->|"reads email"| node_email_tool
node_inbox_skill -->|"runs"| node_interaction_script
node_interaction_script -->|"logs interaction"| node_crm_api
node_interaction_script -->|"defers syntax"| node_manual
node_crm_api -->|"stores activity"| node_activity

click node_digest_skill "https://github.com/crmkit/skills/blob/main/crmkit-digest/SKILL.md"
click node_digest_script "https://github.com/crmkit/skills/blob/main/crmkit-digest/digest.sh"
click node_import_skill "https://github.com/crmkit/skills/blob/main/crmkit-import/SKILL.md"
click node_import_script "https://github.com/crmkit/skills/blob/main/crmkit-import/import.sh"
click node_backup_skill "https://github.com/crmkit/skills/blob/main/crmkit-backup/SKILL.md"
click node_backup_script "https://github.com/crmkit/skills/blob/main/crmkit-backup/backup.sh"
click node_inbox_skill "https://github.com/crmkit/skills/blob/main/crmkit-inbox-sync/SKILL.md"
click node_interaction_script "https://github.com/crmkit/skills/blob/main/crmkit-inbox-sync/log-interaction.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_digest_skill,node_digest_script,node_digest_result,node_import_skill,node_import_script,node_backup_skill,node_backup_script,node_backup_result,node_inbox_skill,node_interaction_script toneBlue
class node_crm_api,node_manual,node_activity toneAmber
class node_agent,node_csv,node_email_tool toneIndigo
```

## Components

### Recipe workflows

- [Digest recipe](https://github.com/crmkit/skills/blob/main/crmkit-digest/SKILL.md): `crmkit-digest/SKILL.md`
- [Build digest](https://github.com/crmkit/skills/blob/main/crmkit-digest/digest.sh): `crmkit-digest/digest.sh`
- **Briefing**
- [Import recipe](https://github.com/crmkit/skills/blob/main/crmkit-import/SKILL.md): `crmkit-import/SKILL.md`
- [Import CSV](https://github.com/crmkit/skills/blob/main/crmkit-import/import.sh): `crmkit-import/import.sh`
- [Backup recipe](https://github.com/crmkit/skills/blob/main/crmkit-backup/SKILL.md): `crmkit-backup/SKILL.md`
- [Export collections](https://github.com/crmkit/skills/blob/main/crmkit-backup/backup.sh): `crmkit-backup/backup.sh`
- **JSON backup**
- [Inbox recipe](https://github.com/crmkit/skills/blob/main/crmkit-inbox-sync/SKILL.md): `crmkit-inbox-sync/SKILL.md`
- [Log interaction](https://github.com/crmkit/skills/blob/main/crmkit-inbox-sync/log-interaction.sh): `crmkit-inbox-sync/log-interaction.sh`

### CRM service

- **CRM API**
- **Operating manual**
- **Logged activity**

### Other components

- **AI agent**
- **CSV data**
- **Email tool**

## Connections

- AI agent → Digest recipe: uses recipe (evidence: `README.md`)
- Digest recipe → Build digest: runs (evidence: `README.md`)
- Build digest → CRM API: requests data (evidence: `README.md`)
- Build digest → Operating manual: defers syntax (evidence: `README.md`)
- Build digest → Briefing: produces briefing (evidence: `README.md`)
- AI agent → Import recipe: uses recipe (evidence: `README.md`)
- Import recipe → Import CSV: runs (evidence: `README.md`)
- CSV data → Import CSV: supplies rows (evidence: `README.md`)
- Import CSV → CRM API: upserts records (evidence: `README.md`)
- Import CSV → Operating manual: defers syntax (evidence: `README.md`)
- AI agent → Backup recipe: uses recipe (evidence: `README.md`)
- Backup recipe → Export collections: runs (evidence: `README.md`)
- Export collections → CRM API: pages collections (evidence: `README.md`)
- Export collections → Operating manual: defers syntax (evidence: `README.md`)
- Export collections → JSON backup: exports JSON (evidence: `README.md`)
- AI agent → Inbox recipe: uses recipe (evidence: `README.md`)
- Inbox recipe → Email tool: reads email (evidence: `README.md`)
- Inbox recipe → Log interaction: runs (evidence: `README.md`)
- Log interaction → CRM API: logs interaction (evidence: `README.md`)
- Log interaction → Operating manual: defers syntax (evidence: `README.md`)
- CRM API → Logged activity: stores activity (evidence: `README.md`)
