Creare skill

Sviluppo software con Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Cosa sono le skill?

Una cassetta degli attrezzi con schede di istruzioni etichettate

  • Istruzioni riutilizzabili che Claude segue su richiesta
  • Definisci una volta, usa ovunque
  • Richiamate con /skill-name o automaticamente
Sviluppo software con Claude Code

Unit test come skill

Concetto di unit test con funzione testata in isolamento

Sviluppo software con Claude Code

Dove vivono le skill

Skill personali (tutti i progetti):

~/.claude/
  /skills/
    /my-skill/
      SKILL.md

Skill di progetto (solo questo progetto):

project/
  /.claude/
    /skills/
      /unit-tests/
        SKILL.md
Sviluppo software con Claude Code

Anatomia di SKILL.md

___
# SKILL.md
name: unit-tests
description: Generate pytest unit tests for Python functions
___

When asked to write unit tests:
1. Identify the function's inputs and outputs
2. Write tests for normal cases first
3. Add edge cases (empty input, invalid data)
4. Use descriptive test names
5. Run pytest to verify tests pass

Frontmatter = name + description | Corpo = istruzioni passo-passo

Sviluppo software con Claude Code

Creare una skill manualmente

Ricetta per creare una skill:

  1. Nella root del progetto crea la cartella mkdir -p .claude/skills/unit-tests
  2. Apri il file: code .claude/skills/unit-tests/SKILL.md (o l'editor che preferisci)
  3. Scrivi o incolla frontmatter e istruzioni
  4. Salva il file
  5. Avvia claude e verifica la skill con /skills
Sviluppo software con Claude Code

Il progetto finora

music-analytics-api/
  app.py
  routes.py
  models.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md
    skills/              # <- Cartella delle skill
      unit-tests/
        SKILL.md
Sviluppo software con Claude Code

Quando usare le skill

  • Ideali per le skill:
    • Flussi ripetitivi con passaggi costanti
    • Standard di codifica del team da applicare
    • Flussi multi-step da rendere riproducibili
    • Pattern da seguire sempre
  • Non ideali per le skill:
    • Attività una tantum
    • Domande semplici sul codice
    • Attività che cambiano molto ogni volta
    • Ricerche rapide di file
Sviluppo software con Claude Code

Skill vs agent

Funzione Skill Agent
Cosa sono Istruzioni che Claude segue Assistenti specializzati
Come funzionano Claude esegue i passaggi L'agent lavora in autonomia
Posizione .claude/skills/ .claude/agents/
Invocazione /skill-name o automatica @agent-name o automatica

Entrambi estendono Claude Code: usa le skill per i flussi, gli agent per l'expertise

Sviluppo software con Claude Code

Agent + skill insieme

File dell'agent che dichiara le skill a cui ha accesso

Sviluppo software con Claude Code

Esercitiamoci!

Sviluppo software con Claude Code

Preparing Video For Download...