nova-pai/.claude/docs/EXAMPLE-NEW-SKILL.md

# Exemplu Practic: Adăugare Skill "Email Drafting"

Acest document demonstrează procesul complet de adăugare a unui skill nou în sistemul Nova PAI.

## Skill Ales: Email Drafting

**De ce acest skill?**
- Use case comun (toată lumea scrie email-uri)
- Necesită context și structură
- Se combină bine cu alte skills (ex: research pentru content)

---

## Pas cu Pas

### 1. Crearea Structurii

```bash
# Creează directorul skill-ului
mkdir -p .claude/skills/email-drafting/

# Verificare
ls -la .claude/skills/
# Should show: email-drafting/
```

### 2. Crearea SKILL.md

**Fișier**: `.claude/skills/email-drafting/SKILL.md`

```markdown
---
name: email-drafting
description: "Skill pentru compunerea de email-uri profesionale: business communication, networking, follow-ups, și outreach. Folosește pentru orice task de scriere email."
---

# Email Drafting Skill

## Prezentare

Acest skill te ajută să compui email-uri profesionale, clare și eficiente pentru diverse contexte: business communication, networking, job applications, follow-ups, și outreach.

## Când să Folosești

- Utilizatorul cere "Scrie-mi un email..."
- "Cum răspund la..."
- Networking outreach
- Cold emails
- Follow-up messages
- Business correspondence
- Job applications / cover letters

## Pre-requisite

Înainte de a compune email-ul, trebuie să ai:
- ✅ Destinatarul (cui scrii)
- ✅ Scopul email-ului (ce vrei să obții)
- ✅ Contextul (de ce acum, ce relație aveți)

## Proces de Execuție

### Pas 1: Clarificare Context

**Întrebări obligatorii**:

1. **Cui scrii?**
   - Rol/poziție (CEO, recrutant, coleg, client)
   - Relație existentă (cunoscut, cold outreach, follow-up)
   - Nivel seniority

2. **Ce vrei să obții?**
   - Acțiune specifică (meeting, informații, aprobare)
   - Deadline (urgent vs. flexibil)
   - Importanță (high stakes vs. casual)

3. **Ce ton e potrivit?**
   - Formal vs. casual
   - Direct vs. diplomatic
   - Urgent vs. relaxat

### Pas 2: Selectare Template

În funcție de tip, alege structura potrivită:

**A. Cold Outreach** (nu vă cunoașteți)
```
Subject: [Specific + Value proposition]

Hi [Name],

[Hook - de ce scrii + connection/relevance]

[Value - ce oferi sau de ce e relevant pentru ei]

[Ask - specific și rezonabil]

[Close - ușor de răspuns]

Best regards,
[Your name]
```

**B. Follow-up** (după întâlnire/email)
```
Subject: Re: [Previous subject] - [Action item]

Hi [Name],

[Reference to previous interaction]

[Update or reason for follow-up]

[Next steps or ask]

Thanks,
[Your name]
```

**C. Request** (ceri ceva)
```
Subject: [Clear what you need]

Hi [Name],

[Context - de ce scrii]

[Request - specific și clar]

[Why it matters - benefit pentru ambii]

[Timeline - când ai nevoie]

Thank you for considering,
[Your name]
```

**D. Professional Introduction**
```
Subject: Introduction - [Your name] from [Company/Context]

Hi [Name],

[Who you are - 1 sentence]

