mxyhi/ok-skills: 큐레이션된 AI 코딩 에이전트 기술 및 CLAUDE.md

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Español | Tiếng Việt | Русский | हिन्दी

큐레이션된 AI 코딩 에이전트 기술(skills) 및 CLAUDE.md

/ AGENTS.md 플레이북은 Codex, Claude Code, Cursor, OpenClaw, Trae 및 기타 SKILL.md 호환 도구들을 위한 것입니다.

이 저장소는 현재 **40개의 재사용 가능한 기술(skills)**을 포함하고 있습니다: 이 저장소에서 직접 관리되는 **32개의 최상위 기술(top-level skills)**과 gsap-skills/ 아래에 포함된 **8개의 GSAP 애니메이션 기술(vendored GSAP animation skills)**로 구성됩니다. 이를 ~/.agents/skills/ok-skills로 클론(Clone)하세요; 내부 디렉토리들은 이미 AGENTS.md 기반 워크플로우(workflows)에서 기대하는 레이아웃과 일치하며, CLAUDE_AGENTS.md는 Claude Code 지향적인 에이전트 플레이북(agent playbook)을 제공합니다.

만약 Codex 기술(skills), Claude Code 기술(skills), Cursor 기술(skills), OpenClaw 기술(skills), 재사용 가능한 CLAUDE.md / AGENTS.md 플레이북(playbooks), 또는 실용적인 SKILL.md 예시를 찾고 있다면, 이 저장소는 검색 가능하면서도 즉시 사용 가능하도록 설계되었습니다.

인기 있는 사용 사례: 문서 조회(docs lookup), 브라우저 자동화(browser automation), GitHub Actions 디버깅(debugging), 프롬프트 엔지니어링(prompt engineering), 계획 워크플로우(planning workflows), 프론트엔드 디자인(frontend design), PDF/Word/PPTX/XLSX 작성(authoring).

• Codex, Claude Code, Cursor, OpenClaw, Trae 또는 다른 AI 코딩 에이전트를 사용하며, 임시 프롬프트(ad-hoc prompts) 대신 재사용 가능한 기술(skills)을 원하는 경우.
• CLAUDE.md / AGENTS.md / SKILL.md 워크플로우(workflows)를 유지 관리하며, 여러 프로젝트에 걸쳐 작동하는 휴대 가능한 지침(portable instructions)을 원하는 경우.
• 문서 조회, 브라우저 자동화, GitHub 워크플로우, 계획, 프롬프트 엔지니어링, 프론트엔드 디자인, PDF, Office 문서, 슬라이드 덱, 스프레드시트를 위한 검증된 기술(battle-tested skills)이 필요한 경우.

먼저 몇 가지 기술(skills)만 설치해보고 싶다면, 다음 항목부터 시작하세요:

• planning-with-files: 복잡한 작업, 연구 및 장기 실행 작업을 위한 파일 기반 계획(file-based planning).
• find-docs: 최신 라이브러리 문서, API 참조 및 Context7 기반 예시를 가져옵니다.
• agent-browser: 스크린샷, 양식, 스크래핑 및 웹 QA를 위한 브라우저 자동화(browser automation).
• gh-fix-ci: 실패하는 GitHub Actions 체크를 조사하고 로그를 수정 계획(fix plan)으로 변환합니다.

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

클론(cloning)한 후, 저장소는 ~/.agents/skills/ok-skills에 위치하며, 내부 디렉토리들은 이미 예상되는 레이아웃을 따르고 있습니다:

~/.agents/skills/ok-skills/
CLAUDE_AGENTS.md
planning-with-files/
...

Claude Code 또는 Codex의 전역 지침(global instructions)을 위해, CLAUDE_AGENTS.md에서 시작하여 이를 Claude Code의 CLAUDE.md 또는 Codex의 AGENTS.md로 복사하거나 병합(merge)하세요.

이 파일은 중국어 우선(Chinese-first), KISS(Keep It Simple, Stupid) 지향 워크플로우와 함께 최신 문서/소스 체크, 멀티 에이전트 선호도, caveman / planning-with-files / karpathy-guidelines 기본값, 엄격한 TypeScript 기대치, 그리고 컨텍스트 모드 라우팅 규칙(context-mode routing rules)을 패키징하고 있습니다. 재사용하기 전에, 귀하의 프로젝트에 맞춰 语言要求(언어 요구사항) 섹션을 편집하십시오. 其他注意项(기타 주의사항) 섹션은 의도적으로 프로젝트 로컬(project-local)로 설정되어 있으므로 필요에 따라 편집할 수 있습니다.

