How do I install the Uoa Map skill?

Run npx skillmds@latest add pengqianhan/uoa-map in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Uoa Map safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Uoa Map?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Uoa Map free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Uoa Map?

pengqianhan (@pengqianhan) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Uoa Map by pengqianhan — Agent Skill

Name: Uoa Map
Author: pengqianhan

Uoa Map

Query University of Auckland (UoA) campus buildings, room numbers, lecture theatres, campus facilities, and indoor/outdoor walking routes. Use when Codex or code agents need to look up room locations (e.g. "Where is 303-G20?"), find building numbers (e.g. "Where is OGGB / Building 260?"), search campus amenities (e.g. cafes, drinking fountains, restrooms, libraries), or plan step-by-step walking routes across UoA campuses.

pengqianhan cd8c22a 4 files · 25.9 KB Updated Sep 17, 2026

File contents

UoA Campus Map & Wayfinding

Overview

Use this skill to look up University of Auckland (UoA) buildings, classrooms, lecture theatres, facilities, and indoor/outdoor walking directions across all 8 UoA campuses (City, Grafton, Newmarket, Tai Tonga, Tai Tokerau, Leigh, Ardmore, Waiheke).

This skill uses a zero-dependency CLI tool (scripts/uoa_map.py) powered entirely by Python's standard library to communicate directly with UoA's public MapsIndoors API (https://maps.auckland.ac.nz).

Workflow

Identify the user's inquiry:
- Room or Location Lookup: User gives a room code (e.g. 303-G20, 260-098, OGGB3) or a place name (e.g. General Library, Strata Cafe).
- Building Identification: User asks for building details, building number, or address.
- Route & Navigation: User asks how to walk from point A to point B on campus.
- Facility Search: User asks for nearest drinking fountain, microwave, printer, or cafe.
Read references/current-guidance.md for campus code mapping and building numbering conventions.
Run the CLI tool scripts/uoa_map.py to retrieve verified live data from UoA Maps:
- python3 skills/uoa-map/scripts/uoa_map.py search "<keyword>" --json
- python3 skills/uoa-map/scripts/uoa_map.py building "<building_number_or_name>" --json
- python3 skills/uoa-map/scripts/uoa_map.py route --from "<origin>" --to "<destination>" --json
Formulate the response with:
- Specific Building Number and Building Name
- Floor level (e.g. Ground Floor, Level 3, Basement)
- Room number and accessibility notes
- Step-by-step walking directions if requested

CLI Commands Reference

All commands use pure Python standard library with no external dependencies:

# 1. Search room, lecture hall, or facility
python3 skills/uoa-map/scripts/uoa_map.py search "303-G20"
python3 skills/uoa-map/scripts/uoa_map.py search "OGGB" --json

# 2. Query building info by number or name
python3 skills/uoa-map/scripts/uoa_map.py building "260"
python3 skills/uoa-map/scripts/uoa_map.py building "Library"

# 3. Calculate indoor & outdoor walking route
python3 skills/uoa-map/scripts/uoa_map.py route --from "General Library" --to "OGGB"
python3 skills/uoa-map/scripts/uoa_map.py route --from "303-G20" --to "401-401" --avoid-stairs

# 4. List all campuses
python3 skills/uoa-map/scripts/uoa_map.py venue

# 5. Browse amenity categories
python3 skills/uoa-map/scripts/uoa_map.py category "Food"

Answering Rules

Always provide the Building Number (e.g. Building 260) alongside the building name (e.g. Sir Owen G Glenn Building (OGGB)).
Clarify the Floor Level (e.g. Level G is ground floor, Level B is basement, Level 1 is upper floor).
When giving directions, mention indoor vs outdoor transitions and floor changes clearly.
If a room is not found, offer fuzzy matching suggestions using uoa_map.py search.

References

Guidance: references/current-guidance.md
CLI Tool: scripts/uoa_map.py
Official Web Map: https://maps.auckland.ac.nz/auckland/29ba645554a3413ab0b28dfb/search

---name: uoa-mapdescription: Query University of Auckland (UoA) campus buildings, room numbers, lecture theatres, campus facilities, and indoor/outdoor walking routes. Use when Codex or code agents need to look up room locations (e.g. "Where is 303-G20?"), find building numbers (e.g. "Where is OGGB / Building 260?"), search campus amenities (e.g. cafes, drinking fountains, restrooms, libraries), or plan step-by-step walking routes across UoA campuses.---# UoA Campus Map & Wayfinding## OverviewUse this skill to look up University of Auckland (UoA) buildings, classrooms, lecture theatres, facilities, and indoor/outdoor walking directions across all 8 UoA campuses (City, Grafton, Newmarket, Tai Tonga, Tai Tokerau, Leigh, Ardmore, Waiheke).This skill uses a zero-dependency CLI tool (`scripts/uoa_map.py`) powered entirely by Python's standard library to communicate directly with UoA's public MapsIndoors API (`https://maps.auckland.ac.nz`).## Workflow1. Identify the user's inquiry: - **Room or Location Lookup**: User gives a room code (e.g. `303-G20`, `260-098`, `OGGB3`) or a place name (e.g. `General Library`, `Strata Cafe`). - **Building Identification**: User asks for building details, building number, or address. - **Route & Navigation**: User asks how to walk from point A to point B on campus. - **Facility Search**: User asks for nearest drinking fountain, microwave, printer, or cafe.2. Read [references/current-guidance.md](references/current-guidance.md) for campus code mapping and building numbering conventions.3. Run the CLI tool `scripts/uoa_map.py` to retrieve verified live data from UoA Maps: - `python3 skills/uoa-map/scripts/uoa_map.py search "<keyword>" --json` - `python3 skills/uoa-map/scripts/uoa_map.py building "<building_number_or_name>" --json` - `python3 skills/uoa-map/scripts/uoa_map.py route --from "<origin>" --to "<destination>" --json`4. Formulate the response with: - Specific Building Number and Building Name - Floor level (e.g. Ground Floor, Level 3, Basement) - Room number and accessibility notes - Step-by-step walking directions if requested## CLI Commands ReferenceAll commands use pure Python standard library with no external dependencies:```bash# 1. Search room, lecture hall, or facilitypython3 skills/uoa-map/scripts/uoa_map.py search "303-G20"python3 skills/uoa-map/scripts/uoa_map.py search "OGGB" --json# 2. Query building info by number or namepython3 skills/uoa-map/scripts/uoa_map.py building "260"python3 skills/uoa-map/scripts/uoa_map.py building "Library"# 3. Calculate indoor & outdoor walking routepython3 skills/uoa-map/scripts/uoa_map.py route --from "General Library" --to "OGGB"python3 skills/uoa-map/scripts/uoa_map.py route --from "303-G20" --to "401-401" --avoid-stairs# 4. List all campusespython3 skills/uoa-map/scripts/uoa_map.py venue# 5. Browse amenity categoriespython3 skills/uoa-map/scripts/uoa_map.py category "Food"```## Answering Rules- Always provide the **Building Number** (e.g. `Building 260`) alongside the building name (e.g. `Sir Owen G Glenn Building (OGGB)`).- Clarify the **Floor Level** (e.g. `Level G` is ground floor, `Level B` is basement, `Level 1` is upper floor).- When giving directions, mention indoor vs outdoor transitions and floor changes clearly.- If a room is not found, offer fuzzy matching suggestions using `uoa_map.py search`.## References- Guidance: [references/current-guidance.md](references/current-guidance.md)- CLI Tool: [scripts/uoa_map.py](scripts/uoa_map.py)- Official Web Map: `https://maps.auckland.ac.nz/auckland/29ba645554a3413ab0b28dfb/search`

Frequently asked questions