Config API
The Config module handles default settings and project-specific overrides for Auto-Skill. Configuration is loaded from YAML frontmatter in.claude/auto-skill.local.md and merged with sensible defaults.
Functions
loadConfig
Load configuration with optional project overrides. Loads defaults and merges any project-local overrides found in.claude/auto-skill.local.md. If no project path is provided, returns default configuration.
Path to project root for local overrides. If omitted, only defaults are returned.
Config - Merged configuration object
Example
parseYamlFrontmatter
Extract and parse YAML frontmatter from markdown content.Markdown content potentially containing YAML frontmatter between
--- delimiters.Record<string, unknown> | null - Parsed YAML data or null if no valid frontmatter found
Example
Constants
DEFAULT_CONFIG
The default configuration object used when no overrides are present.Value
Types
Config
Full configuration for Auto-Skill.Pattern detection settings (thresholds, lookback period, ignored tools)
Multi-agent support settings (auto-detection, symlinks)
Skill provider configuration (external registries, well-known endpoints)
Custom path to SQLite database. Defaults to
~/.claude/auto-skill/events.dbCustom output directory for generated skills. Defaults to
~/.claude/skills/auto/Master switch for Auto-Skill functionality
DetectionConfig
Configuration for pattern detection.Minimum times a pattern must occur before detection
Minimum number of tools in a detectable sequence
Maximum number of tools in a detectable sequence
Number of days to analyze for pattern detection
Minimum confidence score (0.0-1.0) required for skill generation
Tool names to exclude from pattern detection
AgentSettings
Configuration for multi-agent support.Automatically detect installed coding agents
Specific agents to target (e.g.,
["cursor", "aider"]). Empty array means all detected agents.Create symlinks to share skills across agents
ProviderSettings
Configuration for skill providers.Enabled skill source providers (e.g.,
["skillssh", "wellknown", "local"])Domains to check for RFC 8615 well-known skill endpoints
Configuration File Format
Project-local overrides should be placed in.claude/auto-skill.local.md with YAML frontmatter:
min_occurrences) but are converted to camelCase in the TypeScript Config object.