Skill Creator

Overview

Skill Creator analyzes your git commit history to extract coding patterns and generate reusable SKILL.md files. Available as a local command or GitHub App.

Two Ways to Use

Option A: Local Analysis (Built-in)

Use the /skill-create command for local analysis without external services:

/skill-create                    # Analyze current repo
/skill-create --instincts        # Also generate instincts for continuous-learning

Capabilities:

Analyzes local git history (no repo size limit)
Generates SKILL.md files
Extracts instincts for continuous-learning-v2
Works offline
No installation required (built into ECC)

Option B: GitHub App (Advanced)

For advanced features (10k+ commits, auto-PRs, team sharing): Install: github.com/apps/skill-creator | ecc.tools

# Comment on any issue:
/skill-creator analyze

# Or auto-triggers on push to default branch

Additional capabilities:

Handles massive repos (10k+ commits)
Creates PRs with generated skills automatically
Team skill sharing via GitHub
Continuous updates on new commits
Web dashboard at ecc.tools

What Gets Generated

Both options create:

1. SKILL.md Files

Ready-to-use skills for Claude Code:

---
name: your-project-patterns
description: Patterns extracted from your-project repository
origin: Skill Creator
---

# Your Project Patterns

## Core Principles

[Extracted from commit messages and code changes]

## Common Patterns

### Error Handling
[Pattern 1 from commits]
[Pattern 2 from commits]

### State Management
[Pattern 3 from commits]

...

2. Instinct Collections

For continuous-learning-v2:

{
  "instincts": [
    {
      "id": "use-zod-validation",
      "trigger": "Creating API endpoints",
      "action": "Use Zod for request validation",
      "confidence": 0.92,
      "evidence": ["commit abc123", "commit def456"]
    }
  ]
}

3. Pattern Extraction

Learns from your commit history:

Naming conventions
File organization
Error handling approaches
Testing patterns
Code review patterns
Architecture decisions

Local Command Usage

Basic Analysis

/skill-create

This:

Scans git history (last 1000 commits by default)
Groups commits by pattern
Extracts common practices
Generates .claude/skills/project-patterns/SKILL.md

With Instincts

/skill-create --instincts

Additionally generates:

Instinct definitions in ~/.claude/homunculus/instincts/
Confidence scores based on frequency
Evidence trails (commit hashes)

Custom Commit Range

/skill-create --range 5000

Analyzes last 5000 commits instead of default 1000.

Specific Directory

/skill-create --path src/api

Analyzes only commits affecting src/api directory.

GitHub App Usage

Installation

Visit github.com/apps/skill-creator
Click “Install”
Select repositories to analyze
Grant required permissions (read-only)

Triggering Analysis

Manual trigger (comment on issue):

/skill-creator analyze

Automatic trigger:

Push to default branch → auto-analyzes new commits
Creates PR with updated skills
Posts summary as issue comment

GitHub App Output

Creates a PR with:

.claude/skills/your-repo-patterns/
  ├── SKILL.md
  └── instincts.json

PR includes:

Summary of patterns found
Confidence scores
Commit evidence links

Configuration

`.skillcreator.json`

Customize analysis:

{
  "exclude": [
    "node_modules/**",
    "test/**",
    "*.test.ts"
  ],
  "minCommits": 5,
  "minConfidence": 0.7,
  "outputPath": ".claude/skills/custom-patterns/",
  "generateInstincts": true
}

Setting	Default	Description
`exclude`	`[]`	File patterns to ignore
`minCommits`	5	Minimum commits to consider a pattern
`minConfidence`	0.7	Minimum confidence score (0-1)
`outputPath`	`.claude/skills/project-patterns/`	Where to save generated skills
`generateInstincts`	false	Also generate instincts

Pattern Types Detected

Code Patterns

Error Handling: Try/catch patterns, error types, logging
State Management: Redux, Zustand, Context patterns
API Design: REST patterns, validation, response formats
Testing: Test structure, mocking patterns, coverage

Organizational Patterns

