Inserisci Saoirse in Claude e ottieni un technical writer senior che documenta per il lettore in difficoltà, non per chi conosce già il sistema.
Saoirse copre l'intera superficie della documentazione: guide introduttive, guide pratiche, pagine concettuali/di panoramica, supporto per i riferimenti di API e CLI, documentazione per la risoluzione dei problemi e dei messaggi di errore, oltre all'audit della documentazione esistente rispetto ai ticket di assistenza reali per individuare i punti in cui delude silenziosamente i lettori. Identifica l'attività del lettore prima di scrivere una sola parola, sceglie deliberatamente il tipo di pagina e verifica ogni passaggio rispetto al comportamento reale invece di fidarsi delle specifiche.
Cosa ottieni
-
→Guide introduttive, guide pratiche, pagine concettuali e guide alla risoluzione dei problemi
-
→Struttura incentrata sull'attività: un'attività del lettore nominata, non solo un argomento
-
→Verifica i passaggi rispetto al comportamento reale, non rispetto alle specifiche
-
→Verifica la documentazione rispetto ai ticket di assistenza reali
Modalità post per blog tecnico
Oltre a scrivere documentazione tecnica, Saoirse redige post per blog di ingegneria e verifica innanzitutto se il contenuto appartiene invece alla documentazione.
-
Cinque tipi di post: tutorial, approfondimento o descrizione di come è stato realizzato, post di lancio, postmortem e confronto, ciascuno con una propria struttura
-
Codice eseguibile: snippet completi o estratti etichettati, versioni e data dei test indicati, tutto ciò che non è stato verificato è contrassegnato con [VERIFY]
-
Nessun numero inventato: benchmark e costi solo se forniti da te, con indicazione di come sono stati misurati
-
Pronto per la pubblicazione: titolo descrittivo, meta descrizione, slug, testo alternativo e checklist di revisione per segreti e dati dei clienti
📄 saoirse-technical-writer.skill
Installazione in meno di 2 minuti
Funziona con Claude, ChatGPT e qualsiasi chat AI
Come installare
Scarica il pacchetto .skill → apri Claude → incolla SKILL.md nelle Istruzioni del progetto o nel prompt di sistema → descrivi il tuo requisito → Saoirse crea la risposta. Include un esempio completo e svolto, così puoi vedere esattamente cosa ottieni.
// Modello di prompt incluso come bonus
Questa competenza ora include il prompt autonomo AI Technical Documentation Writer (in precedenza venduto separatamente): un unico modello pronto da incollare e usare che copre 10 tipi di documentazione (architettura, riferimento dei componenti, guida introduttiva, integrazione, progettazione del sistema, ADR, migrazione, tutorial, risoluzione dei problemi, spiegazione di concetti), con esempi eseguibili da copiare e incollare e indicatori per i diagrammi. Usalo per una pagina estemporanea e veloce quando non ti serve tutta la gamma di audit di Saoirse.