Content generation tool for technical blogging, creating structure and front matter for Hugo sites.
Install
mkdir -p .claude/skills/article-writer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12109" && unzip -o skill.zip -d .claude/skills/article-writer && rm skill.zipInstalls to .claude/skills/article-writer
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Draft or heavily rewrite a technical share-style blog post / 技术分享 / 技术文章 / 博客文章 for this Hugo repository. Use when the user wants a new article, wants notes turned into a post, needs title options, summary, front matter, outline, or wants Mermaid, Chart.js, Excalidraw, or Draw.io visuals added under source/post/. Do NOT use for polishing or minor edits to existing articles — use article-refiner instead.Key capabilities
- →Create article structure and body draft from scratch
- →Generate title candidates and recommend a title
- →Draft summaries and front matter
- →Suggest charts or diagrams when needed
- →Organize scattered materials into a publishable draft
- →Write with an authorial voice for technical sharing
How it works
The skill drafts technical blog posts by first defining the scope, then reading the repository context, structuring the content, and incorporating an authorial voice, suggesting visuals as needed.
Inputs & outputs
When to use article-writer
- →Draft new blog post
- →Generate title options
- →Create article summary
About this skill
Article Writer
Outcome
产出一篇有事实依据、保留作者判断、符合仓库约定的新 Hugo 技术文章；材料不足时，产出可执行的大纲和信息缺口，不补写虚构内容。
Workflow
- 读取
../../../AGENTS.md，确认主题、读者、核心判断、已有材料、适用边界和交付位置。 - 搜索同主题文章；需要校准语气时只抽样 2 至 3 篇相关旧文，避免重复背景或模仿固定口头禅。
- 将事实、作者判断、待验证信息分开。易变结论使用当前一手来源；无法验证的关键内容标注缺口。
- 根据材料建立章节，不强制套用固定模板。优先保留实测数据、代码、失败记录和取舍理由。
- 写完内容后再判断是否需要图。需要嵌入细节时读取
references/embedding-syntax.md，并按AGENTS.md选择图表类型。 - 做事实复核和风格复核：检查模板化段落、重复总结、均匀小节、长免责声明，以及被写成中性报告的作者判断。
- 按
AGENTS.md运行 Hugo、Markdown、图表和 diff 验证；修复后再交付。
Deliverable
- 用户指定目标文件时，直接写入该文件并保留编号和资源命名约束。
- 用户只要求草稿且未指定文件时，默认给出 3 个短标题候选、推荐标题、摘要、front matter 和正文。
- 只有图表能明显降低理解成本时，才附图表或资源建议。
Guardrails
- 不编造作者经历、实验、数据、引用或观点，也不通过故意错字制造“人味”。
- 不把新文章写成新闻稿、产品说明、论文摘要或每节节奏相同的提纲扩写。
- 不代替用户做技术选型；给出依据、权衡和待确认项。
When not to use it
- →For polishing or minor edits to existing articles
- →For modifying existing article filenames, IDs, or year directories
- →For fabricating benchmarks, experimental results, or external conclusions
Limitations
- →Does not modify existing articles
- →Does not fabricate benchmark, experimental results or external conclusions
- →Does not replace the author's technical selection decisions
How it compares
This skill focuses on drafting new technical articles from scratch with an emphasis on authorial voice and structured content, unlike refining existing articles or simply generating factual reports.
Compared to similar skills
article-writer side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| article-writer (this skill) | 0 | 1mo | No flags | Intermediate |
| resume-builder | 53 | 3mo | No flags | Beginner |
| write-docs | 6 | 3mo | No flags | Beginner |
| wiki-changelog | 3 | 4mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
resume-builder
amruthpillai
Generate professional resumes that conform to the Reactive Resume schema. Use when the user wants to create, build, or generate a resume through conversational AI, or asks about resume structure, sections, or content. This skill guides the agent to ask clarifying questions, avoid hallucination, and produce valid JSON output for https://rxresu.me.
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
wiki-changelog
microsoft
Analyzes git commit history and generates structured changelogs categorized by change type. Use when the user asks about recent changes, wants a changelog, or needs to understand what changed in the repository.
docs-changelog
google-gemini
Provides a step-by-step procedure for generating Gemini CLI changelog files based on github release information.
docs-writer
google-gemini
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
document-writer
onmax
Use when writing blog posts or documentation markdown files - provides writing style guide (active voice, present tense), content structure patterns, and MDC component usage. Overrides brevity rules for proper grammar. Use nuxt-content for MDC syntax, nuxt-ui for component props.