Мале ядро, гострі кути

Pi лишається мінімальним. Скіли Felo беруть на себе зовнішній світ.

Pi постачається з навмисно малим ядром агента й пропонує розширювати його розширеннями, скілами, шаблонами запитів, темами та пакетами. Скіли Felo розширюють його, не додаючи коду в ядро — живий пошук, вилучення сторінок, транскрипти й вивід презентацій приходять як звичайні Markdown-пакети.

Створено для Pi~/.pi/agent/skillsПошук, слайди, транскрипти, X
Встановити скілДивіться компроміси

Мінімальний термінальний harness для кодування

01Встановіть Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Корені скілів
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Встановлення пакета
pi install npm:@scope/pkg або pi install git:github.com/user/repo
04Стандарт
Agent Skills — той самий формат SKILL.md, що й в інших harness
Спробуйте в теці проєктуpi # потім попроси скіл, який зберігає сторінку як Markdown
Мінімальне ядроскіли — це точка розширення, а не ще інструменти
Чотири корені скілів~/.pi/agent/skills, .pi/skills, .agents/skills, пакети
npm або curlвстановіть harness, потім додайте теки
Без пісочниціпрочитайте кожен пакет, перш ніж встановлювати
Розподіл праці

Що лишається в Pi, а що має нести скіл

Документація Pi прямо говорить про обсяг: ядро навмисно мале, а такі можливості, як субагенти й режим планування, залишені поза ним. Скіли — це передбачена точка розширення для знання про задачі, зокрема ті, що виходять за межі термінала.

Ядро PiСкіл Felo
Що цеСередовище виконання, робота з сесіями, TUI, провайдери й моделіПакет SKILL.md, який описує одну задачу від початку до кінця
Як змінюєтьсяРозширення на TypeScript, пакети, налаштування, темиДодати або прибрати теку — без перезбирання й перезапуску ядра
Найкраще дляПідлаштувати harness під те, як працюєте виЗробити так, щоб одна повторювана задача давала надійний результат
Доступ до вебуВіддано провайдеру й інструментам, які ви додастеЖивий пошук, вилучення сторінок і транскрипти зі списками джерел
ВивідНасамперед термінал — потоковий текст і diffMarkdown, нотатки дослідження й презентації, які можна передати далі
Ціна перевіркиВи перевіряєте розширення, які виконують довільний кодВи читаєте Markdown-процедуру, перш ніж їй довіряти
Добірка скілів

П'ять скілів Felo, які не заважають ядру Pi

Pi завантажує скіли з ~/.pi/agent/skills, ~/.agents/skills, проєктних .pi/skills і .agents/skills, або з каталогу skills/ пакета. Покладіть те, що потрібно; решту лишіть осторонь.

Felo Search

Відповідає з джерелами
ДослідженняДжерела

Pi лишається мінімальним навмисно, тож скіл — це спосіб додати охоплення, не додаючи інструментів, за якими треба доглядати. Результати приходять із датами й посиланнями, готові до цитування в тій самій відповіді.

Приклад запитуЗнайди рекомендовану версію Node для цієї залежності й укажи, де ти це прочитав.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Відкрити сторінку Felo Search →

Felo Slides

Презентація з diff
ВивідПрезентація

Рев'юери читають презентації, а не прокрутку термінала. Це перетворює знайдене сесією на слайди, не виходячи з робочого процесу Pi.

Приклад запитуУклади цей рефакторинг у п'ять слайдів: що переїхало, що зламалося, що потребує рев'ю.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Відкрити сторінку Felo Slides →

Felo YouTube Subtitling

Транскрипти без браузера
ВідеоТранскрипт

У Pi немає панелі браузера, тож відеоконтент зазвичай недосяжний. Це витягує субтитри й повертає текст, який сесія може шукати.

Приклад запитуВізьми транскрипт цієї доповіді та витягни всі числа бенчмарків, які в ній згадані.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Відкрити сторінку Felo YouTube Subtitling →

Felo X Search

Що люди пишуть в X
СигналиСоцмережі

Варто запускати перед релізом: перевірте, чи не натрапляють інші на цій версії на ту саму помилку, на яку дивитеся ви.

Приклад запитуПошукай в X помилки цієї версії бібліотеки й переліч три найповторюваніші.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Відкрити сторінку Felo X Search →

Felo SuperAgent

Бренд і продуктові зображення
ЗображенняБренд

Коли проєкту потрібні favicon, логотип-локап або продуктовий кадр, та сама сесія може їх згенерувати й доопрацювати, а не видати вам запит для запуску деінде.

Приклад запитуНакидай логотип для цього пакета в трьох напрямах і збережи варіанти як файли.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Відкрити сторінку Felo SuperAgent →
Повний каталог

Виберіть скіл Felo, який встановити в Pi

Pi завантажує скіли з теки, якою володієте ви, тож додавання — це копіювання. Виберіть роботу, яку хочете доручити наступною: дослідження, вилучення, слайди, транскрипти, моніторинг соцмереж або тривалий робочий процес.

Додати в Pi

Felo Search

Дослідження вебу наживо з джерелами для цитування

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

Felo Web Fetch

Перетворення сторінок на структуровані дані

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

Felo LiveDoc

Відповіді на основі ваших документів

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

Felo YouTube Subtitling

Транскрипти доповідей, демо та оглядів

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

Felo X Search

Відстеження постів і відповідей у X

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

Felo Slides

Презентація з одного запиту

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

Felo Content to Slides

Нотатки й посилання у структуру презентації

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

Felo SuperAgent

Тривалі процеси, що зберігають пам'ять

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

Website Screenshot Agent

Знімки сторінок і Markdown

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

Felo Twitter Writer

Чернетки постів у X з ваших матеріалів

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

Felo Landing Page

Лендінг із брифу

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

Apple Buy Advisor

Дослідження продуктів Apple перед покупкою

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

Потрібно в межах проєкту? Скопіюйте в .pi/skills/ і довіртеся проєкту, коли Pi запитає.

Шлях упровадження

Як користувачі Pi додають скіли Felo

Користувачі Pi зазвичай спершу встановлюють одну теку скіла, тримають сесію відкритою й додають скіли для виводу лише тоді, коли дослідження вже працює.

Встановіть одну теку скіла

Pi читає скіли з рівня користувача, проєкту або пакета, тож почніть із найвужчого обсягу.

  • ~/.pi/agent/skills для всіх проєктів на машині
  • .pi/skills лише для одного репозиторію
  • каталог skills/ пакета, коли команда ділить одне налаштування

Виконайте перший дослідницький запит

Цінність видно вже тоді, коли сесія вперше відповідає з джерелом, а не здогадом.

  • Порівняйте закріплену залежність із сьогоднішніми нотатками про реліз
  • Перевірте рекомендацію з безпеки перед злиттям
  • Тримайте відповідь у терміналі, а не в закладці браузера

Додайте скіли для виводу

Коли дослідження працює, та сама сесія може створити те, що команда справді читає.

  • Слайди з diff або з дослідження
  • Транскрипти з доповіді чи демо
  • Звіти з X перед релізом, зображення, коли проєкту потрібна позначка
Встановлення

Скопіюйте теку або додайте її як пакет

Два шляхи: пряме копіювання працює всюди, а пакети Pi — чистіший варіант, коли ви захочете той самий пакет на кількох машинах.

  1. 01

    Встановіть Pi і увійдіть

    Скористайтеся npm install або інсталятором для оболонки, потім запустіть pi у теці проєкту й автентифікуйтеся через /login або API-ключ провайдера.

    Термінал
    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

    Підготуйте облікові дані Felo

    Скіли викликають Felo CLI, тож встановіть його один раз і зберігайте ключ поза репозиторієм.

    Термінал
    npm install -g felo-ai
    felo config set FELO_API_KEY your-api-key-here
  3. 03

    Додайте скіли

    Глобальні скіли живуть у ~/.pi/agent/skills. Проєктні скіли належать до .pi/skills і завантажуються лише після того, як ви довіритеся проєкту. Якщо ви тримаєте одну спільну теку для кількох harness, ~/.agents/skills теж підійде.

    Термінал
    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/

    Можна також завантажити пакет без копіювання: pi --skill /path/to/felo-search. Прапорець додається навіть тоді, коли ви стартуєте з --no-skills.

  4. 04

    Перевірте, що завантажив Pi

    Pi перевіряє скіли на відповідність стандарту Agent Skills і повідомляє про більшість порушень. Попросіть список скілів, а потім виконайте задачу, яка вам справді важлива.

    Запитайте в Pi
    Які скіли доступні в цій сесії? Далі через felo-search
    підтягни примітки до випуску нашого драйвера бази даних.
На практиці

Що змінюється за день сесій Pi

Три буденні моменти, де скіл кращий за ще одне розширення.

01

Виправте помилку за актуальною поведінкою бібліотеки

Стек-трейс веде в залежність, а ваша встановлена версія відстає від документації на два релізи.

ПромптЗавантаж актуальну документацію для цього методу, порівняй підпис із закріпленою версією й виправ місце виклику.
Що повертається

Патч разом із точною документацією, на якій він ґрунтується, а не здогад, який компілюється, але поводиться дивно.

Felo SearchFelo YouTube Subtitling
02

Готуйте технічне зведення, поки пишете код

Треба пояснити рішення «зробити чи купити» команді, яка не читає репозиторій.

ПромптДосліди актуальні ціни й ліміти цих трьох сервісів і напиши чернетку шести слайдів, які я зможу відредагувати.
Що повертається

Порівняння з джерелами й чернетка слайдів, створені в тій самій термінальній сесії.

Felo SuperAgentFelo Slides
03

Наздоженіть записаний релізний захід

У презентації запуску від постачальника згадано зміну поведінки, яка так і не потрапила в changelog.

ПромптВитягни транскрипт, переліч усі згадані зміни поведінки й перевір, які з них впливають на нашу конфігурацію.
Що повертається

Чекліст, заснований на записі, з мітками часу, які можна перевірити.

Felo YouTube Subtitling
Питання

Питання, які виникають у сесії Pi

У чому різниця між розширенням Pi і скілом Felo?
Розширення — це код на TypeScript, який змінює те, як працює harness. Скіли — це Markdown-процедури, які агент завантажує на вимогу. Пакети Felo — це скіли, тож вони не виконуються всередині ядра Pi так, як розширення.
Де Pi шукає скіли?
Глобально в ~/.pi/agent/skills і ~/.agents/skills; для кожного проєкту в .pi/skills і .agents/skills після того, як проєкту довірилися; і всередині пакетів через каталог skills/ або запис pi.skills у package.json.
Чи можна передати скіли Felo команді через npm?
Пакети Pi підтримують npm, git і локальні шляхи. Якщо ваша команда вже встановлює спільні пакети через pi install, пакети Felo можуть їхати в тому самому пакеті в каталозі skills/.
Чи потрібен скілам Felo API-ключ у репозиторії?
Ні. Felo CLI читає ~/.felo/config.json. Тримайте ключ у своїй користувацькій конфігурації, щоб він ніколи не потрапив у коміт проєкту.
У Pi немає пісочниці дозволів. Це проблема для скілів?
Це причина читати перед встановленням. Власні нотатки Pi про безпеку кажуть, що скіли можуть наказувати моделі запускати все, що може запустити користувач. Тримайтеся перевірених пакетів і віддавайте перевагу тим, які можна прочитати за хвилину.
З якого скіла Felo почати?
Почніть із felo-search, якщо ваша робота залежить від актуальних версій, цін або рекомендацій із безпеки.

Тримайте ядро малим. Додайте потрібну можливість.

Скопіюйте одну теку в ~/.pi/agent/skills, перезапустіть сесію й запитайте в Pi те, що потребує живого вебу.

Felo AI — незалежний видавець скілів. Pi підтримує Earendil Inc.

Коли готових скілів замало

Один ключ API. Повний набір інструментів для агента.

Почніть зі скіла, а далі складіть моделі, живі дані, знання та інструменти виводу, потрібні вашому сценарію в Pi Coding Agent, — із тим самим ключем, який скіли Felo вже використовують.

Моделі

Використовуйте економний доступ до LLM, коли агенту потрібне власне міркування чи генерація.

  • LLM API
  • Chat completions
  • Доступ до моделей
Відкрити LLM API →

Знання та результат

Ґрунтуйте роботу на знаннях, які можна використовувати повторно, а потім перетворюйте їх на матеріали, якими можна поділитися.

  • LiveDoc
  • Генерація PPT
  • Інтелект-карти
Відкрити інструменти знань →

Творчі інструменти

Розширте сценарій від дослідження до візуальних матеріалів і результатів, готових для Office.

  • Генерація зображень
  • Інструменти сторінок
  • Вивід для Office
Відкрити інструменти платформи →