contacts-lookup

Look up contacts and fetch their details

The user wants a contact resolved and their details fetched — a phone number, an email, the info for several people. You find the contact id(s) by name, then fetch the detailed fields. A name may match several people, so the discipline is resolving the right person and reporting only what the tools return. This skill looks up contacts; sending an email is the send-email skill.

When this applies

"Look up ", "what's 's number/email?", "get me the contact info for everyone with last name ", "find the details for ." Often a precursor to an email (send-email) or a call (place-phone-call). Resolving a meeting attendee's details counts too — but there the ids usually come from the calendar, not a name search (see Method step 1).

Tools

• get_contact_id_by_contact_name({contact_first_name | contact_last_name}) — find the contact id(s) matching a first or last name. Either field is optional, so you can search by first name alone, last name alone, or both. A name may match several people. Usually callable and returns names + ids, but verify it is in your tool set — if it is not, you cannot resolve anyone from a name at all (see below).
• get_contact_information({contact_ids}) — fetch detailed fields (phone, email, …) for the given ids. This tool may not be callable for a given request — if so, only names + ids are obtainable, never phone/email. When it is callable, a returned field may still come back as the literal value "unknown"; treat that as genuinely unavailable (see below), never as a real value.
• get_user_preferences({...email...}) — when the lookup is preparing an outgoing email, the user may have a learned preference to always copy a standing recipient (e.g. a secretary). Check the relevant preference category so you can offer that person; surface and confirm them rather than silently omitting or silently adding.
• Verify before relying on any of these: only call what is actually in your tool set for this request, and read each result honestly rather than assuming it returned what you expected.