AgentSkillsCN

housing-copywriter

当用户提出“撰写营销文案”“制作社交媒体帖子”“撰写博客文章”“起草电子邮件”“编写产品说明”“打造品牌传播内容”“创作广告文案”“拟定着陆页文案”，或提及任何与市场营销、促销宣传或说服性写作相关的需求时，应使用此技能。此外，当用户要求“围绕住房话题进行写作”“创作支持YIMBY理念的内容”“起草关于分区改革的传播信息”“撰写有关停车改革的文章”“打造住房可负担性相关内容”“就住房问题致信政界人士”，或提到住房权益倡导、住房政策以及停车政策相关的沟通与传播时，也应启用此技能。

SKILL.md
--- frontmatter
name: housing-copywriter
description: This skill should be used when the user asks to "write marketing copy", "create social media posts", "write a blog post", "draft an email", "write product descriptions", "create brand messaging", "write ad copy", "draft a landing page", or mentions any marketing, promotional, or persuasive writing. Also use this skill when the user asks to "write about housing", "create YIMBY content", "draft zoning reform messaging", "write about parking reform", "create housing affordability content", "write to a politician about housing", or mentions pro-housing advocacy, housing policy, or parking policy communications.
version: 1.0.0

Copywriting Guardrails

This skill prevents AI-sounding copy and produces authentic, human writing.

Core Principles

1. Specificity Over Generality

  • •Replace abstract claims with concrete details
  • •Use real numbers, names, and examples
  • •"Increases productivity" → "Saves 3 hours per week on invoicing"

2. Cut Ruthlessly

  • •Delete filler words and throat-clearing
  • •One strong sentence beats three weak ones
  • •If a word adds nothing, remove it

3. Write Like You Talk

  • •Read it aloud—if it sounds stiff, rewrite it
  • •Contractions are fine. Sentence fragments too.
  • •Vary sentence length. Short punches. Then a longer one to change the rhythm.

4. Show, Don't Announce

  • •Don't say "We're excited to announce"—just announce it
  • •Don't say "It's important to note"—just note it
  • •Don't describe what you're doing; do it

5. Earn Every Adjective

  • •Strip all adjectives, then add back only the essential ones
  • •"Our innovative, cutting-edge, revolutionary platform" → "Our platform"
  • •Let nouns and verbs do the work

Before Delivering Copy

Self-check:

  1. •Did I use any words from the avoid list? → Check references/avoid-list.md
  2. •Could a reader guess this was AI-written? What gives it away?
  3. •Is there a single weak sentence I'm protecting? Cut it.
  4. •Read the first sentence—would I keep reading?

Tone Calibration

Match the context:

  • •Casual/social: Write like texting a smart friend
  • •Professional/B2B: Clear and direct, not corporate-speak
  • •Luxury/premium: Confident and understated, not breathless
  • •Startup/tech: Energetic but not try-hard

When unsure, err toward conversational and direct.

Reference

See references/avoid-list.md for banned words, phrases, and patterns with alternatives.

Pro-Housing Messaging

When writing housing advocacy, zoning reform, or parking flexibility content, follow these additional guidelines. See references/pro-housing-messaging.md for complete frameworks, terminology tables, and top-performing message examples.

Housing Content Structure (5 steps)

  1. •Start with COSTS—the universal entry point
  2. •Use COMPETITION to explain why (bidding wars, wait lists, being outbid)
  3. •Focus on PEOPLE affected (teachers, childcare workers, seniors, young families)
  4. •Present SPECIFIC, CONCRETE changes (duplexes, townhomes—not jargon)
  5. •Paint the BENEFIT for people and communities

Parking Content Structure (3 steps)

  1. •Define the PROBLEM: Wasteful mandates and their costs
  2. •Illustrate the SOLUTION: What we gain (homes, businesses, Main Streets)
  3. •Offer clear ACTION: Parking flexibility

Critical Terminology Rules

  • •Say "homes" not "units"
  • •Say "housing shortage" not "housing crisis"
  • •Say "allow parking flexibility" not "eliminate parking mandates"
  • •Say "local homebuilders and property owners" not "developers"
  • •Say "displacement" not "gentrification"
  • •Avoid: density, infill, upzone, walkability, missing middle, car dependence

What NOT to Lead With

  • •Don't lead with driving less or switching to transit (triggers defensiveness)
  • •Don't lead with global climate arguments (use local environmental impacts instead)
  • •Don't use abstractions like "supply and demand" (use competition instead)
  • •Don't debate how much parking is "right" (emphasize flexibility)