# Nova PAI - Quick Reference Card

## 🚀 Adăugare Skill Nou - 4 Pași

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

# 2. Creează SKILL.md
cat > .claude/skills/[nume-skill]/SKILL.md << 'EOF'
---
name: [nume-skill]
description: "Scurtă descriere (max 2 fraze)"
---

# [Nume] Skill

## Prezentare
[Ce face skill-ul]

## Când să Folosești
- Situație 1
- Situație 2

## Proces de Execuție

### Pas 1: [Nume]
[Descriere]

### Pas 2: [Nume]
[Descriere]

## Exemple Complete

### Exemplu 1: [Scenariu]
**Input**: "..."
**Output**: ...

## Troubleshooting

### Problem: [Problemă]
**Soluție**: [Fix]

---
**Versiune**: 1.0
**Ultima actualizare**: [DATA]
EOF

# 3. Actualizează context/claude.md
# Adaugă în lista "Skills disponibile":
# - `[nume-skill]/` - [Descriere]

# 4. Testează
# În conversație: "Folosește skill-ul [nume-skill] pentru..."
```

---

## 📁 Structura Fișiere

### Skill Simplu
```
.claude/skills/[nume]/
└── SKILL.md
```

### Skill Complex
```
.claude/skills/[nume]/
├── SKILL.md
├── template.md
├── examples/
│   ├── example1.md
│   └── example2.md
└── reference.md
```

---

## 🔧 Upgrade Sistem

### Adaugă Subsistem Nou
```bash
mkdir -p .claude/context/[subsistem]/
# Creează [subsistem]/claude.md
# Actualizează context/claude.md secțiunea "Subsisteme Disponibile"
```

### Adaugă Tip Proiect Nou
```bash
mkdir -p .claude/context/projects/[tip]/
# Creează [tip]/claude.md cu workflow specific
# Actualizează context/claude.md
```

### Adaugă Tool Documentation
```bash
# Editează .claude/context/tools/claude.md
# Adaugă secțiune nouă cu sintaxă și best practices
```

---

## 📝 Template YAML Frontmatter

```yaml
---
name: skill-name
description: "Concise description in 1-2 sentences"
version: "1.0"
author: "Your Name"
tags: ["tag1", "tag2"]
requires: ["other-skill"]  # optional
---
```

---

## ✅ Checklist Post-Skill

- [ ] YAML frontmatter valid
- [ ] Secțiune "Când să folosești"
- [ ] Proces în pași numerotați
- [ ] Minimum 2 exemple
- [ ] Troubleshooting section
- [ ] context/claude.md actualizat
- [ ] Testat în conversație

---

## 🎯 Skills Ideas

### Development
- `code-review` - Review cod profesional
- `debug-assistant` - Debugging workflow
- `api-design` - Design REST APIs
- `test-generation` - Generare teste

### Data & Analysis
- `data-analysis` - Pandas, numpy, stats
- `visualization` - Charts, graphs
- `sql-query` - Query optimization
- `data-cleaning` - Preprocessing data

### Content & Communication
- `email-drafting` - Email profesionale
- `presentation` - Slides și prezentări
- `documentation` - Docs tehnice
- `copywriting` - Marketing copy

### Business
- `market-research` - Analiză piață
- `competitive-analysis` - Analiză competitori
- `financial-analysis` - Analiză financiară
- `business-plan` - Business planning

---

## 🔄 Workflow Adăugare

```
Idee Skill → Template → Scriere → Test → Update Context → Deploy
     ↓          ↓          ↓        ↓          ↓            ↓
  Validare   SKILL.md   Content   Manual   claude.md    Production
```

---

## 📚 Fișiere Importante

| Fișier | Scop | Când Modifici |
|--------|------|---------------|
| `context/claude.md` | Master doc | La fiecare skill nou |
| `output_style.md` | Identitate | Schimbări personalitate |
| `context/tools/claude.md` | Tools docs | Tool nou/updated |
| `memory/learnings.md` | Învățări | Post probleme rezolvate |

---

## 💡 Tips

### ✅ DO
- Păstrează skills modulare și focusate
- Include multe exemple
- Documentează edge cases
- Testează înainte de deploy

### ❌ DON'T
- Nu face skills prea largi
- Nu duplica logică din alte skills
- Nu uita să updatezi context/claude.md
- Nu omite troubleshooting

---

## 🆘 Help

**Documentație completă**: `.claude/docs/HOW-TO-ADD-SKILLS.md`
**Exemple**: `.claude/skills/web-research/` și `/research-report/`
**Arhitectură**: `.claude/context/claude.md`
**README general**: `.claude/README.md`

---

## 🔗 Links Rapide

```bash
# Vezi toate skills
ls -la .claude/skills/

# Citește arhitectura
cat .claude/context/claude.md

# Ghid complet
cat .claude/docs/HOW-TO-ADD-SKILLS.md

# Template skill
cat .claude/docs/HOW-TO-ADD-SKILLS.md | grep -A50 "Template:"
```