# agent-readiness-cli — Awesome Lists для submission

**По committee Kashchei R3:** канал #3 J amplification. Цель: 50+ installs за 30 дней через viral discovery.

## Стасу делать: создать 5 GitHub PR (по 5-7 мин каждый)

### Top-5 Awesome Lists для submission

#### 1. awesome-cli-apps
- **Repo:** https://github.com/agarrharr/awesome-cli-apps
- **DR:** 80+, **Stars:** 17k+
- **Fork → Edit README → Add line to appropriate section** (most likely **«Productivity» или «Search»**):
  ```markdown
  - [agent-readiness-cli](https://github.com/sspoisk/agent-readiness-cli) - Score any URL for ChatGPT/Claude AI agent readiness (0-100). Pip install, MIT.
  ```
- **PR title:** `Add agent-readiness-cli to CLI tools`
- **PR body:**
  ```
  Adding a CLI I built that scores any public URL for "AI agent readiness" — how well ChatGPT/Claude/Perplexity can parse and use the page.
  
  - `pip install agent-readiness-cli`
  - MIT license, std-lib only, Python 3.10+
  - 13/13 tests passing
  - Available on PyPI: https://pypi.org/project/agent-readiness-cli/
  
  Fits this list because: standalone Python CLI, simple installation, single-purpose, no external dependencies.
  ```

---

#### 2. awesome-python
- **Repo:** https://github.com/vinta/awesome-python
- **DR:** 88+, **Stars:** 230k+ (top python list)
- **Section:** «Web Crawling» or «Web Frameworks» — most relevant
- **Line:**
  ```markdown
  - [agent-readiness-cli](https://github.com/sspoisk/agent-readiness-cli) - CLI for scoring URLs against AI agent (ChatGPT/Claude/Perplexity) readability criteria. Std-lib only.
  ```
- **PR title:** `Add agent-readiness-cli to Web Crawling`

---

#### 3. awesome-seo
- **Repo:** https://github.com/marcobiedermann/search-engine-optimization
- **DR:** 70+, **Stars:** 9k+
- **Section:** «Tools» или «Resources»
- **Line:**
  ```markdown
  - [agent-readiness-cli](https://github.com/sspoisk/agent-readiness-cli) - Score sites for AI agent (ChatGPT/Claude) readability — emerging SEO factor in 2026.
  ```
- **PR title:** `Add agent-readiness-cli — AI agent SEO scoring tool`
- **Angle:** AI search (GEO/AEO) — это новый SEO frontier 2026.

---

#### 4. awesome-llm
- **Repo:** https://github.com/Hannibal046/Awesome-LLM
- **DR:** 70+, **Stars:** 25k+
- **Section:** «LLM Tools» или «Evaluation»
- **Line:**
  ```markdown
  - [agent-readiness-cli](https://github.com/sspoisk/agent-readiness-cli) - Score URLs against LLM agent readability criteria (canonical, hreflang, structured data, content density).
  ```
- **PR title:** `Add agent-readiness-cli — LLM agent URL readability scorer`

---

#### 5. awesome-developer-tools
- **Repo:** https://github.com/jondot/awesome-devenv (или подобный general dev tools list)
- **Section:** «Audit Tools»
- **Line:**
  ```markdown
  - [agent-readiness-cli](https://github.com/sspoisk/agent-readiness-cli) - Pre-deploy check: is your site AI-agent ready? Pip install, MIT.
  ```

---

## Дополнительно (если время):

### 6. llms-txt-hub (TheDavidDias 830 stars)
- **Repo:** https://github.com/TheDavidDias/llms-txt-hub
- Это **наш natural fit** — list of sites with llms.txt support. Наш CLI проверяет llms.txt as one of criteria.
- **PR:** add agent-readiness-cli к **«Tools»** section

### 7. HN Show submit retry — после 22.05
- 14-дневное age account requirement
- URL ready: https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fgithub.com%2Fsspoisk%2Fagent-readiness-cli&t=Show+HN%3A+Agent-readiness-cli+%E2%80%93+score+any+URL+for+ChatGPT%2FClaude+readiness

---

## Цель / Acceptance
- 5 PR submitted в течение недели
- Tracking: github.com/sspoisk/agent-readiness-cli/stargazers — стартовая baseline (today)
- Через 30 дней — измерить stars, downloads на PyPI, traffic из Awesome lists

## Tip
Используй ConventionalPRTemplate если есть. На awesome lists главный критерий — **MAINTAINED, PRODUCTION-READY, UNIQUE PURPOSE**. У нас все 3 — emphasize в PR description.