Skip to content
Back to search

custovox-voc

MarketplaceWorks with Claude CodeGitHub

Voice-of-the-Customer skill and MCP server by CustoVox.ai.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/custovox--voc-skill/badge.svg)](/listings/custovox--voc-skill)

HTML

<a href="/listings/custovox--voc-skill"><img src="/api/listings/custovox--voc-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Étape 1 · Installer `uv` (une seule fois)

`uv` lance le petit serveur Python de l'outil et installe ses dépendances automatiquement.

- **Windows** : ouvrez *PowerShell* et collez :

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

- **macOS / Linux** : ouvrez le *Terminal* et collez :

  curl -LsSf https://astral.sh/uv/install.sh | sh

Fermez puis rouvrez le terminal.

Étape 2 · Installer l'outil

**Option A · Claude Code (le plus simple)** : dans Claude Code, tapez ces deux commandes :

/plugin marketplace add custovox/voc-skill
/plugin install voc-skill@custovox-voc

Redémarrez Claude Code. Le skill et le serveur MCP sont installés ensemble.

**Option B · Script d'installation (Claude Code, Codex, Cursor)**

1. Téléchargez le dépôt : bouton vert **Code → Download ZIP**, puis décompressez-le dans un dossier qui ne bougera plus (par exemple `Documents\voc-skill`). 2. Lancez le script : - **Windows** : clic droit dans le dossier → *Ouvrir dans le terminal*, puis ```powershell powershell -ExecutionPolicy Bypass -File install\install.ps1 ``` - **macOS / Linux** : ```bash bash install/install.sh ``` 3. Le script copie le skill pour Claude Code (`~/.claude/skills`) et pour Codex et Cursor (`~/.agents/skills`), enregistre le serveur dans Claude Code s'il est installé, et affiche les quelques lignes à coller dans la configuration de Codex (`~/.codex/config.toml`) ou de Cursor (`~/.cursor/mcp.json`).

**Option C · Copie manuelle du skill seul** : copiez le dossier `skills/voix-du-client` dans `~/.claude/skills/` (Claude Code) ou `~/.agents/skills/` (Codex, Cursor). Le skill fonctionne sans le serveur, en mode réduit (l'agent lit et anonymise lui-même).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "name": "custovox-voc",
  3. "owner": {
  4. "name": "CustoVox.ai",
  5. "url": "https://custovox.ai"
  6. },
  7. "description": "Voice-of-the-Customer skill and MCP server by CustoVox.ai.",
  8. "plugins": [
  9. {
  10. "name": "voc-skill",
  11. "source": "./",
  12. "description": "Analyse customer feedback (reviews, verbatims, calls) into themes, pain points, weak signals and an action plan.",
  13. "version": "0.1.0",
  14. "category": "productivity",
  15. "tags": ["voice-of-customer", "customer-experience", "marketing", "french"]
  16. }
  17. ]
  18. }
