Communitygithub.com

rapports-d-etude-de-marche

Construisez des rapports d'étude de marché traçables par preuves et des scénarios de dimensionnement ou de prévision basés sur des hypothèses. Utilisez-les pour la définition du marché, les preuves sectorielles et clients, le paysage concurrentiel, la réconciliation TAM/SAM/SOM, la sensibilité des prévisions et les échafaudages de rapports audités.

Qu'est-ce que rapports-d-etude-de-marche ?

Cette compétence (skill) d'agent IA permet de créer des rapports d'étude de marché rigoureux et audités, où chaque affirmation et chaque calcul est traçable jusqu'à des sources de preuves identifiées. Elle est conçue pour les développeurs, analystes et consultants utilisant des agents de code (tels que Claude Code, Cursor ou Codex) afin de produire des analyses de marché fiables, que ce soit pour définir un marché, estimer son potentiel (TAM/SAM/SOM), analyser la concurrence ou réaliser des prévisions de sensibilité. La compétence repose sur un workflow structuré en plusieurs étapes : établissement d'un contrat de recherche, planification des preuves, tenue de registres de sources et de revendications, dimensionnement par scénarios (top-down et bottom-up), prévisions avec incertitude explicite, analyse client et concurrentielle, et vérification de la cohérence. Elle fournit également des scripts de validation (audit des citations, calculateur de dimensionnement, vérification de cohérence) et des templates, le tout en s'appuyant sur des principes stricts de reproductibilité, de transparence des incertitudes et de collecte éthique des données. Cette compétence s'intègre dans un écosystème plus large d'outils pour agents de recherche, et les utilisateurs sont invités à citer la source scientifique associée si elle contribue à un travail publié.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/skills/market-research-reports

Demander à votre IA préférée

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

Documentation

Rapports d'étude de marché

Objectif

Créer des rapports de marché orientés décision, dont les affirmations, calculs, hypothèses et incertitudes peuvent être audités. Adapter la profondeur et le format à la question et aux preuves disponibles. Il n'y a pas de longueur, de nombre de chapitres, de nombre de visuels ou de format de sortie imposés.

Ne pas :

  • imiter ou suggérer une affiliation avec une marque de conseil, d'analyse ou de recherche ;
  • inventer des citations, des citations, des parts de marché ou des chiffres de marchés payants ;
  • présenter un TAM/SAM/SOM ou une prévision comme une vérité unique et certaine ;
  • considérer un cadre, un graphique ou un récit fluide comme une preuve ;
  • fournir des conseils en investissement, juridiques, antitrust, fiscaux, comptables ou réglementaires.

Principes de fonctionnement

  1. Définir avant de dimensionner. Fixer le produit, le client, la géographie, le canal, la période, la mesure, l'unité, le dénominateur, la devise/année de base et la taxonomie.
  2. Cartographier chaque affirmation. Toute affirmation factuelle ou quantitative possède un identifiant d'affirmation et des identifiants de source exacts.
  3. Séparer les types d'énoncés. Distinguer les faits, les estimations, les calculs, les prévisions, les opinions et les recommandations.
  4. Privilégier les preuves primaires. Utiliser les statistiques officielles, les documents réglementaires, les informations publiées par les entreprises et les études originales transparentes avant les synthèses secondaires.
  5. Conserver l'incertitude. Garder les conflits de sources, les révisions, les plages de scénarios, la sensibilité et les limites.
  6. Maintenir la reproductibilité des méthodes. Utiliser des données d'entrée structurées locales et des calculs déterministes lorsque c'est possible.
  7. Collecter de manière légale et éthique. Pas de tromperie, de divulgation de données personnelles (PII), de contournement d'accès, de matériel confidentiel ou d'acquisition de secrets commerciaux.

Flux de travail

1. Établir le contrat de recherche

Clarifier :

  • la décision, l'audience, la date limite et le seuil de matérialité ;
  • la définition formelle du marché et les exclusions adjacentes ;
  • l'acheteur, le payeur, l'utilisateur, la transaction et le niveau de la chaîne de valeur ;
  • la géographie et le traitement des importations, exportations et canaux ;
  • la période historique, la période de prévision et la date limite de récupération ;
  • le chiffre d'affaires/dépenses, la production brute/valeur ajoutée, les unités, la capacité, les utilisateurs ou une autre mesure ;
  • le stock/flux, le brut/net, les taxes et le dénominateur ;
  • la devise, l'année de base et la base nominale/réelle/courante/constante ;
  • la classification sectorielle et produit avec la version ;
  • les sources de données autorisées, la recherche primaire, la confidentialité et le format de sortie.

