Not in the top 1,000 by GitHub stars

luoling8192/technical-writing

中文内部技术写作的 agent skill,约束设计文档 / 评审稿 / postmortem / 分享稿场景的语气、句法、结构

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

5f684e950319 → 5f684e950319

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 5f684e950319

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 5f684e950319bee8f773c3b5f5265c8bdda2900a

220GitHub stars
3stars in 7 days
1skill in this repository
0commits in 30 days

Heat

2.8
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 5, 2026220

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

technical-writing

When your agent uses it

Use when drafting or revising internal technical design docs, review notes, architecture writeups, or sharing posts in Chinese, especially when the tone should stay evidence-backed, calm, and suitable for peers or leaders rather than marketing or literary writing.

What it loads into context

Frontmatter

55 tokens

Always available to the agent

SKILL.md

5,545 tokens

When the skill is activated

Reference documents

611 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Overview
  2. When to Use
  3. Core Stance
  4. Preferred Structure
  5. Language Rules
  6. Buzzword Blocklist
  7. Evidence-First Writing
  8. Reader-Aware Explanations
  9. Few-Shot Fixes
  10. Lists, Quotes, and Flow
  11. Module-Level Writing
  12. Tone Calibration
  13. Editing Checklist
  14. Default Prompting Pattern

Files

  • .gitignoreasset46 bytes
  • LICENSEasset1,068 bytes
  • README.mddoc2,145 bytes
  • SKILL.mdcore19,565 bytes
  • SKILL.mdcore19,565 bytes
  • SKILL.mdcore19,565 bytes
  • agents/openai.yamlasset286 bytes
Read SKILL.md

# Internal Technical Writing

## Overview

Use this skill when the writing target is an internal技术方案、评审稿、架构说明、分享文稿,重点在于把背景、猜想、证据、抽象、实现影响面讲清楚。

这类写作更接近技术汇报,不是宣传稿,也不该写成散文。语气要平稳,判断要有来路,段落要能顺着问题往下读。

## When to Use

- 在写内部技术方案、设计说明、评审文档、分享稿
- 在改一篇已经有内容、但文风过满、结论过快、证据不足的技术文章
- 在解释代码、模块边界、架构演进、可观测性、评测方法
- 在把聊天记录、讨论结论整理成可传播的技术文档
View the complete source on GitHub

Skills included

  • technical-writing

Repository facts

License
MIT
Created
May 15, 2026
Last pushed
May 27, 2026
Forks
11
Open issues
0
Project activity
Slowing

Before you install

Instructions only

Automated signals, not a guarantee

Checked Nov 6, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 2 notes
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • No broad tool permissions
  • No dangerous shell commands
  • 3 network referencesin 1 file: README.md:16
  • No hidden or obfuscated text
  • No instruction overrides
  • No executable scripts
  • No access to secrets
  • No requests to vote in Hot
Show all 3 signals by file

README.md

  • Network accessline 16
    通过 [skills.sh](https://skills.sh) 一行装,自动检测当前 agent 并写入对应目录:
  • Network accessline 29
    git clone https://github.com/luoling8192/technical-writing.git ~/repos/technical-writing
  • Network accessline 50
    灵感和反馈来自 [@nekomeowww](https://github.com/nekomeowww)。

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Signal confidence: 3 facts
  • Network access in prose of documentationREADME.md:16Low confidence
  • Network access in code of documentationREADME.md:29Low confidence
  • Network access in prose of documentationREADME.md:50Low confidence

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.