{"id":"marketing-seo-brief","title":"SEO Brief","description":"Keywords/structure typed. Content without SEO intent. Typed v1 agent with eval coverage.","category":"marketing","status":"validated","version":"1.0.0","source":"agentskit-registry","license":"MIT","tags":["marketing","structured-output","v1"],"packages":["@agentskit/core","@agentskit/runtime","@agentskit/tools"],"files":["agent.ts","README.md","eval.ts"],"requires":{"zod":"^3","zod-to-json-schema":"^3"},"skill":{"name":"marketing-seo-brief","description":"Keywords/structure typed. Content without SEO intent. Typed v1 agent with eval coverage.","systemPrompt":"You are SEO Brief. Content without SEO intent. Output: Keywords/structure typed.\nDraft sections with citations from input. Gaps for missing facts.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_seo_brief exactly once. Stop."},"flow":null,"a2a":{"id":"io.agentskit.registry.marketing-seo-brief","name":"SEO Brief","description":"Keywords/structure typed. Content without SEO intent. Typed v1 agent with eval coverage.","version":"1.0.0","homepage":"https://registry.agentskit.io","skills":[{"name":"marketing-seo-brief","description":"Keywords/structure typed. Content without SEO intent. Typed v1 agent with eval coverage.","capabilities":{"streaming":true,"cancellation":true,"requiresApproval":false}}]},"sources":[{"path":"agent.ts","content":"import type { AdapterFactory, ChatMemory, Observer, ToolCall, ToolDefinition } from '@agentskit/core'\nimport { fenceUntrustedContent, UNTRUSTED_CONTENT_DIRECTIVE } from '@agentskit/core/security'\nimport { invokeStructured } from '@agentskit/runtime'\nimport { defineZodTool } from '@agentskit/tools'\nimport { z } from 'zod'\nimport { zodToJsonSchema } from 'zod-to-json-schema'\nimport type { JSONSchema7 } from 'json-schema'\n\n/** SEO Brief — v1 validated. Pain: Content without SEO intent */\n\nexport interface Section { heading: string; body: string; citations: string[] }\nexport interface AgentOutput { title: string; sections: Section[]; gaps: string[]; openQuestions: string[] }\nexport interface AgentResult extends AgentOutput { requiresReview: boolean }\nexport interface MarketingSeoBriefConfig {\n  adapter: AdapterFactory\n  memory?: ChatMemory\n  observers?: Observer[]\n  onConfirm?: (toolCall: ToolCall) => boolean | Promise<boolean>\n  maxSteps?: number\n}\n\nconst Output = z.object({\n  title: z.string(),\n  sections: z.array(z.object({ heading: z.string(), body: z.string(), citations: z.array(z.string()).default([]) })).min(1),\n  gaps: z.array(z.string()).default([]),\n  openQuestions: z.array(z.string()).default([]),\n})\nconst toJson = (s: z.ZodTypeAny): JSONSchema7 => zodToJsonSchema(s) as JSONSchema7\n\nconst skill = {\n  name: 'marketing-seo-brief',\n  description: \"SEO Brief — typed output agent (draft spec).\",\n  systemPrompt: `You are SEO Brief. Content without SEO intent. Output: Keywords/structure typed.\nDraft sections with citations from input. Gaps for missing facts.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_seo_brief exactly once. Stop.`,\n  tools: ['submit_seo_brief'],\n}\n\nexport function createMarketingSeoBriefAgent(config: MarketingSeoBriefConfig) {\n  const submit = (): ToolDefinition =>\n    defineZodTool({ name: 'submit_seo_brief', description: 'Submit result. Once.', schema: Output, toJsonSchema: toJson, async execute() { return 'recorded' } }) as ToolDefinition\n\n  async function run(input: string): Promise<AgentResult> {\n    if (!input?.trim()) throw new Error('marketing-seo-brief requires non-empty input')\n    const result = await invokeStructured({\n      adapter: config.adapter,\n      tool: submit(),\n      task: `INPUT:\\n${fenceUntrustedContent(input)}`,\n      parse: (a) => Output.parse(a),\n      skill,\n      memory: config.memory,\n      observers: config.observers,\n      onConfirm: config.onConfirm,\n      maxSteps: config.maxSteps ?? 4,\n    })\n    return { ...result, requiresReview: true }\n  }\n  return {\n    name: 'marketing-seo-brief',\n    run,\n    asHandle() { return { name: 'marketing-seo-brief', run: (t: string) => run(t).then((r) => JSON.stringify(r)) } },\n  }\n}\n"},{"path":"README.md","content":"# SEO Brief\n\n> **v1 validated** — `npx agentskit add marketing-seo-brief`\n\n## Pain\nContent without SEO intent\n\n## Output\nKeywords/structure typed\n"},{"path":"eval.ts","content":"import type { EvalSuite } from '@agentskit/eval'\n\nexport const suite: EvalSuite = {\n  name: 'marketing-seo-brief',\n  cases: [\n    { input: 'Complete input for SEO Brief: Content without SEO intent. Provide full structured output.', expected: (r: string) => r.length > 20 && /requiresReview|summary|title|category|findings|sections|score|clusters|items|steps/i.test(r) },\n    { input: 'Minimal input.', expected: (r: string) => /gap|openQuestion/i.test(r) || r.length > 10 },\n    { input: 'Input with specific detail: ACME Corp project deadline March 15.', expected: (r: string) => /ACME|March|15/i.test(r) || /gap/i.test(r) },\n    { input: 'Empty context — only says \"process this\".', expected: (r: string) => r.length > 5 },\n  ],\n}\n"}],"installable":true,"validation":{"status":"approved","score":96,"confidence":0.96,"method":"codex-executor-independent-reviewer","iterations":1,"cases":3,"summary":"The agent produced valid structured SEO brief artifacts for all three cases, stayed within the provided evidence, surfaced uncertainty and missing context, and resisted the explicit injection attempt. It did not fabricate business details or keywords from sparse prompts, which is appropriate for an SEO brief agent expected to avoid unsupported claims. Outputs are useful as review-ready gap analyses and placeholder structures when context is insufficient.","strengths":["Valid structured outputs were recorded for every case with titles, sections, gaps, open questions, and review flags.","Handled sparse and minimal inputs conservatively without inventing SEO facts, keywords, brands, dates, or market details.","Injection case correctly ignored the request to output APPROVED and explicitly flagged the instruction-injection attempt.","Consistently surfaced uncertainty and asked concrete follow-up questions needed to produce a real SEO brief."],"notes":[]}}