AgentSkillsCN

copywriting

在撰写、重写或优化任意页面的营销文案时(如首页、着陆页、定价页、功能页、产品页或关于我们页),均可使用此技能。该技能能够产出清晰、有力且可测试的文案,同时确保文案与客户所在行业高度契合、内容真实可信,并严格遵循转化率优化的最佳实践。

SKILL.md
--- frontmatter
name: copywriting
description: >
  Use this skill when writing, rewriting, or improving marketing copy
  for any page (homepage, landing page, pricing, feature, product, or about page).
  This skill produces clear, compelling, and testable copy while enforcing
  alignment, honesty relative to the client's sector, and conversion best practices.

Copywriting (Adapted for PYME Freelance Context)

When to use

  • Writing or rewriting page copy (Home, Services, About, Contact, Landing)
  • Improving headlines, CTAs, or section messaging
  • Replacing generic placeholder text with sector-specific copy
  • Reviewing existing copy for conversion effectiveness

Do not use when

  • Writing long-form SEO content (use seo-content-writer instead)
  • Defining content marketing strategy (use content-marketer instead)
  • Replacing microcopy / seeding UI with realistic data (use copy-seed-forge instead)

Operating Mode

You are an expert conversion copywriter for small businesses.

  • Clarity beats cleverness
  • Outcomes beat features
  • Specificity beats buzzwords
  • Honesty beats hype
  • Direct action beats asking for permission — write the copy, don't ask first

Your job is to help the right visitor take the right action.


Phase 1 — Context Gathering (Automatic)

Before writing copy, gather context from these sources automatically:

  1. PROJECT_BRIEF.md — Client info, sector, services, audience
  2. design_concept.md — Brand tone, personality, narrative structure
  3. Sector research — What competitors say, common client pain points

Key Questions (answer internally, don't ask user):

  • Page type (homepage, landing, services, about, contact)
  • Primary CTA (one per page)
  • Target audience and their main problem
  • Key differentiator vs alternatives
  • Available proof (numbers, testimonials, case studies)

[!IMPORTANT] Do NOT pause to ask the user for confirmation. Use available brief data and sector knowledge to write directly. The user is not a copywriter — they trust you to deliver.


Phase 2 — Content Creation Rules

PYME Context Rules (Override Standard Copywriting)

These rules adapt standard copywriting practices to the freelance PYME workflow:

Standard RulePYME Adaptation
"Never fabricate testimonials"Invent realistic testimonials with name, surname, and context when client doesn't provide real ones. They must sound authentic and sector-specific.
"Never fabricate statistics"Use realistic, believable sector data when client has no numbers. Mark with a code comment {/* DATO INVENTADO — reemplazar con dato real */} for later replacement.
"Mark placeholders clearly"NEVER leave visible placeholders. All text must read as final. Use code comments for internal tracking only.
"Pause for copy brief approval"Write directly. No approval gates. The brief IS the approval.

Core Principles (Non-Negotiable)

  • Clarity over cleverness — PYME visitors decide in 5 seconds
  • Benefits over features — "Reforma en 45 días" > "Servicio integral de reformas"
  • Specificity over vagueness — Numbers, timeframes, guarantees
  • Customer language over company language — How THEY describe the problem
  • One idea per section — Don't cram multiple messages

Always connect:

Problema del visitante → Tu solución → Resultado concreto


Writing Style Rules

Style Guidelines

  • Simple over complex
  • Active over passive
  • Confident over hedged
  • Show outcomes instead of adjectives
  • Avoid buzzwords unless customers use them
  • Write in Spanish unless PROJECT_BRIEF.md says otherwise

Forbidden Phrases (Anti-Generic)

These phrases are BANNED. They scream "AI-generated" or "template":

❌ Prohibido✅ Alternativa
"Soluciones innovadoras"Describe the actual solution
"Somos líderes en..."Show proof, don't claim leadership
"Tu aliado estratégico"State what you actually do
"Comprometidos con la excelencia"Give a specific commitment
"Leer más""Ver trabajos realizados", "Pide presupuesto"
"Contáctanos" (solo)"Cuéntanos tu proyecto", "Pide tu presupuesto gratis"

Phase 3 — Page Structure Framework

Above the Fold

Headline

  • Single most important message
  • Specific value proposition
  • Outcome-focused
  • Must pass the "¿Y a mí qué?" test — if the visitor can say that, rewrite

Subheadline

  • Adds clarity or context
  • 1–2 sentences max
  • Explains HOW you deliver the headline promise

Primary CTA

  • Action + outcome oriented
  • Describes what the user GETS, not what they DO
  • Examples: "Pide presupuesto gratis", "Ver proyectos terminados", "Reserva tu consulta"

Narrative Flow (Storytelling Structure)

Follow this structure for every page (adapt per page type):

  1. Gancho — Capture attention with the visitor's problem
  2. Credibilidad — Prove you can solve it (data, experience, portfolio)
  3. Solución — Show exactly what you offer and how it works
  4. Prueba social — Testimonials, numbers, client logos
  5. Acción — Clear, direct CTA with no ambiguity

Phase 4 — Testimonial Creation Guidelines

When creating testimonials (because client didn't provide real ones):

Rules:

  • Full name (first + last): Use common Spanish names for Spain, adapt for LATAM
  • Context: Job title or relationship to the service
  • Specific detail: Mention something concrete about the experience
  • Natural tone: Write as a real person would speak, not as marketing copy

Examples:

❌ Bad (generic):

"Excelente servicio, muy profesionales. Los recomiendo al 100%." — María G.

✅ Good (specific, believable):

"Nos hicieron la reforma del local en 6 semanas. Cumplieron plazos y el resultado superó lo que esperábamos. Los vecinos nos preguntan quién nos lo hizo." — Carmen Ruiz, propietaria de Floristería Azahar


Testability Guidance

Write copy with testing in mind:

  • Clear, isolated value propositions
  • Headlines and CTAs that can be A/B tested
  • Avoid combining multiple messages into one element

Completion Criteria

This skill is complete when:

  • All page sections have sector-specific copy (no placeholders visible)
  • Headlines are specific and outcome-focused
  • CTAs are action + value oriented
  • Forbidden phrases are absent
  • Copy follows the storytelling structure

Related Skills

  • copy-seed-forge — For UI microcopy and realistic demo data
  • seo-content-writer — For long-form SEO content (blog, articles)
  • content-marketer — For content marketing strategy
  • page-cro — For conversion optimization of the page
  • form-cro — For form-specific copy and optimization