adam-j-ali/research-poster

Les références sont obligatoires, pas optionnelles

Cette compétence fournit 6 fichiers de référence plus deux exemples dans references/examples/. Lisez la référence appropriée AVANT l'étape qui en a besoin, jamais après pour vérifier votre travail.

• references/data-integrity.md : reproduire le résumé à partir des données source (Phase 1)
• references/venues.md : trouver et dater les règles du lieu ; kits de marque institutionnels (Phases 0 et 2)
• references/design-rules.md : seuil de lisibilité, échelle typographique, mise en page, style maison (Phase 3)
• references/build-and-charts.md : graphiques natifs, le déclencheur de réparation, pièges de python-pptx (Phase 4)
• references/rendering-qa.md : rendu, vérifications de lisibilité et de chevauchement, codes QR (Phase 5)
• references/citations.md : vérifier, formater, créer des hyperliens (Phase 2)

Cette compétence encode un workflow éprouvé. Lisez la référence appropriée AVANT l'étape qui en a besoin, jamais après pour vérifier votre travail (à ce stade, l'erreur est déjà dans le résultat) ; ne réinventez pas les parties déjà résolues (sécurité des graphiques, rendu, échelle typographique). Les scripts se trouvent dans ${CLAUDE_SKILL_DIR}/scripts/ ; les exemples et conseils approfondis se trouvent dans ${CLAUDE_SKILL_DIR}/references/. Le rendu utilise LibreOffice (multiplateforme) ou Microsoft PowerPoint sur macOS ; voir references/rendering-qa.md.

<companion_skills> Tout ce dont cette compétence a besoin est inclus ; la construction, le rendu et la vérification s'exécutent uniquement avec les scripts ici. Ces compétences optionnelles ajoutent de la finesse. Utilisez celles qui sont installées. Si l'une manque, continuez sans elle et mentionnez l'installation en une ligne à l'utilisateur une fois ; ne vous arrêtez jamais pour cela.

Compétence	Apporte	Installation (dans Claude Code)
Anthropic pptx + pdf (document-skills)	modifier un poster existant, PDFs difficiles	/plugin marketplace add anthropics/skills, puis /plugin install document-skills@anthropic-agent-skills
frontend-design	palette, appariement typographique, direction de mise en page	/plugin install frontend-design@claude-plugins-official
K-Dense citation-management (MIT)	recherche PubMed / DOI, références formatées	copiez skills/citation-management depuis github.com/K-Dense-AI/scientific-agent-skills dans ~/.claude/skills/
K-Dense scientific-visualization (MIT)	figures matplotlib style revue (route image-graphique)	même dépôt, skills/scientific-visualization

Laissez de côté K-Dense pptx-posters (une route HTML/CSS de poster qui concurrence les mêmes demandes) et scientific-writing (prose de manuscrit qui interdit les puces dont un poster a besoin). Les vérifications de citations n'ont besoin d'aucune compétence supplémentaire : la recherche web et la récupération sur PubMed / Crossref / doi.org suffisent. </companion_skills>

<execution_context> S'exécute de manière interactive OU totalement autonome. Chaque point de contrôle ci-dessous est un AskUserQuestion avec une valeur par défaut recommandée clairement indiquée, de sorte qu'une exécution autonome prend simplement les valeurs par défaut et les indique.

• 🟢 Auto (pas de question) : lire les entrées, rechercher, extraire le style maison, construire, rendre, auto-QA et itérer, git-init + commit dans le répertoire de travail du poster, nettoyer les fichiers intermédiaires.
• 🟡 Demander (avec une valeur par défaut recommandée) : dimensions du poster / spécification du lieu, auteur + affiliation + confirmation du logo, niveau de ton, profondeur des citations, moteur de graphiques (natifs modifiables vs images), et si les données sont définitives.
• 🔴 Jamais : fabriquer un nombre, un résultat ou une citation ; modifier les résultats rapportés de l'étude ; écraser un fichier que l'utilisateur a déjà finalisé (écrire toujours une copie séparée) ; livrer un fichier qui déclenche l'invite de réparation de PowerPoint ; copier des données au niveau du patient hors du fichier de l'auteur ou les envoyer à un service web (lire sur place, enregistrer uniquement les agrégats). </execution_context>

