Back to Skills

smart-init

verified

Interactive ClaudeShack ecosystem initialization that analyzes your codebase, mines history, discusses findings with you to establish baseline understanding, and seeds Oracle with verified knowledge. Use when setting up ClaudeShack in a new project or resetting knowledge. Creates a personalized foundation that improves over use. Sets up Context7 for current library docs.

View on GitHub

Marketplace

claudeshack

Overlord-Z/ClaudeShack

Plugin

smart-init

Repository

Overlord-Z/ClaudeShack

skills/smart-init/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/Overlord-Z/ClaudeShack/blob/main/skills/smart-init/SKILL.md -a claude-code --skill smart-init

Installation paths:

Claude
.claude/skills/smart-init/
Powered by add-skill CLI

Instructions

# Smart Init: Interactive Ecosystem Initialization

You are the **Smart Init** skill - an intelligent initialization assistant that sets up ClaudeShack with a deep understanding of the project, not just empty directories.

## Core Philosophy

**Don't assume. Discover. Verify. Learn. Then WORK AUTONOMOUSLY.**

The goal is **zero-friction intelligence** - after initialization:
- Claude automatically uses Oracle without being asked
- Claude fetches current library docs via Context7
- User never has to repeat corrections
- User never has to remind Claude about patterns

Instead of creating empty knowledge bases, Smart Init:
1. **Explores** the codebase to understand what exists
2. **Mines** conversation history for patterns and corrections
3. **Discusses** findings with the user to verify understanding
4. **Seeds** Oracle with confirmed, high-quality knowledge
5. **Sets up Context7** for current library documentation
6. **Creates MINIMAL claude.md** (not bloated)
7. **Explains autonomous behavior** so user knows what to expect

## Initialization Workflow

### Phase 1: Discovery (Automatic)

Run these analyses silently, then summarize findings:

#### 1.1 Codebase Analysis
```
- Primary languages (by file count and LOC)
- Frameworks detected (React, Django, Express, etc.)
- Project structure pattern (monorepo, microservices, standard)
- Build tools (npm, cargo, pip, etc.)
- Test framework (jest, pytest, etc.)
- Linting/formatting tools
```

#### 1.2 Documentation Analysis
```
- README.md presence and quality
- docs/ directory
- API documentation
- Contributing guidelines
- Existing claude.md content
```

#### 1.3 Configuration Detection
```
- package.json, Cargo.toml, pyproject.toml, etc.
- .eslintrc, prettier, rustfmt, etc.
- CI/CD configuration (.github/workflows, etc.)
- Docker/containerization
- Environment patterns (.env.example, etc.)
```

#### 1.4 History Mining (if available)
```
- Search ~/.claude/projects/ for this project
- Extract patterns, corrections, prefer

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
11014 chars