Communitygithub.com

brycewang-stanford/Awesome-Journal-Skills

À utiliser lors de la préparation des documents de transparence pour un manuscrit de Public Opinion Quarterly (POQ) – l'annexe A « Éléments de divulgation » conforme à l'AAPOR, le package de réplication déposé sur Harvard Dataverse de POQ, et la déclaration de disponibilité des données. POQ exige des documents qui reproduisent exactement tous les tableaux et figures publiés, archivés avant la mise en page. Prépare les documents ; ne supprime pas les exigences.

Qu'est-ce que Awesome-Journal-Skills ?

Cette compétence automatise la préparation des documents de transparence exigés par la revue *Public Opinion Quarterly* (POQ), conformément aux normes de l'AAPOR. Elle aide à générer l'Annexe A (éléments de divulgation), le package de réplication déposé sur le Harvard Dataverse de POQ, et la déclaration de disponibilité des données (DAS). Elle est utile pour les chercheurs en sciences sociales empêchant un blocage du processus éditorial avant la mise en page. La compétence s'exécute sur les plateformes de développement d'agents comme Claude Code, Cursor ou Codex, et se base sur un fichier SKILL.md qui décrit les étapes et les vérifications à effectuer sans intervention manuelle.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brycewang-stanford/Awesome-Journal-Skills/tree/HEAD/Public-Opinion-Quarterly-Skills/skills/poq-transparency-and-data-policy

Demander à votre IA préférée

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

Documentation

Transparency & Data Policy (poq-transparency-and-data-policy)

POQ a deux exigences de transparence qui la distinguent des revues génériques en sciences sociales : la divulgation méthodologique conforme à l'AAPOR pour chaque enquête, et un package de réplication qui reproduit exactement tous les tableaux et figures publiés, archivé dans le Dataverse de POQ avant que l'article ne passe à la mise en page. Construisez les deux au fur et à mesure pour que l'acceptation ne soit pas bloquée.

Quand déclencher

  • Rassembler l'Annexe A : Éléments de divulgation pour chaque jeu de données rapporté
  • Construire le package de réplication/reproduction pour le Dataverse de POQ
  • Un manuscrit a été accepté et le bureau a demandé les documents avant la mise en page
  • Les données ne peuvent pas être entièrement partagées (confidentialité, éthique, restrictions du fournisseur) et vous avez besoin de la voie d'exemption

Divulgation AAPOR — Annexe A : Éléments de divulgation

POQ exige que les manuscrits divulguent ces éléments pour toutes les données rapportées (si applicable) ou renvoient à une documentation publique / publiée, rassemblés dans une « Annexe A : Éléments de divulgation » :

  1. Financement — qui a sponsorisé la collecte de données.
  2. Libellé exact des questions de toutes les questions d'enquête utilisées.
  3. Population étudiée — une description claire.
  4. Plan d'échantillonnage — base, sélection, stratification, grappes.
  5. Méthode et dates de collecte des données — mode(s) et période de terrain.
  6. Taux de réponse et méthode de calcul — selon les Définitions standard de l'AAPOR (indiquez RR1–RR6 et montrez le calcul des codes de disposition).
  7. Tailles d'échantillon et discussion de la précision des résultats.
  8. Effet de plan dû au regroupement et à la pondération — discutez de l'ajustement.

Pour les données secondaires, renvoyez à la documentation publique plutôt que de la reproduire.

