skillrush-town

Category: Daily Life | Uploader: LearnPrompt | Downloads: 0 | Version: v1.0（Latest）

Use when building, maintaining, forking, or publishing Skillrush Town / 淘金小镇 Skill; tracking ClawHub Top100 downloads snapshots; generating daily Skill reports; evaluating ClawHub source changes; or packaging a public GitHub Pages skill radar.

Changelog: Source: GitHub https://github.com/LearnPrompt/skillrush-town

Directory Structure

Current level: tree/main/skills/skillrush-town/

📁 agents/
- 📄 openai.yaml 296 B
📁 references/
- 📄 publishing.md 836 B
- 📄 source-adapter-pattern.md 2.8 KB
- 📄 source-contract.md 1.2 KB
📄 SKILL.md 5.8 KB

SKILL.md

---
name: skillrush-town
description: "Use when building, maintaining, forking, or publishing Skillrush Town / 淘金小镇 Skill; tracking ClawHub Top100 downloads snapshots; generating daily Skill reports; evaluating ClawHub source changes; or packaging a public GitHub Pages skill radar."
---

# Skillrush Town

## First Reads

When this skill triggers inside the repo, read:

- `README.md` for product positioning and user paths.
- `scripts/clawhub_daily.py` before changing data generation.
- `data/dates.json` and the latest `data/snapshots/*.json` before changing the UI.
- `assets/app.js`, `assets/styles.css`, and `index.html` before changing the page.
- `references/source-contract.md` before changing ClawHub request semantics.
- `references/source-adapter-pattern.md` before adding changelog, model leaderboard,
  or any non-ClawHub monitoring source.
- `references/publishing.md` before changing GitHub Pages or Actions.

## Product Direction

Maintain three surfaces:

- **Public town board**: a phone-friendly GitHub Pages site where anyone can
  read the latest ClawHub Top100, growth lists, potential Skills, and history.
- **Forkable Skill generator**: a repo plus Skill that lets users generate their
  own Skill radar without copying private tokens or personal notes.
- **Source-monitoring workflow**: a repeatable pattern for turning public
  leaderboards, changelogs, and release pages into dated snapshots, diffs,
  reports, and optional Agent reminders.

Keep the default story simple: "每天从公开榜单和更新日志里淘出值得看的 AI 变化."
ClawHub Top100 is the first source because it is complex enough to prove the
workflow: runtime request, Convex path, cursor pagination, Top100 normalization,
historical diffs, reports, and a public board.

Do not position this as "just a webpage". The page is the town board; the Skill
is the workflow contract that lets future agents maintain and extend the town.

Good future source examples:

- Claude Code changelog: monitor dated release notes and new capabilities.
- Artificial Analysis model leaderboard: monitor model ranking, price, speed,
  and benchmark changes.
- Other public marketplaces or leaderboards with stable sort and pagination.

## First Run Usage

Installing this Skill only installs the workflow contract; it must not create
hidden scheduled jobs during installation.

For a one-off check, the user can say:

```text
Use skillrush-town to read latest.json and summarize today's ClawHub Top10 and potential Skills.
```

For a daily reminder in Hermes, create a cron job only when the user asks for it.
A good default is 10:00 Asia/Shanghai, after the GitHub Actions update window:

```text
Every day, read https://learnprompt.github.io/skillrush-town/data/latest.json,
summarize the snapshot date, Top10, potential Skills, limitations, and link to
https://learnprompt.github.io/skillrush-town/?date=<snapshot_date>.
```

Codex and Claude Code are usually task runners, not persistent reminder daemons.
For them, keep the repo forkable and use GitHub Actions, system cron, or Hermes
cron for notifications.

## Source Rules

### Default ClawHub Source

- The canonical ranking source is Convex `api/query`, path
  `skills:listPublicPageV4`.
- Request args must keep `sort=downloads`, `dir=desc`,
  `nonSuspiciousOnly=true`, `highlightedOnly=false`, `numItems=25`.
- Build Top100 by following `nextCursor` for 4 pages.
- Do not use `GET /api/v1/skills` as the primary ranking basis.
- If API fields, path, or pagination change, write the limitation into both
  snapshot and report.

### Adding New Sources

Before adding a changelog, model leaderboard, release feed, or any non-ClawHub
source, read `references/source-adapter-pattern.md` and create a source-specific
contract file:

```text
skills/skillrush-town/references/source-contract-<source>.md
```

Do not merge a new source adapter unless it has:

- a canonical URL or request contract
- stable item or entry keys
- snapshot schema
- diff semantics
- limitation handling
- headless tests with fixtures or mocked network responses

## Daily Report Rules

Every run must produce:

- `data/snapshots/YYYY-MM-DD.json`
- `data/reports/YYYY-MM-DD.md`
- `data/latest.json`
- `data/dates.json`

Reports must include new entries, dropped entries, Top10 changes, downloads
growth Top10, stars growth Top10, and potential Skills. If there is no potential
Skill, explicitly write `今日无新增潜力skill`.

Never describe the first run, migration run, or missing-history comparison as a
strict daily delta.

## Potential Skill Criteria

Include at most 10. A Skill qualifies if any condition is true:

- new Top100 entry
- download delta Top20 and star delta Top30
- rank rises by at least 8 places

Each potential Skill needs name, rank change, download/star delta, and one short
recommendation.

## Writing Style

For public README and release text, keep the town/gold-rush metaphor but avoid
AI-marketing boilerplate. Prefer concrete use cases over abstract claims. Do not
say "empower", "ecosystem flywheel", "comprehensive platform", or similar filler.

## Validate

### Required Headless Validation

These checks must work without Chrome, Playwright, Puppeteer, Camofox, Selenium,
or browser login state:

```bash
python -m py_compile scripts/clawhub_daily.py
python -m pytest -q
python "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" skills/skillrush-town
```

For a live ingestion check, write into a temporary data directory instead of
mutating committed data:

```bash
TMP=$(mktemp -d)
python scripts/clawhub_daily.py --date 2026-05-04 --data-dir "$TMP/data"
```

### Optional Browser / Manual Page Check

Only run this when a browser is available:

```bash
python3 -m http.server 8093
```

Open `http://127.0.0.1:8093/?date=2026-05-04` and verify the date selector,
Top10, limitation panel, potential Skill section, search, and Top100 table.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

skillrush-town

Directory Structure

SKILL.md

Report

Notice