@@ -175,8 +175,89 @@ if [[ $total_errors -ge 10 ]]; then # Now requires 10+ errors
175175fi
176176```
177177
178+ ## AI Provider Configuration (v2.0)
179+
180+ ### Activation Modes
181+
182+ Set in ` .claude/skills/skill-rules.json ` :
183+
184+ ``` json
185+ {
186+ "settings" : {
187+ "skill_activation_mode" : " disabled" ,
188+ "conservativeness" : " balanced"
189+ }
190+ }
191+ ```
192+
193+ | Mode | Behavior |
194+ | ------| ----------|
195+ | ` disabled ` | Regex-only (default, v1.0 behavior) |
196+ | ` fallback ` | AI first, regex on failure |
197+ | ` ai-only ` | Pure AI, no fallback |
198+
199+ ### Provider Selection
200+
201+ Auto-detected from environment, or force with ` SKILL_AI_PROVIDER ` :
202+
203+ ``` bash
204+ export SKILL_AI_PROVIDER=gemini # gemini|openai|anthropic|ollama
205+ ```
206+
207+ ### Conservativeness
208+
209+ Controls suggestion aggressiveness in AI mode:
210+
211+ ``` bash
212+ export SKILL_CONSERVATIVENESS=balanced # strict|balanced|aggressive
213+ ```
214+
215+ ### PreToolUse Guard
216+
217+ The ` skill-verification-guard ` hook analyzes code being edited:
218+
219+ ``` bash
220+ # Soft-block: block first edit with suggestions, allow second
221+ export PRETOOLUSE_SOFT_BLOCK=false
222+
223+ # Skip mandatory skill enforcement
224+ export SKIP_MANDATORY_SKILLS=false
225+
226+ # Skip AI analysis in PreToolUse
227+ export SKIP_PRETOOLUSE_AI=false
228+
229+ # Detailed debug logging
230+ export SKILL_GUARD_DEBUG=false
231+ ```
232+
233+ ### Debug Mode
234+
235+ ``` bash
236+ export DEBUG_SKILLS=1 # Show AI classification details in stderr
237+ ```
238+
178239## Environment Variables
179240
241+ ### AI Provider Variables
242+
243+ ``` bash
244+ # Force specific provider
245+ SKILL_AI_PROVIDER=gemini| openai| anthropic| ollama
246+
247+ # Provider API keys (auto-detection uses these)
248+ GEMINI_API_KEY=your-key
249+ OPENAI_API_KEY=your-key
250+ ANTHROPIC_API_KEY=your-key
251+
252+ # OpenAI/Azure customization
253+ OPENAI_BASE_URL=https://your-endpoint.openai.azure.com
254+ OPENAI_MODEL=gpt-4o-mini
255+
256+ # Ollama customization
257+ OLLAMA_MODEL=llama3.2
258+ OLLAMA_BASE_URL=http://localhost:11434
259+ ```
260+
180261### Global Environment Variables
181262
182263Set in your shell profile (` .bashrc ` , ` .zshrc ` , etc.):
0 commit comments