Dual-Forge/skills_overview

skills_overview은(는) 무엇을 하나요?

~/.agents/skills 폴더를 검색 가능한 HTML 지도로 변환합니다. sync 명령어가 각 SKILL.md (YAML 머리말)을 파싱하여 필터, 다크/라이트 테마, 벤토 레이아웃, 복사 가능한 경로를 갖춘 정적 페이지를 생성합니다. 개발 서버 없이 skills-overview.html을 바로 열 수 있습니다.

작동 방식

1. ~/.agents/skills/ 아래 모든 SKILL.md 파일을 재귀적으로 찾습니다.
2. 각 파일의 YAML 머리말을 읽어 name, description, category 등의 메타데이터를 추출합니다.
3. 추출한 정보를 바탕으로 단일 skills-overview.html 파일을 생성합니다.
4. 생성된 HTML은 완전히 독립적이며, 정적 파일이므로 어떤 브라우저에서도 바로 열 수 있습니다.

기능

• 검색: 스킬 이름과 설명을 실시간으로 검색할 수 있습니다.
• 카테고리 필터: 왼쪽 사이드바에서 카테고리별로 스킬을 필터링할 수 있습니다.
• 테마 전환: 다크/라이트 테마를 자유롭게 전환할 수 있습니다.
• 경로 복사: 각 스킬 카드의 경로를 클릭하면 클립보드에 복사됩니다.
• 벤토 레이아웃: 스킬 카드가 다양한 크기의 그리드로 배열되어 시각적으로 정리됩니다.

사용 방법

# 스킬 개요 HTML 생성
dual-forge sync

# 또는 직접 스크립트 실행
python3 ~/.agents/skills/Dual-Forge/skills_overview/skills_overview.py

생성된 skills-overview.html 파일을 브라우저로 열면 됩니다.

요구 사항

• Python 3.6 이상
• ~/.agents/skills/ 디렉토리와 그 안의 SKILL.md 파일들

출력 예시

생성된 HTML 페이지는 다음과 같은 구조를 가집니다:

• 상단: 페이지 제목 및 검색 입력창
• 왼쪽 사이드바: 카테고리 목록 (전체, 각 카테고리별 스킬 수 표시)
• 메인 영역: 벤토 스타일의 스킬 카드 그리드
  • 각 카드: 스킬 이름, 설명, 경로, 카테고리 태그
  • 경로 클릭 시 자동 복사

참고

이 도구는 개발 서버를 실행하지 않으며, 정적 HTML 파일만 생성합니다. 생성된 파일은 어디든 이동하여 사용할 수 있습니다.