Learn-skills.dev initializer-agent

First-session agent for autonomous coding projects. Use when starting a new autonomous project, generating feature lists, setting up environments, or scaffolding project structure.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/adaptationio/skrillz/initializer-agent" ~/.claude/skills/neversight-learn-skills-dev-initializer-agent && rm -rf "$T"

manifest: data/skills-md/adaptationio/skrillz/initializer-agent/SKILL.md

source content

Initializer Agent

First-session agent that sets up the foundation for autonomous coding projects.

Quick Start

Initialize a Project

from scripts.initializer import InitializerAgent

agent = InitializerAgent(project_dir)
result = await agent.initialize_project(
    spec="Build a task management app with user auth",
    tech_stack=["nextjs", "typescript", "prisma"]
)

Generate Feature List

from scripts.feature_generator import generate_features

features = await generate_features(
    spec="E-commerce platform with cart and checkout",
    count=100  # Generate 100 features
)

Initialization Workflow

┌─────────────────────────────────────────────────────────────┐
│                  INITIALIZER WORKFLOW                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  1. READ PROJECT SPECIFICATION                               │
│     ├─ Parse requirements                                   │
│     ├─ Identify technology stack                            │
│     └─ Determine project structure                          │
│                                                              │
│  2. GENERATE FEATURE LIST                                   │
│     ├─ Create 100-200 features                              │
│     ├─ Categorize (functional, UI, API, etc.)              │
│     ├─ Add verification steps                               │
│     └─ Set initial priority                                 │
│                                                              │
│  3. CREATE ENVIRONMENT SCRIPT                               │
│     ├─ Dependency installation                              │
│     ├─ Database setup                                       │
│     ├─ Environment variables                                │
│     └─ Development server                                   │
│                                                              │
│  4. SCAFFOLD PROJECT                                        │
│     ├─ Create directory structure                           │
│     ├─ Initialize package.json/pyproject.toml              │
│     ├─ Create base configuration                            │
│     └─ Set up testing framework                             │
│                                                              │
│  5. MAKE INITIAL COMMIT                                     │
│     ├─ git init                                             │
│     ├─ Add all files                                        │
│     └─ Commit: "Initial project setup"                      │
│                                                              │
│  6. SAVE STATE                                              │
│     ├─ Write feature_list.json                              │
│     ├─ Write init.sh                                        │
│     └─ Create claude-progress.txt                           │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Output Artifacts

feature_list.json

[
  {
    "id": "auth-001",
    "category": "functional",
    "description": "User can sign up with email and password",
    "steps": [
      "Navigate to signup page",
      "Enter email address",
      "Enter password (min 8 chars)",
      "Click submit",
      "Verify account created"
    ],
    "passes": false,
    "priority": 1
  }
]

init.sh

#!/bin/bash
set -e

# Install dependencies
npm install

# Set up database
npx prisma migrate dev

# Start development server
npm run dev &

claude-progress.txt

# Session Progress

## Session 1 - 2025-01-15 10:00

### Accomplishments
- Analyzed project specification
- Generated 150 feature requirements
- Created project structure
- Set up development environment

### Next Steps
- Begin implementing auth-001: User signup

Feature Categories

Category	Description	Example
`functional`	Core functionality	User login, CRUD operations
`ui`	User interface	Forms, modals, navigation
`api`	API endpoints	REST routes, GraphQL
`database`	Data layer	Models, migrations
`integration`	External services	OAuth, payments
`performance`	Speed/efficiency	Caching, optimization
`security`	Protection	Input validation, auth
`accessibility`	A11y compliance	WCAG, ARIA
`testing`	Test coverage	Unit, integration, E2E

Integration Points

autonomous-session-manager: Detects INIT session type
context-state-tracker: Creates initial state artifacts
coding-agent: Picks up from initializer output

References

```
references/INITIALIZER-WORKFLOW.md
```
- Detailed workflow
```
references/FEATURE-CATEGORIES.md
```
- Category guidelines

Templates

```
templates/init.sh.template
```
- Environment setup
```
templates/feature_list.json.template
```
- Feature structure
```
templates/progress.txt.template
```
- Progress file

Scripts

```
scripts/initializer.py
```
- Main InitializerAgent
```
scripts/feature_generator.py
```
- Feature list generation
```
scripts/environment_setup.py
```
- Init script creation
```
scripts/project_scaffold.py
```
- Project scaffolding