ONEDEV

ok-skills

mxyhi파일 788개

★ 494주당 +2조회 3

무엇인가

ok-skills는 AI 코딩 에이전트에 재사용 가능한 규칙과 절차를 파일로 주입하는 스킬 저장소다. 문서 조회, 브라우저 자동화, 프롬프트 엔지니어링, 계획 수립, 코드베이스 이해, 프런트엔드 디자인, PDF·Word·PPTX·XLSX 문서 생성 영역을 규율한다. 각 스킬은 저장소 최상위 디렉터리 하나와 그 안의 SKILL.md로 구성되며, 디렉터리 배치는 AGENTS.md 기반 워크플로가 기대하는 레이아웃과 일치한다.

어떻게 동작하나

동작은 자동 로드가 아니라 트리거 규칙 등록으로 이뤄진다. 저장소 루트의 CLAUDE_AGENTS.md가 Claude Code 지향 에이전트 플레이북을 제공하고, 사용자는 AGENTS.md나 CLAUDE.md에 어떤 상황에서 어떤 스킬을 쓸지 한 줄씩 적는다. 예를 들어 planning-with-files는 도구 호출이 5회 이상 필요한 복잡한 작업에, find-docs는 최신 라이브러리 문서나 API 레퍼런스가 필요할 때, agent-browser는 스크린샷·스크래핑·폼 입력·웹 QA에 발동한다. planning-with-files는 task_plan.md·findings.md·progress.md 세 파일로 계획과 진행을 지속시킨다.

무엇과 다른가

매번 프롬프트를 직접 작성하는 방식과 달리 규칙이 파일로 고정되어 프로젝트 간에 이식된다. 단일 CLAUDE.md 규칙 파일과도 다르다. 스킬별 디렉터리로 분리되어 있어 필요한 스킬만 트리거로 호출하고 나머지는 컨텍스트에 올리지 않는다. CLAUDE_AGENTS.md는 중국어 우선, KISS 지향 워크플로, 최신 문서·소스 확인, 멀티 에이전트 선호, planning-with-files와 karpathy-guidelines 기본값, 엄격한 TypeScript 기대, 컨텍스트 모드 라우팅 규칙을 한 묶음으로 담는다.

어떻게 쓰나

설치는 저장소를 스킬 디렉터리에 클론하는 것으로 끝난다. 사용자 레벨은 ~/.agents/skills/ok-skills, Autohand Code는 ~/.autohand/skills/ok-skills 또는 프로젝트 레벨 .autohand/skills/ok-skills에 둔다. 클론 후 CLAUDE_AGENTS.md를 Claude Code의 CLAUDE.md나 Codex의 AGENTS.md로 복사하거나 병합하고, 재사용 전에 语言要求 섹션을 프로젝트에 맞게 수정한다. 이후 "Use planning-with-files before refactoring this module."처럼 자연어로 호출한다.

전제와 한계

SKILL.md를 읽는 도구에서 동작한다. Codex, Claude Code, Cursor, OpenClaw, Autohand Code, Trae가 README에 명시된 대상이다. CLAUDE_AGENTS.md는 Claude Code 지향이며 중국어 우선으로 작성되어 있어 언어 요구 섹션을 고치지 않으면 그대로 쓰기 어렵다. 其他注意项 섹션은 프로젝트 로컬 전제를 담고 있어 필요에 따라 편집해야 한다. 저장소가 제공하지 않는 스킬이나 에이전트별 전용 훅은 포함되지 않는다.

유사 스킬