writing-tech-post — Claude Code skill: draft and review technical posts
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.
no license 182 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill writing-tech-post -a claude-codeWhat writing-tech-post 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.
What it helps with
- 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 for the agent
- 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
How to install writing-tech-post
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-tech-post -a claude-code2Manually: put the files in place
~/.claude/skills/writing-tech-post/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/writing-tech-post/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-tech-post -a codex2Manually: put the files in place
.agents/skills/writing-tech-post/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-tech-post -a cursor2Manually: put the files in place
.cursor/skills/writing-tech-post/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/writing-tech-post2Manually: put the files in place
.github/skills/writing-tech-post/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-tech-post -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/writing-tech-postManually: put the files in place
.devin/skills/writing-tech-post/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-tech-post -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about writing-tech-post
How do I install writing-tech-post in Claude Code?
Run npx skills add pedronauck/skills --skill writing-tech-post -a claude-code, then open ~/.claude/skills/writing-tech-post/SKILL.md to see the skill description and available commands.
What does writing-tech-post do?
It helps you draft and refine engineering posts by building structure, flagging claims that need evidence, and walking through a publication checklist for disclosure and safety.
What post types does it support?
The skill works with overviews, deep dives, incident postmortems, and migration guides. Reference docs describe when to use each, what structure fits, and how to layer detail and evidence.