CtrlK
BlogDocsLog inGet started
Tessl Logo

bestblogs-discover

Use this skill when the user wants to find today's most worth-reading content from BestBlogs, browse personalized feeds, check trending items, search specific topics, or explore curated newsletters. Triggers include "今天有什么值得读的 / BestBlogs 推荐 / 本周 BestBlogs 热趋 / 搜一下 AI coding / 看关注源的最新 / 最近有什么好周刊", "what's worth reading today", "bestblogs trending this week", "bestblogs discover", "search BestBlogs". Invokes the `bestblogs` CLI.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

bestblogs-discover — 发现（今日 / 个性化 / 关注流 / 热趋 / 搜索 / 周刊）

何时使用

  • 用户想快速了解 "今天最值得读的内容"（最重要触发）。
  • 用户想找某个主题、作者、内容类型的 BestBlogs 精选。
  • 用户想浏览周刊。

原语

原语CLI说明
bestblogs.discover.todaybestblogs discover today --json带多源回退链的今日候选
bestblogs.discover.for_youbestblogs discover for-you --json个性化推荐（需 Pro）
bestblogs.discover.followingbestblogs discover following --json关注源流
bestblogs.discover.trendingbestblogs discover trending --period week --json热趋内容（today / week / month）
bestblogs.discover.searchbestblogs discover search "<q>" --json关键词搜索
bestblogs.discover.newsletter.listbestblogs discover newsletters --json周刊列表
bestblogs.discover.newsletter.getbestblogs discover newsletter <id> --json单期周刊

前置检查

bestblogs auth status --json

多数命令需要 API Key；search、newsletters 在某些配置下也可匿名消费。若未登录，提示先 bestblogs auth login。

核心动作：discover today

bestblogs discover today --limit 20 --json

返回：

{
  "success": true,
  "data": {
    "candidates": [
      {
        "resourceId": "RAW_xxx",
        "title": "...",
        "url": "...",
        "resourceType": "ARTICLE",
        "language": "en_US",
        "score": 92,
        "sourceName": "...",
        "candidateSource": "my_brief",
        "selectionReason": "今日个性化精选",
        "fallbackApplied": false,
        "personalized": true
      }
    ],
    "primarySource": "my_brief",
    "fallbackApplied": false,
    "details": { "triedSources": ["my_brief", "for_you"] }
  }
}

candidateSource 枚举：

  • my_brief — Pro 个性化早报
  • public_brief — 公共精选（非 Pro 或未生成个性化时）
  • public_brief_fallback — 公共早报降级兜底
  • for_you — For You 推荐
  • following — 关注源

展示给用户时应按 candidateSource 打徽标，并显式标注降级状态（fallbackApplied=true 时）。

其它动作

# 个性化流
bestblogs discover for-you --limit 15 --lang en_US --json

# 热趋（今日 / 本周 / 本月）
bestblogs discover trending --period week --limit 20 --json
bestblogs discover trending --period today --lang zh_CN --json

# 搜索
bestblogs discover search "AI coding" --type ARTICLE --sort score --limit 10 --json

# 周刊
bestblogs discover newsletters --limit 10 --json
bestblogs discover newsletter <id> --json

错误处理

  • 403 / FORBIDDEN on for-you → 用户非 Pro，降级到 following 或 today
  • 404 / NOT_FOUND on brief 相关 → 当日早报尚未生成，尝试 public_brief 或 following
  • 429 / RATE_LIMITED → CLI 已退避一次；仍失败时退出并告诉用户稍后重试
  • 空 candidates → 向用户报告 "今日无推荐"，建议做 bestblogs intake setup 建立/修正画像

组合建议

  • 拿到候选后，对感兴趣的条目链式调用 bestblogs-read skill 做深读
  • 高价值条目链式调用 bestblogs-capture skill 收藏/加笔记
  • 想知道 "为什么推这条"？把 candidateSource / selectionReason 直接展示；更深层的解释（如贡献来源的评分）用 bestblogs-explain skill
Repository
ginobefun/BestBlogs
Path

skills/bestblogs-discover/SKILL.md

Commit

756ffbd

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill