Pi Coding Agent용 Felo 스킬: 작은 코어, 실시간 웹
Pi Coding Agent에 Felo 스킬을 추가하면 실시간 검색, 자막, X 신호, 슬라이드 초안 기능을 최소 코어에 코드 한 줄도 추가하지 않고 사용할 수 있습니다.
Pi Coding Agent는 코어를 작게 유지합니다. 서브 에이전트와 계획 모드는 의도적으로 제외하며, 첫날에 익힌 표면이 6개월 후에도 그대로 남아 있습니다.
이 절제는 핵심입니다. 하네스 내부의 움직이는 부분이 적으면 디버깅할 것도 줄고, 동기화할 것도 줄며, 다음 분기에도 세션이 같은 방식으로 동작합니다.
절제에는 한계가 있습니다. 작업이 실시간 웹을 필요로 하는 순간—오늘의 릴리즈 노트, 붙여넣을 수 없는 페이지, 컨퍼런스 발표, 방금 설치한 버전에 대해 사람들이 올리는 글—최소 하네스에는 이를 해결할 방법이 없습니다.
스킬은 Pi가 사용하도록 의도한 확장 지점입니다. Pi 코딩 에이전트 스킬은 컴파일된 플러그인이 아니라 일반 Markdown 폴더입니다. Felo 번들은 코어에 아무것도 추가하지 않고 세션에 확장성을 제공합니다.
스킬은 확장 지점, 도구 추가가 아님
Pi의 문서는 범위에 대해 명확합니다: 코어는 의도적으로 작고, 서브 에이전트와 계획 모드 같은 기능은 제외합니다. 작업 지식은 스킬에 담기며, 에이전트는 작업이 필요할 때 스킬을 로드합니다.
| Pi core | A Felo skill | |
|---|---|---|
| What it is | Runtime, session handling, TUI, provider and model plumbing | A SKILL.md bundle describing one job end to end |
| How it changes | TypeScript extensions, packages, settings, themes | Add or remove a folder — no rebuild |
| Web access | Left to the provider and the tools you add | Live search, page fetching, and transcripts with source lists |
| Review burden | You audit extensions that run arbitrary code | You read a Markdown procedure before you trust it |
확장은 에이전트와 동일한 범위를 가진 코드입니다. 스킬은 2분 만에 읽고 거부할 수 있는 절차입니다.
Pi가 스킬을 찾는 위치. 네 가지 루트와 패키지:
~/.pi/agent/skills— 머신의 모든 프로젝트~/.agents/skills— 같은 표준을 따르는 하네스가 읽을 수 있는 공유 위치.pi/skills— 하나의 저장소, 프로젝트를 신뢰한 후에만 로드.agents/skills— 동일, 공유 위치- 패키지의
skills/디렉터리 또는package.json의pi.skills항목
Pi는 Agent Skills 표준에 맞게 스킬을 검증하고 대부분의 위반을 보고합니다. 이미 다른 하네스에서 동작하는 SKILL.md 폴더는 cp -r 한 번으로 여기서도 동작합니다. Pi 에이전트 스킬은 직접 소유하는 폴더이며, 바이너리에 컴파일된 플러그인이 아닙니다.
프로젝트 레벨 루트는 신뢰 프롬프트 이후에만 로드됩니다. 이 게이트는 실제로 작동합니다: 새로 클론한 저장소가 단순히 pi를 실행했다고 해서 세션에 새로운 절차를 넘겨주지 못합니다.
확장 또는 스킬? Felo 번들은 스킬이며, 확장이 아닙니다. Pi 코어 내부에서 실행되는 것은 없습니다.
스킬 추가 방법. 프로젝트 디렉터리에서 번들을 스킬 루트에 복사하거나 패키지로 전달할 수 있습니다:
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/
같은 번들을 여러 머신에서 사용하려면 패키지로 전달합니다:
pi install npm:@scope/pkg
pi install git:github.com/user/repo
복사 없이 번들을 로드할 수도 있습니다: pi --skill /path/to/felo-search. 이 플래그는 추가적이며, --no-skills로 세션을 시작해도 적용됩니다.
자격 증명은 저장소에 포함되지 않습니다. Felo CLI를 한 번 설치하고, 키를 사용자 설정에 저장하면 모든 스킬이 이를 사용합니다:
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
CLI는 ~/.felo/config.json을 읽으므로 키가 프로젝트 커밋에 포함되지 않습니다. Pi 사용자는 한 폴더로 시작해 실제로 리서치가 동작하는지 확인한 후, 결과를 만드는 스킬을 추가합니다.
추가할 만한 Felo 스킬 다섯 가지
각 스킬은 터미널만으로는 할 수 없는 작업을 담당합니다.
Felo Search — 출처와 함께 답변
다른 스킬이 의존하는 리서치 단계입니다. 실시간 웹에 접근해 날짜와 링크가 달린 결과를 반환하며, 바로 작성 중인 답변에 인용할 수 있습니다.
이 의존성에 추천되는 Node 버전을 찾아 읽은 곳을 인용하세요.
Felo Slides — 세션에서 바로 만드는 슬라이드
리뷰어는 터미널 스크롤백이 아니라 슬라이드 덱을 읽습니다. 개요가 먼저 Pi 내부에 텍스트로 도착하므로, 슬라이드가 만들어지기 전에 논리를 수정할 수 있습니다. 이후 파일을 생성하며, 출처는 발표 노트에 포함됩니다.
이 리팩터링을 다섯 슬라이드로 요약하세요: 무엇이 이동했고, 무엇이 깨졌으며, 무엇을 리뷰해야 하는지.
Felo YouTube Subtitling — 브라우저 없이 자막
Pi에는 브라우저 창이 없으므로 녹화된 영상은 보통 접근할 수 없습니다. 이 스킬은 자막을 가져와 세션에서 grep, 인용, 설정 확인이 가능한 텍스트를 반환합니다.
이 발표의 자막을 가져와 인용된 모든 벤치마크 숫자를 추출하세요.
Felo X Search — X에서 사람들이 보고하는 내용
릴리즈 전에 실행할 가치가 있습니다: 같은 버전을 사용하는 다른 사람이 당신과 같은 오류를 겪는지 확인하세요.
이 라이브러리 버전에서 발생하는 오류를 X에서 검색하고 가장 많이 반복된 세 가지를 나열하세요.
Felo SuperAgent — 같은 세션에서 이미지 생성
프로젝트에 파비콘, 로고, 제품 사진이 필요할 때 세션에서 직접 생성하고 반복할 수 있습니다. 외부로 프롬프트를 넘길 필요가 없습니다.
이 패키지의 로고를 세 가지 방향으로 스케치하고, 변형을 파일로 저장하세요.
전체 목록: felo.ai/skills/pi-coding-agent — 페이지를 구조화된 데이터로 바꾸는 Felo Web Fetch, 제공한 문서에서 답변하는 Felo LiveDoc도 포함되어 있습니다.
실행할 만한 세 가지 세션
실제로 입력할 방식으로 작성했습니다.
현재 라이브러리 동작에 맞춰 버그 수정
스택 트레이스가 의존성 내부를 가리키고, 고정된 버전은 문서보다 두 릴리즈 뒤에 있거나 앞에 있습니다.
이 메서드의 최신 문서를 가져와 시그니처를 고정 버전과 비교하고, 호출 위치를 수정하세요.
돌아오는 결과는 패치와 그 근거가 된 정확한 문서입니다. 컴파일만 되는 추측이 아니라, 부하에서 이상하게 동작하는 코드를 막습니다.
코딩 중 기술 브리프 준비
빌드와 구매 결정에 대해 저장소를 열지 않는 사람에게 설명해야 합니다.
이 세 서비스의 현재 가격과 제한을 조사하고, 내가 수정할 수 있는 여섯 슬라이드 초안을 작성하세요.
출처가 있는 비교와 슬라이드 초안이 코드와 함께 있는 동일한 세션에서 나옵니다. 초안 단계가 핵심입니다: 개요는 쉽게 바꿀 수 있고, 완성된 덱은 재생성이 리뷰 사이클을 소모합니다. 슬라이드는 felo.ai/slides에서도 직접 사용할 수 있습니다. 터미널 밖에서 계속 작업할 때 유용합니다.
녹화된 릴리즈 이벤트 따라잡기
벤더의 런칭 발표에서 변경된 동작이 언급되지만, 변경 로그에는 포함되지 않았습니다.
자막을 가져와 언급된 모든 동작 변경을 나열하고, 우리 설정에 영향을 주는 항목을 확인하세요.
녹화에 근거한 체크리스트와 검증 가능한 타임스탬프가 반환됩니다. 신뢰만 해야 하는 요약이 아닙니다.
안전장치
Pi에는 권한 샌드박스가 없습니다. 이 부분은 솔직하게 기사 본문에 포함해야 합니다. Pi의 보안 노트는 스킬이 모델에게 사용자가 실행할 수 있는 모든 것을 실행하도록 지시할 수 있다고 명시합니다. 스킬은 셸 계정과 동일한 권한을 가집니다. 설치 전에 읽어야 하는 이유이며, 스킬을 피해야 할 이유는 아닙니다.
번들을 먼저 읽으세요. Felo 스킬은 일반 Markdown입니다. SKILL.md를 열어 훑어보고, 모델이 실행하도록 요청하는 명령을 확인하세요. 모든 AI 코딩 에이전트 스킬에 대해 합리적인 습관이며, Pi에서는 전체 안전 모델입니다. 번들이 1분 만에 읽기 어렵다면 그 자체가 결과입니다. 폴더 복사 방식의 설치는 제거도 폴더 삭제로 간단합니다. 언인스톨 스크립트나 코어 내부에 남는 것이 없습니다.
신뢰 게이트를 지키세요. 프로젝트 레벨 .pi/skills와 .agents/skills는 프로젝트를 신뢰한 후에만 로드됩니다. 사용자 레벨 루트에는 의도적으로 선택한 번들만 두고, 프로젝트 범위는 새 폴더를 바로 알아볼 수 있을 만큼 작게 유지하세요.
키는 사용자 설정에 저장하세요. Felo CLI는 ~/.felo/config.json을 읽습니다. API 키가 프로젝트의 .pi/skills에 나타난다면, 스킬 동작이 아니라 설정 실수입니다. 이런 실수는 커밋에 남을 수 있습니다.
출처를 결과에 요청하세요. 스킬의 장점은 각 주장에 날짜와 검증 가능한 출처가 함께 온다는 점입니다. 기본이 아니라면 그 형식을 명시하세요.
FAQ
Pi 확장과 Felo 스킬의 차이는 무엇인가요?
확장은 하네스 동작을 바꾸는 TypeScript 코드입니다. 스킬은 에이전트가 필요할 때 로드하는 Markdown 절차입니다. Felo 번들은 스킬이므로, 확장처럼 Pi 코어 내부에서 실행되지 않습니다.
Pi가 스킬을 찾는 위치는 어디인가요?
전역적으로는 ~/.pi/agent/skills와 ~/.agents/skills, 프로젝트별로는 신뢰 후 .pi/skills와 .agents/skills, 패키지 내부에서는 skills/ 디렉터리 또는 package.json의 pi.skills 항목입니다.
npm으로 팀에 Felo 스킬을 배포할 수 있나요?
Pi 패키지는 npm, git, 로컬 경로를 지원합니다. 팀이 이미 pi install로 공유 패키지를 설치한다면, Felo 번들은 같은 패키지의 skills/ 디렉터리에서 함께 배포할 수 있습니다.
Felo 스킬에 저장소 내 API 키가 필요하나요?
아니요. Felo CLI는 ~/.felo/config.json을 읽습니다. 키는 사용자 설정에 저장해 프로젝트 커밋에 포함되지 않도록 하세요.
Pi에는 권한 샌드박스가 없습니다. 스킬에 문제인가요?
설치 전에 읽어야 하는 이유입니다. Pi 문서는 스킬이 셸 계정과 동일한 권한을 가진다고 명확히 밝힙니다. 검토한 번들만 사용하고, 1분 만에 읽을 수 있는 번들을 우선하세요.
어떤 Felo 스킬부터 시작해야 하나요?
최신 버전, 가격, 권고에 의존한다면 Felo Search부터 시작하세요. 답변에 출처가 붙으면 다른 스킬도 더 유용해집니다.
가장 자주 막히는 작업을 담당하는 스킬을 골라 그 폴더를 ~/.pi/agent/skills에 복사하세요. 다음 질문에는 기억이 아닌 출처를 기대하세요. 코어는 그대로 작게 유지됩니다. 세션은 이제 추측을 멈춥니다.
Pi Coding Agent용 Felo 스킬 살펴보기 →
이 글은 다음 언어로도 읽을 수 있습니다: English, 简体中文, 日本語, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা, Português.