귀하의 AGENTS.md에 간단한 트리거 규칙(trigger rules)을 추가하거나, 동일한 스킬 트리거를 CLAUDE.md / AGENTS.md에 병합하세요:

## Skills
- planning-with-files: 복잡한 작업, 조사, 또는 5회 이상의 도구 호출(tool calls)이 필요한 경우에 사용합니다.
- find-docs: 최신 라이브러리 문서, API 참조, 또는 Context7 기반의 예시가 필요할 때 사용합니다.
...

그 다음 자연스럽게 요청하세요:

Use planning-with-files before refactoring this module. (이 모듈을 리팩토링하기 전에 planning-with-files를 사용해줘.)

Use find-docs to fetch the latest docs for this SDK. (이 SDK의 최신 문서를 가져오기 위해 find-docs를 사용해줘.)

Use agent-browser to reproduce this UI bug. (이 UI 버그를 재현하기 위해 agent-browser를 사용해줘.)

• find-docs: 최신 문서 조회를 위한 Context7 CLI 워크플로우에 집중합니다.

• exa-search: Exa 검색 도구를 사용한 웹, 코드 및 기업 조사.

• get-api-docs: 코딩 전 최신 제3자 API 및 SDK 문서를 가져옵니다.

• find-skills: 사용자가 특정 기능을 요청할 때 기존 스킬을 발견합니다.

• planning-with-files: task_plan.md, findings.md, progress.md를 사용한 지속적인 마크다운(markdown) 계획 수립.

• autoresearch: 명시적인 목표(goals), 지표(metrics), 검증 루프(verify loops), 그리고 유지/폐기 게이트(keep/discard gates)를 갖춘 자율적인 목표 지향적 반복(autonomous goal-directed iteration).

• diagnose: 까다로운 버그와 성능 회귀(performance regressions)를 해결하기 위한 규율 있는 진단 루프(diagnosis loop).

• grill-me: 한 번에 하나의 질문을 던지는 집중 인터뷰를 통해 계획이나 설계를 스트레스 테스트(stress-test)함.

• grill-with-docs: 도메인 언어(domain language), CONTEXT.md, 그리고 ADR(Architecture Decision Records)을 기준으로 계획을 검증하는 동시에 문서를 인라인(inline)으로 업데이트함.

• improve-codebase-architecture: 국소성(locality), 레버리지(leverage), 테스트 가능성(testability), 그리고 AI 탐색(AI navigation)을 개선할 수 있는 심화 기회를 탐색함.

• karpathy-guidelines: 과도한 복잡성, 숨겨진 가정, 그리고 검증 불가능한 변경을 줄이는 행동 코딩 가이드라인(behavioral coding guidelines).

• migrate-to-shoehorn: 테스트 as 단언(assertions)을 @total-typescript/shoehorn으로 마이그레이션함.

• tdd: 기능, 버그 수정, 리팩토링(refactors), 그리고 동작 변경을 위한 테스트 우선(test-first) 레드-그린-리팩터(red-green-refactor) 방식.

• systematic-debugging: 수정 사항을 제안하기 전에 근본 원인(root causes)을 체계적으로 조사함.

• gh-address-comments: gh를 사용하여 현재 PR(Pull Request)의 리뷰 및 이슈 댓글을 처리함.

• gh-fix-ci: 실패하는 GitHub Actions 체크를 검사하고, 로그를 요약하며, 수정 계획을 수립함.

• agent-browser: 탐색, 양식(forms), 스크린샷, 스크래핑(scraping)을 위한 브라우저 자동화.

• kimi-webbridge: 로컬 데몬(local daemon)을 통해 사용자의 실제 브라우저를 제어하여 탐색, 양식, 스크린샷, 페이지 읽기 및 인증된 세션(authenticated sessions)을 수행함.

• browser-trace: 스크린샷, DOM 덤프(DOM dumps), 페이지별 버킷(per-page buckets)을 포함한 브라우저 자동화 실행을 위한 CDP(Chrome DevTools Protocol) 트레이스 캡처.

• opencli: 브라우저 세션 재사용, 공개 API 접근, AI 생성 어댑터(adapters)를 통해 웹사이트를 CLI 명령어로 변환함.

• dogfood: 재현 가능한 증거를 갖춘 구조화된 탐색적 테스트(exploratory testing).

