Skip to main content

​
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:
  1. Scans git history (last 1000 commits by default)
  2. Groups commits by pattern
  3. Extracts common practices
  4. 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

  1. Visit github.com/apps/skill-creator
  2. Click “Install”
  3. Select repositories to analyze
  4. 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
}
SettingDefaultDescription
exclude[]File patterns to ignore
minCommits5Minimum commits to consider a pattern
minConfidence0.7Minimum confidence score (0-1)
outputPath.claude/skills/project-patterns/Where to save generated skills
generateInstinctsfalseAlso 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

TierPriceFeatures
Free$01 repo, 1k commits, manual trigger
Pro$10/mo10 repos, 10k commits, auto-trigger, instincts
Enterprise$100/moUnlimited 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

​
Share with Team

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:
  1. Lower minCommits in .skillcreator.json
  2. Increase commit range: /skill-create --range 5000
  3. Check exclude patterns aren’t too broad

​
”Low confidence scores”

Cause: Inconsistent patterns in codebase. Fix:
  1. Focus on specific directory: /skill-create --path src/core
  2. Lower minConfidence threshold
  3. Refactor codebase for consistency

​
”GitHub App not creating PR”

Cause: Permissions or configuration issue. Fix:
  1. Check app has write permissions
  2. Ensure default branch is protected properly
  3. Check webhook delivery in GitHub settings