mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-02-03 21:23:10 +08:00
New commands: - /skill-create: Local git history analysis to generate SKILL.md files - /instinct-status: Show learned instincts with confidence levels - /instinct-import: Import instincts from files or repos - /instinct-export: Export instincts for sharing - /evolve: Cluster instincts into skills/commands/agents These integrate the continuous-learning-v2 system and provide a local alternative to the Skill Creator GitHub App for pattern extraction.
175 lines
4.4 KiB
Markdown
175 lines
4.4 KiB
Markdown
---
|
|
name: skill-create
|
|
description: Analyze local git history to extract coding patterns and generate SKILL.md files. Local version of the Skill Creator GitHub App.
|
|
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
|
|
---
|
|
|
|
# /skill-create - Local Skill Generation
|
|
|
|
Analyze your repository's git history to extract coding patterns and generate SKILL.md files that teach Claude your team's practices.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
/skill-create # Analyze current repo
|
|
/skill-create --commits 100 # Analyze last 100 commits
|
|
/skill-create --output ./skills # Custom output directory
|
|
/skill-create --instincts # Also generate instincts for continuous-learning-v2
|
|
```
|
|
|
|
## What It Does
|
|
|
|
1. **Parses Git History** - Analyzes commits, file changes, and patterns
|
|
2. **Detects Patterns** - Identifies recurring workflows and conventions
|
|
3. **Generates SKILL.md** - Creates valid Claude Code skill files
|
|
4. **Optionally Creates Instincts** - For the continuous-learning-v2 system
|
|
|
|
## Analysis Steps
|
|
|
|
### Step 1: Gather Git Data
|
|
|
|
```bash
|
|
# Get recent commits with file changes
|
|
git log --oneline -n ${COMMITS:-200} --name-only --pretty=format:"%H|%s|%ad" --date=short
|
|
|
|
# Get commit frequency by file
|
|
git log --oneline -n 200 --name-only | grep -v "^$" | grep -v "^[a-f0-9]" | sort | uniq -c | sort -rn | head -20
|
|
|
|
# Get commit message patterns
|
|
git log --oneline -n 200 | cut -d' ' -f2- | head -50
|
|
```
|
|
|
|
### Step 2: Detect Patterns
|
|
|
|
Look for these pattern types:
|
|
|
|
| Pattern | Detection Method |
|
|
|---------|-----------------|
|
|
| **Commit conventions** | Regex on commit messages (feat:, fix:, chore:) |
|
|
| **File co-changes** | Files that always change together |
|
|
| **Workflow sequences** | Repeated file change patterns |
|
|
| **Architecture** | Folder structure and naming conventions |
|
|
| **Testing patterns** | Test file locations, naming, coverage |
|
|
|
|
### Step 3: Generate SKILL.md
|
|
|
|
Output format:
|
|
|
|
```markdown
|
|
---
|
|
name: {repo-name}-patterns
|
|
description: Coding patterns extracted from {repo-name}
|
|
version: 1.0.0
|
|
source: local-git-analysis
|
|
analyzed_commits: {count}
|
|
---
|
|
|
|
# {Repo Name} Patterns
|
|
|
|
## Commit Conventions
|
|
{detected commit message patterns}
|
|
|
|
## Code Architecture
|
|
{detected folder structure and organization}
|
|
|
|
## Workflows
|
|
{detected repeating file change patterns}
|
|
|
|
## Testing Patterns
|
|
{detected test conventions}
|
|
```
|
|
|
|
### Step 4: Generate Instincts (if --instincts)
|
|
|
|
For continuous-learning-v2 integration:
|
|
|
|
```yaml
|
|
---
|
|
id: {repo}-commit-convention
|
|
trigger: "when writing a commit message"
|
|
confidence: 0.8
|
|
domain: git
|
|
source: local-repo-analysis
|
|
---
|
|
|
|
# Use Conventional Commits
|
|
|
|
## Action
|
|
Prefix commits with: feat:, fix:, chore:, docs:, test:, refactor:
|
|
|
|
## Evidence
|
|
- Analyzed {n} commits
|
|
- {percentage}% follow conventional commit format
|
|
```
|
|
|
|
## Example Output
|
|
|
|
Running `/skill-create` on a TypeScript project might produce:
|
|
|
|
```markdown
|
|
---
|
|
name: my-app-patterns
|
|
description: Coding patterns from my-app repository
|
|
version: 1.0.0
|
|
source: local-git-analysis
|
|
analyzed_commits: 150
|
|
---
|
|
|
|
# My App Patterns
|
|
|
|
## Commit Conventions
|
|
|
|
This project uses **conventional commits**:
|
|
- `feat:` - New features
|
|
- `fix:` - Bug fixes
|
|
- `chore:` - Maintenance tasks
|
|
- `docs:` - Documentation updates
|
|
|
|
## Code Architecture
|
|
|
|
```
|
|
src/
|
|
├── components/ # React components (PascalCase.tsx)
|
|
├── hooks/ # Custom hooks (use*.ts)
|
|
├── utils/ # Utility functions
|
|
├── types/ # TypeScript type definitions
|
|
└── services/ # API and external services
|
|
```
|
|
|
|
## Workflows
|
|
|
|
### Adding a New Component
|
|
1. Create `src/components/ComponentName.tsx`
|
|
2. Add tests in `src/components/__tests__/ComponentName.test.tsx`
|
|
3. Export from `src/components/index.ts`
|
|
|
|
### Database Migration
|
|
1. Modify `src/db/schema.ts`
|
|
2. Run `pnpm db:generate`
|
|
3. Run `pnpm db:migrate`
|
|
|
|
## Testing Patterns
|
|
|
|
- Test files: `__tests__/` directories or `.test.ts` suffix
|
|
- Coverage target: 80%+
|
|
- Framework: Vitest
|
|
```
|
|
|
|
## GitHub App Integration
|
|
|
|
For advanced features (10k+ commits, team sharing, auto-PRs), use the [Skill Creator GitHub App](https://github.com/apps/skill-creator):
|
|
|
|
- Install: [github.com/apps/skill-creator](https://github.com/apps/skill-creator)
|
|
- Comment `/skill-creator analyze` on any issue
|
|
- Receives PR with generated skills
|
|
|
|
## Related Commands
|
|
|
|
- `/instinct-import` - Import generated instincts
|
|
- `/instinct-status` - View learned instincts
|
|
- `/evolve` - Cluster instincts into skills/agents
|
|
|
|
---
|
|
|
|
*Part of [Everything Claude Code](https://github.com/affaan-m/everything-claude-code)*
|