writing-show-and-tell

Craft first-person developer posts with motivation-first structure and explicit limitations.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/liuzhengdongfortest/skills --skill writing-show-and-tell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-show-and-tell
Source: https://github.com/liuzhengdongfortest/skills/tree/main/writing-show-and-tell
Command: npx skills add https://github.com/liuzhengdongfortest/skills --skill writing-show-and-tell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps developers write “show & tell” posts that attract interest and earn clicks by using an honest, first-person, peer-to-peer storytelling angle rather than README-style explanation or sales-copy persuasion.

Core Features & Use Cases

  • First-person opening (“我”): Start with a personal voice, a concrete situation, emotion, or action to avoid the “press release” tone.
  • Motivation-before-product structure: Put the “why I did this / why I used it” story early, then introduce what you built or used.
  • Trust-building writing rules: Use subjective comparisons, admit limitations, replace empty adjectives with specific details, include human quirks, and keep the ending restrained (no star/feedback begging).

Quick Start

Write a first-person developer share about what you built or used recently, then revise it so the first sentence uses “我” with a concrete event, the motivation comes before the product, you include 2–4 real limitations, and the ending only provides essential info without asking for stars or shares.

Frequently Asked Questions about writing-show-and-tell

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Show HN post that developers actually want to click?

To write a Show HN post that earns clicks, open with a first-person voice and a concrete situation, place your motivation before the product introduction, and use specific details rather than vague adjectives.

What is the best way to structure a first-person developer blog for a project intro?

The best way to structure a first-person developer blog is a motivation-first approach: start with why you built or used something, introduce the project, admit 2–4 limitations, and close with essential info only.

Why does my community post sound like a press release instead of peer-to-peer storytelling?

Your community post sounds like a press release because it lacks a first-person opening. Start with a personal action or emotion using “我” to establish an honest, peer-to-peer storytelling angle.

How do I build trust in a weekend project recap without using promotional language?

Build trust in a weekend project recap by using subjective comparisons, admitting specific limitations, including human quirks, and keeping the closing restrained without asking for stars or shares.

Can I use first-person storytelling for independent developer recaps on community platforms?

Yes, you can use first-person storytelling for independent developer recaps. It applies to community posts where you share what you built or used, generating interest through peer credibility.

What should I avoid when writing a technical show-and-tell post?

When writing a technical show-and-tell post, avoid README-style explanations, sales-copy persuasion, empty adjectives, and promotional endings that beg for stars, feedback, or shares.