DeepSeek Harness용 Felo 스킬: 플러그인 빌드 없이 실시간 소스 연결
Felo 스킬을 dsh 플러그인 트리에 추가하여 날짜가 있는 리서치, X 신호, 자막, 슬라이드를 사용할 수 있습니다 — 단순한 SKILL.md 번들, 플러그인 빌드 불필요.
DeepSeek Harness는 모든 것을 플러그인으로 취급합니다. 도구, 모델, 세션 저장소, 웹 UI, 스킬 모두 동일한 플러그인 트리에 마운트되고 스코프 체인을 통해 해석됩니다. 에이전트 루프에 직접 연결하지 않습니다.
이 구조 덕분에 dsh는 복잡하게 얽히지 않고 성장합니다. 추가한 기능은 언제든 교체하거나, 한 저장소에만 적용하거나, 주변 루프를 건드리지 않고 삭제할 수 있습니다.
dsh는 체크아웃 외부의 세계에 대해 에이전트에게 아무것도 알리지 않습니다. dsh 세션은 하루 종일 코드를 읽을 수 있지만, 이번 주 라이브러리 변경사항, 현재 가격 페이지, 지난달 컨퍼런스 발표 내용을 알지 못합니다.
Felo 스킬이 이 간극을 메웁니다. dsh가 기대하는 방식 그대로 도착합니다: 플러그인 트리에 바로 넣을 수 있는 단순한 SKILL.md 번들입니다. 플러그인 빌드도, SDK도 필요하지 않습니다. dsh가 이미 감시하는 루트에 폴더를 복사하고 세션을 새로고침하면, 스킬 도구가 다른 기능처럼 바로 호출할 수 있습니다.
스킬도 플러그인 — 더 작을 뿐
dsh는 모든 기능을 플러그인으로 마운트합니다. 스킬도 같은 구조를 더 작은 단위로 따릅니다. 스킬은 언제, 무엇을 실행하고, 무엇을 반환할지 명시한 SKILL.md가 들어있는 폴더입니다.
이 구분은 의도적입니다. 플러그인은 도구와 서비스를 추가합니다 — 모델 제공자, 저장소 백엔드, UI 등. 스킬은 에이전트가 필요할 때만 불러오는 지침이므로, 작업이 일치하지 않으면 리소스를 소모하지 않습니다.
하네스는 루프를 소유합니다. 스킬은 한 가지 작업의 노하우를 소유합니다. 오픈 웹에 접근하는 DeepSeek Harness 플러그인은 직접 관리하는 빌드입니다. 오픈 웹에 접근하는 스킬은 명령 한 번으로 추가하고 삭제하는 폴더입니다.
세 개의 루트, 한 단계 깊이
dsh는 세 위치에서 스킬을 읽습니다. 번들을 어디에 두느냐에 따라 적용 범위가 달라집니다.
| Root | Scope | What it is for |
|---|---|---|
<projectRoot>/.dsh/skills | 한 저장소 | 최우선 탐색 — 저장소별 리서치 규칙 |
<dshHome>/skills | 이 컴퓨터 | 모든 프로젝트에서 보여야 하는 기능 |
~/.agents/skills | 공유 에이전트 폴더 | 모든 세션에서 쓰고 싶은 검토된 번들 |
번들이 실제로 로드되는지 결정하는 두 가지 조건이 있습니다.
직속 자식만 탐색. dsh는 각 루트를 한 단계만 스캔합니다. skills/felo-search에 번들이 있으면 탐색됩니다. skills/research/felo-search에 있으면 보이지 않습니다. 복사한 스킬이 나타나지 않을 때 가장 흔한 원인입니다. 다른 문제를 디버깅하기 전에 이 부분을 먼저 확인해야 합니다.
kebab-case 이름만 허용. 폴더 번들(<name>/SKILL.md)과 단일 파일(<name>.md) 모두 허용됩니다. 단일 파일 스킬도 동작합니다. 단, 이름은 반드시 소문자와 하이픈만 사용해야 합니다. 그렇지 않으면 무시됩니다.
세 가지 명령, 그리고 질문
Felo 스킬은 이동 가능한 번들입니다. Felo CLI가 모든 스킬의 인증을 담당합니다. 하나의 키로 검색, 페이지 가져오기, 자막, 슬라이드 생성을 모두 처리합니다.
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
그 다음 공개 저장소를 클론하고 원하는 폴더를 복사합니다.
git clone https://github.com/Felo-Inc/felo-skills.git
cd felo-skills
먼저 프로젝트 범위에 복사하면, 한 저장소만 스킬을 시험할 수 있습니다.
mkdir -p .dsh/skills
cp -r felo-skills/felo-search felo-skills/felo-slides .dsh/skills/
유저 범위로 옮기면, 계속 사용할 수 있습니다.
mkdir -p ~/.agents/skills
cp -r felo-skills/felo-search ~/.agents/skills/
세션을 새로고침하고 스킬 도구가 인식하는지 확인합니다.
사용할 수 있는 스킬을 나열한 뒤, felo-search로 평가 중인 두 벤더의 현재 가격 정책을 비교하고 사용한 소스를 인용하세요.
스킬 제공자는 이미 존재하는 루트만 감시합니다. 새 번들은 보통 다음 카탈로그 읽기에서 바로 나타납니다. 그렇지 않으면 새 세션을 시작하세요. 웹 UI도 동일한 레지스트리를 사용합니다: npx @deepseek-ai/dsh web을 실행하고 127.0.0.1:3080을 열면 프로젝트의 스킬도 보입니다.
마운트할 가치가 있는 Felo 스킬 다섯 가지
각 스킬이 메우는 간극에 따라 선택하세요. 모든 번들은 신뢰하기 전에 직접 읽을 수 있는 폴더입니다. 하네스가 샌드박스가 아니라 일반 사용자 권한으로 실행되기 때문에 중요합니다.
Felo Search — 날짜와 소스가 있는 답변
dsh 세션은 lockfile만 알지, 벤더가 이번 주에 바꾼 내용을 모릅니다. Search는 날짜와 소스가 있는 결과를 반환하므로, 에이전트가 의존성 파일이 기억하는 것이 아니라 실제로 배포된 내용을 기반으로 행동합니다.
방금 업그레이드한 SDK의 breaking change를 검색하고, 이 모듈에 영향을 주는 항목을 나열하세요.
Felo YouTube Subtitling — 릴리즈 발표를 텍스트로
릴리즈 워크스루, 컨퍼런스 데모, 메인테이너 리뷰는 changelog가 아니라 영상에 남습니다. 자막은 세션이 파일을 편집할 때 인용할 수 있는 텍스트로 반환됩니다.
이 릴리즈 스트림에서 자막을 가져오고, 발표자가 변경했다고 언급한 모든 API를 나열하세요.
Felo X Search — 회귀가 가장 먼저 드러나는 곳
사람들은 이슈를 등록하기 전에 문제를 먼저 포스팅합니다. 게시글과 답글을 읽으면, 디버깅 세션에서 다른 사람이 같은 문제를 겪었는지 확인할 수 있습니다.
X에서 이 버전의 연결 처리에 대한 보고를 확인하고, 사람들이 겪는 문제를 요약하세요.
Felo Slides — 세션 결과를 터미널 밖으로
하네스가 조사를 담당합니다. 데크는 마크다운 원본을 읽지 않는 사람에게 결과를 전달하는 방법입니다. 슬라이드를 만들기 전에 개요가 텍스트로 도착하므로, 먼저 논지에 동의할 수 있습니다. 제목 여섯 개를 옮기는 데는 비용이 들지 않지만, 완성된 데크를 고치려면 재생성이 필요합니다.
업그레이드 체크리스트를 슬라이드 여섯 장으로 만들고, 각 슬라이드에 한 가지 위험 요소만 포함하세요.
Felo SuperAgent — 같은 세션에서 이미지 생성
사이드 프로젝트는 출시 전에 마크가 필요합니다. SuperAgent는 코드를 작성한 세션에서 바로 로고 방향과 제품 이미지 변형을 초안으로 만듭니다.
이 CLI용 로고 방향 세 가지를 디자인하고, 32px에서도 식별 가능한 버전을 내보내세요.
이 다섯 가지 외에도, 카탈로그에는 페이지를 구조화된 재사용 가능한 데이터로 변환하는 Felo Web Fetch, 자체 문서 기반 답변을 위한 Felo LiveDoc, 스크린샷, 소셜 글쓰기, 랜딩 페이지 번들이 포함되어 있습니다. 설치 방법은 동일합니다: 복사 명령 한 번이면 됩니다.
전체 카탈로그: felo.ai/skills/deepseek-harness
dsh 사용자가 Felo 스킬에 맡기는 세 가지 작업
dsh 사용자가 실제로 입력하는 방식 그대로 작성했습니다.
추측 없이 의존성 업그레이드
저장소가 구버전 SDK를 고정합니다. 하네스는 lockfile을 읽을 수 있지만, 벤더의 마이그레이션 가이드는 읽지 못합니다. 둘은 안전하게 바꿀 수 있는 항목에 대해 다르게 안내합니다.
벤더 마이그레이션 가이드를 가져오고, 새 주요 버전에서 알려진 이슈를 검색한 뒤, 이 저장소의 업그레이드 체크리스트를 작성하세요.
결과로 파일별 수정 대상, 변경된 설정 키, 각 주장에 대한 소스가 포함된 체크리스트가 반환됩니다. 요약이 아니라 논지를 검토할 수 있습니다.
외부 세계와 비교하며 PR 리뷰
리뷰 세션은 diff만 보유합니다. diff를 위험하게 만드는 권고문이나 회귀를 설명하는 업스트림 논의는 포함하지 않습니다.
이 의존성 버전이 공개 CVE가 있는지 확인하고, 증거와 함께 코멘트하세요.
코멘트에는 권고문과 릴리즈 노트가 포함됩니다. "위험해 보인다"는 리뷰가 아닙니다. 날짜가 있는 소스가 리뷰의 근거입니다.
리서치 결과를 데크로 변환
세션에서 벤더나 접근법을 비교했습니다. 이제 결정 내용을 터미널에 없던 사람에게 전달해야 합니다.
비교 결과를 슬라이드 여섯 장으로 요약하세요: 옵션, 비용, 위험, 추천.
데크는 이미 세션에 있는 소스를 기반으로 생성됩니다. 슬라이드의 모든 숫자는 출처로 추적할 수 있습니다. Felo Slides와 같은 개요 우선 흐름입니다. 슬라이드가 만들어지기 전에 논지가 승인됩니다.
가드레일
dsh는 스킬을 샌드박스하지 않습니다. 에이전트는 일반 사용자 권한으로 실행되고, 번들은 로드되는 순간 모든 권한을 상속합니다. 각 스킬을 마운트하는 코드로 취급하세요: SKILL.md와 참조된 스크립트를 반드시 읽으세요. Felo 번들은 감사를 짧게 만듭니다. 절차를 읽으면 충분합니다. 컴파일된 결과물을 추적할 필요가 없습니다.
비밀은 프로젝트 레이어에 두지 마세요. felo config set은 키를 저장소 외부의 ~/.felo/config.json에 기록합니다. 저장소 로컬 스킬 폴더에 키를 붙여넣으면, 코드와 함께 커밋될 수 있습니다.
테스트한 리비전을 고정하세요. dsh는 MIT 라이선스이며 개발자 프리뷰 상태입니다. breaking change가 발생할 수 있습니다. 복사한 스킬 저장소의 커밋을 기록하세요. 다음 달 실패가 발생해도, 신뢰할 수 있는 시작점을 확보할 수 있습니다.
글로벌 적용 전에 프로젝트 단위로 적용하세요. <projectRoot>/.dsh/skills에서 시작하면 한 저장소만 스킬을 시험할 수 있습니다. 읽고 동작을 확인한 뒤에만 ~/.agents/skills로 승격하세요.
인용을 남기세요. 항상 출력에 날짜가 있는 소스를 요청하세요. 10초 만에 검증할 수 있는 주장이, 길지만 신뢰만 해야 하는 답변보다 더 가치 있습니다.
FAQ
dsh는 Claude 스타일 스킬을 지원하나요?
지원합니다. 하네스는 <projectRoot>/.dsh/skills, <dshHome>/skills 등 로컬 루트에서 SKILL.md 번들을 읽는 스킬 기능군을 제공합니다. Felo 스킬 폴더는 이 구조를 따르므로, 플러그인 빌드 없이 바로 로드됩니다.
Felo 스킬을 사용하려면 DeepSeek Harness 플러그인을 작성해야 하나요?
필요하지 않습니다. 스킬은 에이전트가 필요할 때 불러오는 지침입니다. 플러그인은 도구와 서비스를 추가합니다. 탐색 루트에 폴더를 복사하면 스킬 경로가 완성됩니다.
복사한 스킬이 나타나지 않는 이유는 무엇인가요?
대부분의 경우 두 가지 원인입니다: 중첩 폴더(탐색은 루트의 직속 자식만 읽음), kebab-case가 아닌 이름. 단일 파일 스킬을 원하면 <name>.md도 동작합니다.
웹 UI에서 이 스킬을 사용할 수 있나요?
사용할 수 있습니다. 웹 UI와 터미널 세션은 같은 스킬 레지스트리를 공유합니다. 프로젝트에 설치된 번들은 둘 다에서 나타납니다. npx @deepseek-ai/dsh web을 실행하고 127.0.0.1:3080을 열면 됩니다.
업무용 컴퓨터에서 실행해도 안전한가요?
dsh는 사용자 권한으로 실행되고, 스킬을 샌드박스하지 않습니다. 평가용으로는 프로젝트 레이어를 사용하고, 각 SKILL.md를 읽은 뒤에만 검토된 번들을 ~/.agents/skills로 승격하세요.
프로젝트 루트에 번들 하나를 복사하고, 저장소가 답할 수 없는 질문을 던지고, 반환된 소스를 읽으세요. 답변이 신뢰할 만하다면 폴더를 ~/.agents/skills로 옮기세요. 그럼 다음 세션부터는 명령 한 번으로 추가한 기능이 바로 시작됩니다.
DeepSeek Harness용 Felo 스킬 둘러보기 →
이 글은 다음 언어로도 읽을 수 있습니다: English, 简体中文, 日本語, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা, Português.