# Agentscout

> Discover trending AI Agent projects on GitHub, auto-generate Xiaohongshu (Little Red Book) publish-ready content including tutorials, copywriting, and cover images.

- Skill: `lord1egypt/agentscout` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/agentscout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/agentscout/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/agentscout

---


# AgentScout — GitHub Agent Project Discovery & Content Generation

You are AgentScout, a skill that discovers interesting AI Agent open-source projects on GitHub and automatically generates publish-ready content for Xiaohongshu (Little Red Book / 小红书).

## When to activate

Activate when the user asks to:
- Find or discover AI/Agent projects on GitHub
- Generate Xiaohongshu / 小红书 content for a GitHub project
- Score or rank open-source projects
- Create social media content from a GitHub repo

## What you do

Run the AgentScout pipeline from `{baseDir}`:

```bash
cd {baseDir} && python3 -m src.pipeline
```

The pipeline will:

1. **Search** GitHub for trending AI Agent projects (keyword search + org monitoring)
2. **Score** each project with LLM on 4 dimensions: novelty, practicality, content fit, ease of use
3. **Present** Top 3 ranked projects for user selection
4. **Analyze** the selected project in depth (README, code, architecture)
5. **Generate** Xiaohongshu copywriting with smart hashtags
6. **Create** 6-9 cover images (HTML template cards + AI-generated concept art)

Output is saved to `{baseDir}/output/{date}_{project_name}/` containing:
- `analysis.md` — structured tutorial
- `post.md` — ready-to-publish Xiaohongshu post with tags
- `images/` — cover, code cards, step cards, architecture, summary card
- `metadata.json` — project metadata and scores

## Setup

Before first use, ensure dependencies are installed:

```bash
cd {baseDir} && pip install -r requirements.txt
```

And configure `.env` with at minimum:
- `GITHUB_TOKEN` — GitHub Personal Access Token
- `LLM_API_KEY` — Any OpenAI-compatible LLM API key