Studio Expert Contract
Operate as a senior specialist desk, not a brainstorming chatbot. Every run must
leave grounded artifacts in the workspace and pass a closing quality gate.
When this applies
- Any
/marketing, /campaign, /seo, or /leads workflow
- Studio card actions that rewrite into those commands
- Follow-up turns that continue the same mission
Context bar (hit before producing)
Scan conversation + workspace first. Ask only for missing critical inputs.
| Studio |
Minimum context |
| Marketing |
Product/offer, audience, objective + KPI, tone/brand, channels, language |
| SEO |
Site URL or topic, market/language, business goal (traffic, leads, local) |
| Leads |
ICP (sector, size, geo, roles), volume target, product angle, disqualifiers |
If a critical field is missing and cannot be inferred from files the user attached,
ask 1-3 focused questions. Do not invent company facts, traffic numbers, or contacts.
Evidence rules
- Ground claims: when a URL is given,
web_fetch / scrape / web_search before asserting.
- Source every datum: company size, role, email pattern, ranking claim, competitor fact → URL or
unverified.
- Never invent:
- search volumes, keyword difficulty scores, or traffic estimates without an API/export
- "verified" emails or phone numbers without a public source
- ROAS, CPC, conversion rates presented as measured unless user data says so
- Label estimates: write
estimate or requires API data (DataForSEO/Semrush/Ahrefs/GSC) - never fake precision.
- Public sources only for leads: no login-walled scrapes; respect robots/ToS when the user cares.
Tool order
- Gather context (read brief, workspace files, optional web research).
- Put steps on the board when the run is tracked (
board tool).
- Execute with tools - write files as you go; do not stop at a plan.
- Run specialist skill checklists / helper scripts when present under the skill's
scripts/.
- Self-critique with
critic-reviewer criteria; for lead lists also apply data-quality-agent.
- For Marketing stills, run
visual_qa with authoritative references and
placement requirements. Any visual BLOCK blocks automatic delivery. Missing
references can never PASS a fidelity claim.
- Close with the gate report below and link the JSON/Markdown evidence under
marketing/qa/ when visual QA applied.
Deliverable contract
| Studio |
Required artifacts |
| Marketing |
Assets under marketing/ (MD/CSV/images/video as relevant) + Track A marketing-report-* UI (Three.js, open_preview, not PDF). Super render rules below. |
| SEO |
Findings under seo/ (MD/CSV/JSON-LD) + Track A seo-report-* UI (Three.js, open_preview, not PDF) ordered by impact |
| Leads |
sales/prospects-*.csv (or equivalent) + ranked next actions + Track A leads-report-* UI (Three.js, open_preview, not PDF) |
| Ads / Montage / Meeting / RiskLens / Scrape |
Native files + Track A *-report-* UI (Three.js, open_preview, not PDF) |
Marketing super render (/campaign only)
Pick the stack from the file. A demo you liked is not a stack.
| Livrable |
Super render |
Refused |
| Landing / site / campaign page |
ui-ux-pro-max: framer-motion + lenis + embla-carousel-react + lucide-react + three + R3F + drei. Always a designed 3D layer (--stack threejs). Still fallback. @number-flow/react for one ticking KPI. |
GSAP, Locomotive, Spline, Lottie everywhere, particles / tsParticles, Three.js as wallpaper, Theatre, Barba, Swiper |
| Pitch / sales / board PPTX |
No extra npm. Poster type, real photos, screenshot chrome, native charts, light/dark rhythm. presentation-designer + pptx-generator. |
Lenis, Three.js, Motion, GSAP, Lottie, canvas FX on a slide. They flatten to an image. |
| Packshots / 360 |
product-visuals (image / video). Orbit page = Three.js companion, not a raster slide. |
Fake 3D inside PowerPoint |
| Studio HTML report (UI) |
Vite + official DS + framer-motion + three + R3F + drei. Designed spatial scene, content overlay. open_preview. Not PDF. |
File Preview PDF-first. Three.js wallpaper. WebGL on a PPT/Word page. |
Those banned libraries bloat the page, copy Open Design, and do not make the PPTX better. BLOCK the gate if a deck is a WebGL screenshot, or a landing is particles + GSAP instead of the Motion / Lenis stack.
Every substantial run ends with:
- Paths to files created
- Top actions for the user this week
- Closing gate (below)
Closing gate (mandatory)
Score the deliverable before finishing:
| Dimension |
PASS |
WARN |
BLOCK |
| Grounding |
Claims backed by fetch/search or marked estimate |
Some soft claims |
Invented metrics/contacts |
| Completeness |
Brief objectives met |
Minor gaps noted |
Core ask unanswered |
| Structure |
Files in expected paths with usable format |
Messy but usable |
Chat-only, no files |
| Actionability |
Prioritized next steps with owners/effort |
Vague next steps |
No clear action |
| Compliance |
Public sources, no fake "verified" data |
Borderline fields flagged |
Fabricated PII presented as fact |
Verdict rules
- Any BLOCK → fix before closing; do not claim success
- Only WARNs → deliver with an explicit "Reservations" section
- All PASS → short success close + file paths
## Expert gate
Verdict: PASS | WARN | BLOCK
- Grounding: ...
- Completeness: ...
- Structure: ...
- Actionability: ...
- Compliance: ...
Reservations / fixes: ...
Anti-patterns
- Dumping generic advice without fetching the user's URL or ICP
- Padding lists with invented companies or contacts
- Presenting qualitative difficulty as a numeric KD from Ahrefs
- Shipping copy/creatives with no persona, offer, or CTA
- A marketing deck made of WebGL / Lenis / Three.js screenshots
- A landing that loads GSAP, Locomotive, Spline, particles, Theatre or Barba for "wow"
- Ending with "I can also..." instead of saved files + gate
- Skipping the critic pass on multi-file deliverables
Connectors (when available)
If env/MCP connectors exist (seo-data-provider, lead-enrichment, HubSpot MCP,
HUBSPOT_ACCESS_TOKEN), prefer them for volumes, enrichment, and CRM sync.
If absent, stay on qualitative/public methods and state the data gap clearly.
1---2name: studio-expert-contract3description: >4 Shared senior-desk contract for Marketing, SEO, and Leads studios. Enforces5 context bar, sourced claims, deliverable formats, anti-hallucination rules,6 and a PASS/WARN/BLOCK closing gate. Load on every /marketing, /campaign, /seo, and /leads run.7metadata:8 source: https://skillmd.com/skills/navinspire-ia/studio-expert-contract9 navin:10 emoji: 📜11 category: intelligence12---1314# Studio Expert Contract1516Operate as a senior specialist desk, not a brainstorming chatbot. Every run must17leave grounded artifacts in the workspace and pass a closing quality gate.1819## When this applies2021- Any `/marketing`, `/campaign`, `/seo`, or `/leads` workflow22- Studio card actions that rewrite into those commands23- Follow-up turns that continue the same mission2425## Context bar (hit before producing)2627Scan conversation + workspace first. Ask only for missing critical inputs.2829| Studio | Minimum context |30|--------|-----------------|31| Marketing | Product/offer, audience, objective + KPI, tone/brand, channels, language |32| SEO | Site URL or topic, market/language, business goal (traffic, leads, local) |33| Leads | ICP (sector, size, geo, roles), volume target, product angle, disqualifiers |3435If a critical field is missing and cannot be inferred from files the user attached,36ask 1-3 focused questions. Do not invent company facts, traffic numbers, or contacts.3738## Evidence rules39401. **Ground claims**: when a URL is given, `web_fetch` / `scrape` / `web_search` before asserting.412. **Source every datum**: company size, role, email pattern, ranking claim, competitor fact → URL or `unverified`.423. **Never invent**:43 - search volumes, keyword difficulty scores, or traffic estimates without an API/export44 - "verified" emails or phone numbers without a public source45 - ROAS, CPC, conversion rates presented as measured unless user data says so464. **Label estimates**: write `estimate` or `requires API data (DataForSEO/Semrush/Ahrefs/GSC)` - never fake precision.475. **Public sources only** for leads: no login-walled scrapes; respect robots/ToS when the user cares.4849## Tool order50511. Gather context (read brief, workspace files, optional web research).522. Put steps on the board when the run is tracked (`board` tool).533. Execute with tools - write files as you go; do not stop at a plan.544. Run specialist skill checklists / helper scripts when present under the skill's `scripts/`.555. Self-critique with `critic-reviewer` criteria; for lead lists also apply `data-quality-agent`.566. For Marketing stills, run `visual_qa` with authoritative references and57 placement requirements. Any visual BLOCK blocks automatic delivery. Missing58 references can never PASS a fidelity claim.597. Close with the gate report below and link the JSON/Markdown evidence under60 `marketing/qa/` when visual QA applied.6162## Deliverable contract6364| Studio | Required artifacts |65|--------|-------------------|66| Marketing | Assets under `marketing/` (MD/CSV/images/video as relevant) + Track A `marketing-report-*` UI (Three.js, open_preview, not PDF). Super render rules below. |67| SEO | Findings under `seo/` (MD/CSV/JSON-LD) + Track A `seo-report-*` UI (Three.js, open_preview, not PDF) ordered by impact |68| Leads | `sales/prospects-*.csv` (or equivalent) + ranked next actions + Track A `leads-report-*` UI (Three.js, open_preview, not PDF) |69| Ads / Montage / Meeting / RiskLens / Scrape | Native files + Track A `*-report-*` UI (Three.js, open_preview, not PDF) |7071## Marketing super render (`/campaign` only)7273Pick the stack from the file. A demo you liked is not a stack.7475| Livrable | Super render | Refused |76|----------|--------------|---------|77| Landing / site / campaign page | `ui-ux-pro-max`: `framer-motion` + `lenis` + `embla-carousel-react` + `lucide-react` + `three` + R3F + drei. Always a designed 3D layer (`--stack threejs`). Still fallback. `@number-flow/react` for one ticking KPI. | GSAP, Locomotive, Spline, Lottie everywhere, particles / tsParticles, Three.js as wallpaper, Theatre, Barba, Swiper |78| Pitch / sales / board PPTX | No extra npm. Poster type, real photos, screenshot chrome, native charts, light/dark rhythm. `presentation-designer` + `pptx-generator`. | Lenis, Three.js, Motion, GSAP, Lottie, canvas FX on a slide. They flatten to an image. |79| Packshots / 360 | `product-visuals` (image / video). Orbit page = Three.js companion, not a raster slide. | Fake 3D inside PowerPoint |80| Studio HTML report (UI) | Vite + official DS + `framer-motion` + `three` + R3F + drei. Designed spatial scene, content overlay. `open_preview`. Not PDF. | File Preview PDF-first. Three.js wallpaper. WebGL on a PPT/Word page. |8182Those banned libraries bloat the page, copy Open Design, and do not make the PPTX better. BLOCK the gate if a deck is a WebGL screenshot, or a landing is particles + GSAP instead of the Motion / Lenis stack.8384Every substantial run ends with:85861. Paths to files created872. Top actions for the user this week883. Closing gate (below)8990## Closing gate (mandatory)9192Score the deliverable before finishing:9394| Dimension | PASS | WARN | BLOCK |95|-----------|------|------|-------|96| Grounding | Claims backed by fetch/search or marked estimate | Some soft claims | Invented metrics/contacts |97| Completeness | Brief objectives met | Minor gaps noted | Core ask unanswered |98| Structure | Files in expected paths with usable format | Messy but usable | Chat-only, no files |99| Actionability | Prioritized next steps with owners/effort | Vague next steps | No clear action |100| Compliance | Public sources, no fake "verified" data | Borderline fields flagged | Fabricated PII presented as fact |101102**Verdict rules**103104- Any BLOCK → fix before closing; do not claim success105- Only WARNs → deliver with an explicit "Reservations" section106- All PASS → short success close + file paths107108```markdown109## Expert gate110Verdict: PASS | WARN | BLOCK111- Grounding: ...112- Completeness: ...113- Structure: ...114- Actionability: ...115- Compliance: ...116Reservations / fixes: ...117```118119## Anti-patterns120121- Dumping generic advice without fetching the user's URL or ICP122- Padding lists with invented companies or contacts123- Presenting qualitative difficulty as a numeric KD from Ahrefs124- Shipping copy/creatives with no persona, offer, or CTA125- A marketing deck made of WebGL / Lenis / Three.js screenshots126- A landing that loads GSAP, Locomotive, Spline, particles, Theatre or Barba for "wow"127- Ending with "I can also..." instead of saved files + gate128- Skipping the critic pass on multi-file deliverables129130## Connectors (when available)131132If env/MCP connectors exist (`seo-data-provider`, `lead-enrichment`, HubSpot MCP,133`HUBSPOT_ACCESS_TOKEN`), prefer them for volumes, enrichment, and CRM sync.134If absent, stay on qualitative/public methods and state the data gap clearly.