Communitygithub.com

pubmed-database

Workflows de recherche directe dans PubMed et les E-utilities NCBI pour la littérature biomédicale, les requêtes MeSH, la recherche de PMID, la récupération de citations et la surveillance de littérature via API. À utiliser lorsqu'une tâche nécessite de la littérature biomédicale plutôt qu'une recherche web générale.

Qu'est-ce que pubmed-database ?

Cette compétence permet d'effectuer des recherches avancées dans la base de données PubMed (MEDLINE) et d'interagir avec les E-utilities du NCBI (National Center for Biotechnology Information) pour des workflows reproductibles de littérature biomédicale. Elle est idéale pour les chercheurs, les professionnels de santé et les ingénieurs en IA qui ont besoin de requêtes précises avec des termes MeSH, des balises de champ (titre, résumé, auteur, type de publication, etc.), des filtres de date et de disponibilité. La compétence fournit des exemples concrets de construction de requêtes booléennes, d'utilisation des sous-titres MeSH, et d'appels API en Python (esearch, esummary, efetch, elink) avec gestion des clés API et respect des limites de débit. Elle inclut également des bonnes pratiques de documentation des recherches (chaîne exacte, filtres, nombre de résultats) et une checklist de revue pour garantir la reproductibilité et la fiabilité des résultats. Contrairement à une recherche web générale, cette compétence est spécifiquement conçue pour la littérature scientifique indexée dans PubMed et les outils associés du NCBI.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/scientific-db-pubmed-database

Demander à votre IA préférée

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

Documentation

Base de données PubMed

Utilisez cette compétence lorsqu'une tâche nécessite de la littérature biomédicale provenant de PubMed plutôt qu'une recherche web générale.

Quand l'utiliser

  • Recherche dans MEDLINE ou la littérature en sciences de la vie.
  • Construction de requêtes PubMed avec des termes MeSH, des balises de champ, des dates ou des types d'article.
  • Consultation de PMID, résumés, métadonnées de publication ou citations connexes.
  • Réalisation de passes de recherche systématique nécessitant des chaînes de recherche reproductibles.
  • Utilisation des E-utilities NCBI directement depuis Python, le shell ou un autre client HTTP.

Construction de requêtes

Commencez par la question de recherche, divisez-la en concepts, puis combinez les concepts avec des opérateurs booléens.

concept_1 AND concept_2 AND filtre
synonyme_a OR synonyme_b
NOT terme_exclu

Balises de champ PubMed utiles :

  • [ti] : titre
  • [ab] : résumé
  • [tiab] : titre ou résumé
  • [au] : auteur
  • [ta] : abréviation du titre de la revue
  • [mh] : terme MeSH
  • [majr] : sujet MeSH principal
  • [pt] : type de publication
  • [dp] : date de publication
  • [la] : langue

Exemples :

diabetes mellitus[mh] AND treatment[tiab] AND systematic review[pt] AND 2023:2026[dp]
(metformin[nm] OR insulin[nm]) AND diabetes mellitus, type 2[mh] AND randomized controlled trial[pt]
smith ja[au] AND cancer[tiab] AND 2026[dp] AND english[la]

MeSH et sous-titres

Préférez le MeSH lorsque le concept possède un terme de vocabulaire contrôlé stable. Combinez le MeSH avec des termes de titre/résumé lorsque le sujet est nouveau ou que la terminologie varie.

La syntaxe correcte des sous-titres place le sous-titre avant la balise de champ :

diabetes mellitus, type 2/drug therapy[mh]
cardiovascular diseases/prevention & control[mh]

Utilisez [majr] uniquement lorsque le sujet doit être central dans l'article. Cela peut améliorer la précision mais peut manquer des travaux pertinents.

Filtres

Types de publication :

  • clinical trial[pt]
  • meta-analysis[pt]
  • randomized controlled trial[pt]
  • review[pt]
  • systematic review[pt]
  • guideline[pt]

Filtres de date :

2026[dp]
2020:2026[dp]
2026/03/15[dp]

Filtres de disponibilité :

free full text[sb]
hasabstract[text]

Workflow E-utilities

Les E-utilities NCBI prennent en charge des workflows API reproductibles :

  1. esearch.fcgi : recherche et renvoie les PMID.
  2. esummary.fcgi : renvoie les métadonnées légères des articles.
  3. efetch.fcgi : récupère les résumés ou les enregistrements complets en XML, MEDLINE ou texte.
  4. elink.fcgi : trouve les articles connexes et les ressources liées.

Utilisez une adresse e-mail et une clé API pour les scripts de production. Stockez les clés API dans des variables d'environnement, jamais dans des fichiers commités ou l'historique des commandes.

import os
import time
import requests

BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"


def esearch(query: str, retmax: int = 20) -> list[str]:
    params = {
        "db": "pubmed",
        "term": query,
        "retmode": "json",
        "retmax": retmax,
        "tool": "ecc-pubmed-search",
        "email": os.environ.get("NCBI_EMAIL", ""),
    }
    api_key = os.environ.get("NCBI_API_KEY")
    if api_key:
        params["api_key"] = api_key

    response = requests.get(f"{BASE}/esearch.fcgi", params=params, timeout=30)
    response.raise_for_status()
    time.sleep(0.35)
    return response.json()["esearchresult"]["idlist"]


pmids = esearch("hypertension[mh] AND randomized controlled trial[pt] AND 2024:2026[dp]")
print(pmids)

Pour les lots, préférez les paramètres du serveur d'historique NCBI (usehistory=y, WebEnv, query_key) plutôt que de passer de très longues listes de PMID via des URL.

Discipline de sortie

Pour chaque passe de recherche, enregistrez :

  • chaîne de recherche exacte
  • base de données consultée
  • date de la recherche
  • filtres utilisés
  • nombre de résultats
  • format d'exportation
  • toute exclusion manuelle

Exemple :

| Base de données | Date de recherche | Requête | Filtres | Résultats |
| --- | --- | --- | --- | ---: |
| PubMed | 2026-05-11 | `sickle cell disease[mh] AND CRISPR[tiab]` | 2020:2026[dp], Anglais | 42 |

Liste de vérification

  • Les balises de champ sont-elles des balises PubMed valides ?
  • Les termes MeSH sont-ils associés à des synonymes en texte libre pour les sujets plus récents ?
  • La plage de dates est-elle explicite et appropriée ?
  • Le journal de recherche inclut-il suffisamment de détails pour reproduire la requête ?
  • Les clés API sont-elles chargées depuis l'environnement ?
  • Le code HTTP appelle-t-il raise_for_status() ou gère-t-il autrement les réponses non-200 avant l'analyse ?
  • Les limites de débit sont-elles respectées ?

Références

Individual skills in this repo

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

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Skills associés