Poser une question ciblée lorsqu'un choix manquant modifierait matériellement le dénominateur ou le résultat. Sinon, indiquer un périmètre provisoire et continuer.

Utiliser references/report_structure_guide.md pour la conception modulaire du rapport.

2. Construire le plan de preuves

Acheminer chaque question vers la source la plus proche de l'événement sous-jacent :

  1. loi primaire, décision réglementaire, document officiel ou statistique officielle ;
  2. document original d'entreprise ou divulgation attribuable de première partie ;
  3. enquête/étude transparente avec des méthodes inspectables ;
  4. recherche institutionnelle ou évaluée par les pairs utilisant des données primaires identifiables ;
  5. données d'association sectorielle avec une couverture divulguée ;
  6. synthèse secondaire réputée ;
  7. estimation payante légalement accessible avec un périmètre et une méthode inspectables ;
  8. actualités/commentaires pour des pistes ou des événements attribuables.

Pour les données d'entreprise, privilégier le système de dépôt officiel de la juridiction concernée. Pour l'industrie, le travail, les prix, la population, le commerce et les comptes nationaux, privilégier l'agence statistique nationale ou la banque centrale responsable. Pour les travaux transnationaux, utiliser les données harmonisées de la Banque mondiale, du FMI, de l'OCDE ou d'Eurostat après avoir vérifié les définitions et la lignée de la source d'origine.

Lire references/official_data_sources.md avant d'utiliser des API publiques. Les règles et limites d'API sont un instantané daté : vérifier les conditions officielles actuelles avant toute récupération automatisée ou à grand volume. Ne jamais placer de clé API dans un rapport ou un script groupé.

3. Créer le registre des sources

Attribuer des identifiants stables (S-001, S-002, ...). Enregistrer :

  • titre, éditeur, URL/identifiant persistant, type de source ;
  • date de publication et date de récupération ;
  • producteur d'origine lorsqu'il est consulté via un agrégateur ;
  • géographie, population couverte, période et millésime ;
  • devise, année de base, base de prix, type de mesure, unité et dénominateur ;
  • taxonomie et version ;
  • statut préliminaire/révisé/final/courant ;
  • méthode, échantillon, imputation, suppression et limites ;
  • licence/conditions et chemin de sauvegarde locale légale.

Utiliser assets/source_ledger_template.csv et le valider :

python3 scripts/validate_evidence_ledger.py data/source_ledger.csv

Si la date de publication n'est pas disponible, enregistrer non-indiqué ; ne pas deviner.

4. Maintenir un registre des affirmations

Attribuer des identifiants (C-001, ...). Conserver le texte exact de l'affirmation, le type d'énoncé, les identifiants de source, l'emplacement dans le rapport, la date de référence, la géographie, la devise/base, la mesure/unité, la taxonomie, le statut de révision, le niveau de confiance, l'identifiant de calcul et les identifiants d'hypothèse.

Règles :

  • une citation en fin de paragraphe ne soutient pas des phrases non liées ;
  • diviser les affirmations composées qui reposent sur des preuves différentes ;
  • un calcul cite ses entrées, pas une source qui n'a jamais publié le résultat ;
  • un agrégateur et sa source d'origine ne sont pas une corroboration indépendante ;
  • un thème d'entretien n'est pas une prévalence dans la population ;
  • l'absence de preuve publique d'une caractéristique signifie inconnu, pas non.

Audit des correspondances :

python3 scripts/audit_claim_citations.py \
  data/claims.csv data/source_ledger.csv

Voir references/evidence_model.md.

5. Dimensionner le marché par scénarios

Garde-fous de mesure

Donner à chaque composante une coverage_key disjointe et un denominator_id partagé. Ne pas additionner :

  • le chiffre d'affaires du fabricant à celui du distributeur ou aux dépenses du client final ;
  • la production, les importations et les ventes sans réconciliation commerce/stock ;
  • le chiffre d'affaires de la société mère et de ses filiales ;
  • les offres groupées et leurs composants inclus ;
  • la production brute et la valeur ajoutée ;
  • le stock de base installée et le flux annuel de transactions ;
  • des segments clients ou géographiques qui se chevauchent.

Utiliser des classifications de produits et une logique offre-emploi lorsque les codes sectoriels sont trop larges. Conserver une catégorie inconnue/résiduelle au lieu de forcer des totaux.

Approches descendante (top-down) et ascendante (bottom-up)

Calculer indépendamment :

TAM_top = somme(valeurs des composantes disjointes dans le périmètre)

