Competenze Felo per Pi Coding Agent: Nucleo Ridotto, Web Live
Aggiungi competenze Felo a Pi Coding Agent per ricerca live, trascrizioni, segnali X e bozze di slide — senza aggiungere una riga di codice al nucleo minimale.
Pi Coding Agent mantiene il suo nucleo volutamente ridotto. Sub-agent e modalità piano restano esclusi, e la superficie che impari il primo giorno rimane la stessa anche dopo sei mesi.
Questa scelta rappresenta il principio. Meno elementi interni al sistema significano meno problemi da risolvere, meno sincronizzazione, e una sessione che si comporta allo stesso modo anche nel trimestre successivo.
Il limite esiste. Quando un compito richiede il web live — note di rilascio odierne, una pagina che non puoi incollare, una conferenza, ciò che le persone pubblicano sulla versione appena installata — un sistema minimale non offre strumenti.
Le competenze rappresentano il punto di estensione previsto da Pi, e le competenze di Pi Coding Agent sono semplici cartelle Markdown invece di plugin compilati. I bundle Felo danno alla sessione quella portata senza inserirla nel nucleo.
Le competenze sono il punto di estensione, non altri strumenti
La documentazione di Pi chiarisce l’ambito: il nucleo resta intenzionalmente ridotto, e funzionalità come sub-agent e modalità piano non vengono incluse. La conoscenza dei compiti appartiene alle competenze, che l’agente carica quando il compito lo richiede.
| Pi core | Una competenza Felo | |
|---|---|---|
| Cos’è | Runtime, gestione sessione, TUI, provider e modelli | Un bundle SKILL.md che descrive un lavoro dall’inizio alla fine |
| Come cambia | Estensioni TypeScript, pacchetti, impostazioni, temi | Aggiungi o rimuovi una cartella — nessuna ricompilazione |
| Accesso web | Lasciato al provider e agli strumenti aggiunti | Ricerca live, recupero pagine e trascrizioni con elenco fonti |
| Carico di revisione | Si controllano estensioni che eseguono codice arbitrario | Si legge una procedura Markdown prima di fidarsi |
Un’estensione è codice con la stessa portata dell’agente. Una competenza è una procedura che puoi leggere in due minuti e rifiutare.
Dove Pi cerca una competenza. Quattro radici, più pacchetti:
~/.pi/agent/skills— ogni progetto sulla macchina~/.agents/skills— posizione condivisa, accessibile agli agenti che seguono lo stesso standard.pi/skills— un repository, caricato solo dopo aver dato fiducia al progetto.agents/skills— uguale, nella posizione condivisa- la directory
skills/di un pacchetto, o una vocepi.skillsinpackage.json
Pi valida le competenze secondo lo standard Agent Skills e segnala la maggior parte delle violazioni, quindi una cartella SKILL.md già funzionante in un altro sistema può funzionare qui con un semplice cp -r. Le competenze Pi agent sono cartelle di tua proprietà, non plugin compilati nel binario.
Le radici a livello di progetto si caricano solo dopo il prompt di fiducia. Quel filtro svolge un ruolo reale: un repository appena clonato non dovrebbe poter aggiungere una nuova procedura alla sessione solo perché hai eseguito pi al suo interno.
Estensione o competenza? I bundle Felo sono competenze, non estensioni — nulla di loro viene eseguito nel nucleo di Pi.
Come aggiungerne una. Da una directory di progetto, copia un bundle in una radice delle competenze o lascia che un pacchetto lo porti:
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Quando lo stesso bundle deve raggiungere più macchine, lascia che un pacchetto lo porti:
pi install npm:@scope/pkg
pi install git:github.com/user/repo
Puoi anche caricare un bundle senza copiarlo: pi --skill /path/to/felo-search. Il flag è aggiuntivo, anche quando avvii una sessione con --no-skills.
Le credenziali restano fuori dal repository. Installa il CLI Felo una volta, salva la chiave nella configurazione utente, e ogni competenza la recupera:
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
Il CLI legge ~/.felo/config.json, quindi la chiave non finisce mai in un commit di progetto. Gli utenti Pi iniziano con una cartella, verificano che la ricerca funzioni, e solo dopo aggiungono le competenze che producono output.
Cinque competenze Felo da aggiungere
Ognuna copre un compito che il terminale non può svolgere da solo.
Felo Search — risposte con fonti
Il passaggio di ricerca su cui si basano le altre competenze. Raggiunge il web live e restituisce risultati datati e collegati, pronti per essere citati nella stessa risposta che stai già scrivendo.
Trova la versione Node consigliata per questa dipendenza e cita dove l’hai letta.
Felo Slides — il deck dalla sessione
I revisori leggono i deck, non lo scrollback del terminale. La scaletta arriva prima come testo, dentro Pi, così puoi sistemare l’argomentazione prima che esista una sola slide. Solo dopo costruisce il file, con le fonti inserite nelle note del relatore.
Riassumi questo refactor in cinque slide: cosa è stato spostato, cosa si è rotto, cosa serve revisionare.
Felo YouTube Subtitling — trascrizioni senza browser
Pi non ha una finestra browser, quindi il video registrato normalmente resta fuori portata. Questa competenza recupera i sottotitoli e restituisce testo che la sessione può cercare, citare e verificare rispetto alla configurazione.
Recupera la trascrizione di questo talk e estrai ogni numero di benchmark citato.
Felo X Search — cosa si riporta su X
Da usare prima di un rilascio: scopri se qualcun altro con questa versione incontra lo stesso errore che stai osservando.
Cerca su X gli errori di questa versione della libreria e elenca i tre più ripetuti.
Felo SuperAgent — immagini dalla stessa sessione
Quando il progetto richiede una favicon, un logo, o una foto prodotto, la sessione può generare e iterare invece di consegnarti un prompt da portare altrove.
Schizza un logo per questo pacchetto in tre varianti e salva i file.
Catalogo completo: felo.ai/skills/pi-coding-agent — incluso Felo Web Fetch per trasformare pagine in dati strutturati, e Felo LiveDoc, che risponde da documenti forniti invece che dal web aperto.
Tre sessioni da provare
Scritti come li digiteresti davvero.
Risolvi un bug rispetto al comportamento attuale della libreria
Lo stack trace punta a una dipendenza, e la tua versione bloccata sta due rilasci dietro la documentazione — o davanti.
Recupera la documentazione attuale per questo metodo, confronta la firma con la versione bloccata e correggi il punto di chiamata.
Il risultato è una patch più la documentazione esatta su cui si basa. Non un’ipotesi che compila e poi si comporta in modo strano sotto carico.
Prepara un brief tecnico mentre scrivi codice
Serve spiegare una decisione build-versus-buy a persone che non apriranno mai il repository.
Ricerca prezzi e limiti attuali per questi tre servizi e prepara sei slide che posso modificare.
Un confronto con fonti e una bozza di slide, dalla stessa sessione che mantiene il tuo codice. La bozza è il punto: una scaletta costa nulla da cambiare, e un deck finito da rigenerare costa un ciclo di revisione. Le slide sono disponibili anche direttamente su felo.ai/slides quando vuoi lavorarci lontano dal terminale.
Recupera un evento di rilascio registrato
Il talk di lancio di un vendor menziona un cambiamento di comportamento che non è mai finito nel changelog.
Recupera la trascrizione, elenca ogni cambiamento di comportamento menzionato e verifica quali influenzano la nostra configurazione.
Una checklist basata sulla registrazione, con timestamp verificabili — non un riassunto da accettare sulla fiducia.
Parapetti
Pi non ha sandbox di permessi. Questo aspetto merita spazio nell’articolo, non in una nota a piè pagina. Le note di sicurezza di Pi dichiarano che una competenza può istruire il modello a eseguire qualsiasi cosa l’utente può eseguire. Una competenza ha quindi la stessa potenza del tuo account shell. Leggi prima di installare, non evitare le competenze.
Leggi il bundle prima. Le competenze Felo sono semplici Markdown. Apri SKILL.md, scorri e osserva quali comandi chiede al modello di eseguire. Questa pratica vale per tutte le competenze AI coding agent; su Pi rappresenta l’intero modello di sicurezza. Se un bundle è troppo lungo da leggere in un minuto, considera quello il risultato. L’installazione tramite copia cartella funziona in entrambi i sensi: la rimozione è una cancellazione di cartella, senza script di disinstallazione e nulla rimane nel nucleo.
Rispetta il filtro di fiducia. Le competenze a livello di progetto .pi/skills e .agents/skills si caricano solo dopo aver dato fiducia al progetto. Mantieni le radici utente per bundle scelti deliberatamente, e lascia che la portata del progetto resti abbastanza piccola da riconoscere una nuova cartella.
Tieni la chiave nella configurazione utente. Il CLI Felo legge ~/.felo/config.json. Se una chiave API appare sotto .pi/skills di un progetto, si tratta di un errore di setup, non di comportamento della competenza — ed è il tipo di errore che finisce in un commit.
Chiedi fonti nell’output. Il vantaggio di una competenza rispetto a una memoria è che ogni affermazione arriva con una data e un luogo dove verificarla. Specifica quel formato quando non è già quello predefinito.
FAQ
Qual è la differenza tra un’estensione Pi e una competenza Felo?
Le estensioni sono codice TypeScript che modifica il funzionamento del sistema. Le competenze sono procedure Markdown che l’agente carica su richiesta. I bundle Felo sono competenze, quindi non vengono eseguiti nel nucleo di Pi come fanno le estensioni.
Dove cerca Pi le competenze?
Globalmente in ~/.pi/agent/skills e ~/.agents/skills; per progetto in .pi/skills e .agents/skills dopo aver dato fiducia al progetto; e nei pacchetti tramite una directory skills/ o una voce pi.skills in package.json.
Posso distribuire competenze Felo a un team tramite npm?
I pacchetti Pi supportano npm, git e percorsi locali. Se il tuo team installa già pacchetti condivisi con pi install, i bundle Felo possono viaggiare nello stesso pacchetto sotto una directory skills/.
Le competenze Felo richiedono una chiave API nel repository?
No. Il CLI Felo legge ~/.felo/config.json. Tieni la chiave nella configurazione utente così non finisce mai in un commit di progetto.
Pi non ha sandbox di permessi. È un problema per le competenze?
Leggi prima di installare. La documentazione Pi dichiara che una competenza ha la piena portata del tuo account shell. Scegli bundle che hai revisionato, e preferisci quelli che puoi leggere in un minuto.
Quale competenza Felo dovrei provare per prima?
Inizia con Felo Search se il tuo lavoro dipende da versioni, prezzi o avvisi attuali. Tutto il resto diventa più utile quando le risposte arrivano con una fonte allegata.
Scegli la competenza che copre il tuo vicolo cieco più frequente, copia quella cartella in ~/.pi/agent/skills, e poni la prossima domanda aspettandoti una fonte invece di una memoria. Il nucleo resta esattamente ridotto — la sessione smette di indovinare.
Scopri le competenze Felo per Pi Coding Agent →
Questo articolo è disponibile anche in English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, ไทย, Español, বাংলা and Português.