Files

2025-11-06 20:32:36 +02:00

4.2 KiB

Raw Blame History

Nova PAI - Quick Reference Card

🚀 Adăugare Skill Nou - 4 Pași

# 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

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

Adaugă Tip Proiect Nou

mkdir -p .claude/context/projects/[tip]/
# Creează [tip]/claude.md cu workflow specific
# Actualizează context/claude.md

Adaugă Tool Documentation

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

📝 Template YAML Frontmatter

---
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

# 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:"

4.2 KiB Raw Blame History