Felo Skills para Pi Coding Agent: Núcleo Pequeno, Web ao Vivo
Adicione habilidades Felo ao Pi Coding Agent para busca ao vivo, transcrições, sinais do X e rascunhos de slides — sem adicionar uma linha de código ao núcleo mínimo.
O Pi Coding Agent mantém seu núcleo pequeno de propósito. Subagentes e modo de planejamento ficam de fora, e a superfície que você aprende no primeiro dia é a mesma que você encontra no sexto mês.
Essa contenção é o objetivo. Menos partes móveis dentro do núcleo significam menos pontos para depurar, menos necessidade de sincronização e uma sessão que se comporta do mesmo jeito no próximo trimestre.
A contenção tem um limite. Quando uma tarefa precisa da web ao vivo — notas de lançamento de hoje, uma página que você não pode colar, uma palestra, o que as pessoas estão postando sobre a versão que você acabou de instalar — um núcleo mínimo não alcança.
As habilidades são o ponto de extensão que o Pi espera que você use, e as habilidades do Pi Coding Agent são pastas Markdown simples, não plugins compilados. Os pacotes do Felo dão esse alcance à sessão sem que nada disso entre no núcleo.
Habilidades são o ponto de extensão, não mais ferramentas
A documentação do Pi é direta sobre o escopo: o núcleo é pequeno de propósito, e recursos como subagentes e modo de planejamento ficam de fora. O conhecimento da tarefa fica nas habilidades, que o agente carrega quando a tarefa pede.
| Núcleo Pi | Uma habilidade Felo | |
|---|---|---|
| O que é | Runtime, gerenciamento de sessão, TUI, integração de provedor e modelo | Um pacote SKILL.md que descreve um trabalho do início ao fim |
| Como muda | Extensões TypeScript, pacotes, configurações, temas | Adicione ou remova uma pasta — sem rebuild |
| Acesso à web | Fica com o provedor e as ferramentas que você adiciona | Busca ao vivo, captura de página e transcrições com lista de fontes |
| Carga de revisão | Você audita extensões que executam código arbitrário | Você lê um procedimento Markdown antes de confiar |
Uma extensão é código com o mesmo alcance do agente. Uma habilidade é um procedimento que você lê em dois minutos e recusa se quiser.
Onde o Pi procura uma habilidade. Quatro raízes, mais pacotes:
~/.pi/agent/skills— todo projeto na máquina~/.agents/skills— local compartilhado, acessível por agentes que seguem o mesmo padrão.pi/skills— um repositório, carregado só depois que você confia no projeto.agents/skills— igual, mas no local compartilhado- o diretório
skills/de um pacote, ou uma entradapi.skillsnopackage.json
O Pi valida habilidades pelo padrão Agent Skills e relata a maioria das violações, então uma pasta SKILL.md que já funciona em outro agente funciona aqui com um cp -r. Habilidades do Pi são pastas que você controla, não plugins compilados no binário.
As raízes em nível de projeto só carregam depois do prompt de confiança. Esse portão protege de verdade: um repositório recém-clonado não pode entregar um novo procedimento só porque você rodou pi nele.
Extensão ou habilidade? Pacotes Felo são habilidades, não extensões — nada deles executa dentro do núcleo do Pi.
Como adicionar. No diretório do projeto, copie um pacote para uma raiz de habilidades ou deixe um pacote carregar:
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Quando o mesmo pacote deve chegar a várias máquinas, deixe um pacote carregar:
pi install npm:@scope/pkg
pi install git:github.com/user/repo
Você também pode carregar um pacote sem copiar: pi --skill /path/to/felo-search. O flag é aditivo, mesmo quando você inicia a sessão com --no-skills.
Credenciais ficam fora do repositório. Instale o Felo CLI uma vez, armazene a chave na sua configuração de usuário, e toda habilidade encontra:
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
O CLI lê ~/.felo/config.json, então a chave nunca entra em um commit do projeto. Usuários do Pi começam com uma pasta, confirmam que a pesquisa funciona, e só depois adicionam habilidades que produzem saída.
Cinco habilidades Felo que valem a pena
Cada uma cobre um trabalho que o terminal não faz sozinho.
Felo Search — respostas com fontes
O passo de pesquisa que as outras habilidades usam. Alcança a web ao vivo e retorna achados datados e linkados, prontos para citar na mesma resposta que você já escreve.
Encontre a versão recomendada do Node para esta dependência e cite onde leu.
Felo Slides — o deck da sessão
Revisores leem decks, não o scroll do terminal. O esqueleto chega como texto primeiro, dentro do Pi, então você ajusta o argumento antes de existir um slide. Só depois ele gera o arquivo, com fontes nas notas do apresentador.
Resuma este refactor em cinco slides: o que mudou, o que quebrou, o que precisa de revisão.
Felo YouTube Subtitling — transcrições sem navegador
O Pi não tem painel de navegador, então vídeo gravado fica fora de alcance. Isso puxa legendas e devolve texto que a sessão pode buscar, citar e comparar com sua configuração.
Pegue a transcrição desta palestra e destaque cada número de benchmark citado.
Felo X Search — o que relatam no X
Vale rodar antes de um release: veja se mais alguém nesta versão encontra o mesmo erro que você.
Busque no X por erros desta versão da biblioteca e liste os três mais repetidos.
Felo SuperAgent — imagens na mesma sessão
Quando o projeto precisa de favicon, logo ou foto de produto, a sessão gera e itera em vez de entregar um prompt para outro lugar.
Esboce um logo para este pacote em três estilos e salve as variantes como arquivos.
Catálogo completo: felo.ai/skills/pi-coding-agent — incluindo Felo Web Fetch para transformar páginas em dados estruturados, e Felo LiveDoc, que responde a partir de documentos que você fornece, não da web aberta.
Três sessões que valem a pena
Escritas do jeito que você digitaria.
Corrija um bug com o comportamento atual da biblioteca
O stack trace aponta para uma dependência, e sua versão está duas releases atrás da documentação — ou à frente.
Busque a documentação atual deste método, compare a assinatura com a versão fixa e corrija o ponto de chamada.
O retorno é um patch mais a documentação exata usada. Não um chute que compila e depois se comporta estranho sob carga.
Prepare um briefing técnico enquanto codifica
Você precisa explicar uma decisão make-or-buy para quem nunca abre o repositório.
Pesquise preços e limites atuais destes três serviços e rascunhe seis slides para eu editar.
Uma comparação com fontes e um rascunho de slides, da mesma sessão que mantém seu código. O rascunho é o ponto: um esqueleto custa nada para mudar, e um deck pronto que você precisa gerar de novo custa um ciclo de revisão. Slides também ficam disponíveis direto em felo.ai/slides quando quiser trabalhar fora do terminal.
Atualize-se sobre um evento gravado de lançamento
A palestra de lançamento do fornecedor cita uma mudança de comportamento que não entrou no changelog.
Pegue a transcrição, liste cada mudança de comportamento citada e veja quais afetam nossa configuração.
Um checklist baseado na gravação, com timestamps que você pode conferir — não um resumo que você aceita sem ver.
Trilhos de segurança
O Pi não tem sandbox de permissões. Isso é o ponto honesto, e fica no artigo, não no rodapé. As notas de segurança do Pi dizem que uma habilidade pode instruir o modelo a rodar qualquer coisa que o usuário pode rodar. Uma habilidade tem o mesmo poder da sua conta shell. Isso é motivo para ler antes de instalar, não para evitar habilidades.
Leia o pacote antes. Habilidades Felo são Markdown puro. Abra o SKILL.md, leia por cima e veja que comandos o modelo vai rodar. Isso é prática sensata para habilidades de agentes de IA em qualquer agente; no Pi é todo o modelo de segurança. Se um pacote é longo demais para ler em um minuto, trate isso como achado. A instalação ser uma cópia de pasta vale para os dois lados: remoção é apagar a pasta, sem script de desinstalação e nada fica no núcleo.
Respeite o portão de confiança. .pi/skills e .agents/skills em nível de projeto só carregam depois que você confia no projeto. Mantenha as raízes de usuário para pacotes que você escolheu, e deixe o escopo do projeto pequeno o bastante para notar uma pasta nova.
Guarde a chave na configuração de usuário. O Felo CLI lê ~/.felo/config.json. Se uma chave de API aparecer em .pi/skills do projeto, isso é erro de configuração, não comportamento da habilidade — e esse erro sobrevive até um commit.
Peça fontes na saída. A vantagem de uma habilidade sobre uma lembrança é que cada afirmação chega com data e onde conferir. Especifique esse formato quando não for padrão.
FAQ
Qual a diferença entre uma extensão Pi e uma habilidade Felo?
Extensões são código TypeScript que muda como o agente roda. Habilidades são procedimentos Markdown que o agente carrega sob demanda. Pacotes Felo são habilidades, então não executam dentro do núcleo do Pi como uma extensão.
Onde o Pi procura habilidades?
Globalmente em ~/.pi/agent/skills e ~/.agents/skills; por projeto em .pi/skills e .agents/skills depois do projeto confiado; e dentro de pacotes via diretório skills/ ou entrada pi.skills no package.json.
Posso distribuir habilidades Felo para um time via npm?
Pacotes Pi aceitam npm, git e caminhos locais. Se seu time já instala pacotes compartilhados com pi install, os pacotes Felo podem ir junto no mesmo pacote em skills/.
Habilidades Felo precisam de chave de API no repositório?
Não. O Felo CLI lê ~/.felo/config.json. Guarde a chave na configuração de usuário para nunca entrar em um commit.
O Pi não tem sandbox de permissões. Isso é problema para habilidades?
É motivo para ler antes de instalar. A documentação do Pi deixa claro que uma habilidade tem o alcance total da sua conta shell. Fique com pacotes que você revisou, e prefira os que lê em um minuto.
Qual habilidade Felo devo começar?
Comece com Felo Search se seu trabalho depende de versões, preços ou avisos atuais. O resto fica mais útil quando as respostas chegam com fonte.
Escolha a habilidade que cobre seu beco sem saída mais comum, copie a pasta para ~/.pi/agent/skills e faça sua próxima pergunta esperando uma fonte, não uma lembrança. O núcleo fica do mesmo tamanho — a sessão só para de chutar.
Explore habilidades Felo para Pi Coding Agent →
Este post também está disponível em English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español and বাংলা.