intertwine/dspy-agent-skills

코딩 에이전트를 위한 프로덕션급 (Production-grade) DSPy 3.2.x 스킬. Claude Code, Codex CLI 및 기타 agentskills.io 호환 에이전트를 DSPy 전문가로 변환하는, 사양을 준수하도록 합성된 5가지 에이전트 스킬 팩입니다.

• ✅ DSPy 3.2.1을 기준으로 검증됨 (오래된 문서에서 추론한 것이 아닌 실제 API 기준)
• ✅ Claude Code 및 Codex CLI 모두를 위한 단일 진실 공급원 (Single source of truth)
• ✅ 단계적 공개 (Progressive disclosure) (짧은 SKILL.md + 심층 reference.md)
• ✅ 오프라인 --dry-run이 가능한 실행 가능한 example_*.py 스크립트
• ✅ DSPy 3.2.x BetterTogether 체이닝 (chaining) 예제 포함
• ✅ 원클릭 설치를 위한 플러그인 매니페스트 (Plugin manifest) + 마켓플레이스 매니페스트 (Marketplace manifest)
• ✅ Frontmatter 사양, JSON 스키마 (JSON schema), Python AST, 스킬 문서 정확성 및 버전 일치에 대한 검증 테스트

스킬 (Skill)	자동 호출 시점
dspy-fundamentals	모든 새로운 DSPy 코드: Signatures, Modules, Predict/ChainOfThought/ReAct, save/load
dspy-evaluation-harness	메트릭 (metrics) 작성, dev/val 세트 분할, dspy.Evaluate 호출
dspy-gepa-optimizer	dspy.GEPA를 사용한 DSPy 프로그램 최적화/컴파일
dspy-rlm-module	긴 컨텍스트 (Long context), 코드베이스 QA, dspy.RLM을 통한 재귀적 탐색
dspy-advanced-workflow	엔드 투 엔드 (End-to-end) 빌드 — 나머지 4개 스킬을 오케스트레이션 (orchestrates)

/plugin marketplace add intertwine/dspy-agent-skills
/plugin install dspy-agent-skills@dspy-agent-skills

npx skills add intertwine/dspy-agent-skills --list
npx skills add intertwine/dspy-agent-skills --skill '*' -a codex -y

Vercel skills CLI는 현재 소스로서 GitHub owner/repo, URL, well-known HTTPS 엔드포인트 또는 로컬 경로를 기대합니다. 상위 CLI에서 소스 별칭 (source alias)을 추가하지 않는 한, 단순 형태인 npx skills add dspy-agent-skills는 해결할 수 없으므로 intertwine/dspy-agent-skills를 사용하십시오.

git clone https://github.com/intertwine/dspy-agent-skills
cd dspy-agent-skills
./scripts/install.sh # ~/.claude/skills/ 및 ~/.agents/skills/로 심볼릭 링크 (symlinks) 생성

플래그 (Flags): --claude-only, --codex-only, --copy

(심볼릭 링크 대신 복사), --uninstall

, --dry-run

.

skills/*를 다음 경로로 드롭하세요:

~/.claude/skills/ (Claude Code) 또는 ~/.agents/skills/ (Codex CLI). 모든 옵션은 docs/installation.md를 참조하세요.

에이전트에게 다음과 같이 말하세요:

"DSPy 감성 분류기(sentiment classifier)를 구축하고, GEPA로 최적화한 뒤, 아티팩트(artifact)를 저장해줘."

에이전트는 dspy-advanced-workflow를 자동으로 로드하며, 이는 다른 스킬들을 체이닝(chaining)하여 전체적인 Baseline → GEPA → Export 파이프라인을 출력합니다. 추가적인 프롬프팅은 필요하지 않습니다.

examples/ 아래에 있는 세 가지 실행 가능한 데모는 실제 언어 모델(LM)을 대상으로 모든 스킬을 연습하며, 커밋된 베이스라인(baseline) 대 GEPA 최적화 수치와 함께 3.1.3 대 3.2.0의 명시적인 비교 노트를 제공합니다.

예제	아티팩트 DSPy	작업 LM	베이스라인	최적화됨	Δ	상태
01-rag-qa	3.2.0	Ministral 3B 2512	80.47	100.00	+19.53	2026-04-28에 갱신된 깔끔한 비교
02-math-reasoning	3.2.0	Ministral 3B 2512	85.00	93.33	+8.33	2026-04-21에 갱신됨
03-invoice-extraction	3.1.3	Liquid LFM 2.5 1.2B (무료)	0.833	0.931	+0.098	기존 아티팩트 유지

갱신된 01 및 02 아티팩트는 유료 페어인 openrouter/mistralai/ministral-3b-2512 + openrouter/qwen/qwen3-30b-a3b-instruct-2507를 사용합니다. 03은 기존의 DSPy 3.1.3 아티팩트를 유지하는데, 이는 동일한 Liquid/Nemotron 페어에서 깔끔한 DSPy 3.2.0 베이스라인이 이미 0.944에 도달하여, 교체할 GEPA 아티팩트가 제공할 수 있는 유용한 여유 공간(headroom)이 거의 없기 때문입니다. 정확한 명령어와 주의 사항은 examples/README.md 및 각 예제의 version_comparison.md를 참조하세요.

모든 API 주장은 다음을 근거로 합니다:

• https://dspy.ai/ (공식 문서, DSPy 3.2.x)
• https://code.claude.com/docs/en/skills.md (Claude Code 스킬 사양)
• https://developers.openai.com/codex/skills (Codex 스킬 사양)

# 검증 스위트 실행
uv run --with pytest python -m pytest tests/ -v
# 모든 예제를 오프라인에서 스모크 테스트 (API 키 불필요)
...

uv run --with dspy가

현재 버전인 3.2.1 대신 이전 버전의 DSPy 릴리스를 해결(resolves)하는 경우,

wheel 파일이나 UV_EXCLUDE_NEWER 설정, 또는 오래된 패키지 미러(mirror)가 새로운 릴리스를 숨기고 있는지 확인하십시오. 이 리포지토리에 대해 검증된 정확한 3.2.1 오버라이드(override) 명령어는 다음과 같습니다:

env -u UV_EXCLUDE_NEWER uv run --with dspy==3.2.1 python -c 'import dspy; print(dspy.__version__)'

DSPy: 3.2.x (3.2.1 버전으로 테스트됨; 커밋된 예제 아티팩트(artifacts)는 이를 생성한 DSPy 버전에 따라 명시적으로 라벨링되어 있음)
Claude Code: 최신 버전 (2026-04-17 기준 스킬 명세)
Codex CLI: 최신 Agent Skills 형식
Python: 3.10+
Deno: dspy.RLM 예제(Pyodide 샌드박스)에만 필요

dspy-agent-skills/
├── .claude-plugin/
│ ├── plugin.json
...

v0.2.3 • DSPy 3.2.x 대상

MIT — LICENSE 참조.

초안 기여자: Bryan Young (@intertwine) 및 Grok (xAI). 검증, 명세 정렬(spec-alignment) 및 듀얼 에이전트 패키징: Claude Opus 4.7, 2026년 4월.