Nucleo piccolo, bordi affilati

Pi resta minimale. Le skill Felo si occupano del mondo esterno.

Pi distribuisce un nucleo dell'agente volutamente piccolo e ti chiede di estenderlo con estensioni, skill, template di prompt, temi e pacchetti. Le skill Felo lo estendono senza aggiungere codice al nucleo — ricerca in tempo reale, estrazione di pagine, trascrizioni e output in presentazioni arrivano come semplici pacchetti Markdown.

Fatto per Pi~/.pi/agent/skillsRicerca, slide, trascrizioni, X
Installa una skillVedi i compromessi

Harness di coding da terminale, minimale

01Installa Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Radici delle skill
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Installazione da pacchetto
pi install npm:@scope/pkg o pi install git:github.com/user/repo
04Standard
Agent Skills — lo stesso formato SKILL.md degli altri harness
Provalo in una directory di progettopi # poi chiedi una skill che recuperi una pagina come Markdown
Nucleo minimalele skill sono il punto di estensione, non altri tool
Quattro radici per le skill~/.pi/agent/skills, .pi/skills, .agents/skills, pacchetti
npm o curlinstalla l'harness, poi aggiungi cartelle
Nessuna sandboxleggi ogni pacchetto prima di installarlo
Divisione del lavoro

Cosa tiene Pi e cosa dovrebbe portare una skill

La documentazione di Pi è diretta sul perimetro: il nucleo è volutamente piccolo e funzioni come i sub-agent e la modalità piano restano fuori. Le skill sono il punto di estensione previsto per la conoscenza legata ai compiti — compresi i compiti che escono dal terminale.

Nucleo di PiUna skill Felo
Che cos'èRuntime, gestione delle sessioni, TUI, impalcatura di provider e modelliUn pacchetto SKILL.md che descrive un lavoro dall'inizio alla fine
Come cambiaEstensioni TypeScript, pacchetti, impostazioni, temiAggiungi o rimuovi una cartella — nessuna ricompilazione, nessun riavvio del nucleo
Ideale perFar comportare l'harness come lavori tuFar produrre a un compito ripetibile un risultato affidabile
Accesso al webLasciato al provider e ai tool che aggiungiRicerca in tempo reale, estrazione di pagine e trascrizioni con elenchi di fonti
OutputPrima il terminale: testo in streaming e diffMarkdown, note di ricerca e presentazioni da passare ad altri
Carico di revisioneRivedi estensioni che eseguono codice arbitrarioLeggi una procedura Markdown prima di fidartene
Skill scelte

Cinque skill Felo che tengono il nucleo di Pi fuori dai piedi

Pi carica le skill da ~/.pi/agent/skills, ~/.agents/skills, dalle .pi/skills e .agents/skills di progetto, oppure dalla cartella skills/ di un pacchetto. Metti dentro ciò che ti serve; lascia fuori il resto.

Felo Search

Risposte con fonti
RicercaFonti

Pi resta minimale di proposito, quindi una skill è il modo per aggiungere portata senza aggiungere tool da accudire. I risultati arrivano datati e con link, pronti da citare nella stessa risposta.

Richiesta di esempioTrova la versione di Node consigliata per questa dipendenza e cita dove l'hai letto.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Apri la pagina Felo Search →

Felo Slides

Presentazione dal diff
OutputPresentazione

Chi fa review legge presentazioni, non lo scrollback del terminale. Questa trasforma ciò che la sessione ha trovato in slide senza uscire dal flusso di Pi.

Richiesta di esempioRiassumi questo refactor in cinque slide: cosa si è spostato, cosa si è rotto, cosa va rivisto.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Apri la pagina Felo Slides →

Felo YouTube Subtitling

Trascrizioni senza browser
VideoTrascrizione

Pi non ha un pannello browser, quindi i contenuti video restano normalmente fuori portata. Questa estrae i sottotitoli e restituisce testo su cui la sessione può fare grep.

Richiesta di esempioRecupera la trascrizione di questo talk ed estrai ogni numero di benchmark che cita.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Apri la pagina Felo YouTube Subtitling →

Felo X Search

Cosa segnalano le persone su X
SegnaliSocial

Vale la pena eseguirla prima di un rilascio: controlla se altre persone su questa versione stanno incontrando lo stesso errore che stai fissando.

Richiesta di esempioCerca su X gli errori di questa versione della libreria ed elenca i tre più ripetuti.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Apri la pagina Felo X Search →

Felo SuperAgent

Immagini di brand e di prodotto
ImmaginiBrand

Quando il progetto ha bisogno di una favicon, di un logo composto o di uno scatto di prodotto, la stessa sessione può generarlo e iterarlo invece di passarti un prompt da eseguire altrove.

