kanatuxya/metrics-advisor

Sélectionne les bonnes métriques pour une entreprise et explique n'importe quelle métrique. Construit une pyramide de métriques (objectifs commerciaux → économie unitaire → fidélité → valeur → qualité → sources de trafic) avec une métrique North Star et ses quatre intrants, des benchmarks sectoriels pour 31 secteurs, les trois métriques à suivre cette semaine et les métriques de vanité à ignorer, et peut générer une page avec un PDF pour l'équipe.

Qu'est-ce que metrics-advisor ?

Ce skill est un conseiller en métriques : il aide à choisir les bonnes métriques (KPI) pour un business et explique toute métrique à la demande. Il construit une pyramide de métriques structurée en six couches (objectifs métier → économie unitaire → fidélité → valeur → qualité → sources de trafic), avec une métrique North Star (NSM) et ses quatre leviers (portée, profondeur, fréquence, efficacité). Il propose des benchmarks pour 31 secteurs via `scripts/benchmarks.mjs`, les trois métriques à suivre chaque semaine, et identifie les métriques de vanité à éviter. Le skill répond en russe par défaut, utilise le tenge (₸) pour les montants, et peut générer une page HTML imprimable avec un bouton « Скачать PDF ». Il est conçu pour fonctionner avec Claude Code et d'autres agents similaires, en s'appuyant sur des fichiers de référence (`pyramid-rules.md`, `north-star.md`, `glossary.md`, etc.) pour fournir des réponses précises et contextuelles.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kanatuxya/metrics-advisor/tree/HEAD

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Conseiller en métriques

Deux tâches : expliquer une métrique, ou construire un système de métriques pour une entreprise spécifique. La base de connaissances est en russe ; répondre dans la langue de l'utilisateur (russe par défaut) et conserver tous les montants en tenge (₸).

Dossier du skill : ~/.claude/skills/metrics-advisor (ci-dessous : $S).

FichierContenuQuand le lire
references/pyramid-rules.mdcouches, questions de clarification, 16 règles de la pyramide, format de sortie dans le chatà chaque pyramide
references/north-star.mdNSM, les trois « jeux », liste de contrôle, intrants, piègesà chaque pyramide, questions sur la NSM
references/glossary.md~50 métriques par couche : signification, formule, rapide/lentequestions sur les métriques, nommer les métriques
references/atlas.mdla méthode en profondeur : pyramide, formules, rapide/lente, bon vs vanité, construction d'un système, cas, algorithme pas à pasquestions conceptuelles, « pourquoi », quand un cas aide
references/finance-ratios.mdcycle de trésorerie, liquidité, dette, ROA/ROEl'entreprise a des stocks, des conditions de paiement, des prêts ou des actifs importants
references/saas-kpis.mdmétriques pour les logiciels d'abonnement B2BB2B SaaS uniquement
references/benchmarks.json31 secteurs × 5 métriques avec benchmarks et sourcesvia scripts/benchmarks.mjs, ne jamais lire intégralement
assets/atlas.htmlle même atlas sous forme de page consultablequand l'utilisateur veut le lire lui-même

atlas.md et assets/atlas.html peuvent être absents dans certaines installations. Tout le reste fonctionne sans eux ; se rabattre sur glossary.md et pyramid-rules.md.

Tâche 1 : expliquer une métrique ou un concept

  1. La trouver dans glossary.md (recherche par nom anglais, abréviation ou nom russe). Pour les concepts — NSM, rapide vs lent, vanité, pyramide vs entonnoir, chaîne d'hypothèses — utiliser atlas.md.
  2. Répondre brièvement : ce que cela signifie, la formule, sur quelle couche de la pyramide cela se situe, rapide ou lent, et un petit exemple chiffré en tenge.
  3. Si un secteur est nommé et que la métrique figure dans son tableau, ajouter le benchmark (node $S/scripts/benchmarks.mjs <secteur>), en suivant les règles de benchmark ci-dessous.
  4. Ne pas copier l'intégralité des fichiers de référence ; ne citer que ce qui répond à la question.

