profile-enrichment

Enriches brain contact and company files with web search, LinkedIn, and Apollo.io data.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill profile-enrichment-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profile-enrichment
Source: https://github.com/tapway/shogun-os/tree/main/skills/hermes/profile-enrichment
Command: npx skills add https://github.com/tapway/shogun-os --skill profile-enrichment-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, websockets, pymupdf, and includes scripts (resource) and references (resource) components.

What problem does it solve? After every email, meeting, calendar event, or social export, new people and companies appear that need research and structured records. This Skill automates the enrichment pipeline so each person and company gets an up-to-date profile file in your brain directory without manual research. ## Core Features & Use Cases - Multi-source enrichment: Combines web search, LinkedIn via Chrome CDP (logged-in session), and Apollo.io API to fill roles, emails, phone numbers, company industry, revenue, and employee counts. - Structured brain files: Creates individual Markdown files with YAML frontmatter in ~/brain/persons/, ~/brain/companies/, or ~/brain/friends-and-family/, each with timeline entries tracking every interaction. - Batch and event workflows: Handles conference CSVs, business card photos, directory app screenshots, and Facebook exports using parallel subagents, with deduplication against existing contacts. - Use Case: After a trade show, drop 15 business card photos and get deduplicated contact files, a company profile, an event leads tracker, and verified email patterns via Apollo in one pass. ## Quick Start Enrich the contacts from my latest meeting transcript and update their brain files with LinkedIn and Apollo data.

Frequently Asked Questions about profile-enrichment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enrich contacts after a conference or event?

Provide the event CSV, business card photos, or directory screenshots and the pipeline researches each person via web search, LinkedIn, and Apollo.io. It creates individual files in ~/brain/persons/ or ~/brain/contacts/ plus an event leads tracker, using parallel subagents for batches of 10 or more.

How does LinkedIn scraping work with Chrome CDP?

The skill connects to your real logged-in Chrome via the DevTools Protocol on port 9222, bypassing LinkedIn authwalls. It prefers a direct profile URL script, falls back to Playwright connect_over_cdp, then raw CDP WebSocket using window.location.href navigation on Chrome 148+.

Why does Chrome CDP give connection reset by peer errors?

Connection reset on port 9222 almost always means Chrome was not launched with --remote-debugging-port. Verify with netstat that port 9223 is listening, relaunch Chrome with debug flags from WSL, and reset the netsh portproxy if it is stale.

Can Apollo.io find verified email addresses for contacts?

Yes, the people/match endpoint returns verified emails when given a name and company domain. Look up one or two known contacts to detect the company email pattern, then apply it to remaining contacts, flagging unverified ones as estimated.

When should contacts not be enriched?

Skip internal staff on your own domain, noreply and notification senders, newsletters, and already-enriched recurring contacts. For spreadsheet-based outreach lists, fill the xlsx in place instead of creating individual brain files.

What is the difference between persons and friends-and-family folders?

Business contacts from email, meetings, and events go to ~/brain/persons/ or ~/brain/contacts/. Personal contacts from Facebook or social exports go to ~/brain/friends-and-family/, which is isolated from the CRM directory so sales profiles cannot access them.