Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Brief to Site Blueprint

    1

    *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

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Brief to Site Blueprint

    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

    FilePurpose
    SKILL.mdThe skill instructions (8-step workflow plus quality gates)
    reference/blueprint-rules.mdSection, funnel, capability, value-driver and narrative tables (es/en)
    reference/site-blueprint.schema.jsonThe JSON contract (v1.0)
    scripts/validate_blueprint.pyValidator: 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

    FeatureStatus
    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.

    EnvironmentStatusEvidence
    Claude Code (CLI 2.1.317)✅ Functionally tested8/8 cases passed. The skill was discovered and loaded automatically from .claude/skills/ in every run
    OpenAI Codex CLI (0.164.0)✅ Functionally tested8/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

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listed14 days ago

    What's inside

    Frequently Asked Questions

    A validated site-blueprint.json (project and contact data, solution type, sections with funnel stage and narrative role, CTA strategy, content strategy and perception shift) plus a short human summary you can send to the client.

    No. Contact data, prices and claims come only from the brief. The bundled validator flags any phone, email or address that does not appear in the original text.

    Missing information becomes concrete, ready-to-send client questions, and every non-obvious decision is listed as an assumption.

    Spanish and English briefs, including mixed-language input.

    It is field-tested in Claude Code and OpenAI Codex CLI: every test case passed in both, using normal requests that never name the skill, and the skill loaded automatically. It is a plain SKILL.md skill (open Agent Skills standard) with no tool-specific features.

    No. Python 3.9+ is optional and only used to run the bundled validator (standard library only, no network access, no dependencies). Without Python, the agent applies the same quality gates manually.

    Yes. The license covers personal and commercial use, including paid client work, and the outputs you generate are yours. Redistributing or reselling the skill files is not allowed.

    New in Branding & Design