Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pedronauck/skills --skill writing-tech-post -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/writing-tech-post/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/writing-tech-post/

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.

Similar skills

All skills for Writing and docs →

From the same set52

The whole set →
fundraising This skill walks you through an end-to-end fundraising process for early-stage founders: from deciding whether to raise venture capital to building a pitch narrative, targeting investors, running outreach, and preparing for due diligence. CX Codex +1 252installs xstate This skill covers XState v5 machines, actors, stores, and TanStack Query integration. Use it when application logic needs explicit state flows. CX Codex +1 247installs tweetsmash-api tweetsmash-api — a skill for integrating TweetSmash REST API into scripts and tools. Retrieve bookmarks, apply filters, paginate, and manage labels without browser automation. CX Codex +1 214installs herdr-orchestration herdr-orchestration controls interactive Claude and Codex worker TUIs in dedicated herdr tabs using socket CLI commands. CX Codex +1 210installs ship-pr ship-pr delivers finished work with documentation audits, release note grouping, compliant commits, and a pull request. CX Codex +1 181installs kb-yt-channel kb-yt-channel — a skill that builds Karpathy KB topics from YouTube channels: the agent fetches transcripts, organizes them into topic folders, validates structure, and creates search indexes. CX Codex +1 175installs spec-peer-review spec-peer-review runs one independent review of an approved spec, RFC, design document, or detailed PRD. It returns findings for the user to select. CX Codex +1 161installs yc-apply yc-apply is a skill for preparing and checking Y Combinator applications, founder-video notes, interview practice, and reapplication materials based on verified facts. CX Codex +1 158installs

Project sponsors

Companies that keep this analytics open