Uno skill di documentazione tecnica: fai scrivere i docs a qualsiasi IA col tuo standard, poi vendilo

• Chiedi all'IA di scrivere i docs. Tornano generici, stonati e senza i prerequisiti — così te li riscrivi comunque tu.
• Rispieghi le stesse regole ogni volta: il lettore, la struttura, la terminologia. Un prompt lungo si perde per strada, e non resta niente.
• Il criterio che ti sei fatto sul campo ce l'hai solo in testa. Lo vendi a ore, e lì ti fermi.

Resti nel tuo terminale. Prostir impacchetta, controlla e pubblica lo skill.

1. 01
   Aggiungi Prostir come server MCP in Claude Code.

   Un comando: claude mcp add prostir https://prostir.ai.prostir.build/mcp. Accedi una volta sola.

2. 02
   Crea lo skill e porta dentro il tuo standard.

   Claude Code chiama prostir_skills_create (slug tech-docs), poi prostir_skills_import_files — incolli il tuo SKILL.md, lo tiri da un repo GitHub o carichi una cartella. Lo ZIP serve solo per il trasporto: viene estratto, non salvato.

3. 03
   Scrivi le regole che contano.

   Nel SKILL.md: scrivi per l'obiettivo del lettore, metti i prerequisiti in cima, scegli il tipo di doc giusto (tutorial / how-to / reference / explanation) senza mescolarli, fissa terminologia e tono, pretendi esempi testati, aggiungi una checklist di revisione. Dentro ci metti references/ ed evals/.

4. 04
   Controlla.

   prostir_skills_validate verifica che ci sia un solo SKILL.md, un frontmatter valido (name, description), che i riferimenti @file si risolvano, la sicurezza degli script e che gli evals passino. Sistemi quello che blocca.

5. 05
   Decidi come si condivide e si vende.

   Aggiungi un logo, scegli l'accesso (aperto, con chiave o OAuth) e il prezzo (gratis, oppure una tantum / in abbonamento sul tuo Stripe). Accesso e prezzo vanno per conto loro.

6. 06
   Pubblica e condividi il passaporto.

   prostir_skills_publish crea una versione immutabile, online su tech-docs.skill.prostir.build. Chi compra (o la sua IA) scarica il pacchetto in .agents/skills/. Una 1.1 la pubblichi quando vuoi.

Una cartella Agent Skills. Claude Code la impacchetta e la controlla sotto i tuoi occhi.

Prompt vero, chiamate vere, risultato vero.

• Chiunque lo riceve da te aggiunge lo skill, e la sua IA scrive i docs col tuo standard — tipo di doc giusto, prerequisiti indicati, la tua terminologia — già dalla prima bozza.
• Le versioni sono salvate: correggi una regola una volta, pubblichi una 1.1, e ogni nuova installazione riceve lo standard migliore.
• Regalalo per farti conoscere, oppure mettigli un prezzo sul tuo Stripe e vendi lo stesso skill tante volte, invece che a ore.