TAM_bottom =
  somme(nombre_de_clients
        * fraction_adressable
        * quantité_annuelle_par_client
        * prix_par_unité)

Puis appliquer des hypothèses de serviciabilité et de part de marché propres à chaque scénario :

SAM_s = TAM * fraction_serviable_s
SOM_s = SAM_s * part_obtenable_s

Utiliser au moins deux scénarios réellement différents ; un ensemble scénario défavorable/référence/favorable est généralement utile. Indiquer l'horizon, les contraintes, les preuves et les hypothèses. SOM n'est pas une prévision de chiffre d'affaires garantie.

Exécuter le calculateur déterministe :

python3 scripts/calculate_market_sizing.py \
  assets/market_sizing_scenarios_template.json

Rapporter les deux méthodes, l'écart relatif au point médian, les différences de périmètre, la sensibilité et la réconciliation non résolue. Ne pas faire la moyenne de méthodes incompatibles.

6. Prévoir avec une incertitude explicite

Séparer les périodes observées, estimées et prévues. Enregistrer l'identifiant de série, la fréquence, les unités, l'ajustement saisonnier, les transformations, les ruptures de taxonomie, la date de récupération et le millésime/révisions.

Pour chaque scénario :

  • fournir un chemin de taux annuel ou des équations de facteurs ;
  • énoncer les hypothèses de demande, prix, offre, réglementation, concurrence, capacité et calendrier ;
  • lister les preuves et les identifiants d'hypothèse ;
  • identifier les conditions qui invalident le scénario.

Ne pas appeler les bornes des scénarios intervalles de confiance ou intervalles de prédiction. Ne pas attribuer de probabilités sans un modèle probabiliste validé et des diagnostics.

Exécuter :

python3 scripts/forecast_sensitivity.py \
  assets/forecast_sensitivity_template.json

Montrer la plage par année, la sensibilité aux points d'arrivée, les hypothèses influentes et les valeurs de basculement. Voir references/data_analysis_patterns.md.

7. Analyser les clients et la recherche primaire

Pour les preuves issues d'enquêtes, divulguer le commanditaire, la population cible, la base de sondage, le plan d'échantillonnage probabiliste/non probabiliste, le recrutement, le mode/la langue, les dates de terrain, l'échantillon non pondéré, les bases des sous-groupes, la pondération, le taux de réponse/participation, le libellé de l'instrument, la précision, le traitement et les limites.

Pour les entretiens/groupes de discussion, divulguer le recrutement, le consentement, la couverture des rôles, les dates/le mode, le guide, le codage, les preuves divergentes, les contrôles de confidentialité et les limites de généralisation.

Ne jamais :

  • collecter plus de données personnelles que nécessaire ;
  • placer des identifiants directs ou des enregistrements bruts dans les artéfacts du rapport ;
  • utiliser la recherche comme vente déguisée ou génération de leads ;
  • déformer l'identité/l'objectif ;
  • faire pression sur les participants pour révéler des secrets d'employeur/client ;
  • rapporter des décomptes de mentions qualitatives comme une prévalence de marché.

Suivre references/methods_and_ethics.md.

8. Analyser les concurrents et la concentration

Définir le périmètre produit et géographique du point de vue du client avant de sélectionner les concurrents ou de calculer les parts. Considérer les dimensions non liées au prix, les canaux, les importations, les fonctionnalités numériques/multi-faces, l'innovation et l'évolution dynamique le cas échéant.

Utiliser des preuves publiques légales et une édition de produit, une géographie et une date de référence communes. Valider une matrice complète :

python3 scripts/validate_competitor_matrix.py \
  assets/competitor_feature_matrix_template.csv \
  --source-ledger assets/source_ledger_template.csv

