Núcleo pequeno, arestas afiadas

O Pi continua minimalista. Os skills da Felo cuidam do mundo lá fora.

O Pi vem com um núcleo de agente deliberadamente pequeno e pede que você o estenda com extensões, skills, templates de prompt, temas e pacotes. Os skills da Felo estendem o Pi sem adicionar código ao núcleo — busca ao vivo, extração de páginas, transcrições e decks chegam como pacotes Markdown simples.

Feito para o Pi~/.pi/agent/skillsBusca, slides, transcrições, X
Instale um skillVeja os trade-offs

Harness de codificação minimalista para o terminal

01Instalar o Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Raízes de skills
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Instalação por pacote
pi install npm:@scope/pkg ou pi install git:github.com/user/repo
04Padrão
Agent Skills — o mesmo formato SKILL.md de outros harnesses
Teste em um diretório de projetopi # depois peça uma skill que capture uma página como Markdown
Núcleo mínimoos skills são o ponto de extensão, não mais ferramentas
Quatro raízes de skills~/.pi/agent/skills, .pi/skills, .agents/skills, pacotes
npm ou curlinstale o harness e depois adicione pastas
Sem sandboxleia cada pacote antes de instalá-lo
Divisão de trabalho

O que o Pi mantém e o que um skill deve carregar

A documentação do Pi é direta quanto ao escopo: o núcleo é pequeno de propósito, e recursos como subagentes e modo de planejamento ficam de fora. Os skills são o ponto de extensão previsto para conhecimento de tarefa — inclusive tarefas que saem do terminal.

Núcleo do PiUm skill da Felo
O que éRuntime, tratamento de sessão, TUI, encanamento de provedores e modelosUm pacote SKILL.md que descreve um trabalho de ponta a ponta
Como mudaExtensões em TypeScript, pacotes, configurações, temasAdicionar ou remover uma pasta — sem rebuild, sem reiniciar o núcleo
Melhor paraFazer o harness se comportar do seu jeitoFazer uma tarefa repetível produzir um resultado confiável
Acesso à webFica por conta do provedor e das ferramentas que você adicionaBusca ao vivo, leitura de páginas e transcrições com lista de fontes
SaídaPrimeiro o terminal, com texto e diffs em fluxoMarkdown, notas de pesquisa e decks de slides prontos para repassar
Peso da revisãoVocê audita extensões que executam código arbitrárioVocê lê um procedimento em Markdown antes de confiar nele
Skills escolhidos

Cinco skills da Felo que deixam o núcleo do Pi fora do caminho

O Pi carrega skills de ~/.pi/agent/skills, ~/.agents/skills, de .pi/skills e .agents/skills no nível do projeto, ou do diretório skills/ de um pacote. Coloque o que precisa; deixe o resto de fora.

Felo Search

Respostas com fontes
PesquisaFontes

O Pi é minimalista de propósito, então um skill é o jeito de ganhar alcance sem somar ferramentas para vigiar. Os resultados chegam datados e com links, prontos para citar na mesma resposta.

Pedido de exemploDescubra a versão recomendada do Node para esta dependência e cite onde você leu isso.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Abrir a página do Felo Search →

Felo Slides

Deck a partir do diff
SaídaDeck

Quem revisa lê decks, não o histórico do terminal. Isto transforma o que a sessão achou em slides sem sair do fluxo do Pi.

Pedido de exemploResuma este refactor em cinco slides: o que mudou de lugar, o que quebrou, o que precisa de revisão.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Abrir a página do Felo Slides →

Felo YouTube Subtitling

Transcrições sem navegador
VídeoTranscrição

O Pi não tem painel de navegador, então conteúdo em vídeo normalmente fica fora de alcance. Isto puxa as legendas e devolve texto que a sessão consegue vasculhar.

Pedido de exemploPegue a transcrição desta palestra e extraia cada número de benchmark citado.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Abrir a página do Felo YouTube Subtitling →

Felo X Search

O que as pessoas relatam no X
SinaisSocial

Vale rodar antes de um lançamento: verifique se outras pessoas nesta versão estão encontrando o mesmo erro que você está encarando.

Pedido de exemploBusque no X erros desta versão da biblioteca e liste os três mais repetidos.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Abrir a página do Felo X Search →

Felo SuperAgent

