# Awesome Lists Submission Issues

This directory contains draft issue content for submitting pm-skills to various awesome lists and curated repositories.

## Purpose

Each file contains a complete GitHub issue for tracking a submission to a specific awesome list repository. These issues help manage the submission process, track status, and maintain tailored messaging for each target audience.

## How to Use

### Automated Issue Creation (Recommended) 🤖

**Use the GitHub Actions workflow to automatically create issues from all draft files:**

1. **Navigate to Actions:** Go to https://github.com/product-on-purpose/pm-skills/actions
2. **Select workflow:** Click "Create Issues from Drafts"
3. **Run workflow:** Click "Run workflow" button
4. **Choose mode:**
   - **Dry Run (default):** Preview what would happen without creating issues
   - **Live Mode:** Uncheck "Dry run mode" to actually create issues

The workflow will:
- ✓ Create GitHub issues from all unprocessed draft files
- ✓ Update the planning tracker with issue numbers
- ✓ Archive processed files to `.github/issues-archive/`
- ✓ Track state in `.github/.created-issues.json` (idempotent)

**See [WORKFLOW-GUIDE.md](./WORKFLOW-GUIDE.md) for complete documentation.**

### Manual Issue Creation (Legacy)

If you prefer to create issues manually:

1. **Navigate to pm-skills Issues:** Go to https://github.com/product-on-purpose/pm-skills/issues/new
2. **Copy issue content:** Open the relevant draft file (e.g., `01-travisvn-awesome-claude-skills.md`)
3. **Create new issue:** 
   - Copy the frontmatter title to the issue title
   - Copy the body content to the issue description
   - Apply the labels specified in frontmatter
4. **Track in TRACKER.md:** Update `TRACKER.md` with issue number and status

### File Naming Convention

Files are numbered and named by priority and repository:
- `01-04` - Claude Skills focused lists (Priority 1)
- `05-08` - Product Management lists (Priority 1)
- `09-13` - AI agents/LLM lists (Priority 2)
- `14-15` - Prompting/LLM directories (Priority 3)
- `16-18` - Adjacent work methods lists (Priority 4)

### Priority Recommendations

**Start with Priority 1 (Files 01-08):**
- Most aligned audiences
- Highest likelihood of acceptance
- Best visibility for target users

**Priority 2 (Files 09-13):**
- Good reach but positioning matters
- Research repository scope before submitting
- Some marked with ⚠️ caution flags

**Priority 3-4 (Files 14-18):**
- Secondary audiences
- May require research or adaptation
- Some likely to skip based on fit

## Files

### Issue Template
- `awesome-list-submission.md` - Generic template for any awesome list submission

### Claude Skills Lists
- `01-travisvn-awesome-claude-skills.md` - Widely-starred Claude Skills directory
- `02-BehiSecc-awesome-claude-skills.md` - Has "Collaboration & PM" category - perfect fit
- `03-VoltAgent-awesome-claude-skills.md` - Claude Skills ecosystem reach
- `04-karanb192-awesome-claude-skills.md` - May accept meta repos/frameworks

### Product Management Lists
- `05-prakashsellathurai-awesome-product-management.md` - Broad PM resource list
- `06-hugo53-awesome-ProductManager.md` - "Books, tools, resources for PMs"
- `07-yuhenobi-awesome-product-manager.md` - Similar audience, additional distribution
- `08-rajavijayach-awesome-product-management.md` - Smaller PM directory

### AI Agents / LLM Lists
- `09-kyrolabs-awesome-agents.md` - Frame as "agent-ready workflows"
- `10-e2b-dev-awesome-ai-agents.md` - Major directory, positioning critical
- `11-Shubhamsaboo-awesome-llm-apps.md` - Repeatable LLM workflow patterns
- `12-jamesmurdza-awesome-ai-devtools.md` - AI tooling for builders
- `13-tensorchord-Awesome-LLMOps.md` - ⚠️ LLMOps - submit only if credible fit

### Prompting / LLM Directories
- `14-f-awesome-chatgpt-prompts.md` - ⚠️ Prompts-heavy, may need bridge content
- `15-Hannibal046-Awesome-LLM.md` - ⚠️ Academic/technical focus

### Adjacent Work Methods
- `16-domenicosolazzo-awesome-okr.md` - OKR resources, if pm-skills OKR content strong
- `17-eivindml-awesome-productivity.md` - Productivity systems
- `18-GetStream-awesome-saas-services.md` - ⚠️ Likely skip - not a SaaS service

### Tracking
- `TRACKER.md` - Master submission tracker with status for all repositories

## Submission Workflow

### 1. Research Phase
- [ ] Review target repository structure
- [ ] Read contribution guidelines  
- [ ] Check for existing pm-skills entry
- [ ] Confirm pm-skills fits scope
- [ ] Review existing entries for format

### 2. Issue Creation
- [ ] Create GitHub issue from draft content
- [ ] Apply appropriate labels
- [ ] Update TRACKER.md with issue number

### 3. Submission Phase
- [ ] Fork target repository
- [ ] Create branch for submission
- [ ] Add pm-skills entry following their format
- [ ] Submit PR with tailored description
- [ ] Link PR in tracking issue

### 4. Follow-up Phase
- [ ] Respond to maintainer feedback
- [ ] Make requested changes
- [ ] Update TRACKER.md with status
- [ ] Close issue when merged/rejected

## Key Messaging Guidelines

### Tailor to Audience
Each issue contains tailored messaging for its specific audience:
- **Claude Skills lists:** Emphasize skill collection, Agent Skills Spec compliance
- **PM lists:** Focus on practical utility, proven frameworks
- **AI/LLM lists:** Frame as systematic patterns, agent-ready workflows
- **Productivity lists:** Highlight efficiency gains, time savings

### Avoid Generic Pitches
Curators are allergic to generic plugs. Each submission should:
- Reference specific sections where pm-skills fits
- Explain how it fills a gap in their list
- Use language/framing matching their repository's vibe
- Be concise and value-focused

### Quality Over Quantity
Better to submit to 8 perfectly-targeted lists than 18 shotgun submissions. Prioritize:
1. Best audience fit
2. Clear positioning
3. Helpful addition to their list

## Questions?

For questions about:
- **Submission strategy:** Review TRACKER.md notes
- **Messaging:** Check individual issue files for tailored content
- **Process:** See contribution guidelines in each target repository

## Maintenance

This directory and content created: 2026-01-20

Update TRACKER.md as submissions progress through research → submission → merged/rejected stages.
