crystian/skill-map

skill-map은(는) 무엇을 하나요?

AI 에이전트 마크다운 생태계(스킬, 에이전트, 명령, 훅)를 그래프로 매핑, 검사 및 감사합니다.

개요

이 스킬은 주어진 디렉토리에서 마크다운 파일을 재귀적으로 스캔하여 AI 에이전트 구성 요소(스킬, 에이전트, 명령, 훅)를 식별하고, 이들 간의 참조 관계를 추적합니다. 결과는 그래프 데이터 구조로 출력되어 직관적인 분석과 시각화를 지원합니다.

주요 기능

• 매핑: 모든 에이전트 관련 마크다운 파일을 찾아 색인 생성
• 검사: 각 구성 요소의 메타데이터, 명령, 훅, 의존성을 상세 분석
• 감사: 누락된 파일, 중복 정의, 순환 참조, 끊어진 링크 감지
• 시각화: 관계 그래프를 DOT, JSON, 또는 Mermaid 형식으로 출력

사용법

# 기본 사용법: 현재 디렉토리에서 모든 스킬 매핑
skill-map --scan .

# 특정 디렉토리 대상
skill-map --scan /path/to/skills --output graph.json

# 감사 모드 (문제점 보고)
skill-map --scan . --audit

# 형식 지정 출력
skill-map --scan . --format dot | dot -Tpng -o graph.png

옵션

옵션	설명	기본값
--scan <경로>	스캔할 디렉토리 경로	.
--output <파일>	출력 파일 경로	stdout
--format <형식>	출력 형식 (json, dot, mermaid)	json
--audit	감사 모드 활성화	false
--recursive	하위 디렉토리 재귀 스캔	true
--ignore <패턴>	제외할 파일/디렉토리 패턴	.git,node_modules

구성 파일 형식

스킬은 마크다운 파일로 정의되며, YAML frontmatter를 포함해야 합니다:

---
name: example-skill
description: 예제 스킬
version: 1.0.0
commands:
  - name: hello
    description: 인사 출력
    command: echo 'Hello'
hooks:
  - event: on_start
    command: echo '시작'
dependencies:
  - skill: other-skill
---

출력 예시 (JSON)

{
  "nodes": [
    {
      "id": "example-skill",
      "type": "skill",
      "metadata": {
        "description": "예제 스킬",
        "version": "1.0.0"
      }
    }
  ],
  "edges": [
    {
      "source": "example-skill",
      "target": "other-skill",
      "type": "dependency"
    }
  ],
  "audit": {
    "warnings": [],
    "errors": [],
    "stats": {
      "total_skills": 1,
      "total_agents": 0,
      "total_commands": 1,
      "total_hooks": 1
    }
  }
}

요구 사항

• Node.js 18+ (또는 Python 3.9+)
• 읽기 권한이 있는 파일 시스템 접근
• 선택 사항: Graphviz (dot 명령어) (DOT 형식 시각화 시)

라이선스

MIT

---

이 스킬은 AI 에이전트 생태계를 더 잘 이해하고 유지보수하는 데 도움을 주기 위해 설계되었습니다.