auto-skill init Initialize Auto-Skill by creating the required directory structure, configuration file, and checking for optional dependencies.
Usage auto-skill init [options]
Options Force recreate configuration file even if it already exists
Output results in JSON format
What It Creates
Claude Directory
Creates ~/.claude/ if it doesn’t exist
Auto-Skill Data Directory
Creates ~/.claude/auto-skill/ for storing events database and internal data
Skills Output Directory
Creates ~/.claude/skills/auto/ where generated skills will be stored
Configuration File
Creates ~/.claude/auto-skill.local.md with default settings
Configuration File The generated ~/.claude/auto-skill.local.md includes:
~/.claude/auto-skill.local.md
--- detection : min_occurrences : 3 min_sequence_length : 2 max_sequence_length : 10 lookback_days : 7 min_confidence : 0.7 ignored_tools : - AskUserQuestion hybrid : enable_mental : true enable_external : true auto_graduate : true enabled : true --- # Auto-Skill Configuration
Configuration Options Pattern detection settings Minimum number of times a pattern must occur to be detected
Minimum number of tools in a sequence
Maximum number of tools in a sequence
How many days of history to analyze
Minimum confidence score (0.0-1.0) to suggest a pattern
List of tool names to exclude from pattern detection
External skill integration settings Enable Mental CLI integration for semantic codebase understanding
Enable Skills.sh external skill discovery
Automatically suggest skill graduation when criteria are met
Master switch for Auto-Skill functionality
Dependency Check The init command checks for optional dependencies:
Mental CLI Used for semantic codebase understanding and better pattern detection. npm install -g @mentalmodel/cli
Learn more about Mental Examples Standard Initialization Created Claude directory: /Users/username/.claude Created Auto-Skill data: /Users/username/.claude/auto-skill Created Skills output: /Users/username/.claude/skills/auto Created config: /Users/username/.claude/auto-skill.local.md Checking dependencies: Mental CLI: not found (npm i -g @mentalmodel/cli ) Initialization complete! Run 'auto-skill discover' to find skills.
Force Recreate Configuration Recreates the configuration file even if it already exists. Useful for resetting to defaults.
JSON Output { "created" : [ "/Users/username/.claude" , "/Users/username/.claude/auto-skill" , "/Users/username/.claude/skills/auto" , "/Users/username/.claude/auto-skill.local.md" ], "success" : true }
Directory Structure After initialization, your directory structure will look like:
~ /.claude/ ├── auto-skill/ # Internal data (events.db, patterns) ├── skills/ │ └── auto/ # Auto-generated skills └── auto-skill.local.md # Configuration file
The ~/.claude/ directory is used by multiple coding agents. Auto-Skill stores its data in subdirectories to avoid conflicts.
Next Steps
Discover Patterns Find skills relevant to your current project
List Agents Check which coding agents are installed