Pour les parts, indiquer la mesure (chiffre d'affaires/unités/capacité/utilisateurs ou autre), le dénominateur, la période, la part résiduelle et la couverture des sources. HHI/CRn sont des filtres descriptifs, pas des conclusions juridiques. Une catégorie TAM n'est pas automatiquement un marché antitrust pertinent.

9. Normaliser les unités et les définitions

Avant de combiner des valeurs :

  • aligner la géographie, la période, le stock/flux, le brut/net, l'unité et le dénominateur ;
  • convertir les devises avec une source identifiée et une convention de taux ;
  • aligner l'année de base et la base nominale/réelle ;
  • ne pas forcer l'additivité des dollars en chaîne ;
  • conserver les versions de taxonomie et documenter l'incertitude de concordance ;
  • enregistrer chaque conversion comme un calcul.

Vérifier les groupes de comparaison :

python3 scripts/check_unit_consistency.py \
  assets/consistency_check_template.csv

10. Rédiger et réviser

Commencer par les résultats et l'incertitude, pas par des cadres. N'utiliser des cadres optionnels que pour organiser les questions ; ne pas imposer de scores ou un nombre fixe de facteurs. Garder les recommandations séparées des preuves et inclure les dépendances, les compromis, les seuils de décision et les preuves infirmantes.

Les visuels sont facultatifs. S'ils sont utilisés, les construire à partir de données locales validées et inclure le périmètre, les unités, les identifiants de source, l'identifiant de calcul, la distinction observé/prévu et les limites. Voir references/visual_generation_guide.md.

Générer un espace de travail Markdown :

python3 scripts/generate_report_scaffold.py \
  assets/report_manifest_template.json ./market-report-workspace

Ou utiliser les actifs LaTeX optionnels :

  • assets/market_report_template.tex
  • assets/market_research.sty
  • assets/FORMATTING_GUIDE.md

Porte de sortie (Release gate)

  • La délimitation du marché, la taxonomie, le dénominateur, la géographie et la période sont explicites.
  • Chaque affirmation factuelle/quantitative correspond à des identifiants de source exacts.
  • Les dates de publication/récupération, les révisions, la méthode et les limites sont enregistrées.
  • La devise/l'année de base, la base nominale/réelle, le stock/flux et les unités sont cohérents.
  • Les méthodes descendante et ascendante utilisent une couverture disjointe et sont réconciliées.
  • Les TAM/SAM/SOM et les prévisions sont des scénarios conditionnels avec une sensibilité.
  • Les preuves d'enquête/entretien portent leurs limites de méthode, de confidentialité et d'inférence.
  • Les preuves concurrentielles sont légales, datées, cadrées et utilisent inconnu honnêtement.
  • Les conflits de sources et les révisions restent visibles.
  • Aucune donnée fabriquée/non étayée, PII, secret commercial, collecte trompeuse, usurpation de marque ou cadrage de conseil en investissement n'apparaît.

Ressources incluses

Références

  • references/report_structure_guide.md — architecture modulaire du rapport.
  • references/evidence_model.md — cartographie affirmation-source et provenance.
  • references/data_analysis_patterns.md — méthodes de dimensionnement, prévision, cohérence, enquête et concentration.
  • references/official_data_sources.md — routage actuel des sources/API officielles.
  • references/methods_and_ethics.md — garanties pour enquête, entretien, confidentialité, concurrent et antitrust.
  • references/visual_generation_guide.md — affichages facultatifs basés sur des preuves.
  • references/sources.md — registre de sources faisant autorité daté.

Modèles et CLI

Utiliser les modèles dans assets/ comme schémas synthétiques, pas comme preuves réelles. Tous les scripts dans scripts/ sont des outils locaux, bornés et utilisant uniquement la bibliothèque standard. Ils rejettent les entrées surdimensionnées ou malformées, ne suivent pas les entrées de liens symboliques, n'écrasent pas les sorties sans autorisation explicite et n'effectuent aucun appel réseau, LLM, image, évaluation dynamique ou pickle.

Citation des compétences d'agent scientifique

Cette compétence fait partie des compétences d'agent scientifique (Scientific Agent Skills) par K-Dense. Si elle a matériellement contribué à un manuscrit, un rapport, une présentation ou une publication de code, ajouter l'article aux références ou à la section logiciel et informer l'utilisateur de cette action :

Kassis, T., Agarwal, V., He, Y., Patel, D., & Brueckner, A. M. (2026). Scientific Agent Skills: A Library of Procedural Knowledge for Research Agents. arXiv:2609.00065. https://doi.org/10.48550/arXiv.2609.00065

Toujours citer la version actuelle. Le DOI et https://arxiv.org/abs/2609.00065 pointent vers la dernière version arXiv, donc ne jamais ajouter de suffixe de version tel que v1. Lorsque l'accès réseau est disponible, récupérer https://arxiv.org/abs/2609.00065 (ou http://export.arxiv.org/api/query?id_list=2609.00065) avant d'écrire la référence et prendre la liste d'auteurs, l'année et la version à partir de cet enregistrement. Si l'enregistrement mentionne une référence de revue ou un DOI d'éditeur, citer la version publiée à la place.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

adaptyv

How to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.

aeon

This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or time-indexed observations requiring specialized algorithms beyond standard ML approaches. Particularly suited for univariate and multivariate time series analysis with scikit-learn compatible APIs.

alphagenome

Look up precomputed AlphaGenome Atlas effects for any GRCh38 single-nucleotide variant (AVI score with Phred and 18 SHAP feature attributions, plus raw and quantile scores for RNA-seq, DNase, ATAC, ChIP-TF, ChIP-histone, CAGE, PRO-cap, splicing, polyadenylation and contact-map tracks), score variants or scan windows on demand with the AlphaGenome model for human and mouse (variant scoring, in silico mutagenesis, REF-versus-ALT track prediction), and build Atlas website deep links. Use when the user mentions AlphaGenome, AlphaGenome Atlas, AVI or AlphaGenome Variant Impact, DeepMind variant effect prediction, or wants to prioritise or mechanistically interpret non-coding, regulatory, splicing, enhancer, promoter, or chromatin-accessibility effects of SNVs from a VCF, credible set, or region. Research use only; not a clinical tool.

analytical-method-validation

Plan, execute, and document validation, verification, and transfer of analytical procedures under the governing framework - ICH Q2(R2) and Q14, USP <1220>/<1225>/<1226>, ICH M10 bioanalytical, CLSI EP, or ISO/IEC 17025. Use for HPLC, LC-MS/MS, GC, CE, ICP-MS, dissolution, qNMR, qPCR, NIR, and ligand binding or cell-based assays whenever the question is whether a procedure is fit for its intended purpose. Triggers include

anndata

Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.

arbor

Autonomously improve a real artifact (code, training recipe, agent harness, data pipeline, prompt) against an objective and an evaluator, using Hypothesis Tree Refinement (HTR) from the Arbor paper. Use this whenever someone wants to iteratively optimize something over many experiments without overfitting — e.g.

arboreto

Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3). Use when analyzing transcriptomics data (bulk RNA-seq, single-cell RNA-seq) to identify transcription factor-target gene relationships and regulatory interactions. Supports distributed computation for large-scale datasets.

