# Bestblogs Topic

Use this skill when the user asks about a specific topic, subject area, or wants to...

- Repository: https://github.com/ginobefun/BestBlogs (4072 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-07-08
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ginobefun/BestBlogs --skill bestblogs-topic -g -a claude-code -y`
Codex: `npx skills add ginobefun/BestBlogs --skill bestblogs-topic -g -a codex -y`
Cursor: `npx skills add ginobefun/BestBlogs --skill bestblogs-topic -g -a cursor -y`
Gemini CLI: `npx skills add ginobefun/BestBlogs --skill bestblogs-topic -g -a gemini-cli -y`

## Description

Use this skill when the user asks about a specific topic, subject area, or wants to explore curated topic pages on BestBlogs. Triggers include "BestBlogs 有什么主题 / 查一下 AI 编程主题 / 给我看 Claude 主题页 / 大模型相关主题", "BestBlogs topic list", "show me topics about AI", "what topics does BestBlogs have", "topic details for vibe-coding", "browse topic pages". Invokes the `bestblogs` CLI.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# bestblogs-topic, 主题探索

## 何时使用

- 用户想了解 BestBlogs 有哪些主题专页。
- 用户想深入某个特定主题（如 "AI 编程"、"Vibe Coding"）。
- 用户想按类型筛选主题（事件型 / 领域型 / 人物组织型 / 对比型）。

## 原语

| 原语 | CLI | 说明 |
|---|---|---|
| `bestblogs.topic.list` | `bestblogs topics list --json` | 浏览全部主题（默认中文） |
| `bestblogs.topic.list.en` | `bestblogs topics list --lang en --json` | 英文主题列表 |
| `bestblogs.topic.list.filter` | `bestblogs topics list --type DOMAIN --json` | 按类型筛选主题 |
| `bestblogs.topic.get` | `bestblogs topics get <slug> --json` | 查看主题详情 |
| `bestblogs.topic.get.en` | `bestblogs topics get <slug> --lang en --json` | 英文版主题详情 |

## 核心动作：浏览主题列表

```bash
bestblogs topics list --lang zh --json
```

返回：

```json
{
  "success": true,
  "data": {
    "topics": [
      {
        "slug": "vibe-coding",
        "type": "DOMAIN",
        "title": "Vibe Coding",
        "summary": "AI 辅助编程的全新范式……",
        "tagCodes": ["AI_CODING", "LLM"],
        "publishedAt": "2026-04-20T00:00:00Z",
        "pinnedOrder": 1
      }
    ],
    "totalCount": 12
  }
}
```

**展示建议**：
- `pinnedOrder` 非 null → 置顶主题，优先展示（数字越小越靠前）。
- `type` 枚举含义：
  - `EVENT`, 事件型（某次具体事件的深度解读）
  - `DOMAIN`, 领域型（某技术/方向的系统梳理）
  - `PERSON_ORG`, 人物/组织型（人物或公司的全面解读）
  - `COMPARISON`, 对比型（多个选项/方案的对比分析）
- `tagCodes` 帮助用户了解主题覆盖的技术领域。

## 查看主题详情

```bash
bestblogs topics get vibe-coding --lang zh --json
```

返回的 `topic` 对象包含：
- `title` / `summary` / `type` / `language`
- `hasZhVersion` / `hasEnVersion`, 是否有双语版本
- `eventContent` / `domainContent` / `personOrgContent` / `comparisonContent`, 对应类型的详细内容体（仅对应类型非 null）
- `references`, 脚注引用列表（含站内资源标题）
- `furtherReadingResources`, 延伸阅读资源快照（resourceId → resource 元信息）

```bash
# 查看英文版
bestblogs topics get vibe-coding --lang en --json
```

## 主题类型过滤

```bash
# 只看领域型主题
bestblogs topics list --type DOMAIN --json

# 只看事件型主题（英文）
bestblogs topics list --type EVENT --lang en --json
```

## 错误处理

The rest: https://github.com/ginobefun/BestBlogs/blob/HEAD/skills/bestblogs-topic/SKILL.md