Skip to content

AI Skill

The BiomAPI CLI (biomapi.py) is distributed as an Agent Skill through Claude Code and Codex plugin marketplaces.

Use the skill when an assistant needs to process a biometry PDF, image, or JSON file; retrieve a BiomPIN; generate CSV output; check usage; or inspect API status without hand-writing requests.

The host assistant passes the source path directly to the bundled script instead of reading the report into its own context. The script uploads the report to BiomAPI; PDF and image extraction also sends it to Google Gemini. Review the Privacy Policy before processing patient data.


Terminal window
/plugin marketplace add mglraimundo/biomapi-cli
/plugin install biomapi-cli@mglraimundo-biomapi-cli

Once installed, the assistant can process reports, retrieve BiomPIN results, generate CSV output, and run the supported usage and status checks through the bundled CLI.


Terminal window
codex plugin marketplace add mglraimundo/biomapi-cli
codex plugin add biomapi-cli@biomapi

Start a new task after installation so Codex loads the bundled skill.


  • biomapi.py - zero-dependency Python script using only the standard library
  • SKILL.md - agent-readable capability description and invocation guide
  • reference.md - API reference formatted for assistant context

The CLI requires Python 3.11+. BiomPIN generation remains enabled by default. Returned links may include a reversible #biomctx=... fragment containing the patient acronym and ID; handle the complete URL as patient-identifying data.

Source: mglraimundo/biomapi-cli