[Why you're reaching out - connection/reason]

[What you propose - meeting, call, collaboration]

[Call to action - easy to respond]

Looking forward to connecting,
[Your name]
```

### Pas 3: Scriere Draft

**Componentele esențiale**:

1. **Subject Line**
   - ✅ Clar și specific
   - ✅ Sub 50 caractere
   - ✅ Evită spam triggers (FREE, URGENT!!!, etc.)
   - ❌ Nu folosi "Re:" dacă nu e răspuns real

2. **Opening**
   - ✅ Personalizat (folosește numele)
   - ✅ Context imediat (de ce scrii)
   - ❌ Nu începe cu "Sper că ești bine" în cold emails

3. **Body**
   - ✅ Paragrafe scurte (2-4 fraze)
   - ✅ Un singur scop principal
   - ✅ Beneficii clare
   - ❌ Nu include multiple cereri nesupravegheate

4. **Call to Action**
   - ✅ Specific și actionable
   - ✅ Ușor de executat
   - ✅ Include opțiuni (dacă e relevant)
   - ❌ Nu lăsa vag ("Aștept răspunsul tău")

5. **Closing**
   - ✅ Professional
   - ✅ Pe ton cu restul email-ului
   - ✅ Include contact info dacă e relevant

### Pas 4: Revizuire și Optimizare

**Checklist final**:

- [ ] Subject line sub 50 caractere și clar
- [ ] Email sub 150 cuvinte (ideal 75-100)
- [ ] Un singur scop principal
- [ ] CTA clar și specific
- [ ] Fără greșeli gramaticale
- [ ] Ton consistent
- [ ] Mobile-friendly (testează pe telefon)
- [ ] Include toate informațiile necesare pentru răspuns

**Red flags** (evită):
- 🚩 Email > 200 cuvinte (prea lung)
- 🚩 Multiple CTA-uri confuze
- 🚩 Prea formal sau prea casual
- 🚩 Lipsa context (destinatarul nu știe de ce scrii)
- 🚩 Vague asks ("să discutăm cândva")

## Exemple Complete

### Exemplu 1: Networking Cold Email

**Context**: Vrei să te conectezi cu un VP Product din industria ta

**Input**: "Scrie-mi un email de networking către Sarah Johnson, VP Product la TechCorp"

**Output**:

```
Subject: Fellow Product Leader - Quick Question

Hi Sarah,

I'm Alex, VP Product at StartupXYZ, and I've been following TechCorp's product evolution—particularly your recent AI features launch.

I'm currently navigating a similar product challenge (scaling personalization) and would love to hear about your team's approach, if you're open to a brief chat.

Would you have 15 minutes in the next 2 weeks for a quick call? Happy to work around your schedule.

Thanks for considering!

Alex
alex@startupxyz.com
```

**De ce funcționează**:
- Relevance imediat (fellow VP, same field)
- Specific despre ce admiri
- Clear ask (15 min, 2 weeks = flexibil)
- Respectful (nu cere mult timp)

### Exemplu 2: Follow-up După Meeting

**Context**: Ai avut un call cu un client potențial, acum trimiți follow-up

**Input**: "Follow-up după meeting cu John despre implementarea platformei noastre"

**Output**:

```
Subject: Re: Platform Demo - Next Steps

Hi John,

Thanks for taking the time yesterday to walk through your team's workflow challenges. The data synchronization issue you mentioned is definitely something our platform can address.

As discussed, I'm attaching:
- Custom proposal for your 50-person team
- Case study from a similar fintech client
- Pricing breakdown with the Q1 discount

I've blocked time on Friday, Jan 12 at 2pm for our follow-up call, but let me know if you need to reschedule.

Looking forward to moving this forward!

Best,
Alex
```

**De ce funcționează**:
- Reference specific la discussion
- Delivers pe promisiuni
- Clear next step cu dată
- Professional dar friendly

### Exemplu 3: Request Email (Asking for Introduction)

**Context**: Vrei o introducere către un investitor

**Input**: "Cere-i lui Mark să mă introducă la Sarah Chen, investitor la Accel"

**Output**:

```
Subject: Intro Request - Sarah Chen / Accel

Hey Mark,

Hope you're doing well! I'm reaching out because I saw you're connected with Sarah Chen at Accel, and I'm currently raising our Series A.

Our traction (5x growth in Q4, 200+ enterprise customers) aligns well with Accel's B2B SaaS focus, and I'd love to get on Sarah's radar.

Would you feel comfortable making a short intro? Happy to send a forwardable email if that helps.

No worries if the timing isn't right—appreciate you either way!

Best,
Alex
```

**De ce funcționează**:
- Respect relationship (asks permission)
- Provides context (why Sarah specifically)
- Makes it easy (offers forwardable)
- No pressure close

### Exemplu 4: Difficult Email (Saying No)

**Context**: Trebuie să refuzi o cerere dar vrei să păstrezi relația

**Input**: "Refuz politicos o cerere de parteneriat"

**Output**:

```
Subject: Re: Partnership Proposal - Current Focus

Hi Jessica,

Thanks for the detailed partnership proposal—I can see you put a lot of thought into how our products could complement each other.

After discussing with the team, we've decided to hold off on new partnerships this quarter while we focus on product improvements for our current customers.

That said, I'm impressed with what you're building at [Company], and I'd love to revisit this conversation in Q3 when we have more bandwidth.

I'll keep an eye on your progress!

Best,
Alex
```

**De ce funcționează**:
- Respectful și appreciative
- Clear "no" dar nu harsh
- Leaves door open (specific timeframe)
- Positive closing

## Tools Folosite

- **Read** - Pentru citire context anterior (threads)
- **Write** - Pentru salvare drafts
- **WebSearch** - Pentru research recipient (dacă e cold email)

## Integrare cu Alte Skills

**Combină cu**:
- `research` - Pentru background check pe recipient
- `copywriting` - Pentru subject lines mai creative
- `translation` - Pentru email-uri în alte limbi

## Troubleshooting

### Problem: Email prea lung

**Soluție**:
1. Identifică scopul principal
2. Elimină paragrafe care nu contribuie direct
3. Target: 75-100 cuvinte
4. Mută detalii extra în atașamente

### Problem: Ton prea formal/casual

**Soluție**:
1. Verifică seniority destinatar
2. Analizează industrie (tech = mai casual, legal = formal)
3. Dacă unsure, alege profesional-neutral
4. Match tonul emailurilor anterioare dacă există thread

### Problem: Nu știi ce CTA să pui

**Soluție**:
**Template-uri CTA**:
- **Ușor**: "Would [specific day/time] work for a quick call?"
- **Flexibil**: "Let me know what works for your calendar"
- **Urgent**: "Could we connect this week? I'm available [times]"
- **Low commitment**: "Would you be open to a brief intro call?"

### Problem: Nu primești răspuns

**Soluție Follow-up**:
1. Așteaptă 5-7 zile business
2. Trimite bump scurt:
```
Hi [Name],

Bumping this up in your inbox—wanted to make sure it didn't get lost!

Any thoughts on [original ask]?

Thanks,
[You]
```
3. Maxim 2 follow-ups total

## Best Practices

### ✅ DO

- **Personalizează**: Referă ceva specific despre destinatar
- **Scurt**: Under 150 cuvinte ideal
- **Scannable**: Paragrafe scurte, bullet points dacă e relevant
- **Mobile-first**: Majoritatea citesc pe telefon
- **Proofread**: Zero typos
- **Time it right**: Trimite Marți-Joi, 10am-2pm pentru best response

### ❌ DON'T

- **Nu folosi cuvinte spam**: FREE, URGENT, GUARANTEED
- **Nu trimiți la weekend**: Except dacă e industry norm
- **Nu CC prea mulți**: Dilutes responsibility
- **Nu folosești Reply All**: Except dacă relevant pentru toți
- **Nu incluzi emoji**: În business formal
- **Nu scrii când ești nervos**: Draft-uiește, review a doua zi

## Variații pe Contexte

### Intern (Coleg/Manager)
- Mai casual
- Mai direct
- Poate fi mai lung dacă e complex

### Client
- Professional
- Solution-focused
- Clear deliverables

### Recruiter/Job Application
- Enthusiastic dar nu desperate
- Highlight relevant experience
- Show you did research

### Investor
- Concise
- Data-driven
- Clear traction

## Metrics de Success

Un email bun are:
- **Open rate**: >40% (subject line bun)
- **Response rate**: >20% (relevant + clear CTA)
- **Action rate**: >10% (meeting booked, intro made, etc.)

Dacă primești sub aceste rates, iterate pe:
1. Subject lines
2. Personalization
3. Length (mai scurt)
4. CTA clarity

---

**Versiune**: 1.0
**Ultima actualizare**: 2025-01-06
**Autor**: Claude (Nova PAI Demo)
```

### 3. Actualizare context/claude.md

**Editează**: `.claude/context/claude.md`

**Găsește secțiunea**:
```markdown
**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale
```

**Adaugă**:
```markdown
**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale
- `email-drafting/` - Compunere email-uri profesionale
```

### 4. (Opțional) Testare

**În conversație nouă**:

```
"Citește .claude/skills/email-drafting/SKILL.md și folosește-l pentru a-mi scrie un email de networking către un VP Engineering"
```

**Așteptat**:
- Nova citește skill-ul
- Întreabă clarificări (context, relație, etc.)
- Generează email folosind template-ul potrivit
- Verifică cu checklist-ul final

---

## Rezultat Final

Ai acum:
- ✅ Skill nou funcțional: `email-drafting`
- ✅ Documentație completă cu 4 exemple
- ✅ Integrare în sistemul Nova
- ✅ Ready for production use

**Locație fișiere**:
```
.claude/
├── skills/
│   └── email-drafting/
│       └── SKILL.md  ← NOU
└── context/
    └── claude.md     ← ACTUALIZAT
```

---

## Următorii Pași

1. **Testează skill-ul** cu diverse scenarii
2. **Documentează probleme** în troubleshooting
3. **Adaugă în memory** orice învățări
4. **Iterează** bazat pe feedback

---

## Template pentru Skill-ul Tău

Folosește această structură ca starting point:

```bash
# 1. Creează
mkdir -p .claude/skills/[nume]/

# 2. Copiază structura din email-drafting ca template
cp .claude/skills/email-drafting/SKILL.md .claude/skills/[nume]/SKILL.md

# 3. Editează cu conținut specific

# 4. Update context/claude.md

# 5. Test!
```

---

**Pro Tip**: Începe cu skills simple și concrete (ca email-drafting), apoi extinde la skills mai complexe (data analysis, code generation, etc.).