# rtk-setup-skill
RTK(Rust Token Killer)를 OpenClaw 워크스페이스에 설치하고, 모든 에이전트가 RTK 명령어를 강제로 사용하도록 설정하는 스킬.
## 왜 필요한가?
RTK는 Claude Code 플러그인(`claude plugins install`)으로 설치하면 PreToolUse 훅이 자동 적용된다.
하지만 **OpenClaw(ACP) 환경에서는 훅이 작동하지 않는다.**
이 스킬은:
1. RTK 바이너리를 설치하고
2. `RTK.md` (에이전트용 규칙 파일)를 생성하고
3. `AGENTS.md`에 강제 지침을 삽입하여
에이전트들이 `ls` 대신 `rtk ls`, `git status` 대신 `rtk git status`를 사용하도록 **강제**한다.
## 벤치마크 (실측)
RTK 0.34.3 / macOS ARM64 / OpenClaw 워크스페이스 (파일 90+개, untracked 80+개)
| 명령어 | 기존 출력 (bytes) | RTK 출력 (bytes) | 절약률 |
|--------|----------------:|----------------:|-------:|
| `ls -la` → `rtk ls` | 6,878 | 2,261 | **67.1%** |
| `git status` → `rtk git status` | 3,982 | 304 | **92.4%** |
| `grep` → `rtk grep` | 3,738 | 1,675 | **55.2%** |
| `git diff` → `rtk git diff` | 520 | 215 | **58.7%** |
| `cat` → `rtk read` | 4,210 | 4,211 | 0% (소규모 파일) |
**종합: 7개 명령 실행 → 3.9K 토큰 절약 (57.5%)**
> `rtk read`는 소규모 파일에서는 절약 효과가 없다. 대형 파일(100줄+)에서 효과가 크다.
> `git status`는 untracked 파일이 많을수록 절약률이 높다 (이 워크스페이스에서 92.4%).
## 설치
### 1. 스킬 복사
```bash
cp -r rtk-setup/ <your-workspace>/skills/rtk-setup/
```
### 2. 스킬 실행
에이전트에게 "RTK 설치해줘" 또는 "RTK 설정해줘"라고 요청하면 SKILL.md의 워크플로가 실행된다.
또는 수동으로:
```bash
# RTK 바이너리 설치
brew install rtk
# RTK.md 생성 (스킬 내 STEP 2 참고)
# AGENTS.md에 RTK 블록 추가 (스킬 내 STEP 3 참고)
```
## 파일 구조
```
rtk-setup/
└── SKILL.md # 스킬 정의 (워크플로 + 지침)
```
설치 후 워크스페이스에 생성되는 파일:
```
workspace/
├── RTK.md # 에이전트용 RTK 사용 규칙
└── AGENTS.md # RTK 강제 지침 블록 추가됨
```
## RTK 명령어 치환 표
| 기존 명령어 | RTK 명령어 |
|------------|-----------|
| `ls`, `tree` | `rtk ls` |
| `cat`, `head`, `tail` | `rtk read` |
| `grep`, `rg` | `rtk grep` |
| `find` | `rtk find` |
| `git status` | `rtk git status` |
| `git log` | `rtk git log` |
| `git diff` | `rtk git diff` |
| `git push` | `rtk git push` |
| `npm test` | `rtk test npm test` |
| `npm run build` | `rtk err npm run build` |
### 예외
- Claude Code 내장 도구 (Read, Grep, Glob) → RTK 불필요
- `cd`, `mkdir`, `rm` 등 출력 없는 명령어
- 사용자가 원본 출력을 명시적으로 요청한 경우
## 토큰 절약 확인
```bash
rtk gain # 요약
rtk gain --graph # 30일 그래프
rtk discover # 놓친 절약 기회
```
## 참고
- [RTK GitHub](https://github.com/rtk-ai/rtk)
- RTK는 Claude Code 내장 도구(Read, Grep, Glob)와 무관하게 Bash 명령에만 적용된다.
- OpenClaw ACP 환경에서는 훅 대신 AGENTS.md 지침 방식을 사용한다.
## License
MIT