- HOTFIXES: 새 2026-05-24 절 — v0.17.0 closure 영향 (한국어 lexical 3-gram, 영어 substring 변경, BM25 분포, 디스크 용량, heading_path JSON 노이즈 관찰). 기존 2026-05-22 한국어 lexical 항목의 Status / Next step 을 closure 표현으로 갱신. - HANDOFF: 머지 후 발견 deviation 절에 2026-05-24 entry + 기존 2026-05-22 항목을 closure cross-link 로 정리. P10 백로그 한국어 tokenizer 항목 ✅ v0.17.0 + "다음 task 후보" follow-up 라인의 상태 갱신. - README: 검색 명령 행에 trigram 동작 + hint + 디스크 용량 한 줄. - SMOKE: 새 "한국어 trigram 검색 (v0.17.0)" 절 — 도그푸딩 query 시퀀스 (충돌은 raw / 해시 충돌 multi-token / Rust 충돌은 mixed / 충돌 2자 + stderr / --json hint 검증) + 영어 substring 동작 변경 안내. - SKILL.md: search 절에 hint 필드 안내 한 줄 — agent 가 short query 케이스에서 같은 query 재시도 대신 사용자에게 surface 하도록. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Claude Code integration
Skill packages that let Claude Code call kebab automatically when a question would benefit from the user's local KB.
Available skills
| Skill | Trigger | What it does |
|---|---|---|
kebab |
Internal / org-specific questions, runbooks, indexed-doc lookups | Calls kebab search --json / kebab ask --json and folds the results into the answer with citations |
Install
User-level (every Claude Code session on this machine):
# from a kebab repo checkout
cp -r integrations/claude-code/kebab ~/.claude/skills/
# verify
ls ~/.claude/skills/kebab/SKILL.md
Or symlink so git pull in the repo updates the skill in place:
mkdir -p ~/.claude/skills
ln -s "$(pwd)/integrations/claude-code/kebab" ~/.claude/skills/kebab
Project-level (only loads when Claude Code runs in a specific project):
mkdir -p <project>/.claude/skills
cp -r integrations/claude-code/kebab <project>/.claude/skills/
After install, start a fresh Claude Code session — the skill self-registers from its frontmatter description and is invoked automatically when a matching question shows up. No config edit needed.
Customization
The shipped SKILL.md is generic on purpose — it triggers on any "internal / org-specific" cue. To make Claude Code more eager (or less) for your corpus, edit the frontmatter description of your local copy and add the team / system / acronym keywords that should trigger the skill (e.g. MLOps, DMQ, AiSuite). Don't PR those keywords back into this repo — they're per-user.
A symlink install + a ~/.claude/skills/kebab/SKILL.md.local patch script is one pattern; another is to keep a fork branch with personalized frontmatter and rebase on main.
Update policy
The skill consumes kebab's wire schema v1 (schema_version fields like search_hit.v1, answer.v1). When the wire schema major-bumps to v2, this skill is updated in the same PR — see the project root CLAUDE.md §Wire schema v1.
Other hosts
kebab exposes the same --json contract to any agent host. To add a new integration:
- Drop a directory under
integrations/<host>/mirroring the structure here. - Reference
docs/wire-schema/v1/for the JSON shapes. - Link from this
README.mdtable.
A native MCP server (kebab serve --mcp) and an HTTP wrapper are listed in the root README §외부 AI 통합 as future options.