astropy

Core Python library for astronomy and astrophysics workflows that need Astropy APIs, including units/quantities, coordinates, FITS I/O, tables, time systems, WCS, and cosmology. Use when implementing or debugging astronomical data analysis code with Astropy.

autoskill

Observe the user

benchling-integration

Benchling Python SDK and REST API integration for registry entities, inventory, ELN entries, workflows, Benchling Apps, and Data Warehouse queries. Use when automating lab data with benchling-sdk or the v2 API.

bgpt-paper-search

Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server. Returns 25+ fields per paper including methods, results, sample sizes, quality scores, and conclusions. Use for literature reviews, evidence synthesis, and finding experimental details not available in abstracts alone.

bids

>

biopython

Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.

bioservices

Unified Python interface to 40+ bioinformatics services. Use when querying multiple databases (UniProt, KEGG, ChEMBL, Reactome) in a single workflow with consistent API. Best for cross-database analysis, ID mapping across services. For quick single-database lookups use gget; for sequence/file manipulation use biopython.

bulk-rnaseq

End-to-end bulk RNA-seq orchestrator — takes raw FASTQ reads through QC and trimming (FastQC, fastp/Trim Galore), alignment and quantification (STAR, Salmon, featureCounts), assembles a gene-level counts matrix, then hands off to differential expression (pydeseq2), pathway/GSEA enrichment (pathway-enrichment), and publication figures (scientific-visualization). Use whenever the user has bulk RNA-seq reads or quant output and wants a complete, reproducible differential-expression workflow — e.g.

cellxgene-census

Query the CZ CELLxGENE Census programmatically for versioned public single-cell and spatial transcriptomics data. Use when you need population-scale cell metadata, gene expression slices, Census summary counts, source H5AD URIs/downloads, embeddings, spatial Census data, or reference atlas comparisons across organisms, tissues, diseases, assays, and cell types. For analyzing your own local single-cell data use scanpy, anndata, or scvi-tools.

cirq

Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.

citation-management

Comprehensive citation management for academic research. Search OpenAlex, PubMed, and Google Scholar for papers, extract accurate metadata, validate citations, and generate properly formatted BibTeX entries. This skill should be used when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.

clinical-decision-support

Prepare and validate research-only clinical decision-support evaluation, evidence-profile, cohort, survival, biomarker/model, privacy, and governance artifacts. Use for aggregate or synthetic research documentation and traceability—not patient care or live clinical operation.

clinical-reports

Create safety-bounded draft structures and run local deterministic checks for clinical case, diagnostic, trial, safety, and aggregate research reports. Use only with synthetic, de-identified, or aggregate inputs and verified source-fact manifests; every output requires qualified review.

Skills associés