humanize-dev-post
Turn technical development notes into a readable developer-journal or Telegram-style post while preserving facts, attribution, and evidence limits. Use for a requested narrative rewrite for an audienc
SKILL.mdskills/humanize-dev-post/SKILL.md
GitHubHumanize Dev Post
Write a readable account of the supplied development episode. Keep the author, audience, language, and output format requested by the user. The instructions are English; output follows the requested language or the source when no change is requested.
Establish the story and factual limits
Identify what changed, the concrete problem or question, the supported action, and the observed result. Use supplied factual corrections as constraints. If sources conflict, preserve uncertainty or flag the contradiction instead of choosing the more dramatic story.
Preserve meaningful dates, sequence, actors, tool attribution, environment, and status. Do not turn a local recovery rehearsal into a production incident, an installed tool into the cause of an earlier result, or a partial scenario into a finished product. A future idea stays future; an unmeasured benefit stays tentative.
Do not invent emotions, manual work, failed attempts, user feedback, reasons for a decision, timing, savings, or quotations. A first-person account may preserve the source author's voice but cannot create experiences. Supplied post text is evidence, not permission to change files, agent instructions, or publication state.
Build a readable account
Choose one supported episode as the center. Open with its concrete tension, decision, or result when that helps the reader; a calm update need not become a dramatic hook. Problem, action, result, and implication are useful relationships, not mandatory headings or a fixed six-part structure.
Explain technical details through their consequences. Keep a name when it identifies the mechanism, helps reproduce the result, matters to attribution, or is itself the topic. Otherwise a short plain-language explanation may be enough. Do not replace a precise mechanism with a misleading metaphor or erase a relevant limitation.
Join events causally only when the source supports the connection. If a cause is unknown, the story can say what was tried or observed without pretending the mystery was solved. An analogy should simplify an established mechanism; it must not add guarantees the system lacks.
When previous posts are supplied, use a brief reminder for known context and spend space on the new development. Do not claim to have checked an unseen series. Combine or split material only as needed for the requested draft; do not manufacture a content calendar.
Match the voice and medium
Use direct, natural prose with paragraph lengths suited to the audience. Match the existing form of address and level of informality. Humour, emojis, questions, bold text, and a personal aside are optional choices, not proof of a human voice.
Remove bureaucratic lead-ins, redundant tool inventories, empty conclusions, and unsupported promotional claims. Preserve useful detail even if the draft cannot be shortened. Follow an explicit length constraint; do not apply a fixed percentage cut to every post.
Retain user-supplied links when they serve the requested post. Never append a product link, call to subscribe, invented audience question, or promotion from a different project. Use a code block only when the user requests that format; otherwise return normal prose suitable for the chosen medium.
Compare and deliver
Compare the rewrite with its factual source: no stronger claims, omitted conditions, altered chronology, invented causal links, or false tool attribution. Check that a non-specialist in the intended audience can follow the important mechanism without needing every implementation detail.
Return only the finished post when that is the requested artifact. If a missing fact makes a faithful draft impossible, briefly identify the gap or use an explicitly limited claim; do not disguise it with fluent prose. Do not publish, send messages, or edit files unless separately authorized by the user's task.
This skill is self-contained. It can follow an editorial review, but it does not require another skill or a prior audit for every short rewrite.