auto-skill init

Initialize auto-skill configuration and directories

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 · boolean · default: "false"

Force recreate configuration file even if it already exists

--json · boolean · default: "false"

Output results in JSON format

What It Creates

1. Claude Directory

   Creates ~/.claude/ if it doesn’t exist

2. Auto-Skill Data Directory

   Creates ~/.claude/auto-skill/ for storing events database and internal data

3. Skills Output Directory

   Creates ~/.claude/skills/auto/ where generated skills will be stored

4. 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

detection · object

Pattern detection settings

Show properties

min_occurrences · number · default: "3"

Minimum number of times a pattern must occur to be detected

min_sequence_length · number · default: "2"

Minimum number of tools in a sequence

max_sequence_length · number · default: "10"

Maximum number of tools in a sequence

lookback_days · number · default: "7"

How many days of history to analyze

min_confidence · number · default: "0.7"

Minimum confidence score (0.0-1.0) to suggest a pattern

ignored_tools · string[]

List of tool names to exclude from pattern detection

hybrid · object

External skill integration settings

Show properties

enable_mental · boolean · default: "true"

Enable Mental CLI integration for semantic codebase understanding

enable_external · boolean · default: "true"

Enable Skills.sh external skill discovery

auto_graduate · boolean · default: "true"

Automatically suggest skill graduation when criteria are met

enabled · boolean · default: "true"

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

auto-skill init

Output

  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

auto-skill init --force

Recreates the configuration file even if it already exists. Useful for resetting to defaults.

JSON Output

auto-skill init --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