README.md · README · 228 lines
  1. # voc-skill · Voix du client / Voice of the Customer
  2. [![tests](https://github.com/custovox/voc-skill/actions/workflows/tests.yml/badge.svg)](https://github.com/custovox/voc-skill/actions/workflows/tests.yml)
  3. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  4. ![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
  5. ![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-8A2BE2)
  6. **[Français](#français) · [English](#english)**
  7. ---
  8. ## Français
  9. **Transformez vos avis clients, verbatims et transcriptions d'appels en un diagnostic clair : irritants priorisés, émotions, signaux faibles et plan d'action, en quelques minutes et sans clé d'API.**
  10. <p align="center"><img src="docs/images/demo.gif" alt="Démonstration : de 200 avis clients au rapport voix du client" width="760"></p>
  11. ### Ce que ça fait
  12. Vous donnez un fichier (CSV, Excel, JSON, texte, transcriptions) à votre agent IA (Claude Code, Codex, Cursor) et vous demandez une analyse. L'agent :
  13. 1. **charge et anonymise** les données (noms, e-mails, téléphones, adresses, IBAN, numéros de commande) **avant toute lecture** ;
  14. 2. **décrit** le corpus : volumes, canaux, périodes, notes ;
  15. 3. **identifie les thèmes et irritants**, qualifie le **sentiment et les émotions** ;
  16. 4. repère les **signaux faibles** (rares mais nouveaux, graves ou en hausse) ;
  17. 5. choisit des **citations représentatives** ;
  18. 6. **priorise** les irritants : fréquence × intensité, en 4 quadrants ;
  19. 7. propose un **plan d'action** (horizon, responsable, indicateur) ;
  20. 8. produit un **rapport Markdown** et un **fichier JSON** réutilisable.
  21. L'analyse sémantique est faite par l'agent lui-même : **aucune clé d'API, aucun envoi de vos données vers un service tiers** autre que l'agent que vous utilisez déjà.
  22. 👉 Exemple de rapport obtenu sur des données fictives : [examples/rapport/rapport_demo.md](examples/rapport/rapport_demo.md)
  23. ### Installation pas à pas
  24. #### Étape 1 · Installer `uv` (une seule fois)
  25. `uv` lance le petit serveur Python de l'outil et installe ses dépendances automatiquement.
  26. - **Windows** : ouvrez *PowerShell* et collez :
  27. ```powershell
  28. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  29. ```
  30. - **macOS / Linux** : ouvrez le *Terminal* et collez :
  31. ```bash
  32. curl -LsSf https://astral.sh/uv/install.sh | sh
  33. ```
  34. Fermez puis rouvrez le terminal.
  35. #### Étape 2 · Installer l'outil
  36. **Option A · Claude Code (le plus simple)** : dans Claude Code, tapez ces deux commandes :
  37. ```
  38. /plugin marketplace add custovox/voc-skill
  39. /plugin install voc-skill@custovox-voc
  40. ```
  41. Redémarrez Claude Code. Le skill et le serveur MCP sont installés ensemble.
  42. **Option B · Script d'installation (Claude Code, Codex, Cursor)**
  43. 1. Téléchargez le dépôt : bouton vert **Code → Download ZIP**, puis décompressez-le dans un dossier qui ne bougera plus (par exemple `Documents\voc-skill`).
  44. 2. Lancez le script :
  45. - **Windows** : clic droit dans le dossier → *Ouvrir dans le terminal*, puis
  46. ```powershell
  47. powershell -ExecutionPolicy Bypass -File install\install.ps1
  48. ```
  49. - **macOS / Linux** :
  50. ```bash
  51. bash install/install.sh
  52. ```
  53. 3. Le script copie le skill pour Claude Code (`~/.claude/skills`) et pour Codex et Cursor (`~/.agents/skills`), enregistre le serveur dans Claude Code s'il est installé, et affiche les quelques lignes à coller dans la configuration de Codex (`~/.codex/config.toml`) ou de Cursor (`~/.cursor/mcp.json`).
  54. **Option C · Copie manuelle du skill seul** : copiez le dossier `skills/voix-du-client` dans `~/.claude/skills/` (Claude Code) ou `~/.agents/skills/` (Codex, Cursor). Le skill fonctionne sans le serveur, en mode réduit (l'agent lit et anonymise lui-même).
  55. ### Exemples de requêtes
  56. - « Analyse les avis clients de `avis.csv` avec le skill voix-du-client et sors-moi le rapport. »
  57. - « Quels sont les 3 irritants à traiter en priorité dans nos tickets du trimestre ? »
  58. - « Compare les verbatims de mars et d'avril : qu'est-ce qui a changé ? »
  59. - « Y a-t-il des signaux faibles liés à la sécurité ou à la santé dans ces retours ? »
  60. - « Fais un échantillon stratifié de 300 verbatims sur ce fichier de 20 000 lignes et analyse-le. »
  61. - « Analyse the reviews in `reviews.xlsx` and write the report in English. »
  62. Essayez tout de suite avec les données fictives fournies : « Analyse le dossier `examples/data` avec le skill voix-du-client. »
  63. ### Outils du serveur MCP
  64. | Outil | Rôle |
  65. |---|---|
  66. | `load_feedback` | Lit CSV, XLSX, JSON, TXT ou un dossier ; détecte les colonnes texte, date, note, canal (ou les impose) ; **anonymise par défaut** |
  67. | `anonymize` | Masque les données personnelles d'un texte ou d'un jeu de données |
  68. | `stats` | Volumes, période, répartition par canal, par mois (avec note moyenne) et par note |
  69. | `sample` | Échantillon stratifié reproductible pour les gros fichiers (au moins 1 verbatim par segment) |
  70. | `export_report` | Rapport Markdown + JSON ; calcule les scores fréquence × intensité et les quadrants |
  71. | `transcribe` *(option)* | Transcription d'appels avec séparation agent / client (FunASR, Whisper large-v3 turbo, français et anglais) |
  72. **Audio (optionnel)** : la transcription demande PyTorch et environ 1,6 Go de modèles. Dans le dossier du dépôt : `uv sync --extra audio`. L'outil `transcribe` n'apparaît que si cette option est installée.
  73. ### Données personnelles (RGPD)
  74. - L'anonymisation est **activée par défaut** et appliquée **avant** l'analyse, puis une seconde fois sur les citations du rapport.
  75. - Elle repose sur des règles (formats français et anglais) : c'est un **masquage au mieux**, pas une garantie. Relisez les citations avant de diffuser un rapport.
  76. - Elle peut masquer par excès des références métier (numéros de lot, par exemple).
  77. - Vos fichiers restent sur votre machine ; seul l'agent que vous utilisez lit les verbatims anonymisés.
  78. ### Structure du dépôt
  79. ```
  80. voc-skill/
  81. ├── .claude-plugin/ # plugin.json + marketplace.json (installation Claude Code)
  82. ├── .mcp.json # déclaration du serveur MCP pour le plugin
  83. ├── skills/voix-du-client/ # le skill : SKILL.md, grille d'analyse, priorisation, modèle de rapport
  84. ├── src/voc_mcp/ # serveur MCP (FastMCP) : chargement, anonymisation, stats, échantillonnage, rapport, audio
  85. ├── tests/ # tests (pytest)
  86. ├── examples/data/ # 200 avis + 5 appels fictifs (marque fictive « Maison Verveine »)
  87. ├── examples/rapport/ # rapport obtenu (Markdown + JSON)
  88. ├── scripts/ # générateur des données de démonstration
  89. ├── install/ # scripts d'installation Windows / macOS / Linux
  90. └── docs/images/ # captures et GIF de démonstration
  91. ```
  92. ### Dépannage
  93. - **« uv n'est pas reconnu »** : fermez et rouvrez le terminal après l'installation de `uv`.
  94. - **Erreur de certificat (réseau d'entreprise)** : définissez la variable `UV_SYSTEM_CERTS=1` avant de lancer l'agent, pour que `uv` utilise les certificats du système.
  95. - **Le serveur n'apparaît pas** : dans Claude Code, tapez `/mcp` pour voir l'état des serveurs.
  96. - **Mauvaise colonne détectée** : précisez-la dans la requête (« la colonne texte s'appelle *commentaire_client* »).
  97. ### Aller plus loin
  98. Ce projet est volontairement simple et local. Pour des **volumes importants**, l'analyse de **l'audio et de la vidéo** à grande échelle, des **tableaux de bord** partagés et le **suivi dans le temps** de la voix du client, voir [CustoVox.ai](https://custovox.ai).
  99. ### Contribuer
  100. Les contributions sont bienvenues : nouveaux formats de fichiers, règles d'anonymisation pour d'autres pays, traductions, cas d'usage sectoriels. Voir [CONTRIBUTING.md](CONTRIBUTING.md).
  101. ### Licence
  102. [MIT](LICENSE) © 2026 CustoVox.ai. Les données d'exemple sont entièrement fictives.
  103. ---
  104. ## English
  105. **Turn customer reviews, verbatims and call transcripts into a clear diagnosis: prioritised pain points, emotions, weak signals and an action plan, in minutes and without any API key.**
  106. <p align="center"><img src="docs/images/demo-en.gif" alt="Demo: from 200 customer reviews to a Voice-of-the-Customer report" width="760"></p>
  107. ### What it does
  108. Give a file (CSV, Excel, JSON, text, transcripts) to your AI agent (Claude Code, Codex, Cursor) and ask for an analysis. The agent:
  109. 1. **loads and pseudonymises** the data (names, e-mails, phone numbers, addresses, IBAN, order numbers) **before reading it**;
  110. 2. **describes** the corpus: volumes, channels, periods, ratings;
  111. 3. **identifies themes and pain points**, qualifies **sentiment and emotions**;
  112. 4. spots **weak signals** (rare but new, severe or growing);
  113. 5. selects **representative quotes**;
  114. 6. **prioritises** pain points: frequency × intensity, in 4 quadrants;
  115. 7. proposes an **action plan** (horizon, owner, KPI);
  116. 8. writes a **Markdown report** and a reusable **JSON file**.
  117. The semantic analysis is done by the agent itself: **no API key, no data sent to a third-party service** other than the agent you already use.
  118. 👉 Sample report on fictional data (in French): [examples/rapport/rapport_demo.md](examples/rapport/rapport_demo.md). Reports can be generated in English (`language: "en"`).
  119. ### Step-by-step installation
  120. **1. Install `uv`** (once). Windows (PowerShell): `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"` · macOS/Linux: `curl -LsSf https://astral.sh/uv/install.sh | sh`. Then reopen the terminal.
  121. **2. Install the tool**
  122. - **Claude Code (easiest)**:
  123. ```
  124. /plugin marketplace add custovox/voc-skill
  125. /plugin install voc-skill@custovox-voc
  126. ```
  127. Restart Claude Code.
  128. - **Installer script (Claude Code, Codex, Cursor)**: download the repository (**Code → Download ZIP**), unzip it in a permanent folder, then run `powershell -ExecutionPolicy Bypass -File install\install.ps1` (Windows) or `bash install/install.sh` (macOS/Linux). The script copies the skill to `~/.claude/skills` and `~/.agents/skills`, registers the MCP server in Claude Code, and prints the snippet for Codex (`~/.codex/config.toml`) and Cursor (`~/.cursor/mcp.json`).
  129. - **Skill only**: copy `skills/voix-du-client` to `~/.claude/skills/` or `~/.agents/skills/`. It works without the server, in reduced mode.
  130. ### Example prompts
  131. - "Analyse the reviews in `reviews.csv` with the voix-du-client skill and write the report in English."
  132. - "What are the top 3 pain points to fix in this quarter's support tickets?"
  133. - "Compare March and April verbatims: what changed?"
  134. - "Are there weak signals related to safety or health in this feedback?"
  135. - "Draw a stratified sample of 300 verbatims from this 20,000-row file and analyse it."
  136. Try it now with the bundled fictional data: "Analyse the `examples/data` folder with the voix-du-client skill."
  137. ### MCP server tools
  138. | Tool | Purpose |
  139. |---|---|
  140. | `load_feedback` | Reads CSV, XLSX, JSON, TXT or a folder; detects text/date/rating/channel columns (or forces them); **pseudonymises by default** |
  141. | `anonymize` | Masks personal data in a text or a dataset |
  142. | `stats` | Volumes, period, breakdown by channel, by month (with average rating) and by rating |
  143. | `sample` | Reproducible stratified sample for large files (at least one verbatim per segment) |
  144. | `export_report` | Markdown + JSON report; computes frequency × intensity scores and quadrants |
  145. | `transcribe` *(optional)* | Call transcription with agent/customer separation (FunASR, Whisper large-v3 turbo, French and English); install with `uv sync --extra audio` |
  146. ### Personal data (GDPR)
  147. Pseudonymisation is **on by default**, applied before the analysis and again on the report's quotes. It is rule-based (French and English formats): **best effort, not a guarantee**; review quotes before sharing a report. Your files stay on your machine.
  148. ### Repository structure
  149. See the tree in the French section: plugin manifests, the skill (`skills/voix-du-client`), the MCP server (`src/voc_mcp`), tests, fictional demo data and report, installers.
  150. ### Troubleshooting
  151. `uv` not found → reopen the terminal · certificate errors on corporate networks → set `UV_SYSTEM_CERTS=1` · server missing → type `/mcp` in Claude Code · wrong column detected → name it in your prompt.
  152. ### Going further
  153. This project is deliberately simple and local. For **large volumes**, **audio and video** analysis at scale, shared **dashboards** and **tracking over time**, see [CustoVox.ai](https://custovox.ai).
  154. ### Contributing
  155. Contributions are welcome: new file formats, anonymisation rules for other countries, translations, sector use cases. See [CONTRIBUTING.md](CONTRIBUTING.md).
  156. ### License
  157. [MIT](LICENSE) © 2026 CustoVox.ai. Sample data is entirely fictional.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.