diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1df75a5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,272 @@
+
+
+# JobHunter Master
+
+### AI-Powered Job Hunting Skill for Claude Code
+
+**Stop spraying applications. Start hunting strategically.**
+
+[](https://github.com/anthropics/claude-code)
+[](LICENSE)
+[](https://daringfireball.net/projects/markdown/)
+
+[Installation](#-installation) · [Workflow](#-6-phase-workflow) · [Templates](#-ready-to-use-templates) · [Integrations](#-integrations)
+
+
+
+---
+
+## Why JobHunter Master?
+
+**Most job seekers use the "spray and pray" method** — mass-applying through LinkedIn Easy Apply and hoping for the best. That's a lottery ticket, not a strategy.
+
+JobHunter Master is a **Claude Code skill** that transforms your job search into a **systematic sales process**. It automates research, outreach planning, material customization, and follow-up — turning Claude into your personal job hunting assistant.
+
+### Key Benefits
+
+| Feature | What It Does |
+|---|---|
+| **Target Acquisition** | Identify high-value opportunities beyond Easy Apply across LinkedIn, AngelList, RemoteOK, and HN Who's Hiring |
+| **Company Intelligence** | Auto-research funding stage, tech stack, culture, recent hires, and pain points |
+| **People Finder** | Map hiring managers, recruiters, and team members with contact discovery via Hunter.io, Apollo.io, and RocketReach |
+| **Material Customization** | Tailor CVs and cover letters per-application using job post language matching |
+| **Multi-Channel Outreach** | Coordinated LinkedIn, email, and Twitter/X engagement strategies |
+| **Follow-Up Engine** | Structured cadence (Day 0 → Day 3 → Day 7 → Day 14) that persists without being pushy |
+
+---
+
+## 6-Phase Workflow
+
+### Phase 1: Target Acquisition
+Find jobs worth pursuing — not just the ones with a one-click apply button. Sources include LinkedIn, company career pages, AngelList, RemoteOK, and Hacker News Who's Hiring threads.
+
+**Research checklist per target:**
+- Company size, funding stage, recent news
+- Tech stack (job post, GitHub, StackShare, blog posts)
+- Company culture signals (Glassdoor, Blind, LinkedIn)
+- Recent hires in similar roles
+- Pain points and growth challenges
+
+### Phase 2: Intelligence Gathering
+Map the decision-makers before you apply:
+1. **Hiring Manager** — Identified from job post or LinkedIn search
+2. **HR/Recruiter** — Located via `[Company] Recruiter` LinkedIn queries
+3. **Team Members** — People with similar titles at the company
+4. **Warm Connections** — Mutual connections, alumni networks
+
+**Contact discovery methods:**
+- LinkedIn direct messages and InMail
+- Email pattern inference (`firstname@`, `f.lastname@`)
+- Hunter.io / Apollo.io / RocketReach lookups
+- Twitter/X DM warm-ups
+
+### Phase 3: Material Customization
+Every application gets a tailored CV and cover letter — never send a generic resume again.
+
+**CV adjustments:**
+- Lead with experience relevant to THIS role
+- Mirror the job post's language and keywords
+- Quantify achievements matching their stated needs
+- Cut irrelevant content
+
+**Cover letter formula:**
+```
+Para 1: Why THIS company (prove you researched)
+Para 2: Why YOU (match experience to their pain points)
+Para 3: What you'll DO (concrete value proposition)
+Para 4: Call to action (request a 15-minute call)
+```
+
+### Phase 4: Multi-Channel Approach
+Coordinated outreach across LinkedIn, email, and Twitter/X:
+
+- **LinkedIn**: Personalized connection requests → thoughtful comments → InMail
+- **Email**: Punchy cold emails showing you did your homework
+- **Twitter/X**: Follow key people → engage genuinely → DM after warming up
+
+### Phase 5: Follow-Up Cadence
+```
+Day 0: Apply + Connect on LinkedIn
+Day 3: Follow-up email if no response
+Day 7: LinkedIn message or comment on their content
+Day 14: Final follow-up with a new angle or value-add
+```
+
+**Never:** Send the same message twice, sound desperate, or spam multiple people at the same company.
+
+### Phase 6: Track & Iterate
+Per-application success metrics:
+- [ ] Company researched
+- [ ] CV customized
+- [ ] Cover letter written
+- [ ] HR/Hiring manager identified
+- [ ] Connection request sent
+- [ ] Follow-up scheduled
+
+---
+
+## Ready-to-Use Templates
+
+### LinkedIn Connection Request
+```
+Hi [Name], I just applied for the [Role] position and wanted to connect directly.
+Your work on [specific thing] caught my attention. Would love to learn more about [Company]'s engineering culture.
+```
+
+### Cold Email
+```
+Subject: Quick question about [Role] at [Company]
+
+Hi [Name],
+
+I noticed [Company] is hiring for [Role] and I'm genuinely excited about [specific thing].
+
+Quick background: I've spent [X years] doing [relevant experience], most recently [specific achievement].
+
+I'd love to learn more about what you're looking for. Do you have 15 minutes this week?
+
+Best,
+[Name]
+[LinkedIn] | [Portfolio/GitHub]
+```
+
+### Follow-Up
+```
+Subject: Re: [Previous Subject]
+
+Hi [Name],
+
+Following up on my application for [Role].
+
+Since I last reached out, I [did something relevant — built something, wrote about the topic, etc.].
+
+Still very interested in [Company]. Happy to chat whenever convenient.
+
+Best,
+[Name]
+```
+
+---
+
+## Integrations
+
+JobHunter Master works seamlessly with other Claude Code skills:
+
+| Skill | Use Case |
+|---|---|
+| **browser** | LinkedIn automation, company research, job board scraping |
+| **bird** | Twitter/X engagement with company employees and founders |
+| **gog** | Email outreach via Gmail integration |
+| **nano-pdf** | CV editing, formatting, and per-application customization |
+
+---
+
+## Installation
+
+### Prerequisites
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured
+- Active Anthropic API key
+
+### Install as a Claude Code Skill
+
+1. **Clone the repository:**
+```bash
+git clone https://github.rommark.dev/admin/Job-Hunter-Linkedin-Skill-Hermes-OpenClaw-ClaudeCode-Comet.git
+```
+
+2. **Copy the skill to your Claude Code skills directory:**
+```bash
+cp Job-Hunter-Linkedin-Skill-Hermes-OpenClaw-ClaudeCode-Comet/skill.md ~/.claude/skills/jobhunter.md
+```
+
+3. **Activate in your session:**
+```
+/jobhunter
+```
+
+### File Structure
+```
+~/.claude/skills/
+ jobhunter.md # Main skill definition
+~/memory/
+ job-targets.md # Active targets and application status
+ job-templates/ # Customized CVs and cover letters per role
+```
+
+---
+
+## Usage Examples
+
+### Research a target company
+```
+> Research [Company] for a Senior Engineer role
+```
+Claude will pull funding info, tech stack, Glassdoor reviews, recent hires, and engineering blog posts.
+
+### Find decision-makers
+```
+> Find the hiring manager and recruiter for the [Role] at [Company]
+```
+Returns LinkedIn profiles, email patterns, and mutual connection opportunities.
+
+### Generate a tailored cover letter
+```
+> Write a cover letter for [Role] at [Company] using my background
+```
+Produces a customized letter following the 4-paragraph formula, using language from the job post.
+
+### Plan outreach for a target
+```
+> Create an outreach plan for [Company]'s [Role] posting
+```
+Generates a multi-channel engagement timeline with specific touchpoints.
+
+---
+
+## Philosophy
+
+> *"The job doesn't go to the best candidate. It goes to the best job hunter."*
+
+Easy Apply = lottery ticket. Real job hunting = sales process.
+
+Every hire is a business decision. Treat your job search like a B2B sales funnel:
+1. **Research** — Know the company better than their employees
+2. **Qualify** — Match your experience to their pain points
+3. **Customize** — Tailor every touchpoint for THIS job
+4. **Find the humans** — HR, hiring manager, team lead, insider
+5. **Engage** — Comment, connect, message, email
+6. **Follow up** — Persistence without being annoying
+
+---
+
+## Who Is This For?
+
+- **Software engineers** tired of 300+ application black holes
+- **Career changers** who need to stand out without traditional experience
+- **Senior candidates** targeting specific companies, not job boards
+- **Remote workers** competing globally for distributed roles
+- **Anyone** who wants to treat job hunting like the strategic process it is
+
+---
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/new-template`)
+3. Commit your changes (`git commit -m 'Add new outreach template'`)
+4. Push to the branch (`git push origin feature/new-template`)
+5. Open a Pull Request
+
+---
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+
+---
+
+
+
+**Built with Claude Code** · Part of the [OpenClaw](https://github.rommark.dev) ecosystem
+
+