Package de réplication — Dataverse POQ (Harvard)

  1. Déposer sur le Dataverse de POQ dans Harvard Dataverse (l'archive permanente de la revue avec des identifiants persistants) — pas un site web personnel ou un lien cloud générique.
  2. Reproduire exactement tous les tableaux et figures publiés : données + code + documentation suffisants pour régénérer chaque résultat rapporté. Script maître + README + versions figées + graines aléatoires.
  3. Archivé avant la mise en page — les manuscrits acceptés n'avancent pas tant que les documents ne sont pas en place.
  4. Déclaration de disponibilité des données (DAS) dans les annexes de l'article décrivant où/comment accéder aux données.

Quand les données ne peuvent pas être partagées (voie d'exemption)

  • Expliquez pourquoi les données sont restreintes (confidentialité, éthique, limites du fournisseur/juridiques).
  • Fournissez des instructions README sur la manière exacte dont d'autres peuvent obtenir les données (processus d'accès, contact).
  • Dans la mesure du possible, fournissez des données synthétiques pour que le code puisse être exécuté.
  • Un embargo de douze mois à partir de la parution de l'article peut être demandé (confirmez les conditions actuelles — 待核实).

Liste de vérification « construire au fur et à mesure »

  • Annexe A rédigée avec les huit éléments de divulgation (ou liens) pour chaque jeu de données
  • Taux de réponse indiqué avec la définition AAPOR + le calcul
  • Un script maître régénère chaque tableau et figure
  • README + provenance + graines aléatoires + versions figées
  • Les numéros des figures dans le manuscrit correspondent exactement à la sortie du package
  • Déclaration de disponibilité des données rédigée pour les annexes
  • Données restreintes : note d'exemption + chemin d'accès + données synthétiques + demande d'embargo si nécessaire

Anti-patrons

  • Un taux de réponse sans définition AAPOR ni calcul (un échec de l'Annexe A)
  • Considérer le dépôt comme une réflexion post-publication (il bloque la mise en page)
  • Code qui ne reproduit pas réellement les tableaux/figures imprimés
  • Une URL personnelle au lieu du Dataverse de POQ
  • Prétendre que les données sont restreintes sans chemin d'accès ni substitut synthétique

Format de sortie

【Annexe A】les 8 éléments de divulgation présents (ou liés) ? [O/N]
【Taux de réponse】définition AAPOR + calcul montré ? [O/N]
【Dépôt】Dataverse POQ (Harvard) — package prêt ? [O/N]
【Reproduit tableaux/figures ?】script maître vérifié localement ? [O/N]
【Documentation】README + provenance + graines + versions figées ? [O/N]
【DAS】rédigé pour les annexes ? [O/N]
【Données restreintes ?】exemption + chemin d'accès + synthétique + embargo ?
【Suivant】poq-review-process

Ressources supplémentaires

Individual skills in this repo

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

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and the data/code archive for a Conservation Biology manuscript. The journal (Wiley/SCB) requires a data-availability statement for research/synthesis articles, encourages data sharing, and requires sensitive species data to be protected. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and reproducibility materials for a Demography (PAA / Duke University Press) manuscript. Demography requires a data availability statement at acceptance with persistent identifiers and encourages reproducible, commented code; it hosts no repository, so authors deposit in a FAIR repository. Covers restricted-data exemptions. Prepares the materials; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Light: Science & Applications or deciding whether a photonics manuscript fits this venue. Encodes the journal's fit, the Nature-Portfolio significance bar, optical-measurement rigor, open-access house style, the Light-vs-Optica-vs-review routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Biomedical Engineering or deciding whether a biomedical-engineering / health-technology manuscript fits this venue. Encodes the journal's fit, the Nature-style biomedical-significance and translational bar, validation and evidence rigor, house style, the device-vs-biomaterials-vs-clinical routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Electronics or deciding whether an electronic-devices / circuits / systems manuscript fits this venue. Encodes the journal's fit, the Nature-style significance and field-advancing bar, device-and-system measurement rigor, house style, the device-vs-materials-vs-systems routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Biotechnology or deciding whether a biotechnology/enabling-methods manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Cell Biology or deciding whether a cell-biology manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Geoscience or deciding whether an earth science manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Materials or deciding whether a materials science manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Nanotechnology or deciding whether a nanotechnology manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the Data Availability Statement and replication materials for a Governance: An International Journal of Policy, Administration, and Institutions manuscript. Governance requires the statement (mandatory) and encourages sharing data/code in a DOI-citable repository, but does not run a verified pre-publication reproduction check like APSR. Builds the statement and materials; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the replication/transparency materials for an International Organization (IO) manuscript. IO's signature requirement is verification BEFORE final acceptance — the editorial staff request data and code at conditional acceptance, IO staff re-run quantitative results and check proofs of formal models, and editors withhold final acceptance until all reported results are confirmed; materials then deposit to the IO Dataverse with a DOI and a Data Availability Statement. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the replication / transparency materials for a Journal of Policy Analysis and Management (JPAM) manuscript — depositing data and code in a public repository so the reported results can be reproduced, with an honest exemption path for restricted administrative data. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and reproducibility materials for a Population and Development Review (PDR, Wiley / Population Council) manuscript. PDR follows Wiley's data-sharing and research-integrity expectations — a data availability statement, ORCID, and reproducible, well-documented materials deposited in a FAIR repository (verify current policy). Covers restricted-data exemptions. Prepares the materials; it does not waive requirements.

Skills associés