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

feat(integrations): ship Claude Code skill for kebab

Browse Source 
Add `integrations/claude-code/kebab/` — a Claude Code skill that calls
`kebab search --json` / `kebab ask --json` automatically when the user
asks an internal-context / runbook / wiki-lookup question. Install via
`cp -r integrations/claude-code/kebab ~/.claude/skills/` (or symlink for
in-place updates).

The shipped SKILL.md keeps its frontmatter `description` generic so the
trigger fires on any "internal / org-specific" cue — per-user keywords
(team / system / acronym) belong in a local override, not in the
repo-shipped frontmatter.

CLAUDE.md §Wire schema v1: add a paragraph documenting the
`integrations/<host>/` layout and the rule that a wire schema major bump
(v1→v2) updates each shipped integration in the same PR — same shape as
the version-cascade rule.

README.md §외부 AI 통합: replace the "~50줄 wrapper" prose with a direct
link to `integrations/claude-code/`, since the wrapper is now in-tree.
This commit is contained in:
th-kim0823
2026-05-06 18:00:53 +09:00
parent 5398fb057c
commit e31871d03e
4 changed files with 149 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
integrations/claude-code/README.md Normal file
View File

@@ -0,0 +1,57 @@
# Claude Code integration
Skill packages that let [Claude Code](https://claude.ai/claude-code) call `kebab` automatically when a question would benefit from the user's local KB.
## Available skills
| Skill | Trigger | What it does |
|-------|---------|--------------|
| [`kebab`](kebab/SKILL.md) | 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):
```bash
# 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:
```bash
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):
```bash
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`](../../CLAUDE.md#wire-schema-v1) §Wire schema v1.
## Other hosts
`kebab` exposes the same `--json` contract to any agent host. To add a new integration:
1. Drop a directory under `integrations/<host>/` mirroring the structure here.
2. Reference `docs/wire-schema/v1/` for the JSON shapes.
3. Link from this `README.md` table.
A native MCP server (`kebab serve --mcp`) and an HTTP wrapper are listed in the root [README §외부 AI 통합](../../README.md#외부-ai-통합) as future options.