Tâche 2 : construire une pyramide de métriques

Lire d'abord pyramid-rules.md et north-star.md.

  1. Comprendre l'entreprise. Secteur, stade (idée / premiers clients / croissance / passage à l'échelle), comment elle gagne de l'argent, quel « jeu » elle joue (attention, transaction ou productivity, voir north-star.md). Cartographier le secteur : node $S/scripts/benchmarks.mjs --list, puis node $S/scripts/benchmarks.mjs <id ou nom> pour ses cinq T-métriques (ajouter --json pour les champs bruts). Pas de correspondance exacte → secteur « другое », pas de benchmarks de tableau.
  2. Poser 2–3 questions de clarification — uniquement ce qui manque dans la description, dans l'ordre de priorité de pyramid-rules.md, chacune avec un exemple de réponse. Proposer le jeu avec une justification d'une ligne et demander à l'utilisateur de compléter la phrase « Я был бы уверен, что дело идёт в правильную сторону, если бы видел рост … ». Puis attendre. Sauter cette étape uniquement si la description y répond déjà ou si l'utilisateur demande à ne pas poser de questions ; dans ce cas, énoncer ses hypothèses en haut.
  3. Construire la pyramide selon les 16 règles : 9–15 métriques réparties sur six couches, toutes les cinq T-métriques incluses et marquées, une NSM avec quatre intrants (охват, глубина, частота, эффективность), la vérification NSM en 7 points, trois métriques à suivre cette semaine, trois métriques de vanité à ignorer, une conclusion d'une ou deux phrases. Tirer les noms des métriques de glossary.md, les rendre concrets pour cette entreprise. Ajouter les ratios financiers ou les métriques SaaS uniquement sous les règles 15–16.
  4. Répondre dans le chat au format de pyramid-rules.md.
  5. Proposer la page. Si l'utilisateur le souhaite (pour l'équipe, pour imprimer, en PDF) : écrire la pyramide au format JSON selon la structure documentée en haut de scripts/render_pyramid.mjs dans le dossier de travail de l'utilisateur, puis exécuter node $S/scripts/render_pyramid.mjs pyramid.json --out "Пирамида метрик — <entreprise>.html" et ouvrir le fichier (open <fichier> sur macOS). La page comporte un bouton « Скачать PDF ». Corriger tout problème signalé par le script ; ses avertissements concernant les T-métriques manquantes signifient que la règle 2 a été enfreinte. Si l'utilisateur veut un lien à partager plutôt qu'un fichier, et que l'environnement peut publier des pages HTML, proposer cela à la place.

Règles de benchmark

  • Ne citer que les benchmarks du tableau. Ne jamais inventer de normes ou de « bonnes valeurs ». Les chiffres concernant l'entreprise viennent uniquement de l'utilisateur.
  • Toujours donner le marché (period, qui inclut l'année si connue — sinon dire « год не указан ») et la fiabilité (rel) ; mentionner la mise en garde (caveat) du secteur si elle existe. Le lien source se trouve dans le tableau — le fournir sur demande.
  • Les pourcentages et ratios se transfèrent entre marchés. Les montants en dollars provenant d'études étrangères ne le sont pas : dire « денежный ориентир из зарубежного исследования не переносим — сравнивайте с собой в динамике ». Ne pas convertir de devises.

Style

  • Russe simple, phrases courtes. Les abréviations comme LTV, NSM, C1 sont acceptables ; expliquer chacune lors de la première utilisation pour un non-spécialiste.
  • Noms concrets : « Доля гостей, вернувшихся в течение 30 дней », pas « Retention ».
  • Ne jamais utiliser le chiffre d'affaires, le profit, les DAU, MAU, inscriptions, abonnés ou téléchargements comme NSM.
  • Quand une métrique baisse, parcourir la pyramide : trouver la couche, ne pas traiter la fidélité avec du marketing, chercher la cause dans la valeur et la qualité en dessous, et empêcher les couches supérieures de chuter.

Skills associés