framework360-skill

Skill per Claude Code che insegna a Claude come usare la CLI di framework360-mcp-server per interagire con l'API REST di Framework360 (CRM/CMS) da terminale.

Indice

• Cos'è una skill
• Prerequisiti
• Installazione
• Cosa fa questa skill
• Verifica
• Personalizzazione
• Sicurezza
• Licenza

Cos'è una skill

Una skill di Claude Code è un file Markdown (SKILL.md) con un frontmatter name/description che Claude carica automaticamente quando la richiesta dell'utente corrisponde alla descrizione. Contiene istruzioni operative (comandi, opzioni, linee guida) che Claude segue invece di improvvisare — in questo caso, come usare correttamente la CLI di framework360-mcp-server senza indovinare nomi di comandi o parametri.

Prerequisiti

• Claude Code installato
• Il progetto framework360-mcp-server clonato e configurato (vedi il suo README): npm install, .env compilato con FRAMEWORK360_API_KEY e FRAMEWORK360_BASE_URL

Questa skill non funziona da sola: descrive solo come usare la CLI dell'altro repo, che deve essere presente sul filesystem.

Installazione

1. Clona questo repo (o copia solo SKILL.md) in una cartella di skill personali di Claude Code, tipicamente:

   mkdir -p ~/.claude/skills/framework360
   cp SKILL.md ~/.claude/skills/framework360/SKILL.md

2. Apri SKILL.md e sostituisci ogni <progetto> con il percorso assoluto in cui hai clonato framework360-mcp-server (es. /home/utente/framework360-mcp-server).

3. Riavvia/apri una nuova sessione di Claude Code: la skill framework360 viene rilevata automaticamente dalla cartella ~/.claude/skills/.

Cosa fa questa skill

Quando chiedi a Claude Code di leggere o gestire dati Framework360 (clienti, ordini, chat, marketing, report, ecc.) da riga di comando, la skill:

• suggerisce il comando CLI corretto invece di indovinare path o parametri (usando list/describe della CLI per verificare prima di chiamare);
• usa --dry-run di default prima di qualsiasi comando che scrive o modifica dati (create/update/delete/registration/login/assign/remove), mostrando la richiesta all'utente prima di eseguirla davvero;
• esegue direttamente le chiamate di sola lettura (get/list/search/dashboard/report);
• riconosce e segnala all'utente situazioni note: .env senza API key, dominio non più attivo ("Sito non trovato"), risposte con errore applicativo ({"status":0,...}).

Il dettaglio completo dei comandi e delle opzioni è nel file SKILL.md stesso.

Verifica

Dopo l'installazione, chiedi a Claude Code qualcosa come:

Usa la CLI di Framework360 per verificare la connessione

Se la skill è caricata correttamente, Claude userà node bin/cli.mjs check (o il comando equivalente) nella directory del progetto configurata.

Personalizzazione

Se usi un dominio o un'API key diversi per ambienti differenti (staging/produzione), puoi tenere più copie di framework360-mcp-server con .env diversi e passare --env <path> ai comandi della CLI: aggiorna la sezione corrispondente in SKILL.md se vuoi che Claude lo faccia automaticamente.

Sicurezza

Questa skill non contiene credenziali: l'API key resta nel .env del progetto framework360-mcp-server, mai in questo repo. Le istruzioni della skill spingono esplicitamente Claude a usare --dry-run prima di azioni distruttive/scrittura, per evitare modifiche accidentali ai dati di produzione.

Licenza

ISC.