# Tov Style

> >

- **Type:** Skill
- **Install:** `agentstack add skill-fullo-claude-writing-assistant-skill-tov-style`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fullo](https://agentstack.voostack.com/s/fullo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fullo](https://github.com/fullo)
- **Source:** https://github.com/fullo/claude-writing-assistant-skill/tree/main/skills/tov-style

## Install

```sh
agentstack add skill-fullo-claude-writing-assistant-skill-tov-style
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TOV & Writing Style

Skill di riferimento per tono di voce, stile narrativo, qualità linguistica e scorecard editoriale. Questa skill è language-aware: adatta i controlli alla lingua configurata nel progetto.

## Configurazione lingua

**Prima di qualsiasi controllo**, leggere `book-config.md` nella root del progetto libro:

1. Leggere il campo **Lingua** (default: italiano se non specificato)
2. Leggere la sezione **Stile e Tono** per: tono target, registro, pattern narrativo, termini vietati
3. Caricare le regole grammaticali dal language pack appropriato:
   - Se esiste `references/{lang}/grammar-rules.md` → caricare e applicare
   - Se NON esiste → usare `references/grammar-framework.md` come guida per generare check appropriati nella lingua target
4. Caricare la style guide dal language pack se esiste: `references/{lang}/style-guide.md`

**Language pack disponibili:**
- `it/` — Italiano: 15 regole dettagliate (R1-R15), style guide completa
- `en/` — English: 15 rules (R1-R15), starter pack

Per lingue senza pack dedicato, il framework generico (`grammar-framework.md`) fornisce le 15 categorie di regole (R1-class...R15-class) con indicazioni su come adattarle.

## Tono di voce

Il tono è definito in `book-config.md` sezione **Stile e Tono**, campo **Tono target**. Se non specificato, il default è **conversazionale-esperto**: il tono di un collega senior che spiega qualcosa a un pari. Non un professore, non un guru, non un divulgatore che semplifica eccessivamente.

**Caratteristiche del tono conversazionale-esperto (default):**

- **Confidenziale ma competente** — espressioni colloquiali nei passaggi di transizione, mai nelle spiegazioni tecniche dove il registro resta preciso
- **Auto-ironico quando appropriato** — ammettere limiti è un segno di competenza
- **Diretto** — preferire parole concrete a perifrasi
- **Mai condiscendente** — il lettore è un professionista

**Adattamento per lingua:** ogni lingua ha le proprie espressioni colloquiali e marcatori di familiarità. Usare quelli naturali della lingua target, non tradurre quelli di un'altra lingua.

### Benchmark quantitativi (target per capitolo, adattabili)

| Indicatore | Target | Range accettabile |
| :--- | :---: | :---: |
| Marcatori colloquiali | 8 | 3–16 |
| Riferimenti personali autore | 2 | 0–5 |
| Narrative personali estese per Parte | 1 | 0–1 |
| Cross-reference | 8 | 4–16 |
| Paragrafi in prosa (>100 char) | 50+ | 40–80 |

Questi benchmark vanno adattati alla lingua e al tono. In tono formale, i marcatori colloquiali saranno zero.

## Prosa narrativa, non elenchi

Il libro è scritto in prosa continua. La tendenza a trasformare spiegazioni in elenchi puntati è il primo nemico della qualità.

**Elenchi ammessi:** checklist nei Checkpoint, step numerati nei processi, tabelle comparative, formattazione inline di framework di dominio.

**Elenchi vietati:** spiegazioni di concetti, narrazioni, sequenze di esempi (max 2 in prosa per concetto), riassunti di fine sezione.

Convertire sempre elenchi narrativi in prosa che spiega il "perché" di ogni punto.

## Pattern narrativo obbligatorio per capitolo

Il pattern è definito in `book-config.md` sezione **Stile e Tono**, campo **Pattern narrativo**. Se non specificato, il default è: **Esperienza → Problema → Soluzione → Esercizio**.

1. **Hook** — esperienza concreta dal caso studio con contesto temporale, numeri, dialoghi
2. **Problema** — il caso rivela un pattern ricorrente, generalizzazione dall'esperienza al principio
3. **Soluzione** — framework introdotto come risposta: prima il principio, poi la struttura, infine 1–2 esempi pratici
4. **Esercizio** — Quick Win + Checkpoint. Non opzionale.

Rapporto target: definito in book-config.md (default: **30% teoria / 70% pratica**).

## Linguaggio

**Sentence case** per tutti i titoli — prima lettera maiuscola, resto minuscolo tranne nomi propri, acronimi. (Per lingue con Title Case prevalente come l'inglese, seguire la convenzione in book-config.md.)

**Termini tecnici stranieri:** le regole dipendono dalla lingua del libro. Vedere il language pack appropriato (`references/{lang}/grammar-rules.md`) per le regole R1/R1-class specifiche.

**Termini vietati:** definiti in book-config.md sezione **Stile e Tono** e/o nel language pack della lingua.

## Dialoghi

I dialoghi tra personaggi del caso studio sono il principale veicolo del tono conversazionale. Regole: emergono dal contesto (non artificiali), personaggi difendono posizioni diverse, il dialogo rivela il problema e la prosa lo analizza, max 4–5 battute consecutive senza commento narrativo.

## Internazionalizzazione e Localizzazione

Quando si scrive o si revisiona un libro:

- **Modi di dire:** usare espressioni idiomatiche naturali della lingua target, non calchi da altre lingue
- **Registro:** rispettare il livello di formalità definito in book-config.md (tu/Lei/Voi in italiano, du/Sie in tedesco, tu/vous in francese, etc.)
- **Formati locali:** numeri, date, valute, unità di misura seguono le convenzioni della lingua/cultura target (vedi R6-class in grammar-framework.md)
- **Esempi e metafore:** devono essere comprensibili nella cultura target

## Gotchas

- **Variazioni regionali**: ogni lingua ha varianti regionali (es. italiano settentrionale vs meridionale, inglese americano vs britannico). Verificare quale variante l'autore usa prima di suggerire correzioni.
- **Pronomi di cortesia**: verificare la convenzione del libro prima di suggerire cambiamenti (tu/Lei/Voi in italiano, you in inglese, du/Sie in tedesco).
- **Anglicismi/prestiti**: in contesti tecnici, molti prestiti sono accettati anche in lingue che tradizionalmente li evitano. Non suggerire traduzioni forzate per termini tecnici consolidati a meno che l'autore lo richieda esplicitamente.

## Risorse dettagliate

Per il framework generico di regole (tutte le lingue): **`references/grammar-framework.md`**
Per le regole specifiche per lingua: **`references/{lang}/grammar-rules.md`** (sostituire {lang} con il codice lingua)
Per la style guide specifica per lingua: **`references/{lang}/style-guide.md`** (se esiste)
Per la scorecard di qualità: **`references/scorecard.md`**

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fullo](https://github.com/fullo)
- **Source:** [fullo/claude-writing-assistant-skill](https://github.com/fullo/claude-writing-assistant-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fullo-claude-writing-assistant-skill-tov-style
- Seller: https://agentstack.voostack.com/s/fullo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