Imagens de marca e de produto
ImagensMarca

Quando o projeto precisa de um favicon, de um logo ou de uma foto de produto, a mesma sessão pode gerar e iterar nisso em vez de te entregar um prompt para rodar em outro lugar.

Pedido de exemploEsboce um logo para este pacote em três direções e salve as variantes como arquivos.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Abrir a página do Felo SuperAgent →
Catálogo completo

Escolha o skill da Felo para instalar no Pi

O Pi carrega skills de uma pasta sua, então adicionar um é uma cópia. Escolha o trabalho que você quer resolver agora: pesquisa, extração, slides, transcrições, monitoramento social ou um fluxo de longa duração.

Adicionar no Pi

Felo Search

Pesquisa na web ao vivo com fontes citáveis

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

Felo Web Fetch

Transforme páginas em dados estruturados e reutilizáveis

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

Felo LiveDoc

Respostas com base nos seus próprios documentos

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

Felo YouTube Subtitling

Transcrições de palestras, demos e reviews

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

Felo X Search

Acompanhe posts e respostas no X

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

Felo Slides

Gere uma apresentação a partir de um único prompt

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

Felo Content to Slides

Transforme notas e URLs em um roteiro de apresentação

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

Felo SuperAgent

Fluxos de longa duração que mantêm a memória

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

Website Screenshot Agent

Capture páginas como snapshots e Markdown

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

Felo Twitter Writer

Escreva posts no X com o seu próprio material

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

Felo Landing Page

Gere uma landing page a partir de um briefing

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

Apple Buy Advisor

Pesquisa de produtos Apple antes de comprar

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

Prefere escopo de projeto? Copie para .pi/skills/ e confie no projeto quando o Pi pedir.

Caminho de adoção

Como usuários do Pi adicionam skills da Felo

Quem usa o Pi costuma instalar primeiro uma pasta de skill, manter a sessão aberta e só adicionar os skills de saída quando a pesquisa funciona.

Instale uma pasta de skill

O Pi lê skills da camada de usuário, do projeto ou de um pacote, então comece pelo escopo mais estreito.

  • ~/.pi/agent/skills para todos os projetos da máquina
  • .pi/skills para um repositório apenas
  • O diretório skills/ de um pacote quando um time compartilha a configuração

Faça a primeira pergunta de pesquisa

O valor aparece na primeira vez que a sessão responde com uma fonte em vez de um palpite.

  • Compare uma dependência fixada com as notas de release de hoje
  • Cheque um aviso de segurança antes de um merge
  • Mantenha a resposta no terminal, não em uma aba do navegador

Adicione os skills de saída

Quando a pesquisa funciona, a mesma sessão consegue produzir o que o time de fato lê.

  • Slides a partir do diff ou da investigação
  • Transcrições de uma palestra ou demonstração
  • Relatos do X antes de um lançamento, imagens quando o projeto precisa de uma marca
Instalação

Copie uma pasta ou adicione como pacote

Dois caminhos: a cópia direta funciona em qualquer lugar, e os pacotes do Pi são a opção mais limpa quando você quiser o mesmo pacote em várias máquinas.

  1. 01

    Instale o Pi e faça login

    Use o npm install ou o instalador de shell, depois rode pi dentro de um diretório de projeto e autentique com /login ou com a chave de API do provedor.

    Terminal
    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

    Prepare as credenciais da Felo

    Os skills chamam a CLI da Felo, então instale-a uma vez e guarde a chave fora do repositório.

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

    Adicione os skills

    Skills globais ficam em ~/.pi/agent/skills. Skills de projeto ficam em .pi/skills e só carregam depois que você confia no projeto. Se você mantém uma pasta compartilhada para vários harnesses, ~/.agents/skills também funciona.

    Terminal
    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/

    Você também pode carregar um pacote sem copiá-lo: pi --skill /path/to/felo-search. A flag é aditiva mesmo quando você começa com --no-skills.

  4. 04

    Veja o que o Pi carregou

    O Pi valida skills contra o padrão Agent Skills e reporta a maioria das violações. Peça a lista de skills e depois rode a tarefa que realmente importa.

    Pergunte ao Pi
    Quais skills estão disponíveis nesta sessão? Em seguida, use felo-search
    para buscar as notas de versão do nosso driver de banco de dados.
