Agent skill

Kol Writer

by cafe3310 in cafe3310/public-agent-skills

“梳理自媒体文章大纲与写作语料的管理流程”

— description from SKILL.md by cafe3310
Apache-2.0Auto-check passedResearch & Science

Install Kol Writer

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill kol-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cafe3310/public-agent-skills kol-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kol-writer .claude/skills/kol-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kol-writer
GitHub stars
255
Token cost
~643 tokens
SKILL.md length
92 words
Files
39 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 3 steps: 核心流程:大纲梳理与迭代 → 交互规范 → 语料收集流程
  • SKILL.md covers 1. 核心流程:大纲梳理与迭代, 2. 交互规范 and 3. 语料收集流程

About this skill

Kol Writer is a skill in cafe3310/public-agent-skills (255 stars). Its SKILL.md is about 643 tokens, with 38 other files in the folder (scripts). Licence: Apache-2.0.

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. 核心流程:大纲梳理与迭代
  2. 交互规范
  3. 语料收集流程

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kol Writer loads about 643 tokens when it runs. Until then it costs about 8 tokens; SKILL.md has 92 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~8
When it runs · the whole SKILL.md, loaded when a task matches
~643

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 92 words, ~643 tokens.

Download SKILL.mdSave it as .claude/skills/kol-writer/SKILL.md (or your agent's skills folder). This skill also uses 38 other files; get the full folder from GitHub.
name
kol-writer
description
梳理自媒体文章大纲与写作语料的管理流程
license
Apache-2.0
author
github/cafe3310
depends_on_skill
github/cafe3310/public-agent-skills -> deep-research, github/cafe3310/public-agent-skills -> agent-browser, github/cafe3310/public-agent-skills -> markdown-new

kol-writer: 自媒体大纲梳理与语料管理

⚠️ 内置子技能 (Sub-skills) 加载路径 本技能包含三个依赖子技能,存放在本地 sub-skills/ 目录:

  • deep-research ──→ 位于 sub-skills/deep-research/
  • markdown-new ──→ 位于 sub-skills/markdown-new/
  • agent-browser ──→ 位于 sub-skills/agent-browser/

必须且只能从相对路径 sub-skills/ 下读取其 SKILL.md,严禁访问全局技能根目录以防冲突。

本技能用于协助创作者,将零散想法、原始素材与检索信息整理为结构化大纲,并归档个人写作资产。

1. 核心流程:大纲梳理与迭代

mermaid
graph TD
    AI_Ask["1. 询问基本信息<br>(主题/平台/风格/目标)"] --> U_Answer["2. 用户提供信息"]
    U_Answer --> AI_Init["3. 初始化工作区<br>(创建目录并保存原始输入)"]
    AI_Init --> AI_Note["4. 对话式观点速记<br>(仅记录事实,不做推理)"]
    AI_Note --> AI_Eval["5. 结构化大纲梳理<br>(输出初版大纲并标注调查项)"]
    AI_Eval --> AI_Research["6. 补充检索与回填<br>(针对大纲缺失信息执行检索)"]
    AI_Research --> Loop_Iter{"7. 对话修改与调优<br>(反馈微调)"}
    Loop_Iter -->|未完善| Loop_Iter
    Loop_Iter -->|用户确认| AI_Write["8. 终稿归档<br>(写入 03-大纲终稿.md)"]
1.1 阶段一:初始化工作区
  • 1. 询问基本信息:Agent 主动向用户确认五个维度:主题、发布平台、写作风格、预期目标以及参考样例。
  • 2. 用户提供信息:用户针对提问提供输入。
  • 3. 初始化工作区:创建独立的写作工作目录,将输入保存为 01-用户原始输入.md。详见:01_initialize_project.md
1.2 阶段二:观点速记
  • 4. 观点速记:以对话形式记录用户的观点。Agent 需将用户输入保存到 02-用户想法记录.md 中,作为大纲整理和文风模仿的素材。详见:02_quick_notes.md
1.3 阶段三:大纲整理与检索
  • 5. 结构化大纲梳理:速记结束后,Agent 检索并调用 rules/platforms.md 中对应的平台规范,结合已有想法提炼论点,输出初版大纲。大纲中需使用引用块(>)标注待调查或补充的事项。详见:03_understanding_prompt.md
  • 6. 补充检索与回填:针对大纲中标注的待调查项制定检索计划。等待用户确认计划并选定方案后,运行检索工具将结果填入大纲。详见:04_deep_research.md
1.4 阶段四:大纲微调
  • 7. 迭代优化:根据用户反馈持续修改大纲,更新并覆盖 03-大纲草稿.md,直到用户确认满意。详见:05_iteration_optimization.md
1.5 阶段五:终稿归档
  • 8. 终稿归档:将最终大纲写入 03-大纲终稿.md,输出简短的总结和下一步行动建议。详见:06_archive_final.md

2. 交互规范

2.1 交互询问工具 (ask_user / ask_question) 优先

当执行环境支持 ask_question 或 ask_user 时,Agent 在关键决策点必须优先调用对应工具,避免使用纯文本交互。

应用场景:

  1. 初始确认 (Step 1):选择发布平台、文风及参考样例。
  2. 大纲侧重确认 (Step 5):确认大纲的方向偏好或调性选择。
  3. 检索方案确认 (Step 6.1):确认检索计划并选择网页访问方案(如 markdown-new 或 agent-browser)。

3. 语料收集流程

用于写作参考的博文、长图文及外部优秀案例,其收集、转写、清洗与归档需遵循统一的流程规范。详见:07_corpus_collection.md

© cafe3310, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 38 other files (scripts) in skills/kol-writer of cafe3310/public-agent-skills.

  • SKILL.md
  • FOR_DEV.md
  • rules/ai_artifacts_blacklist.md
  • rules/platforms.md
  • rules/safety_policy.md
  • samples/wechat_viral_propagation_hype_bible.md
  • samples/x_sharing_nature_plotting.md
  • samples/x_sharing_reflection_anxiety.md
  • samples/x_sharing_reflection_obsidian_agent_and_corporate_politics.md
  • samples/x_sharing_reflection_self_media_founder_dependency.md
  • samples/x_sharing_reflection_xhs_user_psychology.md
  • samples/x_tech_commentary_agent_system_design.md
  • samples/x_tech_commentary_deep_agents.md
  • samples/x_tech_commentary_deepseek_v4_distillation_and_writing.md
  • samples/x_tech_commentary_llm_uncensoring_and_ai_verifiability.md
  • samples/x_tech_commentary_openclaw.md
  • samples/x_tech_commentary_vibe_coding_synthesis.md
  • samples/x_viral_propagation_crayfish_politics.md
  • samples/xhs_lifestyle_life_hacks.md
  • … and 20 more

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Kol Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kol Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kol Writer this skillcafe3310/public-agent-skills255—~643Automated safety check: PassApache-2.0
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated today
    Research & ScienceAuto-check: notes
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Obsidian Todo Collector

    cafe3310/public-agent-skills

    从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~575 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Kol Writer

How do I install Kol Writer in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill kol-writer -a claude-code`. Or copy the skill folder (skills/kol-writer in cafe3310/public-agent-skills) into .claude/skills/kol-writer in your project. Claude Code loads it when a task matches its description.

How do I install Kol Writer in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill kol-writer -a codex`. Or copy the skill folder (skills/kol-writer in cafe3310/public-agent-skills) into .agents/skills/kol-writer in your project. Codex loads it when a task matches its description.

Can I use Kol Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cafe3310/public-agent-skills --skill kol-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kol-writer, .gemini/skills/kol-writer, .github/skills/kol-writer and .opencode/skills/kol-writer in your project.

What does Kol Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Kol Writer is instructions for the agent only.

Does Kol Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kol Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Kol Writer use?

Kol Writer is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kol Writer use?

About 643 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kol Writer?

Skills that share tags, products or a category with Kol Writer: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kol Writer?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

Source: cafe3310/public-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.