- Home
- Skills
- Branding & Design
- Brief to Site Blueprint
Works with the AI Agents you already use
Brief to Site Blueprint
*by FS Studio* **Turn a messy client brief into a validated website plan in minutes, before you design a single pixel.** Clients don't send specs.
$14
Brief to Site Blueprint
Example session with this skill installed
Plan the website for this client brief before we start designing:
Hi! We're Northlight Studio, a small architecture practice in Porto, Portugal. We design private homes and small hospitality projects (guesthouses, a couple of restaurants).
Most of our clients find us through word of mouth and then ask to "see more of our work". Our current website is just a logo and an email address. We want a proper site that shows our built projects - we have professional photos of 9 finished projects.
We'd like
- A strong opening image
- Projects (each project with its own photos and a short description)
- About the studio / our approach
- Process: how a project works with us, from first meeting to construction
- Contact form so people can request a first meeting
Instagram: @northlight.studio
Email: hello@northlight-studio.example
We like calm, minimal, lots of white space. English only for now.
- Read your context and instructions
- Compiled the brief to site
Here is the validated site blueprint (site-blueprint.json). Validator: PASS.
{
"schema_version": "1.0",
"language": "en",
"project": {
"business_name": "Northlight Studio",
"industry": "architecture (private homes and small hospitality)",
"location": "Porto, Portugal",
"site_type": "portfolio",
"main_goal": "Turn word-of-mouth referrals into first-meeting requests by showing built work",
"audience": "Private homeowners and small hospitality owners referred by past clients",
"desired_style": "Calm, minimal, generous white space"
},
"contact": {
"phone": "",
"whatsapp": "",
"email": "hello@northlight-studio.example",
"instagram": "@northlight.studio",
"facebook": "",
"linkedin": "",
"address": "",
"google_maps": "",
"website": ""
},
"solution": {
"solution_type": "portfolio",
"mode": "single_page",
"capabilities": {
"contact_form": true,
"whatsapp": false,
"booking": false,
"products": false,
"payments": false,
"maps": false,
"blog": false,
"portfolio": true,
"membership": false,
"newsletter": false
},
"complexity": "low"
},
"cta_strategy": {
"objective": "lead_generation",
"primary_cta": "Request a first meeting",
"secondary_ctas": ["See our projects"]
},
"sections": [
{
"id": "hero",
"label": "Opening",
"source": "requested",
"purpose": "Open with one strong image of a built project and a single line about what the studio designs",
"funnel_stage": "awareness",
"visual_weight": "primary",
"emphasis": "secondary",
"narrative_role": "hook",
"visual_intensity": "high"
},
{
"id": "portfolio",
"label": "Projects",
"source": "requested",
"purpose": "Show the 9 built projects, each with its own photo set and a short description",
"funnel_stage": "interest",
"visual_weight": "secondary",
"emphasis": "protagonist",
"narrative_role": "prove",
"visual_intensity": "high"
},
{
"id": "process",
"label": "Process",
"source": "requested",
"purpose": "Explain how a project works with the studio, from first meeting to construction",
"funnel_stage": "interest",
"visual_weight": "secondary",
"emphasis": "secondary",
"narrative_role": "explain",
"visual_intensity": "medium"
},
{
"id": "about",
"label": "About the studio",
"source": "requested",
"purpose": "Present the studio and its design approach",
"funnel_stage": "trust",
"visual_weight": "secondary",
"emphasis": "supporting",
"narrative_role": "build_trust",
"visual_intensity": "low"
},
{
"id": "contact",
"label": "Contact",
"source": "requested",
"purpose": "Let referred visitors request a first meeting through a short form",
"funnel_stage": "action",
"visual_weight": "primary",
"emphasis": "secondary",
"narrative_role": "convert",
"visual_intensity": "medium"
}
],
"pages": [
{"slug": "/", "title": "Northlight Studio", "sections": ["hero", "portfolio", "process", "about", "contact"]}
],
"content_hierarchy": {
"primary": ["hero", "portfolio", "contact"],
"secondary": ["process", "about"],
"tertiary": ["privacy"]
},
"content_strategy": {
"primary_value_driver": "visual_proof",
"protagonist_sections": ["portfolio"],
"secondary_sections": ["process"],
"supporting_sections": ["about"],
"differentiator_summary": "Referred clients already trust the studio's reputation; what they ask for is to see more built work, and the studio has professional photos of 9 finished projects.",
"basis": "explicit"
},
"perception_shift": {
"initial_perception": "I was told they're good, but I can't picture what they would do for a home like mine.",
"target_perception": "They have already built homes and spaces like the one I want, and I can see the result.",
"perceptual_friction": "Referred visitors cannot see enough built work to imagine their own project (lack of visible proof).",
"central_belief": "This studio has solved projects like mine before.",
"dominant_evidence": "Professional photos of 9 built projects, private homes and small hospitality.",
"experience_thesis": "The experience must move the visitor from 'I've heard they're good' to 'they have built what I want' by foregrounding the 9 built projects.",
"basis": "explicit"
},
"missing_info": [
"Project names, locations and years for each of the 9 projects",
"Team members or founders to feature in About",
"Phone or WhatsApp (if they want a direct channel)"
],
"open_questions": [
"Which 2-3 projects do you want to show first? They will define the first impression.",
"Should each project have its own page, or open in a gallery view on the same page?",
"Do you want to show who is behind the studio (names and photos), or keep About focused on the approach?"
],
"assumptions": [
"Mode is single_page because the brief asks for a focused portfolio site; per-project pages can be added later if projects open in their own page.",
"About is supporting: referred clients already trust the reputation, so built work matters more than biography."
],
"warnings": [
"With 9 projects on one page, the projects section needs a compact index (cover image per project) to avoid an extremely long page."
]
}
Next steps: send the open questions to the client, then hand the blueprint to design/copy.
Connects securely to your tools. The creator never sees your data.
About this skill
by FS Studio
Turn a messy client brief into a validated website plan in minutes, before you design a single pixel.
Clients don't send specs. They send WhatsApp messages, long emails and "algo lindo para mi cafetería". This skill reads the brief the way a senior web strategist would and gives you a structured site blueprint: what the site must contain, in what order, what it must make visitors do, what should be the protagonist, and what still has to be asked.
It works in Spanish and English and outputs both a machine-readable site-blueprint.json and a short human summary you can send to the client.
What makes it different
Most "sitemap generator" prompts return a generic list: Home, About, Services, Contact. This skill makes the strategic decisions a professional makes:
- Content strategy. It decides what actually sells this business. For an architecture studio that is built projects; for a small law firm it is the people. It then marks 1-2 protagonist sections and orders the page around them.
- Perception shift. It states what the visitor believes before the site and what they must believe after it, the main friction, the concrete evidence available, and a one-sentence experience thesis. It is not "make it modern and premium".
- Narrative role per section. Every section gets a job (hook, explain, prove, build trust, convert) and a visual intensity, so the designer knows where the weight goes.
- CTA strategy derived from the business goal (lead generation, booking, purchase, newsletter, contact), using the client's own button text when they give one.
- No invented data. Contact details, prices and claims come only from the brief. The included validator flags any phone, email or address that is not in the original text.
- Honest gaps. Missing information becomes concrete client questions, ready to paste into a message. Every non-obvious decision is listed as an assumption.
Use cases
- A freelance web designer receives a brief and needs a structure to quote and design from.
- An agency standardizes discovery so every project starts from the same contract.
- A developer feeds the JSON to another agent or tool that writes copy or builds pages.
- A one-line brief ("necesito una web para mi cafetería") that needs to become a list of the right questions.
What you get
| File | Purpose |
|---|---|
SKILL.md | The skill instructions (8-step workflow plus quality gates) |
reference/blueprint-rules.md | Section, funnel, capability, value-driver and narrative tables (es/en) |
reference/site-blueprint.schema.json | The JSON contract (v1.0) |
scripts/validate_blueprint.py | Validator: schema plus 20+ consistency and anti-hallucination rules |
examples/ | 3 complete brief → blueprint pairs: law firm (es), architecture studio (en), one-line brief (es) |
tests/ | Unit tests for the validator, including edge cases |
Requirements
- An AI agent that supports Agent Skills (
SKILL.md). - Optional: Python 3.9+ to run the validator. It uses the standard library only, makes no network calls and has no dependencies. Without Python, the agent applies the same quality gates manually.
Example
Input (excerpt):
Somos Estudio Marenco, un estudio jurídico chico... Nuestros clientes son trabajadores y familias que muchas veces tienen miedo de que un estudio no les dé bola porque su caso es "chico".
Output (excerpt):
"content_strategy": {
"primary_value_driver": "trust_and_expertise",
"protagonist_sections": ["team"]
},
"perception_shift": {
"perceptual_friction": "Miedo a que un estudio serio no le dé importancia a un caso considerado chico.",
"experience_thesis": "La experiencia debe llevar al visitante de 'mi caso es muy chico para un estudio' a 'acá me van a tomar en serio' poniendo en primer plano a las abogadas y su experiencia."
}
See examples/ for the full files.
Implementation status
| Feature | Status |
|---|---|
| Project and contact extraction with a no-invention rule | ✅ Included, enforced by the validator |
| Solution type, single/multi-page mode, 10 capabilities, complexity | ✅ Included |
| Sections with funnel stage, visual weight, narrative role and intensity | ✅ Included |
| CTA strategy (5 objectives) | ✅ Included |
| Content strategy (6 value drivers, protagonist sections) | ✅ Included |
| Perception shift (7 fields) | ✅ Included |
| Missing info, open questions, assumptions and warnings | ✅ Included |
| Validator (schema plus semantic rules) | ✅ Included, with 29 unit tests |
| Final copywriting, colors, fonts, HTML/CSS | ❌ Not included, by design |
| Competitor research or web browsing | ❌ Not included |
| Project pricing or hour estimates | ❌ Not included |
Compatibility and testing
Field-tested on 2026-11-03 with the final release. Every test gives the agent a normal user request without naming the skill. The output is checked with the skill's own validator plus case-specific expectations: correct classification, no invented data, the right verdict and so on.
| Environment | Status | Evidence |
|---|---|---|
| Claude Code (CLI 2.1.317) | ✅ Functionally tested | 8/8 cases passed. The skill was discovered and loaded automatically from .claude/skills/ in every run |
| OpenAI Codex CLI (0.164.0) | ✅ Functionally tested | 8/8 cases passed. The skill was discovered automatically from .agents/skills/ in every run |
Built on the open Agent Skills standard: a plain SKILL.md with name/description frontmatter, relative paths only and no tool-specific features.
What the 8 cases cover: 5 cases use inputs that are not in the shipped examples, so the agent cannot copy an example. The other 3 reproduce the shipped examples and only show that the examples can be reproduced. The cases include realistic inputs and edge cases: incomplete input, ambiguous input, unusual wording and mixed languages.
Validator and unit tests: these run anywhere with Python 3.9+ (python -m unittest discover -s tests).
AI agents are not deterministic. Two runs on the same input can phrase things differently or find slightly different sets of minor issues. The contract, the closed vocabularies and the validator keep the structure and the critical decisions consistent.
Pricing
US$14: a single license for your own and your clients' projects. It will also be part of the Web Proposal Pack (Blueprint + Art Director Review + Feedback Interpreter) for US$39.
License
FS Studio Commercial Skill License (single user). See LICENSE.txt.
- ✅ Use it in personal and commercial projects, including paid client work.
- ✅ The outputs you generate (blueprints, reviews, change requests) are yours.
- ❌ No redistribution, sharing or resale of the skill or its files, alone or bundled in another product.
The license supplements the Agensi Terms of Service, which prevail in case of conflict.
© 2026 Facundo Sicart · Published by FS Studio
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Branding & Design.
Does not write final copy, pick colors or fonts, or generate HTML/CSS. No competitor research or web browsing. No project pricing or hour estimates. Output quality depends on the brief: with little information, most decisions are marked as inferences (by design).
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 14 days ago
Nothing to install. It runs in your AI agent.
- Optional
Python 3.9+
Python only runs the bundled validator, with the standard library.