1. Collecter les entrées : le résumé PDF (obligatoire) ; un poster de référence facultatif (.pptx) pour le style maison ; des fichiers de logo facultatifs ; toutes données mises à jour.
2. Réitérer ce que vous avez compris, puis grouper les points de contrôle (un ou deux appels AskUserQuestion, chaque option marquée avec la valeur par défaut recommandée). Valeurs par défaut recommandées entre crochets :
   • Dimensions / lieu : vérifier d'abord les spécifications ePoster du lieu [par défaut] ; sinon, 16:9 diapositive unique (48x27 po) qui correspond à la plupart des visionneuses ePoster à l'écran.
   • Auteurs, affiliations et logos : confirmer avec l'auteur, pas avec le bloc de soumission du résumé (il n'est souvent pas définitif). Plusieurs institutions signifient plusieurs logos [demander lesquels].
   • Ton : niveau d'érudition modéré [par défaut] ; les données et les résultats ne changent jamais.
   • Citations : 4 à 6 références vérifiées avec des DOI/URL cliquables [par défaut].
   • Moteur de graphiques : graphiques natifs modifiables [par défaut] ; images soignées sur demande.
   • Les données sont-elles définitives ou d'autres arrivent-elles ? Si en cours, construire de manière à ce que les nombres soient triviaux à mettre à jour (bloc de données unique) et conserver le cadre préliminaire.
   • Une diapositive de poster unique ou un jeu de diapositives de présentation ? "PowerPoint pour une conférence" peut signifier l'un ou l'autre [poster].
   • Lorsque le fichier de données de l'auteur est fourni et qu'il est en désaccord avec le résumé : quels chiffres figurent sur le poster [obtenir le fichier d'analyse de l'auteur ; sinon, recalculer et reproduire, voir data-integrity.md].
   • Liens pour tous les codes QR (vidéos, article complet). Les liens manquants deviennent des espaces réservés marqués [par défaut].
   • La date limite de soumission : demander l'email d'acceptation ; une date limite peut être proche.
3. Mode autonome : prendre les valeurs par défaut, les indiquer, procéder.

1. Utiliser optionnellement les compétences compagnon si l'environnement les possède (document/pptx et pdf, dataviz, conception frontale, gestion de citations, visualisation scientifique). Ce sont des améliorations ; le workflow ci-dessous est autonome via python-pptx, matplotlib et un moteur de rendu.
2. Lire le résumé complètement : texte via pdfplumber (python-docx pour un .docx), un rendu visuel, et une vérification OCR/image pour qu'aucune figure ne soit manquée. Capturer le titre, les auteurs, les affiliations, chaque nombre et le n/N pour chacun.
3. Si l'auteur a fourni les données sous-jacentes, lire leur structure avant toutes valeurs, puis reproduire chaque figure du résumé à partir de celles-ci dans un analysis.py qui les vérifie et écrit les agrégats dans data.json. Vérifier SD vs SE, moyennes appariées vs groupées, le propre n de chaque figure, les étiquettes de catégories par rapport aux notes originales et la première ligne de données. Voir references/data-integrity.md.
4. Si un poster de référence est fourni, extraire son style maison : taille de diapositive, palette (remplissages de bandes et d'accent), polices et tailles, structure des barres de section, et le logo. Le rendre avec bash ${CLAUDE_SKILL_DIR}/scripts/render.sh pour le voir. Voir references/design-rules.md.
5. Confirmer les dépendances python : pip install python-pptx matplotlib pdfplumber pypdfium2 pillow pypdf pymupdf.

1. Vérifier les spécifications ePoster du lieu sur les propres pages de la société pour cette année (rapport d'aspect, polices, médias, fournisseur de téléchargement, date limite, formulation de divulgation requise) et les dater. Confirmer de quelle organisation chaque source traite. Voir references/venues.md, qui couvre également la prise de la palette, de la police et du logo à partir du kit de marque publié de l'institution.
2. Vérifier et récupérer les citations : réelles, vérifiées via PubMed/DOI, avec hyperliens et dates d'accès ; inclure les sources de registre et de littérature grise que l'auteur utilise réellement, pas seulement les revues. Voir references/citations.md. Ne jamais inventer une citation.
3. Récupérer tout contexte nécessaire pour l'introduction. Consulter la documentation actuelle de la bibliothèque lors de la construction.

1. Définir les jetons de style maison, une grille de colonnes, une hiérarchie visuelle claire, une typographie à l'échelle du poster, un espacement aéré et un contraste fort. Voir references/design-rules.md.
2. Choisir les types de graphiques honnêtement : anneau/camembert uniquement pour les parties d'un tout ; un graphique à barres pour les proportions indépendantes ou non mutuellement exclusives ; des tuiles à grands nombres pour les chiffres uniques. Étiqueter chaque graphique avec son n/N. Voir references/build-and-charts.md.
3. Définir un bloc de données modifiable qui pilote chaque graphique et légende.

1. Adapter references/examples/build_poster_example.py (graphiques natifs modifiables) ou references/examples/make_charts_example.py (images matplotlib) au contenu et au style maison.
2. Construire des graphiques natifs modifiables avec un style sécurisé pour PowerPoint UNIQUEMENT. La seule règle absolue : ne jamais définir la POSITION d'une étiquette de données d'anneau/camembert, c'est le paramètre qui fait que PowerPoint répare et supprime le graphique. Les remplissages par tranche, les légendes, les étiquettes de pourcentage, les formats de nombre et les polices d'axe sont tous sûrs. Mettre le pourcentage de l'anneau dans la légende plus un grand nombre dans le trou. Recette complète dans references/build-and-charts.md.
3. TDD-léger : vérifier que chaque pourcentage affiché se recalcule à partir du nombre source avant d'enregistrer.
4. Obtenir les auteurs, affiliations et logos corrects selon la Phase 0.
5. Contrôle de lisibilité : définir chaque taille à partir d'un tableau d'échelle typographique avec un seuil minimal (22 pt sur une diapositive de 48 po), définir chart.font.size sur chaque graphique, et terminer la construction en échouant si une taille dans le fichier enregistré est inférieure au seuil (scripts/check_fonts.py). Voir references/design-rules.md.
6. Contrôle de préparation : conserver les éléments non confirmés (liste des auteurs, affiliation, divulgations, liens) dans une liste de contrôle CONFIRMÉ dans la construction. Jusqu'à ce que tous soient Vrai, nommer la sortie ..._DRAFT.pptx, marquer chaque lacune visiblement sur le poster, et imprimer ce qui est encore ouvert.

1. Rendre avec bash ${CLAUDE_SKILL_DIR}/scripts/render.sh <pptx> <out.pdf> <out.png> 1.7 (LibreOffice, ou PowerPoint sur macOS), puis visualiser le PNG.
2. Pour les graphiques natifs, exécuter python3 ${CLAUDE_SKILL_DIR}/scripts/check_charts.py <pptx> : il échoue si un anneau/camembert porte une position d'étiquette de données, le paramètre qui fait que PowerPoint supprime le graphique à l'ouverture.
3. Exécuter scripts/check_fonts.py <pptx> et scripts/check_overlap.py <rendered.pdf>, puis réduire le rendu à 1920x1080 et visualiser les régions les plus denses sous forme de recadrages 1:1. Décoder chaque code QR à partir du rendu. Voir references/rendering-qa.md.
4. Corriger selon la liste de contrôle references/rendering-qa.md : pas de débordement ou de rognage, type assez grand, espacement aéré, contraste élevé, colonnes alignées, nombres corrects. Itérer jusqu'à ce que ce soit vraiment bon avant de montrer à l'utilisateur.

1. Écrire une copie SÉPARÉE, clairement nommée ; ne jamais écraser un fichier que l'utilisateur a finalisé.
2. Livrer le .pptx, un PDF de soumission et un PNG d'aperçu.
3. Initialiser git dans le répertoire de travail du poster si nécessaire et commiter avec un message clair (d'abord la base de référence lors de l'itération sur un poster existant, afin que la version précédente soit préservée).
4. Supprimer les rendus intermédiaires et les fichiers temporaires ; conserver les scripts de construction reproductibles.

<success_criteria>

• Le livrable est un .pptx modifiable plus un PDF correspondant (taille de page vérifiée) et un PNG d'aperçu
• Les graphiques sont natifs et modifiables (par défaut) et survivent à l'ouverture dans PowerPoint sans invite de réparation
• Chaque pourcentage se recalcule à partir du nombre source ; n/N affiché ; le cadre préliminaire conservé si en cours
• Les citations sont toutes réelles et vérifiées, avec des hyperliens DOI/URL
• Auteurs, affiliations et logos confirmés avec l'utilisateur
• Chaque figure que le résumé énonce se reproduit à partir des données source (lorsque les données ont été fournies)
• Aucun texte en dessous du seuil (check_fonts.py), aucun texte chevauchant (check_overlap.py), lisible dans des recadrages 1:1 de la vue 1080p ; espacement aéré, contraste fort, colonnes alignées
• Chaque code QR se décode à partir du rendu pour donner exactement son lien ; les espaces réservés maintiennent le fichier en DRAFT
• Le style maison correspond au poster de référence lorsqu'il a été fourni
• Une copie séparée a été écrite ; le fichier finalisé de l'utilisateur n'a pas été écrasé ; git a été initialisé si nécessaire

…

[La fin du contenu a été tronquée pour la traduction – la structure du succès continue de la même manière] </success_criteria>