altair823-org/kebab
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 40 Wiki Activity

docs(skill): MCP-first guidance + CLI as fallback #121

Merged
altair823 merged 1 commits from docs/skill-mcp-first into main 2026-05-07 14:46:41 +00:00
Conversation 0 Commits 1 Files Changed 1 +70 -49
altair823 commented 2026-05-07 14:45:47 +00:00
Owner
Copy Link

배경

repo-shipped skill (integrations/claude-code/kebab/SKILL.md) 이전에 CLI를 primary로, MCP를 별도 "recommended" alternative로 다뤘다. v0.3.1에서 MCP server가 ship된 이후로도 Recipe A/B/C가 여전히 `kebab search/ask` Bash 호출을 명시 → 일관성 깨짐.

변경

  • MCP tool catalog (6 tools as mcp__kebab__<name>) 가 첫 번째 surface로 등장
  • 모든 recipe (A/B/C/D) MCP tool 호출 명시 — CLI 옵션 괄호로 병기
  • CLI 섹션은 "fallback" 으로 유지 (MCP 미지원 host 용)
  • mutation tool (ingest_*) 자동 호출 금지 명시
  • repo-shipped이라 generic 유지 — user-specific trigger keyword (DMQ/MLOps 등) 추가 안 함

영향

  • Claude Code 사용자가 이 skill을 user-local로 복사할 때 MCP-first guidance 받음
  • mcp.json 미등록이거나 다른 host (Cursor/Copilot CLI/etc)에서도 CLI fallback 유효
  • 기존 mcp-usage.md 문서로 cross-link 유지
## 배경 repo-shipped skill (`integrations/claude-code/kebab/SKILL.md`) 이전에 CLI를 primary로, MCP를 별도 \"recommended\" alternative로 다뤘다. v0.3.1에서 MCP server가 ship된 이후로도 Recipe A/B/C가 여전히 \`kebab search/ask\` Bash 호출을 명시 → 일관성 깨짐. ## 변경 - MCP tool catalog (6 tools as `mcp__kebab__<name>`) 가 첫 번째 surface로 등장 - 모든 recipe (A/B/C/D) MCP tool 호출 명시 — CLI 옵션 괄호로 병기 - CLI 섹션은 \"fallback\" 으로 유지 (MCP 미지원 host 용) - mutation tool (`ingest_*`) 자동 호출 금지 명시 - repo-shipped이라 generic 유지 — user-specific trigger keyword (DMQ/MLOps 등) 추가 안 함 ## 영향 - Claude Code 사용자가 이 skill을 user-local로 복사할 때 MCP-first guidance 받음 - mcp.json 미등록이거나 다른 host (Cursor/Copilot CLI/etc)에서도 CLI fallback 유효 - 기존 mcp-usage.md 문서로 cross-link 유지
altair823 added 1 commit 2026-05-07 14:45:48 +00:00
docs(skill): MCP-first guidance + CLI as fallback b20c1dd56a 
Repo-shipped skill previously framed CLI as primary surface with MCP
as a separate "recommended" alternative. Recipes still used CLI calls
even though MCP server has been the recommended surface since v0.3.1.

Now: MCP tool catalog (6 tools as `mcp__kebab__<name>`) leads, recipes
call MCP tools directly, CLI documented as fallback for hosts without
MCP. Generic wording preserved (no user-specific trigger keywords).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
altair823 merged commit 6d4a648349 into main 2026-05-07 14:46:41 +00:00
altair823 deleted branch docs/skill-mcp-first 2026-05-07 14:46:42 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
altair823 claude-reviewer-01
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: altair823-org/kebab#121
Delete Branch "docs/skill-mcp-first"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?