# Contributing to Awesome PM Skills

> Making world-class PM wisdom accessible through AI coding assistants

**The Lenny Collection** features 26 AI-powered skills built from [Lenny's Podcast](https://www.lennyspodcast.com/) transcripts, curated by [Udi Menkes](https://linkedin.com/in/udimenkes) at [GenAI PM](https://genaipm.com).

This open-source project transforms Claude Code and Cursor into world-class product management partners. Thank you for contributing! 🎉

## 📁 Project Structure

```
awesome-pm-skills/
├── README.md                    ← Main documentation
├── CONTRIBUTING.md              ← You are here
├── QUICKSTART.md                ← Getting started guide
├── SKILLS-INDEX.md              ← All 26 skills reference
├── LICENSE                      ← MIT License
├── images/                      ← Visual assets
│   ├── README.md               ← Image generation guide
│   ├── guests/                 ← Guest photos (to be added)
│   └── skills/                 ← Skill card images (to be added)
└── [skill-name]/               ← 26 skill folders
    └── SKILL.md                ← Individual skill details
```

## How Can I Contribute?

### 1. Report Issues
- Found a bug or error in a skill? Open an issue!
- Suggestion for improvement? We'd love to hear it!

### 2. Suggest New Skills
If you've found valuable insights from Lenny's Podcast that would make a great skill:
- Open an issue with the episode title and guest name
- Describe the framework or insight
- Explain how it would be used while building products

### 3. Improve Existing Skills
- Better examples
- Clearer explanations
- Additional frameworks from the same guest
- Code examples and templates

### 4. Share Your Experience
- Built something using these skills? Share it!
- "Skill stacks" for specific use cases
- Before/after examples
- Success stories

## Guidelines

### For New Skills
1. **Based on Lenny's Podcast** - Must be derived from actual episodes
2. **Actionable** - Claude/Cursor should be able to actively use it
3. **Well-Structured** - Follow the existing skill format:
   - When This Skill Activates
   - Core Frameworks
   - Decision Trees
   - Action Templates
   - Quick Reference
   - Real-World Examples
   - Key Quotes

### For Skill Improvements
1. **Credit the Source** - Always attribute to the original guest
2. **Be Specific** - Include concrete examples and patterns
3. **Stay Concise** - Skills should be scannable and actionable
4. **Test It** - Make sure it works in Claude/Cursor

## Skill Format Template

```markdown
---
name: skill-name
description: [When to use, what it does, who it's based on]
---

# Skill Title

## When This Skill Activates
Claude uses this skill when:
- [Trigger 1]
- [Trigger 2]

## Core Frameworks
### 1. Framework Name (Source: Guest Name)
[Description and how to apply]

## Action Templates
[Copy-paste formats]

## Quick Reference
[Checklist]

## Key Quotes
> "[Quote from guest]"
```

## Pull Request Process

1. Fork the repo
2. Create a branch (`git checkout -b feature/amazing-skill`)
3. Make your changes
4. Test the skill in Claude/Cursor
5. Commit with clear message
6. Push to your fork
7. Open a Pull Request

## Code of Conduct

### Our Standards
- Be respectful and inclusive
- Give credit where credit is due
- Focus on constructive feedback
- Help others learn and grow

### Attribution Requirements
- Always credit the podcast guest
- Link to the episode when possible
- Note the view count if available
- Respect intellectual property

## Questions?

- Open an issue in this repository
- Reach out to [@menkesu](https://x.com/menkesu) on X
- Connect with [Udi Menkes](https://linkedin.com/in/udimenkes) on LinkedIn

## License

By contributing, you agree that your contributions will be licensed under the MIT License.

---

Built with 💙 for the PM community, from the PM community.