Configuration Reference

export interface Config {
  detection: DetectionConfig;        // Pattern detection settings
  agents: AgentSettings;             // Multi-agent configuration
  providers: ProviderSettings;       // Skill provider configuration
  dbPath: string | null;             // Custom database path
  skillsOutputDir: string | null;    // Custom skills output directory
  enabled: boolean;                  // Master enable/disable switch
}

export interface DetectionConfig {
  minOccurrences: number;        // Minimum pattern repetitions (default: 3)
  minSequenceLength: number;     // Minimum tools in sequence (default: 2)
  maxSequenceLength: number;     // Maximum tools in sequence (default: 10)
  lookbackDays: number;          // Analysis window in days (default: 7)
  minConfidence: number;         // Minimum confidence score (default: 0.7)
  ignoredTools: string[];        // Tools to exclude (default: ['AskUserQuestion'])
}

export interface AgentSettings {
  autoDetect: boolean;       // Auto-detect current agent (default: true)
  targetAgents: string[];    // Agents to share skills with (default: [])
  symlinkSkills: boolean;    // Use symlinks for cross-agent sharing (default: true)
}

export interface ProviderSettings {
  enabledProviders: string[];    // Active providers (default: ['skillssh'])
  wellknownDomains: string[];    // Domains for RFC 8615 discovery (default: [])
}

{
  dbPath: '/custom/path/events.db',
  skillsOutputDir: '/custom/path/skills'
}

---
enabled: false
---

---
detection:
  min_occurrences: 5
  min_confidence: 0.8
  ignored_tools:
    - AskUserQuestion
    - WebFetch

agents:
  auto_detect: true
  target_agents:
    - claude
    - cursor
  symlink_skills: true

providers:
  enabled_providers:
    - local
    - skillssh
  wellknown_domains:
    - company.internal

enabled: true
---

# Auto-Skill Configuration

This file customizes Auto-Skill for this project.

## Notes

- We use aggressive detection (5 occurrences) because this is a mature project
- Skills are shared between Claude and Cursor
- We use both local and Skills.sh providers

import { loadConfig } from '@matrixy/auto-skill';

// Load default config
const defaultConfig = loadConfig();

// Load config with project overrides
const projectConfig = loadConfig('/path/to/project');

console.log(projectConfig.detection.minOccurrences); // From .local.md or default

---
# Pattern Detection
detection:
  min_occurrences: 4
  min_sequence_length: 2
  max_sequence_length: 12
  lookback_days: 14
  min_confidence: 0.75
  ignored_tools:
    - AskUserQuestion
    - WebFetch
    - Task
    - TodoWrite

# Multi-Agent Support
agents:
  auto_detect: true
  target_agents:
    - claude
    - cursor
    - aider
  symlink_skills: true

# Skill Providers
providers:
  enabled_providers:
    - local
    - skillssh
    - wellknown
  wellknown_domains:
    - skills.company.internal
    - devtools.acme.com

# Custom Paths (optional)
# db_path: /custom/path/events.db
# skills_output_dir: /custom/path/skills

# Master Switch
enabled: true
---

# Auto-Skill Configuration for MyProject

This project uses Auto-Skill with custom settings optimized for our workflow.

## Rationale

- **4 occurrences minimum**: We have high code reuse, so 3 was too noisy
- **14-day lookback**: Team works on features for 1-2 weeks
- **75% confidence**: We prefer quality over quantity
- **Multi-agent**: Team uses Claude, Cursor, and Aider
- **Internal registry**: We have company-approved skills at skills.company.internal

## Maintenance

Update this config as team workflow evolves. Commit to version control.

# Initialize config file
auto-skill init

# Show current config
auto-skill config show

# Validate config file
auto-skill config validate

# Set a config value
auto-skill config set detection.min_occurrences 5

# Get a config value
auto-skill config get detection.min_confidence