Richiesta di esempioAbbozza un logo per questo pacchetto in tre direzioni e salva le varianti come file.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Apri la pagina Felo SuperAgent →
Catalogo completo

Scegli la skill Felo da installare su Pi

Pi carica le skill da una cartella che è tua, quindi aggiungerne una è una copia. Scegli il lavoro che vuoi far gestire adesso: ricerca, estrazione, slide, trascrizioni, monitoraggio social o un flusso di lavoro di lunga durata.

Aggiungi su Pi

Felo Search

Ricerca web live con fonti citabili

cp -r felo-skills/felo-search ~/.pi/agent/skills/

Felo Web Fetch

Trasforma le pagine in dati strutturati e riutilizzabili

cp -r felo-skills/felo-web-fetch ~/.pi/agent/skills/

Felo LiveDoc

Risposte basate sui tuoi documenti

cp -r felo-skills/felo-livedoc ~/.pi/agent/skills/

Felo YouTube Subtitling

Trascrizioni di talk, demo e recensioni

cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/

Felo X Search

Segui post e risposte su X

cp -r felo-skills/felo-x-search ~/.pi/agent/skills/

Felo Slides

Genera una presentazione da un solo prompt

cp -r felo-skills/felo-slides ~/.pi/agent/skills/

Felo Content to Slides

Trasforma note e URL in una scaletta per slide

cp -r felo-skills/felo-content-to-slides ~/.pi/agent/skills/

Felo SuperAgent

Workflow di lunga durata che mantengono la memoria

cp -r felo-skills/felo-superagent ~/.pi/agent/skills/

Website Screenshot Agent

Cattura pagine come snapshot e Markdown

cp -r felo-skills/doc-screenshot-agent ~/.pi/agent/skills/

Felo Twitter Writer

Bozze di post su X dal tuo materiale

cp -r felo-skills/felo-twitter-writer ~/.pi/agent/skills/

Felo Landing Page

Genera una landing page da un brief

cp -r felo-skills/felo-landingpage ~/.pi/agent/skills/

Apple Buy Advisor

Ricerca sui prodotti Apple prima dell'acquisto

cp -r felo-skills/apple-buy-advisor ~/.pi/agent/skills/

Preferisci limitarla al progetto? Copia in .pi/skills/ e dai fiducia al progetto quando Pi lo chiede.

Percorso di adozione

Come gli utenti Pi aggiungono le skill Felo

Di solito gli utenti Pi installano prima una cartella di skill, tengono la sessione aperta e aggiungono le skill di output solo quando la ricerca funziona.

Installa una cartella di skill

Pi legge le skill dal livello utente, dal progetto o da un pacchetto, quindi parti dal perimetro più stretto.

  • ~/.pi/agent/skills per ogni progetto della macchina
  • .pi/skills solo per un repository
  • La cartella skills/ di un pacchetto quando un team condivide la configurazione

Fai la prima richiesta di ricerca

Il valore si vede la prima volta che la sessione risponde con una fonte invece che con una supposizione.

  • Confronta una dipendenza bloccata con le note di rilascio di oggi
  • Controlla un avviso di sicurezza prima di un merge
  • Tieni la risposta nel terminale, non in una scheda del browser

Aggiungi le skill di output

Quando la ricerca funziona, la stessa sessione può produrre ciò che il team legge davvero.

  • Slide dal diff o dall'indagine
  • Trascrizioni da un talk o da una demo
  • Segnalazioni da X prima di un rilascio, immagini quando il progetto ha bisogno di un marchio
Installazione

Copia una cartella, oppure aggiungila come pacchetto

Due strade: la copia diretta funziona ovunque, e i pacchetti Pi sono l'opzione più pulita quando vuoi lo stesso pacchetto su più macchine.

  1. 01

    Installa Pi e accedi

    Usa l'npm install o l'installer da shell, poi esegui pi dentro una directory di progetto e autenticati con /login o con la chiave API di un provider.

    Terminale
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    # or
    curl -fsSL https://pi.dev/install.sh | sh
    
    # then, in a project directory
    pi
  2. 02

    Prepara le credenziali Felo

    Le skill chiamano la CLI Felo, quindi installala una volta e salva la chiave fuori dal repository.

    Terminale
    npm install -g felo-ai
    felo config set FELO_API_KEY your-api-key-here
  3. 03

    Aggiungi le skill

    Le skill globali stanno in ~/.pi/agent/skills. Le skill di progetto vanno in .pi/skills e si caricano solo dopo che dai fiducia al progetto. Se tieni una cartella condivisa per più harness, va bene anche ~/.agents/skills.

    Terminale
    git clone https://github.com/Felo-Inc/felo-skills.git
    
    # Every project on this machine
    mkdir -p ~/.pi/agent/skills
    cp -r felo-skills/felo-search ~/.pi/agent/skills/
    
    # Or just this repository
    mkdir -p .pi/skills
    cp -r felo-skills/felo-search .pi/skills/

    Puoi anche caricare un pacchetto senza copiarlo: pi --skill /path/to/felo-search. Il flag è additivo anche quando parti con --no-skills.

  4. 04

    Controlla cosa ha caricato Pi

    Pi valida le skill secondo lo standard Agent Skills e segnala la maggior parte delle violazioni. Chiedi l'elenco delle skill, poi esegui il compito che ti interessa davvero.

    Chiedi a Pi
    Quali skill sono disponibili in questa sessione? Poi usa felo-search
    per recuperare le note di rilascio del nostro driver di database.
