skillcli은(는) 무엇을 하나요?
Claude Code / Codex 스킬을 위한 로컬 제어판 — 결정론적 규칙 + 품질 게이트 + 사용 피드백 루프. 자동 트리거 비율을 ~50%에서 100%로 끌어올리세요.
개요
skillcli는 AI 코딩 에이전트(Claude Code, Codex 등)의 스킬 실행을 더욱 정확하고 예측 가능하게 만드는 CLI 도구입니다. 기존 스킬은 대략적인 프롬프트 매칭에 의존하여 약 50%의 경우에만 자동으로 트리거되지만, skillcli는 다음과 같은 세 가지 메커니즘을 통해 이를 100%에 가깝게 끌어올립니다:
- 결정론적 규칙(
rules/): 파일 확장자, 의존성 변경, 디렉토리 구조 등 정확한 조건을 기반으로 스킬 활성화 여부를 결정합니다. - 품질 게이트(
quality/): 각 스킬의 출력이 사전 정의된 품질 기준(예: 컴파일 통과, 코드 스타일 준수)을 충족하는지 검증합니다. - 사용 피드백 루프(
feedback/): 사용자가 스킬 제안을 수락하거나 거절할 때마다 그 패턴을 기록하고, 이를 바탕으로 규칙을 동적으로 업데이트합니다.
설치
# npm을 통해 전역 설치
npm install -g edward4226/skillcli
# 또는 소스에서 직접 실행
git clone https://github.com/Edward4226/skillcli.git
cd skillcli
npm install
사용법
기본 명령어
# 현재 프로젝트의 스킬 규칙 초기화
skillcli init
# 규칙에 따라 스킬 트리거 테스트
skillcli check <skill-name>
# 수동으로 스킬 실행
skillcli run <skill-name> [args...]
# 피드백 루프 시작 (사용자 인터랙션 모니터링)
skillcli feedback --watch
설정
skill.config.json 파일을 프로젝트 루트에 생성하거나, 환경 변수를 통해 설정할 수 있습니다:
{
"skills": {
"refactor": {
"rules": [
{"type": "filePattern", "pattern": "**/*.ts"},
{"type": "dependencyChange", "package": "typescript"}
],
"qualityGate": {
"type": "compile",
"command": "npm run build"
}
}
},
"feedback": {
"enabled": true,
"learningRate": 0.1
}
}
환경 변수:
SKILLCLI_CONFIG_PATH: 설정 파일의 경로 (기본값:./skill.config.json)SKILLCLI_LOG_LEVEL: 로깅 수준 (debug,info,warn,error)
아키텍처
skillcli는 다음과 같은 디렉토리 구조를 권장합니다:
.skillcli/
├── rules/ # 결정론적 규칙 정의 (YAML/JSON)
│ ├── refactor.yaml
│ └── test.yaml
├── quality/ # 품질 게이트 스크립트
│ ├── compile.sh
│ └── lint.sh
└── feedback/ # 피드백 데이터 저장
└── log.jsonl
지원 플랫폼
- Claude Code: Anthropic의 Claude Code CLI와 통합됩니다.
- Codex: OpenAI의 Codex 에이전트와 호환됩니다.
- 기타 에이전트: 표준 입력/출력 및 파일 시스템 접근을 지원하는 모든 AI 코딩 에이전트에서 사용 가능합니다.
기여하기
버그 리포트, 기능 제안, 풀 리퀘스트는 언제나 환영합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.
라이선스
MIT