Na prática

O que muda em um dia de sessões no Pi

Três momentos do dia a dia em que um skill supera mais uma extensão.

01

Corrija um bug usando o comportamento atual da biblioteca

A stack trace aponta para uma dependência, e a versão instalada está duas releases atrás da documentação.

PromptBusque a documentação atual deste método, compare a assinatura com a versão fixada e corrija o ponto de chamada.
O que retorna

Um patch e a documentação exata em que ele se baseou, em vez de um palpite que compila mas se comporta de forma estranha.

Felo SearchFelo YouTube Subtitling
02

Prepare um resumo técnico enquanto você programa

Você precisa explicar uma decisão de comprar ou construir para um time que não lê o repositório.

PromptPesquise preços e limites atuais destes três serviços e rascunhe seis slides que eu possa editar.
O que retorna

Uma comparação com fontes e um rascunho de slides, produzidos na mesma sessão de terminal.

Felo SuperAgentFelo Slides
03

Coloque em dia um evento de lançamento gravado

Uma palestra de lançamento de um fornecedor menciona uma mudança de comportamento que nunca entrou no changelog.

PromptPuxe a transcrição, liste cada mudança de comportamento mencionada e veja quais afetam a nossa configuração.
O que retorna

Uma lista de verificação baseada na gravação, com marcações de tempo que você pode conferir.

Felo YouTube Subtitling
Perguntas frequentes

Perguntas que aparecem em uma sessão no Pi

Qual é a diferença entre uma extensão do Pi e um skill da Felo?
Extensões são código TypeScript que muda como o harness roda. Skills são procedimentos em Markdown que o agente carrega sob demanda. Os pacotes da Felo são skills, então não executam dentro do núcleo do Pi como uma extensão.
Onde o Pi procura skills?
Globalmente em ~/.pi/agent/skills e ~/.agents/skills; por projeto em .pi/skills e .agents/skills depois que o projeto é marcado como confiável; e dentro de pacotes por um diretório skills/ ou uma entrada pi.skills no package.json.
Consigo distribuir skills da Felo para um time via npm?
Pacotes do Pi aceitam npm, git e caminhos locais. Se o seu time já instala pacotes compartilhados com pi install, os pacotes da Felo podem ir junto no mesmo pacote, dentro de um diretório skills/.
Os skills da Felo precisam de uma chave de API no repositório?
Não. A CLI da Felo lê ~/.felo/config.json. Mantenha a chave na sua configuração de usuário para que ela nunca entre em um commit do projeto.
O Pi não tem sandbox de permissões. Isso é um problema para os skills?
É um motivo para ler antes de instalar. As próprias notas de segurança do Pi dizem que skills podem instruir o modelo a rodar qualquer coisa que o usuário consiga rodar. Fique com pacotes que você revisou, e prefira os que dá para ler em um minuto.
Com qual skill da Felo eu começo?
Comece pelo felo-search se o seu trabalho depende de versões, preços ou avisos atuais.

Mantenha o núcleo pequeno. Adicione a capacidade de que precisa.

Copie uma pasta para ~/.pi/agent/skills, reinicie a sessão e pergunte ao Pi algo que exija a web ao vivo.

A Felo AI é uma publicadora independente de skills. O Pi é mantido pela Earendil Inc.

Além das skills prontas

Uma chave de API. Um kit completo de ferramentas para agentes.

Comece com uma skill e combine depois os modelos, os dados em tempo real, o conhecimento e as ferramentas de saída de que o seu fluxo no Pi Coding Agent precisa — a mesma chave que as skills da Felo já usam.

Modelos

Use acesso a LLM com bom custo-benefício quando o seu agente precisar de raciocínio ou geração próprios.

  • LLM API
  • Chat completions
  • Acesso a modelos
Explorar a LLM API →

Conhecimento e saída

Fundamente o trabalho em conhecimento reutilizável e transforme-o em entregáveis que podem ser compartilhados.

  • LiveDoc
  • Geração de PPT
  • Mapas mentais
Explorar ferramentas de conhecimento →

Ferramentas criativas

Estenda o fluxo da pesquisa até resultados visuais e prontos para o Office.

  • Geração de imagens
  • Ferramentas de página
  • Saídas do Office
Explorar ferramentas da plataforma →