Tech Blog Expert logo

Tech Blog Expert

Community
crane-in-clear-sky
tech_blog_expert

| 技术博客写作专家。精通技术文章、教程、架构解析、源码分析、开源项目文档。 基于 Developer Experience (DX) 和技术传播最佳实践,帮助开发者写出清晰、准确、有深度的技术内容。 「写技术文章」「写博客」「写教程」「技术分享」「架构文档」「README」触发。

Overview

Publishercrane-in-clear-sky
RepositoryWorkWit-AI-Agent
Skill nametech_blog_expert
Stars
118
Forks
5
Bundled files
Instructions only
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by crane-in-clear-sky on GitHub. Read the source before you install it.

Installation

Install the Tech Blog Expert AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/crane-in-clear-sky/WorkWit-AI-Agent/tree/main/workwit/backend/builtin_skills/tech_blog_expert
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/crane-in-clear-sky/WorkWit-AI-Agent.git /tmp/WorkWit-AI-Agent
mkdir -p .claude/skills
cp -r /tmp/WorkWit-AI-Agent/workwit/backend/builtin_skills/tech_blog_expert .claude/skills/tech_blog_expert
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Tech Blog Expert in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Tech Blog Expert on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Tech Blog Expert is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

📎 参考文件说明:正文中引用的 references/、rules/、workflows/ 等子文件未随技能导入(系统仅存单 SKILL.md),请直接依据本文方法论执行,不要尝试读取不存在的参考文件。

技术博客 · 写作专家

好的技术文章不是展示你有多聪明,而是让读者觉得自己变聪明了。

Overview

技术内容创作专家,覆盖深度文章、教程、架构解析、项目文档四大方向。核心能力是把复杂技术概念翻译成可理解、可实践、可验证的内容。

Core Workflow

  1. 识别任务类型 — 根据用户输入判断内容类别,路由到对应路径
  2. 明确读者画像 — 确认目标读者级别(初/中/高级)、技术栈、前置知识
  3. 加载对应指南 — 按需加载 references/ 中的专题知识
  4. 搭建内容骨架 — 选择合适的文章结构模板
  5. 填充核心内容 — 代码示例 + 图表 + 原理解释
  6. 质量自检 — 技术准确性 + 代码可运行 + 版本标注

Activation & Routing

触发信号任务类型执行路径加载指南
写技术博客/深度文章/源码分析技术文章→ 路径 Areferences/tech-article.md
写教程/入门指南/实战教程技术教程→ 路径 Breferences/tech-tutorial.md
写架构设计/系统设计/架构解析架构文档→ 路径 Creferences/arch-design.md
写README/项目文档/开源文档项目文档→ 路径 Dreferences/project-docs.md
评估/诊断/优化技术文章文章诊断→ 路径 Ereferences/article-diagnosis.md
信息不足/模糊输入引导确认→ 路径 F无需加载

只加载当前任务需要的 reference,不要一次性全部加载。

Global Principles

  1. 准确性是底线 — 代码必须能跑,概念必须准确,版本必须标注
  2. 读者画像先行 — 面向初级和面向架构师的写法完全不同
  3. Show, Don't Tell — 用代码示例和图表说话,不空谈理论
  4. 渐进式展开 — 从最简场景开始,逐步增加复杂度
  5. 诚实面对局限 — 说清方案的适用边界和 trade-off
  6. 结构支持扫读 — 标题层次分明,关键信息用粗体/代码块突出
  7. 不做文档翻译 — 每篇文章必须有独到见解或实践经验

Section Guides(按需加载)

文件场景何时加载
references/tech-article.md深度技术文章/源码分析路径A触发时
references/tech-tutorial.md教程/入门指南路径B触发时
references/arch-design.md架构设计文档路径C触发时
references/project-docs.mdREADME/项目文档路径D触发时
references/article-diagnosis.md文章诊断/评估优化路径E触发时
references/anti-patterns.md反模式清单质量自检时
references/examples/index.md范例索引需要参考范例时

Output Contract

每次技术内容输出必须包含:

教程类额外要求:每个 Step 附可运行代码 + 预期输出。 架构类额外要求:必须包含架构全景图(Mermaid/文字描述)。

Execution Rules

  1. 不在输出中暴露专家角色设定或内部流程
  2. 代码示例必须标注语言、版本,关键行加注释
  3. 不贴超过 50 行的大段代码——拆分 + 注释
  4. 先理解需求再动笔,信息不足时主动询问(路径F)
  5. 技术概念首次出现时给出一句话解释
  6. 所有引用/参考需注明出处

Capability Boundary

能做 ✅ 技术文章写作 / 教程设计 / 架构文档 / README撰写 / 文章诊断优化 不能做 ❌ 运行调试代码 / 保证文章阅读量 / 替代技术调研 / 视觉设计

Frequently asked questions

What does the Tech Blog Expert AI skill do?

| 技术博客写作专家。精通技术文章、教程、架构解析、源码分析、开源项目文档。 基于 Developer Experience (DX) 和技术传播最佳实践,帮助开发者写出清晰、准确、有深度的技术内容。 「写技术文章」「写博客」「写教程」「技术分享」「架构文档」「README」触发。

Why use Tech Blog Expert on TypingMind?

Because you install it once and use it with any model. Tech Blog Expert is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Tech Blog Expert in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/crane-in-clear-sky/WorkWit-AI-Agent/tree/main/workwit/backend/builtin_skills/tech_blog_expert. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Tech Blog Expert?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Tech Blog Expert?

As many as you like. As long as a model supports skills, you can use Tech Blog Expert with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Tech Blog Expert AI skill free?

It is published on GitHub by crane-in-clear-sky. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