우리는 '텍스트로서의 프롬프트(prompt as text)'에서 **런타임 모듈로서의 스킬(skill as runtime module)**로 이동하고 있습니다. 각 스킬은 AI 작업을 위한 가볍고 컨테이너화된 애플리케이션처럼 작동합니다: 안정적인 인터페이스, 명확한 워크플로우, 그리고 설치, 버전 관리, 테스트 및 프로젝트 전반에 걸쳐 재사용할 수 있는 번들링된 리소스를 제공합니다.
이것은 Codex, Cursor, OpenClaw 및 에이전트 중심 도구링(agent-first tooling)을 위한 저의 개인 .skills 저장소입니다. .skills는 AI 실행에 적용된 dotfiles 사고방식입니다: 일회성 프롬프트 대신, 이 저장소는 다음을 번들로 묶은 재사용 가능한 스킬 유닛들을 저장합니다:
- 프롬프트 로직 (
SKILL.md, /AGENT.md, /AGENTS.md) - 참조 및 지식 자산
- 결정론적 실행을 위한 스크립트
- 반복 가능한 검증 + 게시 워크플로우
- 서브모듈을 통한 외부 스킬 지원
- git 관리 개인 레지스트리 및 github action 훅
각 설정을 해당 구성 요소를 설치하고 검증하는 곳에 보관하세요:
| 설정 | 소유자 |
|---|
| 재사용 가능한 스킬, 참조 및 번들된 도우미 | 이 저장소 |
| 개인 전역 에이전트 지침 | dotfiles .codex/AGENTS.md |
저장소별 AGENTS.md 지침 | 해당 저장소 |
| MCP 등록, 기계 로컬 설정 및 자격 증명 주입 | 플랫폼의 dotfiles/부트스트랩 설치 프로그램 |
make sync는 codex 및 cursor와 같은 에이전트 대상을 선택합니다. 이는 스킬과 지원되는 슬래시 명령어 프롬프트를 설치하지만, 저장소 지침이나 MCP 구성은 렌더링하지 않습니다. 기계의 MCP 설정을 조정하려면 플랫폼 설치 프로그램을 사용하고, 자격 증명은 스킬 패키지에서 제외하세요. 이렇게 하면 두 번째 설정 생성기가 해당 소유자들과 경쟁하는 것을 방지할 수 있습니다.
| 스킬 (Skill) | 기능 (What it does) | 설치 방법 (Install) |
|---|
codebase-memory-mcp | 보호된 CLI를 통해 표준 Git 체크아웃을 인덱싱하고 중복 작업 트리 캐시를 감사합니다. | npx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y |
agent-device-lab | 개별 iPhone 미러링 설정을 갖추고 물리적 Android 및 iPhone 테스트를 준비합니다. | npx skills add vincentkoc/dotskills --skill agent-device-lab -y |
codex-goal-mining | 로컬 또는 플릿(fleet) Codex 목표 기록을 증거 기반 재실행 스위트(evidence-backed rerun suites)로 채굴합니다. | npx skills add vincentkoc/dotskills --skill codex-goal-mining -y |
codex-session-recovery | 복원 증거를 덮어쓰지 않고 Codex 및 Claude tmux 세션을 복구합니다. | npx skills add vincentkoc/dotskills --skill codex-session-recovery -y |
crabpot-perf-metrics | 과도한 노이즈 판독 없이 Crabpot 및 OpenClaw 성능 아티팩트를 해석합니다. | npx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y |
crawlkit | 공유 크롤 앱 Go 라이브러리를 유지 관리하고 릴리스합니다. | npx skills add vincentkoc/dotskills --skill crawlkit -y |
graincrawl | 로컬 우선(local-first) Granola 아카이브 CLI를 유지 관리하고 릴리스합니다. | npx skills add vincentkoc/dotskills --skill graincrawl -y |
github-airplane-mode | 이미 설치된 호환 가능한 로컬 Git/GitHub 다운로드 가드를 전환합니다. | npx skills add vincentkoc/dotskills --skill github-airplane-mode -y |
ghcrawl-cluster-operator | CLI에서 ghcrawl 로컬 동기화, 클러스터링 및 클러스터 검사를 수행합니다. | npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y |
openclaw-bun-upgrade | 기존 서비스 소유자(service owner)를 통해 고정된 Bun 포크 빌드를 자격 부여하고 승진시킵니다. | npx skills add vincentkoc/dotskills --skill openclaw-bun-upgrade -y |
openclaw-github-dedupe | 저장소 전반에 걸쳐 GitHub 이슈/PR 클러스터를 분류(triage)하여, 기여자 크레딧을 보존하면서 표준 수정 사항과 안전한 폐쇄를 선택합니다. | |
| npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y |
openclaw-pr-batch-sweep |
낮은 위험도의 OpenClaw 기여자 풀 리퀘스트를 선택하고 처리합니다. | npx skills add vincentkoc/dotskills --skill openclaw-pr-batch-sweep -y |
org-branch-cleanup |
GitHub 조직 전체에 걸쳐 오래되고 병합된 브랜치를 감사하고 안전하게 정리합니다. | npx skills add vincentkoc/dotskills --skill org-branch-cleanup -y |
opik-integrations-auditor |
SDK 및 OTEL/API 표면 전반에 걸쳐 Opik 통합 커버리지를 감사합니다. | npx skills add vincentkoc/dotskills --skill opik-integrations-auditor -y |
opik-optimizer |
Opik 워크플로우를 통해 프롬프트, 도구(tools), 에이전트(agents) 및 매개변수를 최적화합니다. | npx skills add vincentkoc/dotskills --skill opik-optimizer -y |
operations-worktree |
오래된 로컬 브랜치 대신 신선한 원격 기본값으로부터 안전한 git worktree를 생성합니다. | npx skills add vincentkoc/dotskills --skill operations-worktree -y |
semantic-slicing |
집중적인 리포지토리 검토를 위해 로컬 기능, 위협(threat), 이슈 및 지원 맵을 구축합니다. | npx skills add vincentkoc/dotskills --skill semantic-slicing -y |
technical-deslop |
깨끗한 diff를 빠르게 배포합니다: AI 노이즈를 제거하고 동작은 변경되지 않게 유지합니다. | npx skills add vincentkoc/dotskills --skill technical-deslop -y |
technical-documentation |
Simplified Technical English, 샤딩된 대형 트리 감사(sharded large-tree audits), 워크플로우/하위 에이전트 팬아웃을 사용하여 문서를 구축, 검토 및 감사합니다. | npx skills add vincentkoc/dotskills --skill technical-documentation -y |
session-done |
세션 인수인계를 준비하고 요청 시에만 Markdown 노트를 보존합니다. | npx skills add vincentkoc/dotskills --skill session-done -y |
technical-integrations |
배포되는 통합을 설계합니다: 벤더 중립적인 API/RFC/SDK 계획과 배포 안전성 확보. | npx skills add vincentkoc/dotskills --skill technical-integrations -y |
technical-skill-finder |
실제 에이전트의 어려움을 새로운 스킬로 전환합니다: 로그 마이닝, 성공 사례 순위화, 다음 단계 초안 작성.
|
npx skills add vincentkoc/dotskills --skill technical-skill-finder -y |
tmux-agent-lane-orchestrator |
tmux 코딩 에이전트 레인(lane)을 모니터링하고 증거 기반의 매니저 요약본을 생성합니다. | npx skills add vincentkoc/dotskills --skill tmux-agent-lane-orchestrator -y |
tmux-lane-orchestrator |
일치하는 매니저 패인(pane)에서 하나의 tmux 워커 레인을 조정합니다. | npx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y |
로컬 전용 스킬은 무시되는 private-skills/ 디렉토리에 존재할 수 있지만, 이 공개 저장소에서는 절대 추적되어서는 안 됩니다.
스킬 하나 설치하기:
npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y
npx skills add vincentkoc/dotskills --skill agent-device-lab -y
npx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y
...
사용 가능한 공개 스킬 목록 보기:
npx skills add vincentkoc/dotskills --list
github-airplane-mode는 이미 설치된 호환되는 low-data 명령어를 필요로 합니다. 이 스킬을 설치한다고 해서 네트워크 가드를 설치하거나 모드를 변경하는 것은 아닙니다.
기본 동기화 대상은 vercel skills에 의해 자동으로 관리됩니다.
이 저장소는 또한 vendor/에서 Codex 슬래시 명령어(slash-command) 프롬프트를 미러링하여 ~/.codex/prompts로 동기화할 수도 있습니다.
make sync은 이제 codex 프로필에 대한 스킬 및 슬래시 명령어를 동기화합니다. - 현재 포함된 벤더 명령어:
/sectriage (출처: steipete/agent-scripts)
로컬 make sync와 make sync-copy는 macOS 또는 Linux가 필요합니다. 업데이트는 동일 소스 심볼릭 링크(symlinks)나 변경되지 않은 관리된 사본만 동기화합니다. 모든 내용과 모드가 현재 소스와 일치하는 경우, 이전의 표시되지 않은 사본을 채택할 수 있습니다. 다른 사본, 추가 로컬 파일 및 외부 링크는 동기화 전에 조정이 필요합니다. 실패한 게시(publication)는 중간 목적지를 덮어쓰지 않으며, 재시도를 하기 전에 검토가 필요한 유지된 복구 디렉토리의 이름을 오류 메시지에 명시합니다.
skills/ # 퍼스트파티 스킬
<skill-name>/
SKILL.md|AGENT.md|AGENTS.md
...
make validate는 이제 실행합니다:
- 저장소 정책 검사 (repo policy checks) (
Purpose/When to use/Workflow/Inputs/Outputs, entry-file 검사)
- 에이전트 스킬 사양 검사 (AgentSkills spec checks) 로컬
SKILL.md
스킬 (name/description 제약 조건, 프런트매터 유효성, 상대 리소스 참조, 한 단계 깊이 참조 제한)
- 공개 스킬 OpenAI 메타데이터 검사 (public skill OpenAI metadata checks) (
agents/openai.yaml,
필수 인터페이스 필드, AGENTS.md의 기본 아이콘/브랜드, 아이콘 경로 존재 여부)
설치된 경우 외부 참조 유효성 검사기(external reference validator)도 사용됩니다:
skills-ref validate ./skills/<skill-name>
Dotfiles는 머신을 구성합니다.
.skills는 AI 실행 품질을 구성합니다.
이 저장소는 조합 가능하고, 감사 가능하며, 실용적이어야 합니다. 스킬은 일회성 프롬프트 조각이 아니라 테스트 가능한 아티팩트여야 합니다.
CONTRIBUTING.md와 CODE_OF_CONDUCT.md를 읽어보세요.