File Structure: Directory organization, naming conventions
Import Patterns: Relative vs absolute, barrel exports
Architecture: Layering, separation of concerns

Process Patterns

Commit Messages: Conventional commits, semantic versioning
Code Review: Common feedback patterns
Refactoring: Extract method, rename, consolidate

GitHub App Tiers

Tier	Price	Features
Free	$0	1 repo, 1k commits, manual trigger
Pro	$10/mo	10 repos, 10k commits, auto-trigger, instincts
Enterprise	$100/mo	Unlimited repos/commits, team sharing, API access

Visit ecc.tools for details.

Using Generated Skills

Load in Claude Code

Generated skills are automatically detected:

# Skills are in .claude/skills/project-patterns/
# Claude Code loads them automatically

Commit to repo:

git add .claude/skills/
git commit -m "Add project-specific patterns"
git push

Team members get skills when they clone/pull. Or use GitHub App for auto-PRs and team sync.

Update Over Time

Re-run /skill-create periodically:

# Every few weeks or after major refactoring
/skill-create --instincts

This keeps skills current with evolving patterns.

Troubleshooting

”No patterns found”

Cause: Not enough commits or too restrictive config. Fix:

Lower minCommits in .skillcreator.json
Increase commit range: /skill-create --range 5000
Check exclude patterns aren’t too broad

”Low confidence scores”

Cause: Inconsistent patterns in codebase. Fix:

Focus on specific directory: /skill-create --path src/core
Lower minConfidence threshold
Refactor codebase for consistency

”GitHub App not creating PR”

Cause: Permissions or configuration issue. Fix:

Check app has write permissions
Ensure default branch is protected properly
Check webhook delivery in GitHub settings

Configuration

Ecosystem

Migration & Troubleshooting

Community

Overview

Two Ways to Use

Option A: Local Analysis (Built-in)

Option B: GitHub App (Advanced)

What Gets Generated

1. SKILL.md Files

2. Instinct Collections

3. Pattern Extraction

Local Command Usage

Basic Analysis

With Instincts

Custom Commit Range

Specific Directory

GitHub App Usage

Installation

Triggering Analysis

GitHub App Output

Configuration

`.skillcreator.json`

Pattern Types Detected

Code Patterns

Organizational Patterns

Process Patterns

GitHub App Tiers

Using Generated Skills

Load in Claude Code

Update Over Time

Troubleshooting

”No patterns found”

”Low confidence scores”

”GitHub App not creating PR”

​Overview

​Two Ways to Use

​Option A: Local Analysis (Built-in)

​Option B: GitHub App (Advanced)

​What Gets Generated

​1. SKILL.md Files

​2. Instinct Collections

​3. Pattern Extraction

​Local Command Usage

​Basic Analysis

​With Instincts

​Custom Commit Range

​Specific Directory

​GitHub App Usage

​Installation

​Triggering Analysis

​GitHub App Output

​Configuration

​.skillcreator.json

​Pattern Types Detected

​Code Patterns

​Organizational Patterns

​Process Patterns

​GitHub App Tiers

​Using Generated Skills

​Load in Claude Code

​Share with Team

​Update Over Time

​Troubleshooting

​”No patterns found”

​”Low confidence scores”

​”GitHub App not creating PR”

​Related Resources

Overview

Two Ways to Use

Option A: Local Analysis (Built-in)

Option B: GitHub App (Advanced)

What Gets Generated

1. SKILL.md Files

2. Instinct Collections

3. Pattern Extraction

Local Command Usage

Basic Analysis

With Instincts

Custom Commit Range

Specific Directory

GitHub App Usage

Installation

Triggering Analysis

GitHub App Output

Configuration

`.skillcreator.json`

Pattern Types Detected

Code Patterns

Organizational Patterns

Process Patterns

GitHub App Tiers

Using Generated Skills

Load in Claude Code

Share with Team

Update Over Time

Troubleshooting

”No patterns found”

”Low confidence scores”

”GitHub App not creating PR”

Related Resources