majiayu000 Engram Generate
Generate project-specific skills by analyzing Claude Code session history.
When to Use
- Starting work on a codebase you've worked on before
- Onboarding to a project (after initial exploration sessions)
- Periodically to capture evolving conventions
- Before handing off a project to another agent
Workflow
Step 1: Generate a skill from history
npx engram generate-skill --workspace . --days 30
This analyzes your Claude Code sessions and generates a SKILL.md encoding:
- Files that are frequently edited together
- Test and build commands used
- Common tool sequences
- Error patterns and their fixes
Step 2: Review the generated skill
The skill is created in generated-skills/<project>-conventions/SKILL.md.
Review it for accuracy:
- Remove any sensitive information
- Correct any misidentified patterns
- Add missing conventions you know about
Step 3: Install the skill
# Copy to your skills directory
cp -r generated-skills/<project>-conventions ~/.claude/skills/
# Or use the skills CLI
skills add ./generated-skills/<project>-conventions
Step 4: Keep it updated
Re-run periodically (e.g., monthly) to capture new patterns:
npx engram generate-skill --workspace . --days 30 --update
Integration with Skills CLI
Use with skills sync to keep generated skills up to date:
# Add engram as a skill source
skills source add https://github.com/bobamatcha/engram
# Sync skills from engram
skills sync engram-recall engram-generate
Output
The generated skill includes:
| Section | What It Contains |
|---|---|
| Files Often Changed Together | File co-edit patterns |
| Testing | Test commands used in this project |
| Building | Build/compile commands |
| Common Workflows | Frequent tool sequences |
| Common Issues | Error patterns and fixes |
Integration with Other Skills
| Skill | When to Combine |
|---|---|
| engram-recall | Use recall before generate to review history |
| describe-codebase | Generate after describing to capture conventions |
| project-init | Generate skill after initial project setup |
Example Output
# myproject Conventions
## Files Often Changed Together
- `src/index.ts` → also check: `src/types.ts`, `tests/index.test.ts`
## Testing
```bash
npm test
npm run test:watch
Common Workflows
- Read → Edit → Bash (used 15x)
- Write → Bash → Read (used 8x)
## Important
- Generated skills are starting points — refine them
- Don't include sensitive paths or credentials
- Update skills when project structure changes significantly