pubmed-field-validator

Validate PubMed search field tags against official NCBI documentation.

1|Updated Jun 24, 2025
One-click install
npx skills add https://github.com/illumination-k/pubmed-client --skill pubmed-field-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pubmed-field-validator
Source: https://github.com/illumination-k/pubmed-client/tree/main/.claude/skills/pubmed-field-validator
Command: npx skills add https://github.com/illumination-k/pubmed-client --skill pubmed-field-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building PubMed queries with incorrect field tags leads to failed searches, inaccurate results, and wasted research time. This Skill automates the validation of PubMed field tags against official NCBI documentation, ensuring your queries are always precise and compliant.

Core Features & Use Cases:

  • Official Documentation Validation: Automatically checks field tags against the latest NCBI PubMed help, confirming their existence, syntax, and usage.
  • Invalid Tag Detection: Identifies common mistakes like [organism] or [Title] and suggests correct alternatives (e.g., MeSH terms or short forms).
  • Codebase Audit: Scans your project's source code to find all used field tags, validating them in bulk and flagging any non-compliant usage.
  • Use Case: You're developing a new feature to search PubMed by grant number. Before coding, use this Skill to verify [gr] is a valid tag, understand its syntax, and ensure your implementation aligns with NCBI standards, saving you debugging time later.

Quick Start: Validate the PubMed field tags ti, au, and organism for me.

Frequently Asked Questions about pubmed-field-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate PubMed field tags to ensure my queries are correct?

PubMed field tag validation checks your search tags against official NCBI documentation to confirm they're syntactically correct and recognized. This prevents failed searches and ensures accurate results by catching common mistakes like incorrect capitalization or deprecated tags before query execution.

What are common PubMed field tag errors and how do I fix them?

Common errors include using full-form tags like `[organism]` instead of short forms like `[orgn]`, or applying uppercase syntax. The validator identifies these mistakes, classifies them as invalid or deprecated, and suggests correct alternatives aligned with NCBI standards.

Can I audit my entire codebase for invalid PubMed field tags?

Yes, bulk validation scans your source code to find all used field tags and flags non-compliant usage in one pass. This identifies problematic tags across your project without manual inspection, then provides statuses and guidance for each tag found.

How do I know if a PubMed field tag is deprecated or no longer supported?

The validator checks tags against predefined dictionaries that distinguish valid, deprecated, and invalid tags. It returns a status for each tag with descriptive messages, letting you update code before deprecated tags stop working in NCBI queries.

What's the correct syntax for PubMed field tags when building queries?

PubMed field tags use short-form lowercase syntax without brackets in the validation process—for example, `ti` for title, `au` for author. The validator normalizes by stripping brackets and enforces lowercase to standardize your query construction.

Do I need to manually check NCBI documentation every time I add a new field tag?

No, the validator automatically checks field tags against the latest NCBI PubMed help documentation. This eliminates manual lookups and ensures your tags stay compliant without reviewing official docs repeatedly.