OK Skills – Codex, Claude Code, Cursor, OpenClaw 등에서 재사용 가능한 AI 에이전트 '스킬'

설명 – ~/.agents/skills/ok-skills 폴더(또는 이에 상응하는 Autohand Code 위치)에 넣을 수 있는 31개의 스킬 디렉터리 모음입니다. 각 스킬은 AI 코딩 어시스턴트가 호출할 수 있는 자체 포함 지침(SKILL.md)과 도우미 스크립트로 구성됩니다. 또한 리포지토리에는 도구의 CLAUDE.md / AGENTS.md 파일에 병합할 수 있는 CLAUDE_AGENTS.md 플레이북이 포함되어 있어 에이전트에 즉시 사용 가능한 기능 메뉴를 제공합니다.

대상 – 이미 AI 코딩 에이전트(Codex, Claude Code, Cursor, OpenClaw, Autohand Code, Trae 등)를 사용하고 있으며, 매번 임시 프롬프트를 작성하는 대신 검증된 플러그 앤 플레이 액션 라이브러리를 원하는 개발자. 또한 공유 AGENTS.md 워크플로를 유지하고 이식 가능하고 버전 관리되는 스킬 정의가 필요한 팀에게도 유용합니다.

시작하기

mkdir -p ~/.agents/skills
cd ~/.agents/skills
git clone https://github.com/mxyhi/ok-skills.git ok-skills

또는 Autohand Code 스킬 폴더(~/.autohand/skills 또는 .autohand/skills)에 클론합니다. 클론 후 디렉터리 구조는 에이전트가 기대하는 것과 이미 일치합니다:

~/.agents/skills/ok-skills/
  CLAUDE_AGENTS.md
  planning-with-files/SKILL.md
  find-docs/SKILL.md
  agent-browser/SKILL.md
  …

AGENTS.md(또는 CLAUDE.md)의 Skills 섹션에 스킬 이름을 추가합니다. 예:

## Skills
- planning-with-files: 복잡한 다단계 작업에 사용
- find-docs: 최신 라이브러리 문서 가져오기
- agent-browser: 브라우저 자동화, 스크린샷, 페이지 스크래핑

그런 다음 에이전트에게 간단히 요청할 수 있습니다:

"이 모듈을 리팩토링하기 전에 planning-with-files를 사용하세요." "find-docs를 사용하여 최신 SDK 문서를 가져오세요." "agent-browser를 사용하여 이 UI 버그를 재현하세요."

내용 – 스킬은 일반적인 사용 사례별로 그룹화되어 있습니다:

• 연구 및 문서 – find-docs, exa-search, get-api-docs, ax.
• 계획 및 프롬프팅 – planning-with-files, autoresearch, diagnosing-bugs, karpathy-guidelines, tdd.
• 자동화 및 QA – agent-browser, kimi-webbridge, browser-trace, opencli.
• 프론트엔드 및 디자인 – ai-elements, huashu-design, imagegen-frontend-web, gpt-taste, better-icons, diagram-design.
• 유틸리티 및 제작 – 아이콘 조회, 다이어그램 생성 등 다양한 헬퍼.

각 스킬의 SKILL.md에는 다음이 포함됩니다:

• 간단한 설명 및 호출 시점.
• 필요한 외부 도구(예: gh 인증, 브라우저 작업용 Chrome/Playwright, pip install playwright).
• 전역 에이전트 구성에 복사할 수 있는 트리거 규칙.

중요성 – AI 코딩 에이전트는 호출할 수 있는 도구만큼 유용합니다. 표준화되고 버전 관리되는 스킬 세트를 제공함으로써 ok-skills는 팀이 매번 프롬프트를 재발명하지 않고도 모범 사례 워크플로(예: "plan-with-files → fetch docs → run browser automation")를 공유할 수 있게 합니다. 또한 리포지토리는 각 스킬의 업스트림 소스를 추적하므로 원본 프로젝트에서 업데이트를 가져오면서 로컬 레이아웃을 안정적으로 유지할 수 있습니다.

전제 조건 – 대부분의 스킬은 다음을 가정합니다:

• 대상 AI 코딩 에이전트가 설치되어 있음(Codex, Claude Code 등).
• 최신 git 및 많은 브라우저 관련 스킬의 경우 Chrome DevTools Protocol(CDP)을 사용할 수 있는 Chrome/Chromium 환경.
• 개별 SKILL.md 파일에 명시된 선택적 CLI(gh, exa, Context7 등).

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다. 추가 기능은 추론되지 않았습니다.