Repolode
제출하기
scaccogatto

scaccogatto/okf-skills

OKF(Open Knowledge Format) 마크다운 지식 번들을 작성·검증·시각화·관리할 수 있는 Claude Code 툴킷입니다.

GitHub에서 보기웹사이트
스타
438
포크
42
열린 이슈
7
마지막 커밋
그저께

어떤 프로젝트인가요?

OKF는 YAML frontmatter가 포함된 마크다운 파일 디렉터리 형태로 시스템 지식을 저장하는 개방형 벤더 중립 포맷입니다. 이 프로젝트를 사용하면 Claude Code의 일반적인 작업 흐름에서 OKF 번들을 생성하고, 관리하고, 활용하고, 검증하고, 시각화할 수 있습니다. 사양 준수 여부를 결정적으로 검사하는 도구, 번들을 인터랙티브 그래프로 렌더링하는 viz 스크립트, git 기록과 세션 트랜스크립트에서 번들을 재구성하는 백필 스킬이 포함되어 있습니다.

이 툴킷은 여러 채널로 제공됩니다. Claude Code 플러그인, skills.sh로 설치할 수 있는 에이전트 스킬, 에이전트 없이 CI에서 번들을 검증하는 GitHub Action, 검색·읽기·이웃 조회 도구를 제공하는 읽기 전용 MCP 서버가 있습니다. 포맷 버전 0.2에는 출처, 신뢰도, 최신성 필드가 추가되었으며, 도구는 이 필드를 읽고 v0.1에서 마이그레이션할 수 있습니다.

저장소는 MIT 라이선스를 따르며, 벤더링된 OKF v0.2 사양, 라이브 데모에서 볼 수 있는 샘플 번들, 프로토콜과 결과가 포함된 벤치마크 실험을 제공합니다.

핵심 기능

  • 01벤더링된 사양과 템플릿을 바탕으로 OKF 지식 번들을 생성하고 관리합니다.
  • 02엄격 모드와 경고 임계값 모드, JSON 출력을 지원해 사양에 따라 번들을 검증합니다.
  • 03신뢰도 및 최신성 배지가 포함된 독립형 인터랙티브 HTML 그래프로 번들을 렌더링합니다.
  • 04git 기록과 Claude 세션 트랜스크립트에서 번들을 백필합니다.
  • 05검색, 읽기, 이웃 조회 도구를 제공하는 읽기 전용 MCP 서버를 제공합니다.
  • 06CI에서 번들을 검증하는 GitHub Action이 포함되어 있습니다.

활용 사례

  • 코드와 함께 버전 관리되는 마크다운으로 서비스의 아키텍처와 의사결정을 문서화합니다.
  • 코딩 에이전트가 읽고 인용할 수 있는 구조화된 프로젝트 맥락을 제공합니다.
  • 병합 전에 CI에서 지식 번들을 자동으로 검증합니다.
  • 기존 번들이 없는 저장소의 프로젝트 문서를 재구성합니다.

빠른 시작

  1. 1

    Claude Code에 마켓플레이스를 추가합니다

    /plugin marketplace add scaccogatto/okf-skills
  2. 2

    okf 플러그인을 설치합니다

    /plugin install okf@scaccogatto
  3. 3

    Claude에게 bundle 생성을 요청해 OKF에서 프로젝트를 문서화합니다

    /okf:okf produce .okf
  4. 4

    커밋하기 전에 bundle을 검증합니다

    /okf:validate .okf --strict

사용 전 알아둘 점

  • 전체 툴체인은 Claude Code용으로 만들어졌습니다. 다른 에이전트에서는 skills만 사용할 수 있으며 backfill subagents는 제공되지 않습니다.
  • 스크립트를 실행하려면 uv 또는 pyyaml이 설치된 python3가 필요합니다.
  • 프로젝트가 아직 1.0 이전 버전이므로 @v1 액션 태그는 릴리스마다 바뀔 수 있습니다.

포함된 컬렉션

Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱MCP 서버AI 에이전트 스킬 라이브러리정적 사이트 생성기 및 문서 도구

토픽

#claude-code#knowledge-management#markdown#yaml#agent-skills#llm-tools#mcp#knowledge-graph#ai-agents#claude-code-plugin

자주 묻는 질문

okf-skills은(는) 무엇인가요?
OKF(Open Knowledge Format) 마크다운 지식 번들을 작성·검증·시각화·관리할 수 있는 Claude Code 툴킷입니다. OKF는 YAML frontmatter가 포함된 마크다운 파일 디렉터리 형태로 시스템 지식을 저장하는 개방형 벤더 중립 포맷입니다. 이 프로젝트를 사용하면 Claude Code의 일반적인 작업 흐름에서 OKF 번들을 생성하고, 관리하고, 활용하고, 검증하고, 시각화할 수 있습니다. 사양 준수 여부를 결정적으로 검사하는 도구, 번들을 인터랙티브 그래프로 렌더링하는 viz 스크립트, git 기록과 세션 트랜스크립트에서 번들을 재구성하는 백필 스킬이 포함되어 있습니다.
okf-skills은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
okf-skills은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
okf-skills은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. okf-skills의 마지막 커밋은 2026년 11월 4일입니다.
okf-skills은(는) 어디에 사용할 수 있나요?
코드와 함께 버전 관리되는 마크다운으로 서비스의 아키텍처와 의사결정을 문서화합니다. 코딩 에이전트가 읽고 인용할 수 있는 구조화된 프로젝트 맥락을 제공합니다. 병합 전에 CI에서 지식 번들을 자동으로 검증합니다. 기존 번들이 없는 저장소의 프로젝트 문서를 재구성합니다.
okf-skills는 어떻게 설치하나요?
Claude Code에 마켓플레이스를 추가합니다: /plugin marketplace add scaccogatto/okf-skills okf 플러그인을 설치합니다: /plugin install okf@scaccogatto Claude에게 bundle 생성을 요청해 OKF에서 프로젝트를 문서화합니다: /okf:okf produce .okf 커밋하기 전에 bundle을 검증합니다: /okf:validate .okf --strict
okf-skills은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/scaccogatto/okf-skills

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트