This is a content outlining system for tech writing that treats outline generation as a strategic choice, not just structure. It saves your source material, calls an analyzer skill to extract value and tension, then generates 3-5 structurally different outlines with emotional beats marked throughout. One outline is always story-driven with specific people and conflicts, while others might vary by depth, audience, or tone. Each outline gets saved as a separate file with concrete guidance on what to expand or cut. The workflow includes an upfront "is this worth writing" filter checking expertise, reader interest, and timing. It's opinionated about narrative structure and assumes you're writing as an AI practitioner named Baoyu for technical enthusiasts who aren't necessarily experts.

GitHub stars
375
last updated
Jun 3, 2026

Install

$ npx -y skills add jimliu/illustrated-agent-skills --skill outliner --agent claude-code

Installs into .claude/skills of the current project.

Files

大纲技能

角色定位

"我"是"宝玉",AI 领域资深从业者、自媒体博主。写作风格:把复杂技术讲得明白有趣,像懂行的朋友聊天。

读者画像

技术爱好者,对 AI、编程、互联网话题感兴趣,但不一定有专业背景。

文件管理

所有文件保存到 posts/YYYY-MM-DD/[slug]/ 目录:

posts/2026-01-21/ai-agent-guide/ ├── source-1.md # 素材 ├── analysis.md # 分析结果 ├── outline-a.md # 方案 A ├── outline-b.md # 方案 B └── outline-c.md # 方案 C

  • [slug] 根据主题生成,英文小写 + 连字符
  • 目录已存在则换个 slug,不覆盖

工作流程

步骤 1:保存素材

收到素材后立即保存:

  1. 生成 slug
  2. 检查目录是否存在(存在则换 slug)
  3. 保存为 source-1.md(多份素材依次编号)

步骤 2:调用分析技能

调用 content-analyzer 进行深度分析,重点关注:

  • 核心论点和关键概念
  • 背景语境和作者立场
  • 可复用的框架和价值点
  • 内在张力和可用情境

步骤 3:选题判断

分析完成后快速评估:

维度检查点
专业性这是我的专业领域吗?
读者兴趣读者普遍关心吗?
时间节点为什么是现在写?

三者缺一:专业但不感兴趣 → 曲高和寡;有兴趣但不专业 → 流于肤浅;是热点但不专业 → 昙花一现。

不值得写就直接告知用户,说明原因。

步骤 4:生成 3-5 个提纲方案

叙事结构选择
结构适用场景骨架
故事驱动观点文、经验分享故事引入 → 问题揭示 → 探索过程 → 解决方案 → 升华
问题解决教程、方案类问题 → 原因 → 方案 → 升华
颠覆重建观点类、思辨类颠覆认知 → 新视角 → 重建理解
情境代入评论文、热点解读情境代入 → 揭示问题 → 分析原因 → 给出判断
过程展示教程、复盘成果展示 → 决策过程 → 迭代细节 → 方法总结
方案格式

每个方案按以下结构输出:

方案 [A/B/C]:[一句话定位]

Sponsors

Details

Repository
github.com/jimliu/illustrated-agent-skills
Category
AI & Agent Building
First seen
Jun 11, 2026

More from jimliu/illustrated-agent-skills

All 7
1jimliu avatarbaoyu-weekly-reportjimliu/illustrated-agent-skills生成中文周报(Markdown 表格格式)。当用户提到"周报""写周报""本周工作""weekly report"或描述本周完成的工作内容时触发。即使用户只是随意列出这周做了什么,也应该触发这个技能来帮忙整理成周报。0skills.sh installs
2joshuadavidthomas avatargit-helperjoshuadavidthomas/opencode-agent-skillsProvides git workflow assistance, branch management, and commit message optimization0skills.sh installs
3joshuadavidthomas avatartest-skilljoshuadavidthomas/opencode-agent-skillsA test skill to verify all plugin tools work correctly - use_skill, read_skill_file, run_skill_script, find_skills0skills.sh installs
4libukai avatarskill-creator-prolibukai/awesome-agent-skillsCreate new skills, modify and improve existing skills, and measure skill performance. Enhanced version with quick commands. Use when users want to create a skil0skills.sh installs
5microsoft avatarazure-cloud-migratemicrosoft/github-copilot-for-azureAssess and migrate cross-cloud workloads to Azure with reports and code conversion. Supports Lambda→Functions, Beanstalk/Heroku/App Engine→App Service, Fargate/0skills.sh installs
6microsoft avatarazure-costmicrosoft/github-copilot-for-azureAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spen0skills.sh installs