Communitygithub.com

zhoy0409-debug/scholarflow-skills

Compétences ScholarFlow de Zhoy : compétences d'agent réutilisables pour la revue de littérature, la rédaction académique, les figures, la bioinformatique et les livrables de recherche.

Qu'est-ce que scholarflow-skills ?

Cette compétence d'agent spécialisée dans la manipulation de PDF fournit des instructions directrices pour la lecture, la création et la validation de documents PDF, en mettant l'accent sur la fidélité de la mise en page et la qualité visuelle. Elle est idéale pour les chercheurs, les rédacteurs académiques et les développeurs d'outils de recherche qui ont besoin de résultats PDF fiables. La compétence prend en charge les workflows de prévisualisation visuelle en utilisant `pdftoppm` pour convertir les pages PDF en PNG, permettant une inspection complète de la mise en page. Pour la création de PDF, elle s'appuie sur `reportlab`, et elle utilise `pdfplumber` ou `pypdf` pour l'extraction de texte, mais ne fait pas confiance à ces derniers pour les détails de mise en page. La compétence établit également des conventions pour les fichiers temporaires (`tmp/pdfs/`) et les artefacts finaux (`output/pdf/`), garantissant un travail organisé. Elle détaille les dépendances nécessaires, notamment `uv` pour la gestion des paquets Python, et fournit des commandes pour les outils système (Poppler) sur différentes plateformes. La compétence insiste sur des contrôles de qualité rigoureux, exigeant l'absence de défauts visuels, une typographie cohérente et le respect des formats de citation avant la livraison finale.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

Demander à votre IA préférée

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

Documentation

Compétence PDF

Quand l'utiliser

  • Lire ou réviser le contenu PDF lorsque la mise en page et les visuels sont importants.
  • Créer des PDF par programmation avec un formatage fiable.
  • Valider le rendu final avant la livraison.

Workflow

  1. Privilégier la révision visuelle : convertir les pages PDF en PNG et les inspecter.
    • Utiliser pdftoppm si disponible.
    • S'il n'est pas disponible, installer Poppler ou demander à l'utilisateur de réviser la sortie localement.
  2. Utiliser reportlab pour générer des PDF lors de la création de nouveaux documents.
  3. Utiliser pdfplumber (ou pypdf) pour l'extraction de texte et les vérifications rapides ; ne pas s'y fier pour la fidélité de la mise en page.
  4. Après chaque mise à jour significative, re-rendre les pages et vérifier l'alignement, l'espacement et la lisibilité.

Conventions pour les fichiers temporaires et de sortie

  • Utiliser tmp/pdfs/ pour les fichiers intermédiaires ; les supprimer une fois terminé.
  • Écrire les artefacts finaux dans output/pdf/ lorsqu'on travaille dans ce dépôt.
  • Conserver des noms de fichiers stables et descriptifs.

Dépendances (installer si manquantes)

Préférer uv pour la gestion des dépendances.

Paquets Python :

uv pip install reportlab pdfplumber pypdf

Si uv n'est pas disponible :

python3 -m pip install reportlab pdfplumber pypdf

Outils système (pour le rendu) :

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

Si l'installation n'est pas possible dans cet environnement, indiquer à l'utilisateur quelle dépendance manque et comment l'installer localement.

Environnement

Aucune variable d'environnement requise.

Commande de rendu

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Exigences de qualité

  • Maintenir une conception visuelle soignée : typographie, espacement, marges et hiérarchie des sections cohérents.
  • Éviter les problèmes de rendu : texte tronqué, éléments chevauchants, tableaux cassés, carrés noirs ou glyphes illisibles.
  • Les graphiques, tableaux et images doivent être nets, alignés et clairement étiquetés.
  • Utiliser uniquement des traits d'union ASCII. Éviter U+2011 (trait d'union insécable) et autres tirets Unicode.
  • Les citations et références doivent être lisibles par un humain ; ne jamais laisser de jetons d'outil ou de chaînes de substitution.

Vérifications finales

  • Ne pas livrer tant que la dernière inspection PNG ne montre aucun défaut visuel ou de formatage.
  • Confirmer que les en-têtes/pieds de page, la numérotation des pages et les transitions entre les sections sont soignés.
  • Garder les fichiers intermédiaires organisés ou les supprimer après l'approbation finale.

Skills associés