$npx -y skills add ma-compbio-lab/SkillFoundry --skill gbif-species-occurrence-search-starterUse this skill to query the official GBIF API for a canonical species match and a small live occurrence sample.
| 1 | # GBIF Species Occurrence Search Starter |
| 2 | |
| 3 | Use this skill to query the official GBIF API for a canonical species match and a small live occurrence sample. |
| 4 | |
| 5 | ## What it does |
| 6 | |
| 7 | - Resolves a scientific name against the GBIF species matcher. |
| 8 | - Fetches a compact occurrence sample with optional country filtering. |
| 9 | - Returns a normalized JSON summary suitable for biodiversity data discovery and early species-distribution workflows. |
| 10 | |
| 11 | ## When to use it |
| 12 | |
| 13 | - You need a verified starter for `Species distribution modeling`. |
| 14 | - You want a lightweight live biodiversity occurrence query without adding a heavyweight geospatial stack first. |
| 15 | |
| 16 | ## Example |
| 17 | |
| 18 | ```bash |
| 19 | python3 skills/ecology-evolution-and-biodiversity/gbif-species-occurrence-search-starter/scripts/run_gbif_species_occurrence_search.py \ |
| 20 | --scientific-name "Puma concolor" \ |
| 21 | --country US \ |
| 22 | --out scratch/gbif/puma_concolor_us.json |
| 23 | ``` |
| 24 | |
| 25 | ## Verification |
| 26 | |
| 27 | - Skill-local tests: `python3 -m unittest discover -s skills/ecology-evolution-and-biodiversity/gbif-species-occurrence-search-starter/tests -p 'test_*.py'` |
| 28 | - Repository smoke: `python3 -m unittest tests.smoke.test_phase30_empty_domain_seed_skills -v` |