content-wireframe
Draft a content wireframe for a website or page before any design or code. Produces a structured markdown document with real copy, section intent, and open decisions — approved by the user before implementation begins. Use when the user says "content first", "wireframe the copy", "words before design", "start with the content", "what should the page say", or when a website project lacks finalized copy and is jumping straight to visuals.
jcottam · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add jcottam/agent-resources --skill content-wireframeAbout this skill
name: content-wireframe description: >- Draft a content wireframe for a website or page before any design or code. Produces a structured markdown document with real copy, section intent, and open decisions — approved by the user before implementation begins. Use when the user says "content first", "wireframe the copy", "words before design", "start with the content", "what should the page say", or when a website project lacks finalized copy and is jumping straight to visuals.
Content Wireframe
Write every word a page needs — in order, with intent annotations — before touching layout, color, or code. The wireframe is the blueprint; design follows.
When to use
- New website or landing page where copy hasn't been written
- Redesign where the existing page was built design-outward and the words feel secondary
- Any project where the user is unhappy with the "feel" but can't articulate why (often a content problem, not a design problem)
Inputs to gather
Before drafting, collect as much of the following as possible:
- Business context — What does the company do? Who are the customers?
- Primary goal — What is the single most important action a visitor should take?
- Brand voice — Formal/casual? Technical/approachable? Any existing style guide?
- Existing copy — Current site, marketing materials, internal docs
- Competitor pages — Direct competitors' sites, their messaging, positioning, and gaps
- Data files — Locations, pricing, FAQs, testimonials, team bios — anything structured
- Constraints — Pre-launch? Pricing TBD? Missing photography? Legal requirements?
Sources: AGENTS.md, README.md, existing page files, data modules, brand guides, and conversation context.
Audience model
After gathering inputs, define the audience before writing a word. Produce a short profile for each distinct audience segment the page must address:
- Who they are — Role, situation, level of awareness of the problem/product
- What they already believe — Assumptions, prior experiences, mental models
- What objections they carry — Reasons they might leave without acting
- What language they use — How they describe the problem in their own words
Reference the relevant audience segment in each section's intent annotation (e.g., "This section targets first-time visitors who don't yet understand what the product does"). If a section doesn't clearly serve at least one segment, question whether it belongs.
Voice calibration
Before drafting, establish the page's voice concretely — not just "casual" or "professional," which mean different things to different people.
- Write 3 sample sentences in the proposed voice, covering different tones the page will need (e.g., a hero headline, an explanatory paragraph, an FAQ answer).
- Present these to the user for confirmation. Adjust until the voice feels right.
- Write all copy in the calibrated voice. If voice drifts between sections, catch it in review.
Competitive messaging analysis
If competitor pages are available (from inputs or by crawling), analyze them before drafting:
- Note each competitor's headline, value proposition, and primary CTA
- Identify messaging patterns — what claims do they all make?
- Find gaps — what do competitors fail to say, underemphasize, or get wrong?
- Use this to sharpen the wireframe's positioning — lean into the gaps
Summarize findings in a short "Competitive landscape" section at the top of the wireframe document, before the page sections begin. This gives the user context for why certain messaging choices were made.
Output format
Produce a single markdown file (e.g., HOMEPAGE-WIREFRAME.md) that reads top to
bottom like a visitor scrolling the page.
Section template
Every section must have an intent annotation and real copy. The structure below each intent adapts to the content type — not every section is headline + paragraph.
## [N]. [Section Name]
> **Intent:** What is this section's job? What should the visitor understand,
> feel, or do after reading it? Which audience segment does this serve?
>
> **Density:** [Light | Medium | Dense] — see guidance below
### Headline
[The actual headline words]
### Copy
[The actual paragraphs, bullets, labels — real words, not lorem ipsum]
### CTA
[Exact button/link text] → [destination]
> **Open question:** [Any decision the user needs to make — phrasing alternatives,
> missing info, things to confirm with stakeholders]
>
> **Content note:** [Constraints, dependencies, or context that affects this section]
Omit sub-sections that don't apply (e.g., not every section has a CTA).
Variant structures
Not all sections fit the headline → copy → CTA mold. Use the appropriate structure for the content:
- Data sections (pricing, specs, comparisons): Use tables or structured lists. Write column headers, row labels, and footnotes as real copy.
- Multi-item sections (features, team members, locations): Write the section-level headline and intro, then each item as a named entry with its own copy.
- Media-anchored sections (hero image, video, demo): Describe the media asset needed (subject, mood, what it should communicate) and write any overlay text, captions, or surrounding copy.
- Interactive sections (calculators, configurators, maps): Describe the interaction, write all labels and microcopy, and note what inputs/outputs the user sees.
Copy density guidance
Match density to the section's job:
| Density | When to use | Typical length |
|---|---|---|
| Light | Hero, closing CTA, navigation — sections that rely on a few precise words | 1-2 sentences, a single headline, or just labels |
| Medium | Value proposition, how-it-works, about — sections that explain or persuade | 1-3 short paragraphs or a headline + supporting bullets |
| Dense | FAQ, pricing details, product specs — se |