--- name: contact-list description: "Single source of truth for all contacts, PAs, and WhatsApp groups. Use when: looking up a phone number, email, address, PA, group JID, adding/updating a contact, or before sending any WhatsApp message. Reads and writes contact-list.md in the workspace root." --- # Contact List Skill ## Minimum Model Any model. This is a lookup/edit skill. --- ## Source File All contact data lives in **`contact-list.md`** (workspace root). This is the ONLY source of truth. ❌ Do NOT use `data/contacts.md`, `PA_LIST.md`, `addresses.md`, `builders_leadership.md`, or `groups_index.md` — they are deprecated. ### File Structure `contact-list.md` has these sections: | Section | Content | |---|---| | **אנשי קשר** | Main contacts table: שם, טלפון, אימייל, כתובת, עיר, Owner Role, PA, הערות | | **Active PAs** | PA↔Owner mapping with phones and status | | **PA Sync List** | DM targets for pa-network-daily-sync | | **Contacts Without PA** | Interested/pending PA contacts | | **WhatsApp Groups** | All group JIDs (English + Hebrew) | --- ## Lookup ### Find a contact by name ```bash grep -i "SEARCH_TERM" /path/to/workspace/contact-list.md ``` Replace `SEARCH_TERM` with the name (partial match OK, case-insensitive). ### Find a PA by owner name ```bash grep -i "OWNER_NAME" /path/to/workspace/contact-list.md | head -5 ``` The PA column in the contacts table shows `PA_NAME (+phone)`. The Active PAs section has the full mapping. ### Find a group JID ```bash grep -i "GROUP_NAME" /path/to/workspace/contact-list.md ``` Look in the WhatsApp Groups section (bottom of file). ### Pre-send validation Before sending any WhatsApp message: 1. `grep` the recipient's name or phone in `contact-list.md` 2. Verify the phone/JID exists 3. If not found → ask the owner. Never guess. --- ## Add a Contact Append a new row to the **אנשי קשר** table in `contact-list.md`: ``` | Name | Phone | Email | Address | City | Owner Role | PA | Notes | ``` Rules: - Check for duplicates first: `grep -i "NAME_OR_PHONE" contact-list.md` - If the contact is from Builders Leadership → set `Owner Role` = `leadership` - If they have a PA → fill the PA column with `PA_NAME (+phone)` - Keep alphabetical order: Hebrew names (א-ת) first, then English (A-Z) - After adding → `git add contact-list.md && git commit -m "add contact: NAME" && git push` --- ## Update a Contact 1. Read `contact-list.md` 2. Find the row to update 3. Edit the specific field (phone, address, PA, etc.) 4. After updating → `git add contact-list.md && git commit -m "update contact: NAME — FIELD" && git push` --- ## Add a New PA When a new PA is onboarded: 1. **Add to Active PAs table** — new row with PA Name, Phone, Owner, Owner Phone, Status 2. **Update the contact row** — add PA name + phone to the PA column of the owner's entry 3. **Add to PA Sync List** — append DM target line: `- +PHONE — PA_NAME (Owner)` 4. **Git push** — `git add contact-list.md && git commit -m "add PA: PA_NAME for OWNER" && git push` --- ## Add a New Group When joining a new WhatsApp group: 1. Add a row to the appropriate section (English or עברית) in the WhatsApp Groups table 2. Include: שם הקבוצה, Group JID, הערות 3. Git push --- ## Remove / Deactivate - **Contact removed:** Delete the row. Git push. - **PA deactivated:** Change status to `❌ לא פעיל` in Active PAs. Remove from PA Sync List DM targets. Keep the contact row but clear the PA column. Git push. --- ## Trigger Phrases | If the owner says... | Action | |---|---| | "מי זה X" / "who is X" | Lookup by name | | "מספר של X" / "X's number" / "phone for X" | Lookup phone | | "כתובת של X" / "address for X" | Lookup address | | "אימייל של X" / "email for X" | Lookup email | | "PA של X" / "X's PA" / "find PA for X" | Lookup PA | | "JID של X" / "group JID" | Lookup group | | "add contact" / "הוסף איש קשר" | Add contact flow | | "update contact" / "עדכן פרטים" | Update contact flow | | "new PA" / "PA חדש" | Add PA flow (then also run ai-pa) | --- ## Cost Tips - **Very cheap** — grep + file edit, any model works - **No API calls** — everything is local markdown - Batch multiple updates into one commit --- ## Error Reference | Error | Cause | Fix | |---|---|---| | Contact not found | Name spelling, partial match | Try shorter search term, check both Hebrew and English | | Duplicate detected | Contact already exists | Update existing row instead of adding | | File not found | `contact-list.md` missing | Check workspace root, run `git pull` | | Git push failed | Network or auth issue | Retry, check git credentials | --- Source attribution: netanel-abergel Original project: https://github.com/netanel-abergel/pa-skills/blob/ca4344f33175b78797352bb9e8cdec864eff492d/skills/contact-list/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Netanel Abergel Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: netanel-abergel Original project: https://github.com/netanel-abergel/pa-skills/blob/ca4344f33175b78797352bb9e8cdec864eff492d/skills/contact-list/SKILL.md Attribution basis: Source repository record Fields of work: Sales, Customer Support Roles: Community Manager, Customer Success Manager, Support Agent Specialties: Specialty not specified Tools: WhatsApp Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 3ee970e4b08e3d9fabf71ce826d805a48d8b1a807b2549a641498187caf7747c