• electron: Chrome DevTools Protocol을 통해 Electron 데스크톱 앱을 자동화함.

dogfood/와 electron/은 여전히 vercel-labs/agent-browser에서 벤더링(vendored)된 것이지만, 업스트림(upstream)에서 커밋 7c2ff0a2a624e86cec0bcc9cc0835aeff6a2edf0을 통해 이들을 skills/에서 skill-data/로 이동시켰으므로, 설치 프로그램 탐색(installer discovery)은 부트스트랩(bootstrap) agent-browser만 노출합니다.

기술 (skill)입니다. 이 저장소는 해당 전문 기술들이 여전히 업스트림 (upstream)에서 유지 관리되고 있으며 직접적으로 사용 가능한 상태이기 때문에, 이를 최상위 디렉토리 (top-level directories)로 유지합니다.

• ai-elements: ai-elements 라이브러리를 위한 AI 채팅 UI 컴포넌트 구축.
• frontend-skill: 시각적으로 강력한 랜딩 페이지, 웹사이트, 앱, 프로토타입 (prototype), 데모 (demo) 또는 게임 UI가 필요할 때 사용.
• shader-dev: ShaderToy 호환 실시간 시각 효과를 위한 포괄적인 GLSL 셰이더 (shader) 기술.
• better-icons: CLI 또는 MCP를 통해 200개 이상의 Iconify 라이브러리에서 SVG 아이콘을 검색, 탐색 및 검색.
• gsap-skills/: 8가지 공식 GSAP 애니메이션 기술: core, timelines, ScrollTrigger, plugins, utils, React, performance, frameworks.
• minimax-docx: OpenXML SDK (.NET)를 사용한 전문적인 DOCX 생성, 편집 및 서식 지정.
• minimax-pdf: 토큰 기반 디자인 시스템을 사용하여 PDF 생성, 채우기 및 재구성.
• pptx-generator: PptxGenJS, XML 워크플로 (workflows) 또는 markitdown을 사용하여 PowerPoint 프레젠테이션 생성, 편집 및 읽기.
• minimax-xlsx: 손실이 적은 XML 워크플로를 사용하여 Excel 또는 스프레드시트 파일을 열기, 생성, 읽기, 분석, 편집 및 검증.

gsap-skills/는 커밋 aed9cfd3277740755f6bfc1155c7aa645403b760 시점의 greensock/gsap-skills에서 벤더링 (vendored)된 애니메이션 중심 번들 (bundle)을 포함합니다.

다음 항목들이 포함됩니다:

gsap-core
gsap-timeline
gsap-scrolltrigger
gsap-plugins
gsap-utils
gsap-react
gsap-performance
gsap-frameworks

출처 표기 및 법적 파일은 gsap-skills/NOTICE.md 및 gsap-skills/LICENSE에 보존되어 있습니다.

planning-with-files/는 OthmanAdi/planning-with-files/.pi/skills/planning-with-files를 업스트림 베이스라인 (upstream baseline)으로 추적합니다. 이 저장소는 해당 업스트림 디렉토리를 로컬 기술의 정식 베이스라인 (canonical baseline)으로 유지합니다. 로컬 차이점은 공개 기술 이름인 planning-with-files를 유지하고, skills-ref 호환성을 위해 SKILL.md 프론트매터 (frontmatter)를 정규화하는 것에 국한됩니다.

• 일부 기술은 gh를 가정합니다.

• 일부 기술은 gh가 설치되어 있고 인증되어 있다고 가정합니다. 브라우저 중심의 기술은 Chrome/CDP(Chrome DevTools Protocol)가 가능한 환경이 필요할 수 있습니다.

• 제3자 문서 조회 (doc lookup) 기술은 외부 CLI 또는 MCP (Model Context Protocol) 도구에 의존할 수 있으므로, 자세한 내용은 각 SKILL.md를 확인하십시오.

Source URL은 기술이 벤더링(vendored)되거나 임포트(imported)된 경우 정식 업스트림 (upstream)을 가리키며, 그렇지 않은 경우 이 저장소 내의 기술 디렉토리를 가리킵니다.

