asets-gobizit/converting-briefs-to-websites

<!-- Built by Danny · 2026-03-10 -->

brief2web

Converts a business brief into a complete website content package: messaging framework, webpage structure, copy, visual strategy, and LinkedIn posts. Operates as a Senior Conversion Copywriter / Web Marketing Strategist. All business facts must come from the brief — never invented.

---

⚙️ FUNCTIONAL CODE

| Script | Purpose | |--------|---------| | brief2web.py | Reads brief doc text, saves LinkedIn posts as .docx |

Run directly: python "C:/Users/dansk/.claude/skills/brief2web/brief2web.py" --file "filename.docx"

---

When to Use This Skill

• User says "brief2web" or "convert brief to website"
• User uploads a .docx, .pdf, or .pptx and asks for webpage content
• User says "create a webpage from this document"
• User mentions "messaging framework", "webpage copy from brief", or "LinkedIn post from brief"

---

HOW TO INVOKE

/brief2web

Or: user provides a brief document name and asks to generate website content.

---

Workflow

Run these steps in order. Do not skip or reorder.

Step 1 — Gather Inputs

Ask these questions one at a time (not all at once):

Q1 — Existing website (optional):

"Do you have an existing website? If yes, share the URL and I'll match its design."

• If URL provided: fetch the page, identify CSS patterns, color palette, font style, layout structure. Do not redesign. Only add content.
• If no URL: proceed with clean slate.

Q2 — New page URL:

"What will be the URL of the new page? (e.g. https://gobizit.ai/ai-crm-automation)"

Q3 — Brief document name(s):

"What is the filename of your brief? It should be in the Vid-Trrasncipts-Files folder. If multiple files, separate with commas."

Brief document folder: C:/Users/dansk/Zoho WorkDrive (Go Biz IT)/00 Claude.ai/@CoWorkAccess/Vid-Trrasncipts-Files/

Supported formats: .docx, .pdf, .ppt, .pptx

Read brief using:

python "C:/Users/dansk/.claude/skills/brief2web/brief2web.py" --file "filename.docx"

---

Step 2 — Read Reference Documents

Scan: C:/Users/dansk/Zoho WorkDrive (Go Biz IT)/00 Claude.ai/@CoWorkAccess/Vid-Trrasncipts-Files/

• Identify documents related to website creation, marketing processes, or copywriting workflows.
• Extract relevant insights and apply them when generating webpage content.

---

Step 3 — Analyze the Brief

Extract only information explicitly present in the document:

Required (must find):

• Business description
• Products or services

Extract only if present:

• Differentiators
• Customer problems
• Desired outcomes
• Supporting proof / case studies
• Credibility indicators (years in business, certifications, client logos)

Constraint: Do NOT invent or assume any business facts not in the document.

---

Step 4 — Messaging Framework (Approval Gate)

Generate and display:

MESSAGING FRAMEWORK
────────────────────────────────────────
Target Audience:   [who they serve]
Problem:           [what pain they solve]
Desired Outcome:   [what customers want to achieve]
Unique Value Prop: [what makes them different]
Core Offer:        [what they provide]
CTA Strategy:      [only if CTA found in brief — otherwise omit this line]
────────────────────────────────────────

Ask:

"Do you approve this messaging framework before I generate the webpage?"

Do not proceed until user confirms approval.

---

Step 5 — Optional: Offer Generator

Assess if a new service/product offer should be suggested based on the brief.

If appropriate, generate:

SUGGESTED OFFER
────────────────────────────────────────
[Offer title]
[1-2 sentence description]

Deliverables:
• [Item 1]
• [Item 2]
• [Item 3]
────────────────────────────────────────

Ask:

"Would you like this suggested offer included on the webpage?"

Only include if user approves.

---

Step 6 — Webpage Structure

Generate a structured layout. Adapt sections to content available in the brief:

| # | Section | Include When | |---|---------|-------------| | 1 | Hero | Always | | 2 | Problem | If customer problem found in brief | | 3 | Solution | Always | | 4 | Benefits | If benefits/outcomes found | | 5 | Products / Services | Always | | 6 | Credibility / Proof | If credibility indicators found | | 7 | Call to Action | Only if CTA found in brief |

Generate full copy for each included section.

---

Step 7 — Visual Strategy

Output before generating any images:

VISUAL STRATEGY
────────────────────────────────────────
Hero Image:        [description]
Section Graphics:  [description]
Background Style:  [description]
Color Palette:     [from existing site OR derived from industry]
────────────────────────────────────────

• If existing website provided: match its CSS, colors, and typography.
• Images may be generated via Picsart API.
• Possible uses: hero images, conceptual illustrations, service visuals, backgrounds.

---

Step 8 — Conversion Optimization Check

Before finalizing output, run:

CONVERSION CHECK
────────────────────────────────────────
Headline clarity:           [ PASS / FAIL ]
Value proposition clarity:  [ PASS / FAIL ]
CTA visibility:             [ PASS / FAIL ] (skip if no CTA)
Credibility signals:        [ PASS / FAIL ]
────────────────────────────────────────

If any item FAILS:

1. Identify the failing element.
2. Revise the relevant section.
3. Re-run the check.
4. Repeat until all applicable items PASS.

---

Step 9 — LinkedIn Post Generation + Save

Generate 1–2 LinkedIn posts that:

• Summarize the page value
• Highlight the unique value proposition
• Encourage engagement
• Include the new page URL

Save as .docx using:

python "C:/Users/dansk/.claude/skills/brief2web/brief2web.py" --linkedin "post text here" --slug "page-slug"

Output folder: C:/Users/dansk/Zoho WorkDrive (Go Biz IT)/00 Claude.ai/@CoWorkAccess/Vid-Trrasncipts-Files/

File naming: linkedin-post-[page-slug]-[YYYY-MM-DD].docx

---

Final Output Checklist

• [ ] Business summary extracted from brief
• [ ] Messaging framework (approved by user)
• [ ] Marketing positioning summary
• [ ] Structured webpage layout
• [ ] Full website copy for the new page
• [ ] Visual strategy
• [ ] Generated images or image prompts
• [ ] Conversion check passed
• [ ] LinkedIn posts saved as .docx

---

Key Constraints

• Business facts: only from the brief — never invented
• Existing site design: preserve CSS, colors, layout — never redesign
• Messaging framework: must be approved before webpage generation
• CTA sections: only if CTA found in brief or inputs
• Conversion check: must pass before final delivery

---

Dependencies

| Tool | Install | |------|---------| | python-docx | pip install python-docx | | pdfplumber | pip install pdfplumber | | python-pptx | pip install python-pptx |