# writing-tech-post

writing-tech-post — a skill for writing and editing engineering posts with supported claims. Use it to draft new articles, rework existing drafts, or review content before publication.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 182 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/writing-tech-post/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/writing-tech-post

## What it does

The skill targets authors of technical writing: it takes a brief outline and reader context, suggests a structure and archetype that fit the material. If you have a draft already, it keeps the existing shape and edits only what you ask for.

At its core is a strict separation: fact, example, and hypothesis each get marked and treated differently. The skill flags quantitative, comparative, and capability claims and asks for evidence, stating limitations openly. Before external publication, it walks through a checklist of what to verify for safety, confidentiality, and honesty.

Includes reference guides on post archetypes (overview, deep dive, incident postmortem, migration), how to layer depth and where to anchor diagrams and code. A linter is available: `python3 <writing-tech-post-dir>/scripts/lint-post.py <draft.md>`. It surfaces style and logic hints; whether facts are true remains on the author and editor.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill writing-tech-post -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/writing-tech-post/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/writing-tech-post/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill writing-tech-post -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/writing-tech-post/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill writing-tech-post -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/writing-tech-post/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/writing-tech-post
```

2. **Manually: put the files in place**
- File: `.github/skills/writing-tech-post/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill writing-tech-post -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/writing-tech-post
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/writing-tech-post/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill writing-tech-post -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/writing-tech-post/SKILL.md

## When to use it
- Draft a technical post with clear structure and supported claims
- Rewrite parts of an existing post while keeping what works
- Verify assertions in an article before sending it out
- Tell fact from example from hypothesis in your text
- Prepare a post for external publication with a pre-launch checklist

## Example prompts
- Write a post about migrating from Express to Fastify for backend engineers
- Revise the Performance section in my draft, keep the overall structure
- Check facts in this article before publishing to our blog

## Similar
- [press-release-writing](https://affpapa.org/en/nevibecode/skills/press-release-writing.md) — skill · 238 installs
- [avoid-ai-writing](https://affpapa.org/en/nevibecode/skills/conor-bronsdon-avoid-ai-writing.md) — skill · 5300 installs
- [writing-style-and-tone](https://affpapa.org/en/nevibecode/skills/writing-style-and-tone.md) — skill · 1200 installs
- [human-writing](https://affpapa.org/en/nevibecode/skills/human-writing.md) — skill · 630 installs
- [better-writing](https://affpapa.org/en/nevibecode/skills/forjd-better-writing.md) — skill · 624 installs
- [clear-writing](https://affpapa.org/en/nevibecode/skills/clear-writing.md) — skill · ★ 67 repo stars

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