기술 (Skill)	설명 (Description)	소스 URL (Source URL)
agent-browser	AI 에이전트를 위한 브라우저 자동화 CLI: 탐색, 양식 채우기, 스크린샷, 추출 및 웹 테스트.	vercel-labs/agent-browser
...	openai/skills
gh-fix-ci	실패한 GitHub Actions 체크를 검사하고, 로그를 가져오며, 수정 계획을 세웁니다.	openai/skills
grill-me	상호 이해가 도달할 때까지 계획이나 설계에 대해 사용자에게 끊임없이 질문(interview)합니다.	mattpocock/skills
grill-with-docs	도메인 언어, CONTEXT.md, 그리고 ADR (Architecture Decision Records)을 바탕으로 계획을 스트레스 테스트하고, 문서 내에서 인라인으로 업데이트합니다.	mattpocock/skills
improve-codebase-architecture	국소성 (locality), 활용성 (leverage), 테스트 가능성 (testability) 및 AI 탐색을 개선할 수 있는 심화 기회를 찾습니다.	mattpocock/skills
karpathy-guidelines	과도한 복잡성, 숨겨진 가정, 검증 불가능한 변경을 줄이는 행동 코딩 가이드라인.	forrestchang/andrej-karpathy-skills
migrate-to-shoehorn	테스트 파일을 as 타입 단언 (type assertions)에서 @total-typescript/shoehorn으로 마이그레이션합니다.	mattpocock/skills
opensrc	AI 에이전트에게 더 깊은 구현 컨텍스트를 제공하기 위해 의존성 소스 코드를 가져옵니다.	vercel-labs/opensrc
opencli	브라우저 세션 재사용, 공개 API 액세스 및 AI 생성 어댑터를 통해 웹사이트를 CLI 명령어로 변환합니다.	jackwener/opencli
dogfood	웹 앱을 체계적으로 테스트하고 스크린샷 및 비디오가 포함된 재현 가능한 이슈 보고서를 생성합니다.	vercel-labs/agent-browser
...	OthmanAdi/planning-with-files
pptx-generator	PptxGenJS, XML 워크플로 또는 markitdown을 사용하여 PowerPoint 프레젠테이션을 생성, 편집 및 읽습니다.

| MiniMax-AI/skills |
| tdd | 기능 추가, 버그 수정, 리팩토링(refactor) 또는 동작 변경 전 사용; 공개 인터페이스 통합 테스트(public-interface integration tests)를 선호함. | mattpocock/skills |
| systematic-debugging | 버그, 테스트 실패 또는 예기치 않은 동작을 마주했을 때, 수정안을 제안하기 전에 사용. | obra/superpowers |
| minimax-xlsx | 손실이 적은 XML 워크플로를 사용하여 Excel 또는 스프레드시트 파일을 열기, 생성, 읽기, 분석, 편집 및 검증함. | MiniMax-AI/skills |

참고 사항:

dogfood 및 electron은 상위(upstream) skills/가 아닌 상위 skill-data/에서 가져온 것입니다.

• 상위 저장소에서 커밋 7c2ff0a2a624e86cec0bcc9cc0835aeff6a2edf0를 통해 이러한 특화된 기술(skills)들을 이동시켰기 때문에, 설치 프로그램(installer) 검색 시 부트스트랩(bootstrap) agent-browser 기술만 발견됩니다. - 이 저장소는 이 기술들이 여전히 상위에서 유지 관리되고 있으며 직접적으로 유용하기 때문에, 의도적으로 최상위 벤더 기술(vendored skills)로 유지합니다.

기술 (Skill)	설명	소스 URL
gsap-core	핵심 API: gsap.to()/from()/fromTo(), easing, duration, stagger, defaults, matchMedia.	greensock/gsap-skills
...

새로운 기술 추가나 기존 기술의 개선을 위한 기여(Contributions)를 환영합니다.

• 트리거 조건(trigger conditions)을 명시적이고 테스트 가능하게 유지하세요.
• 예시는 간결하고 실행 중심적으로 유지하세요.
• 기술이 외부 도구에 의존하는 경우, SKILL.md에 해당 의존성을 문서화하세요.
• 기술을 추가하거나 이름을 변경할 때는 README.md 및 README.zh-CN.md를 업데이트하고, 공개용 기술 인덱스가 변경되면 다른 번역된 README들도 갱신하세요.

이 저장소는 LICENSE에 따라 라이선스가 부여됩니다.

일부 기술에는 caveman/, diagnose/, grill-me/, grill-with-docs/, improve-codebase-architecture/, migrate-to-shoehorn/, minimax-docx/, 그리고 gsap-skills/를 포함하여, 기술별 자산 및 출처 표기를 위한 추가 라이선스 파일이나 고지 사항이 포함되어 있습니다.