GitHub App

​

Overview

​

Features

​

Automated Skill Creation

• Push to default branch (auto-analyzes new commits)
• Comment /skill-creator analyze on any issue
• Manual trigger via web dashboard

• Creates PR with generated skills in .claude/skills/
• Includes instincts for continuous-learning-v2
• Posts summary with confidence scores and evidence

​

Team Collaboration

• Shared skills across team via git
• Auto-PR workflow for skill updates
• Skill versioning with git history
• Team dashboard at ecc.tools

​

Repository Insights

• Pattern detection from commit history (10k+ commits)
• Coding standards extraction
• Architecture visualization (coming soon)
• Team velocity metrics (Pro tier)

​

Installation

​

1. Install GitHub App

​

2. Select Repositories

• All repositories (recommended for teams)
• Selected repositories (for specific projects)

​

3. Grant Permissions

• Contents: Read-only (to analyze commits)
• Issues: Write (to post analysis results)
• Pull requests: Write (to create skill PRs)
• Metadata: Read (repository info)

​

4. Configure Tier

​

Usage

​

Automatic Analysis (Pro/Enterprise)

1. App analyzes new commits
2. Updates skill patterns
3. Creates PR if patterns changed
4. Posts summary as PR description

## Skill Update: project-patterns

### New Patterns Detected
- Error handling with custom error classes (15 commits)
- Zod validation for API endpoints (12 commits)
- React Query for data fetching (8 commits)

### Confidence Scores
- use-zod-validation: 0.92
- use-react-query: 0.88
- custom-error-classes: 0.85

### Evidence
- [abc123] feat: add Zod validation to auth endpoints
- [def456] refactor: migrate to React Query
...

​

Manual Trigger (All Tiers)

/skill-creator analyze

1. Analyze repository
2. Create issue comment with results
3. Optionally create PR (Pro/Enterprise)

​

Web Dashboard (Pro/Enterprise)

• View all analyzed repositories
• Trigger manual analysis
• Download generated skills
• Manage team members
• View pattern trends over time

​

Configuration

​

Repository Settings

# Skill generation settings
skills:
  enabled: true
  outputPath: .claude/skills/project-patterns/
  minCommits: 5
  minConfidence: 0.7
  
# Exclude patterns
exclude:
  - node_modules/**
  - test/**
  - "*.test.ts"
  
# Auto-PR settings (Pro/Enterprise)
autoPR:
  enabled: true
  branch: main
  reviewers:
    - username1
    - username2
  labels:
    - ecc-skills
    - automated

# Instincts (Pro/Enterprise)
instincts:
  enabled: true
  outputPath: .claude/skills/project-patterns/instincts.json

​

Global Settings (ecc.tools)

• Default branch: Which branch to analyze
• Analysis frequency: On every push / daily / weekly
• Notification preferences: Email, Slack, Discord
• Team members: Grant access to organization members

​

Webhook Events

​

Output Structure

.claude/skills/project-patterns/
  ├── SKILL.md              # Main skill file
  ├── instincts.json        # Instincts for continuous-learning-v2
  └── metadata.json         # Analysis metadata

​

SKILL.md Format

---
name: project-patterns
description: Patterns from username/repo (generated by Skill Creator)
origin: Skill Creator
generated: 2026-03-03T12:00:00Z
commits: 1250
---

# Project Patterns

Automatically extracted patterns from 1,250 commits.

## Error Handling

[Pattern 1]
[Pattern 2]
...

​

instincts.json Format

{
  "generated": "2026-03-03T12:00:00Z",
  "commits": 1250,
  "instincts": [
    {
      "id": "use-zod-validation",
      "trigger": "Creating API endpoints",
      "action": "Use Zod for request validation",
      "confidence": 0.92,
      "evidence": [
        {"commit": "abc123", "message": "feat: add Zod validation"},
        {"commit": "def456", "message": "refactor: validate with Zod"}
      ]
    }
  ]
}

​

Security & Privacy

​

Data Access

• Read-only access to repository contents
• No code storage — analysis happens in-memory
• No external data sharing — results stay in your GitHub

​

Permissions

• ✅ Contents (read): Analyze commit history
• ✅ Issues (write): Post analysis results
• ✅ Pull requests (write): Create skill PRs
• ✅ Metadata (read): Repository info
• ❌ No secrets access
• ❌ No deploy key access
• ❌ No organization member access

​

Audit Log

Settings > Security > Audit log

​

Troubleshooting

​

”No PR created after analysis”

• Upgrade to Pro/Enterprise for auto-PRs
• Check if patterns changed since last analysis
• Lower minConfidence in .github/ecc-tools.yml

​

”Analysis taking too long”

• Use Pro/Enterprise tier (optimized for large repos)
• Reduce commit range in config
• Exclude test directories

​

”Webhook not triggering”

1. Check webhook deliveries: Settings > Webhooks > ecc-tools
2. Re-deliver failed webhooks
3. Verify app has correct permissions

​

Support

• Free tier: GitHub Issues only
• Pro tier: Email support (48h response)
• Enterprise tier: Priority support (4h response) + Slack/Discord

​

Related Resources

• Skill Creator Reference
• Continuous Learning v2
• GitHub: ecc-tools
• ecc.tools