{ "schema": "aiblocks-page/1", "id": "agency-specialized-developer-advocate", "type": "agent", "name": "Developer outreach planner", "summary": "Get a developer relations plan: the top fixes to getting started, tutorial ideas, community actions and a monthly feedback report.", "headline": "Developer outreach planner", "subhead": "Give it your product, your developers and the complaints and questions you already have. It finds the top fixes to getting started, plans tutorials that answer real questions and plans community work. You get a plan, plus a report for your product team.", "job": { "id": "grow-social", "name": "Grow on social" }, "level": "intermediate", "thinking": "high", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-26", "inputs": [ { "type": "question", "required": true, "label": "Question", "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like" }, { "type": "voc_reviews", "required": true, "label": "Voc reviews", "what": "customer words from reviews, tickets, surveys or calls, with source and date" }, { "type": "source_text", "required": false, "label": "Source text", "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link" }, { "type": "spreadsheet", "required": false, "label": "Spreadsheet", "what": "a spreadsheet with its data, formulas and charts" }, { "type": "plan", "required": false, "label": "Plan", "what": "a dated plan: what to do, in what order, with a decision rule for each step" } ], "outputs": [ { "type": "plan", "required": true, "label": "Plan", "what": "a dated plan: what to do, in what order, with a decision rule for each step" }, { "type": "document", "required": true, "label": "Document", "what": "a finished document, such as a Word file, a PDF or a page of notes" } ], "you_give": [ "Your product and who the developers are", "The first thing a new developer must do, and a link to your quickstart or docs if you have one", "Evidence of friction, such as GitHub issues, support tickets, forum threads or survey answers (paste them)", "What content and channels you have now, such as docs, blog, Discord or videos (optional)", "How many hours a week the team can give (optional)", "Your numbers, such as sign-ups and time to first success (optional)" ], "you_get": [ "The top five onboarding fixes, each with the evidence and a suggested change", "Three to five tutorial or talk ideas, each tied to a real developer question", "Community actions, with reply templates for issues and a plan for office hours", "A monthly developer feedback report for your product team", "The numbers to track, with your starting values or MISSING", "A list of gaps and checks, including every code sample to test" ], "use_when": [ "You launched an API or tool and few developers get past the first step.", "Your GitHub issues, forum posts or support tickets keep showing the same pain and nobody has summed it up.", "You need a content and community plan for a developer audience, not a general marketing plan.", "You want to bring evidence from developers to your product team, in one short report." ], "skip_when": [ "You want the docs themselves written. Use the Developer docs writer or the Developer quickstart writer.", "You want a Discord or GitHub Discussions set-up with channels and rules. Use the Developer Community Builder agent.", "You want a plan to grow through partners and outside coders. Use the Developer adoption program planner.", "You want paid ads or general social posts. Use the Social media strategist." ], "output_sample": { "input": [ "Your product and who the developers are", "Your quickstart link or text", "GitHub issues, support tickets or forum posts from the last 30 days", "Your current content and channels (optional)" ], "prerequisites": [ "An AI that reads pasted text, such as Claude, ChatGPT or Gemini", "Someone who can run code samples before you publish them" ], "output": [ { "name": "What developers say", "contains": "Themes from your evidence, with counts only from what you pasted." }, { "name": "Top fixes", "contains": "Ranked onboarding and product fixes, each with evidence and a suggested change." }, { "name": "Content plan", "contains": "Tutorial and talk ideas, each tied to a real question, with an outline." }, { "name": "Community actions", "contains": "Reply templates for issues, an office hours rhythm and a way to pick champions." }, { "name": "Developer feedback report", "contains": "The top pain points with evidence, ready for your product team." }, { "name": "Measures", "contains": "Numbers to track, with your starting values or MISSING." }, { "name": "Gaps and checks", "contains": "Code to test, claims to verify and facts you did not give." } ] }, "output_shape": "WHAT DEVELOPERS SAY\n | how often in what you pasted | example from your evidence\n\nTOP FIXES\n | fix | evidence | effort | owner \n\nCONTENT PLAN\n | question it answers | format | outline \n\nCOMMUNITY ACTIONS\n Reply templates | Office hours | Champions \n\nDEVELOPER FEEDBACK REPORT\n Top pain points | evidence | what we told developers \n\nMEASURES\n | starting value | target \n\nGAPS AND CHECKS\n ", "how_to_use": [ "Download the pack from this page and add it to your AI as a skill. If you cannot, open a new chat and paste SKILL.md, then references/source-agent.md. Claude, ChatGPT and Gemini all work.", "Paste your product and who your developers are. Add your quickstart link or text.", "Paste the last 30 days of GitHub issues, support tickets or forum posts. Remove names and private data first.", "Say: \"Make my developer relations plan. Use only what I pasted. Do not invent counts or quotes. Mark any code as untested.\"", "Read the fix list first. Check each fix against the evidence. Take the list to the team that owns the product.", "Run every code sample yourself before you publish a tutorial. Then bring back the numbers a month later for the next report." ], "checks": [ "The result addresses your actual task and cites the evidence used.", "Examples, role-play experience and targets are kept separate from verified results.", "Claims of tests, memory, tool access or completed actions match what actually happened." ], "next": [ { "name": "Top-customer outreach planner", "url": "https://useaiblocks.com/skills/top-customer-touch-planner", "why": "Top-customer outreach planner" } ], "source": { "by": "Michael Sitarzewski and Agency Agents contributors", "repo": "msitarzewski/agency-agents", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/specialized/specialized-developer-advocate.md", "licence": "MIT", "original_name": "Developer Advocate", "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219" }, "credits": [ { "title": "Developer Advocate", "by": "Michael Sitarzewski and Agency Agents contributors", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/specialized/specialized-developer-advocate.md", "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions." }, { "title": "AI Blocks catalogue guidance", "by": "AI Blocks", "url": "https://useaiblocks.com", "used": "We added Before you start and After this sections that link to other AI Blocks steps. We refreshed those generated sections from the catalogue inputs and next-step links." } ], "files": [ "LICENSE", "references/source-agent.md", "SETUP.md", "source.json" ], "links": { "page": "https://useaiblocks.com/agents/agency-specialized-developer-advocate", "markdown": "https://useaiblocks.com/agents/agency-specialized-developer-advocate.md", "json": "https://useaiblocks.com/agents/agency-specialized-developer-advocate.json", "instructions": "https://useaiblocks.com/skills/agency-specialized-developer-advocate/SKILL.md", "download": "https://useaiblocks.com/skills/agency-specialized-developer-advocate.zip", "api_item": "https://useaiblocks.com/api/v1/items/agency-specialized-developer-advocate", "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-specialized-developer-advocate", "mcp": "https://useaiblocks.com/mcp" } }