In pratica

Cosa cambia in una giornata di sessioni Pi

Tre momenti quotidiani in cui una skill batte un'altra estensione.

01

Correggi un bug confrontandoti con il comportamento attuale della libreria

Lo stack trace punta dentro una dipendenza e la versione che hai installato è due rilasci indietro rispetto alla documentazione.

PromptRecupera la documentazione attuale di questo metodo, confronta la firma con la versione bloccata e correggi il punto di chiamata.
Cosa arriva indietro

Una patch più la documentazione esatta su cui si basa, invece di una supposizione che compila ma si comporta in modo strano.

Felo SearchFelo YouTube Subtitling
02

Prepara un briefing tecnico mentre scrivi codice

Devi spiegare a un team che non legge il repository una decisione tra costruire e comprare.

PromptFai ricerca sui prezzi e sui limiti attuali di questi tre servizi e prepara sei slide che possa modificare.
Cosa arriva indietro

Un confronto con fonti e una bozza di slide, prodotti nella stessa sessione da terminale.

Felo SuperAgentFelo Slides
03

Recupera un evento di rilascio registrato

Il talk di lancio di un fornitore cita un cambiamento di comportamento che non è mai finito nel changelog.

PromptEstrai la trascrizione, elenca ogni cambiamento di comportamento citato e controlla quali toccano la nostra configurazione.
Cosa arriva indietro

Una checklist fondata sulla registrazione, con timestamp che puoi verificare.

Felo YouTube Subtitling
Domande frequenti

Domande che emergono in una sessione Pi

Qual è la differenza tra un'estensione di Pi e una skill Felo?
Le estensioni sono codice TypeScript che cambia come gira l'harness. Le skill sono procedure Markdown che l'agente carica su richiesta. I pacchetti Felo sono skill, quindi non vengono eseguiti dentro il nucleo di Pi come fa un'estensione.
Dove cerca le skill Pi?
Globalmente in ~/.pi/agent/skills e ~/.agents/skills; per progetto in .pi/skills e .agents/skills dopo che il progetto è considerato fidato; e dentro i pacchetti tramite una cartella skills/ o una voce pi.skills in package.json.
Posso distribuire le skill 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 pacchetti Felo possono viaggiare nello stesso pacchetto sotto una cartella skills/.
Le skill Felo richiedono una chiave API nel repository?
No. La CLI Felo legge ~/.felo/config.json. Tieni la chiave nella tua configurazione utente, così non finisce mai in un commit di progetto.
Pi non ha una sandbox dei permessi. È un problema per le skill?
È un motivo per leggere prima di installare. Le note di sicurezza di Pi dicono che le skill possono istruire il modello a eseguire qualunque cosa l'utente possa eseguire. Attieniti ai pacchetti che hai rivisto e preferisci quelli che leggi in un minuto.
Da quale skill Felo conviene iniziare?
Inizia da felo-search se il tuo lavoro dipende da versioni, prezzi o avvisi di sicurezza attuali.

Tieni piccolo il nucleo. Aggiungi la capacità che ti serve.

Copia una cartella in ~/.pi/agent/skills, riavvia la sessione e chiedi a Pi qualcosa che richiede il web in tempo reale.

Felo AI è un editore di skill indipendente. Pi è mantenuto da Earendil Inc.

Oltre le skill già pronte

Una chiave API. Un kit di strumenti completo per gli agenti.

Parti da una skill e componi poi i modelli, i dati in tempo reale, la conoscenza e gli strumenti di output che servono al tuo flusso su Pi Coding Agent: la stessa chiave che le skill Felo usano già.

Modelli

Usa un accesso LLM conveniente quando il tuo agente ha bisogno di ragionamento o generazione su misura.

  • LLM API
  • Chat completions
  • Accesso ai modelli
Esplora l'LLM API →