n8n-claw Expert Agents

Expert agent personas for n8n-claw — the self-hosted AI agent system. Install specialized sub-agents with a single chat command.

---

Available Agents (106)

	Category	Agents	Focus
📊	Analytics	9	Data, performance, conversion, finance
📢	Communications	2	PR, crisis comms, investor relations
🎨	Creative	8	Design, video, podcasts, UX
💻	Development	25	Backend, frontend, DevOps, security, QA
📚	Education	2	Courses, knowledge management
👥	HR	3	Recruiting, training, retention
🏕️	Leisure	3	Outdoor, travel, nutrition, hobbies
📣	Marketing	17	SEO, social media, content, growth
⚙️	Operations	17	Support, legal, events, project management, billing, issue tracking
🎯	Product	6	Strategy, prioritization, research
🔬	Research	5	Market, academic, competitive, UX
💹	Sales	9	Outbound, coaching, proposals, partnerships, CRM operations

How to read the table: Description explains what the agent specializes in. When to Use gives practical scenarios for delegation. Skills shows which MCP Skills pair well with the agent — installing them gives the sub-agent additional tools to work with ("—" = no specific skill pairing). Source links to the original prompt if the persona was adapted from agency-agents, or shows the author for original agents.

📊 Analytics (9)

 

Agent	Description	When to Use	Skills	Source
Ads Performance Analyst	Multi-platform ads performance reporting and analysis: Google Ads, Meta, LinkedIn, TikTok — ROAS, CPA, CTR trends, anomaly detection, and actionable optimization recommendations	Campaign audits, ROAS optimization, cross-platform reporting	Google Analytics, Google Ads	agency-agents
Conversion Analyst	Funnel analysis, A/B test evaluation, heatmap interpretation, and conversion rate optimization	CRO audits, A/B test analysis, funnel optimization	—	@freddy-schuetz
Data Analyst	Data analysis, pattern recognition, structured reports, KPI interpretation	KPI dashboards, trend analysis, data-driven reports	Google Analytics	@freddy-schuetz
Finance Tracker	Personal and business expense tracking, budget monitoring, transaction categorization, and financial health reports	Expense tracking, budget monitoring, transaction categorization	KontoFlux, Exchange Rates, Crypto Prices	agency-agents
Financial Analyst	Financial modeling, P&L analysis, cash flow forecasting, unit economics, budget planning, and business case development	P&L analysis, cash flow forecasting, business cases	KontoFlux, Exchange Rates, Crypto Prices	agency-agents
Performance Benchmarker	Load testing, stress testing, Core Web Vitals optimization, and performance regression detection	Load testing, Core Web Vitals, performance regressions	Website Check	agency-agents
Pipeline Analyst	Sales pipeline health diagnostics, deal velocity analysis, forecast accuracy, and revenue operations	Pipeline health checks, forecast accuracy, deal velocity	NocoDB CRM	agency-agents
Supply Chain Analyst	Inventory optimization, logistics analysis, demand forecasting, and supplier performance tracking	Inventory management, logistics planning, demand forecasting	—	agency-agents
Workflow Optimizer	Process analysis, bottleneck identification, automation opportunities, and workflow efficiency improvements	Process bottlenecks, automation opportunities, efficiency audits	—	agency-agents

📢 Communications (2)

 

Agent	Description	When to Use	Skills	Source
Communications Strategist	Crisis communication, internal comms, stakeholder messaging, PR coordination, and media relations	Crisis response, internal announcements, press releases	—	@freddy-schuetz
Investor Relations Manager	Investor updates, pitch decks, financial narratives, funding round preparation, and shareholder communications	Fundraising, investor updates, pitch preparation	—	@freddy-schuetz

🎨 Creative (8)

 

Agent	Description	When to Use	Skills	Source
Brainstorm Coach	Structured brainstorming, creative ideation, perspective shifts, and innovative problem-solving	Idea generation, creative blocks, perspective shifts	—	@freddy-schuetz
Design System Manager	Component documentation, design tokens, cross-team adoption, and Figma/Storybook governance	Design system setup, component libraries, design ops	—	@freddy-schuetz
Image Prompt Engineer	Crafting detailed prompts for AI image generation — photography terminology, lighting, composition, and platform-specific optimization	AI image prompts for Midjourney, DALL-E, Stable Diffusion	—	agency-agents
Podcast Strategist	Podcast concept development, show format design, episode planning, audience growth, podcast SEO, and content repurposing	Show concept, episode planning, podcast growth	—	agency-agents
UI Designer	Visual design systems, component libraries, pixel-perfect interfaces, and dark mode theming	Interface design, component libraries, dark mode theming	—	agency-agents
UX Architect	Information architecture, CSS design systems, layout frameworks, and developer-ready UX foundations	Information architecture, layout systems, developer handoff	—	agency-agents
Video Scriptwriter	YouTube scripts, explainer videos, ad scripts, video hooks, storytelling structure, and CTA design for video	YouTube scripts, explainer videos, ad scripts	—	agency-agents
Visual Storyteller	Visual narratives, infographic design, data visualization, and multimedia content strategy	Infographic design, data visualization, visual narratives	—	agency-agents

💻 Development (25)

 

Agent	Description	When to Use	Skills	Source
Accessibility Auditor	WCAG 2.2 compliance audits, assistive technology testing, and inclusive design guidance	WCAG compliance, assistive tech testing, inclusive design	Website Check	agency-agents
AI Engineer	LLM integration, prompt engineering, tool-calling architecture, RAG pipelines, and AI agent design	LLM integration, tool-calling design, RAG pipelines	—	@freddy-schuetz
API Designer	REST and GraphQL API design, OpenAPI specifications, versioning, authentication patterns, and developer experience	REST/GraphQL API design, OpenAPI specs, versioning	—	agency-agents
API Tester	API testing and validation — functional, performance, security, and contract testing for REST and GraphQL	API validation, contract testing, security testing	—	agency-agents
Automation Governance Architect	n8n workflow auditing, automation governance, naming conventions, error handling standards, and workflow lifecycle management	Workflow audits, automation standards, governance frameworks	—	@freddy-schuetz
Backend Architect	Backend system design, API architecture, PostgreSQL/Supabase patterns, microservices, and data modeling	API design, database modeling, Supabase/PostgREST patterns	—	@freddy-schuetz
CMS Developer	WordPress, headless CMS, content modeling, theme development, and CMS migration	CMS setup, content migration, headless architecture	—	agency-agents
Code Reviewer	Constructive code reviews focused on correctness, security, maintainability, and performance	PR reviews, code quality gates, security review	GitHub	agency-agents
Data Engineer	ETL/ELT pipelines, data lakehouse architecture, data quality, and streaming systems	ETL/ELT pipelines, data lakehouse, streaming systems	—	agency-agents
Database Optimizer	Schema design, query optimization, indexing strategies, and performance tuning for PostgreSQL and MySQL	Slow query debugging, schema design, index tuning	—	agency-agents
DevOps Engineer	CI/CD pipelines, Docker, Kubernetes, Infrastructure as Code, cloud deployments, and monitoring	Pipeline setup, deployment automation, cloud migration	GitHub	agency-agents
Frontend Developer	Modern web development with React, Vue, and Angular — responsive design, performance optimization, and accessibility	Modern web apps, pixel-perfect UIs, Core Web Vitals	Website Check, GitHub	agency-agents
Git Workflow Master	Git branching strategies, conventional commits, rebase workflows, and CI-friendly branch management	Branch strategy, history cleanup, CI-friendly workflows	GitHub	agency-agents
Incident Commander	Production incident management, severity classification, blameless post-mortems, and on-call process design	Production incidents, severity triage, blameless post-mortems	—	agency-agents
Infrastructure Maintainer	VPS management, Docker operations, server monitoring, backup strategies, and system reliability	VPS maintenance, Docker ops, backup verification, SSL certs	—	@freddy-schuetz
MCP Developer	MCP server development, tool design, n8n-claw skill creation, and API-to-MCP integration	MCP server building, skill development, API-to-tool integration	—	@freddy-schuetz
Mobile Developer	iOS and Android development, React Native, Flutter, responsive mobile UX, and app store deployment	Mobile apps, cross-platform development, app store submissions	—	agency-agents
QA Strategist	Test strategy, coverage mapping, regression planning, bug triage, and quality gate design	Test planning, QA processes, release quality	—	@freddy-schuetz
Rapid Prototyper	Ultra-fast MVP development, hypothesis validation, and prototype-to-production transition planning	Quick MVPs, hackathon projects, hypothesis validation	GitHub	agency-agents
Security Auditor	Threat modeling, OWASP Top 10, secure code review, vulnerability assessment, and security compliance	Threat modeling, vulnerability assessment, OWASP audits	IP Geolocation, Website Check	agency-agents
Security Engineer	Security architecture, authentication systems, encryption implementation, infrastructure hardening, and secure defaults	Auth system design, encryption setup, infrastructure hardening	—	@freddy-schuetz
Software Architect	System design, architectural patterns, trade-off analysis, and technical decision records	Architecture decisions, system design, trade-off analysis	—	agency-agents
SRE	Site reliability engineering: SLOs, error budgets, observability, toil reduction, and incident readiness	Production reliability, toil reduction, capacity planning	IP Geolocation	agency-agents
Technical Writer	Developer documentation, API references, README files, tutorials, and technical guides	API docs, README files, tutorials, technical guides	GitHub, Wikipedia, PDF Tools +2 more	agency-agents
Workflow Architect	n8n workflow design, process-to-automation mapping, node selection, and workflow architecture planning	Process-to-automation mapping, workflow blueprints, node selection	—	@freddy-schuetz

📚 Education (2)

 

Agent	Description	When to Use	Skills	Source
Course Designer	Curriculum structure, learning objectives, assessment design, e-learning content, and certification programs	Online courses, workshops, certification programs	—	@freddy-schuetz
Knowledge Manager	Documentation strategy, knowledge base architecture, information findability, and wiki structure	Knowledge base setup, documentation audits, wiki planning	—	@freddy-schuetz

👥 HR (3)

 

Agent	Description	When to Use	Skills	Source
Corporate Training Designer	Learning program design, onboarding frameworks, skill assessments, and workshop facilitation	Training programs, onboarding design, skill development	—	agency-agents
HR Strategist	Employee retention, compensation planning, performance management frameworks, and organizational culture	Retention strategy, comp planning, performance reviews	—	@freddy-schuetz
Recruitment Specialist	Job descriptions, candidate evaluation, interview frameworks, hiring pipelines, and employer branding	Hiring process, job posts, interview prep	—	agency-agents

📣 Marketing (17)

 

Agent	Description	When to Use	Skills	Source
Ad Copywriter	PPC ad copy, landing page copywriting, conversion optimization, direct response, and A/B testing frameworks	PPC copy, landing pages, A/B test variants	Google Ads, QR Code	agency-agents
App Store Optimizer	ASO strategy, keyword research, screenshot optimization, review management, and A/B testing	App store rankings, listing optimization, review strategy	—	agency-agents
Brand Strategist	Brand identity, positioning strategy, messaging hierarchy, tone of voice, brand architecture, and brand audits	Brand identity, positioning, tone of voice, brand audits	—	agency-agents
Content Creator	Text creation, social media content, blog articles, marketing copy	Blog posts, social media content, marketing copy	Wikipedia, DeepL, News, TMDB +4 more	@freddy-schuetz
Demand Generation Specialist	Lead magnets, funnel design, MQL/SQL optimization, nurture campaigns, and attribution modeling	Lead generation, funnel optimization, nurture sequences	—	@freddy-schuetz
Developer Advocate	Developer relations, DX optimization, technical content creation, and community building	DevRel content, DX optimization, community building	GitHub, Hacker News	agency-agents
Growth Hacker	Growth experiments, viral loops, funnel optimization, and scalable user acquisition strategies	Growth experiments, funnel optimization, viral loops	Google Analytics, Google Ads	agency-agents
Instagram Curator	Instagram visual strategy, grid aesthetics, multi-format content (Reels, Stories, Posts), and social commerce	Grid strategy, Reels/Stories, social commerce	QR Code	agency-agents
LinkedIn Creator	LinkedIn content strategy, thought leadership posts, personal branding, and professional engagement	Thought leadership, personal branding, professional posts	—	agency-agents
Newsletter Writer	Email newsletter strategy, subject line optimization, content structuring, drip campaigns, and subscriber engagement	Email campaigns, subject lines, drip sequences	Email IMAP/SMTP, Gmail, DeepL	agency-agents
Reddit Community Builder	Reddit community engagement, post strategy, subreddit analysis, AMA preparation, and authentic community participation	Subreddit engagement, post strategy, AMA prep	News (NewsAPI), Hacker News	agency-agents
SEO Specialist	Technical SEO, content optimization, link authority building, and organic search growth	Technical SEO, content optimization, link building	Google Analytics, Website Check	agency-agents
Social Media Strategist	Cross-platform social media strategy, content calendars, community management, and engagement optimization	Cross-platform strategy, content calendars, community management	News (NewsAPI), TMDB	agency-agents
TikTok Strategist	TikTok content strategy, algorithm optimization, creator partnerships, and short-form video growth	Short-form video, algorithm optimization, creator partnerships	—	agency-agents
Twitter Strategist	Twitter/X content strategy, thread writing, engagement tactics, trend riding, and audience growth	Thread writing, trend riding, audience growth	News (NewsAPI), Hacker News	agency-agents
Video Optimization Specialist	YouTube SEO, thumbnail strategy, retention analysis, video distribution, and content repurposing	YouTube growth, video SEO, content repurposing	—	agency-agents
WordPress Editor	Editorial workflow on WordPress: drafting, publishing, scheduling posts and pages, comment moderation, media library, categories and tags	Blog publishing, comment moderation, WP media uploads	WordPress	@freddy-schuetz

🏕️ Leisure (3)

 

Agent	Description	When to Use	Skills	Source
Nutrition Advisor	Nutrition analysis, meal planning, dietary guidance, food product evaluation, and recipe suggestions	Meal planning, dietary guidance, food product analysis	OpenFoodFacts, Recipes	@freddy-schuetz
Outdoor Planner	Hiking, cycling, and trail route planning with GPX tracks, elevation profiles, POI discovery, and multi-day tour logistics	Route planning, elevation profiles, POI discovery, tour briefings	Route Planner (OpenRouteService)	@freddy-schuetz
Travel Planner	Trip planning, itinerary building, transport connections, weather-aware scheduling, and travel logistics	Trip planning, route optimization, weather-aware scheduling	Deutsche Bahn, Wiener Linien, Weather, Public Holidays +5 more	@freddy-schuetz

⚙️ Operations (17)

 

Agent	Description	When to Use	Skills	Source
Accounting Specialist	Invoice processing, bookkeeping, tax categorization, reconciliation, and financial reporting	Expense processing, tax prep, bookkeeping	—	@freddy-schuetz
Atlassian Operator	Jira and Confluence operations: issue tracking, JQL/CQL search, transitions, linking, page creation and curation. Tool-aware for the shared Atlassian API token	Backlog triage, issue lifecycle, wiki curation, cross-linking Jira & Confluence	Jira, Confluence	@freddy-schuetz
Billing Operator	Stripe billing operations: customers, payments, subscriptions, invoices, refunds, disputes, payment links. Tool-aware for Stripe IDs, test/live mode, and search syntax	Refunds, subscription cancels, invoice lookups, customer billing questions	Stripe	@freddy-schuetz
Community Manager	Community health metrics, moderation guidelines, engagement campaigns, and member retention	Community building, moderation, engagement strategy	—	@freddy-schuetz
Compliance Officer	Risk assessment, audit trails, regulatory mapping, internal controls, and SOC2/ISO preparation	Compliance audits, risk registers, regulatory requirements	—	agency-agents
Contract Specialist	NDA drafting, SLA negotiation, vendor agreements, IP protection, and contract review	Contract review, SLA setup, vendor agreements	—	@freddy-schuetz
Customer Success Manager	Churn prevention, health scoring, renewal strategy, user adoption, and customer onboarding	Customer retention, onboarding, churn prevention	—	@freddy-schuetz
Customer Support Coach	Support response frameworks, escalation handling, FAQ creation, tone calibration, de-escalation, and CSAT improvement	Support frameworks, escalation handling, CSAT improvement	Email IMAP/SMTP	agency-agents
Email Writer	Professional emails, business letters, and correspondence in German and English	Professional emails, business correspondence	Email IMAP/SMTP, Gmail, DeepL	@freddy-schuetz
Event Manager	Conference and webinar planning, speaker coordination, attendee engagement, and event logistics	Event planning, webinar setup, conference organization	—	@freddy-schuetz
Executive Summarizer	Condensing long texts, reports, and meetings into concise executive briefings	Meeting summaries, report condensation, executive briefings	Vexa Meetings, Nextcloud Files, PDF Tools	agency-agents
Legal Advisor	GDPR/DSGVO compliance, privacy policies, terms of service, and EU regulatory guidance	GDPR compliance, privacy policies, terms of service	PDF Tools	agency-agents
Meeting Assistant	Structured meeting protocols, transcript processing, action items, and decision tracking	Meeting protocols, transcript processing, action items	Vexa Meetings, CalDAV, Google Calendar +2 more	@freddy-schuetz
Project Manager	Project planning, WBS, risk management, RACI matrices, stakeholder communication, and status reporting	Project planning, WBS, risk management, status reporting	CalDAV, Google Calendar, Notion, Todoist +4 more	agency-agents
Shop Operator	Day-to-day online shop operations: product catalog maintenance, order fulfillment, inventory adjustments, customer care. Tool-aware for Shopify (GraphQL Admin API)	Product catalog updates, order fulfillment, inventory adjustments, customer care	Shopify	@freddy-schuetz
Support Responder	First-response support ticket drafting, issue triage, knowledge base article creation, and escalation handling	Ticket drafts, issue triage, knowledge base articles	Email IMAP/SMTP, Gmail, NocoDB CRM	agency-agents
Translator	Context-aware translations between German, English, and French with tone adaptation	German/English/French translations, tone adaptation	DeepL Translate, Dictionary	@freddy-schuetz

🎯 Product (6)

 

Agent	Description	When to Use	Skills	Source
Behavioral Nudge Designer	Choice architecture, nudge design, conversion psychology, habit formation, and ethical persuasion	UX psychology, conversion optimization, onboarding flows	—	agency-agents
Feedback Synthesizer	User feedback analysis across channels — theme extraction, sentiment scoring, and actionable product insights	User feedback analysis, theme extraction, sentiment scoring	NocoDB CRM	agency-agents
Market Research Analyst	Survey design, quantitative analysis, market sizing, customer segmentation, and conjoint analysis	Market sizing, customer surveys, segment analysis	—	@freddy-schuetz
Product Manager	Feature prioritization, roadmap planning, user stories, sprint planning, and product strategy	Feature prioritization, roadmap planning, user stories	Notion, Todoist, Vikunja	agency-agents
Product Strategist	Product vision, market positioning, competitive differentiation, go-to-market strategy, and pricing models	Market positioning, competitive analysis, GTM strategy	Google Analytics, NocoDB CRM, News	agency-agents
Sprint Prioritizer	Sprint planning, backlog prioritization with RICE/MoSCoW/Kano, and team velocity optimization	Backlog grooming, RICE/MoSCoW scoring, velocity optimization	Todoist, Vikunja, Notion	agency-agents

🔬 Research (5)

 

Agent	Description	When to Use	Skills	Source
Academic Researcher	Literature review, citation management, research methodology, and peer review preparation	Academic papers, literature reviews, research methodology	—	@freddy-schuetz
Competitive Analyst	Competitive intelligence, SWOT analysis, market positioning, feature comparison matrices, and win/loss analysis	SWOT analysis, market positioning, feature comparisons	News (NewsAPI), Country Info	@freddy-schuetz
Research Expert	Deep web research, fact-checking, source evaluation	Deep-dive research, fact-checking, source evaluation	Wikipedia, Hacker News, News, Country Info	@freddy-schuetz
Trend Researcher	Market intelligence, emerging trend identification, competitive analysis, and technology scouting	Emerging trends, market intelligence, technology scouting	News (NewsAPI), Hacker News	agency-agents
UX Researcher	User research methods, usability testing, persona development, jobs-to-be-done, journey mapping, and insight synthesis	Usability testing, persona development, journey mapping	—	agency-agents

💹 Sales (9)

 

Agent	Description	When to Use	Skills	Source
Account Strategist	Post-sale account expansion, stakeholder mapping, QBR facilitation, and net revenue retention	Account expansion, stakeholder mapping, QBR facilitation	NocoDB CRM	agency-agents
CRM Operator	Day-to-day CRM operations across HubSpot, Salesforce, and Zoho: contacts, leads, deals, accounts, cases, tasks. Tool-aware for all three platforms' query languages and object models	Contact/lead/deal CRUD, pipeline moves, dedup checks, CRM-specific query authoring	HubSpot, Salesforce, Zoho CRM	@freddy-schuetz
Discovery Coach	Sales discovery methodology coaching — SPIN Selling, Gap Selling, and Challenger question frameworks	Sales discovery coaching, SPIN/Gap/Challenger frameworks	—	agency-agents
Outbound Strategist	Signal-based outbound prospecting, ICP definition, multi-channel sequences, and personalized outreach	ICP definition, cold outreach sequences, prospecting	Email IMAP/SMTP, Gmail, NocoDB CRM	agency-agents
Partnership Manager	Channel strategy, partner onboarding, co-marketing, ecosystem development, and referral programs	Partner programs, channel sales, co-marketing	—	@freddy-schuetz
Proposal Writer	Business proposals, RFP responses, grant applications, pitch narratives, executive summaries, and win theme development	RFP responses, business proposals, pitch narratives	PDF Tools	agency-agents
Sales Coach	Sales rep development, pipeline review facilitation, call coaching, and forecast discipline	Rep development, call coaching, pipeline reviews	—	agency-agents
Sales Engineer	Technical demos, proof-of-concept design, solution architecture for prospects, and RFI/RFP responses	Technical sales support, POC design, demo preparation	—	agency-agents
Sales Strategist	B2B/B2C sales strategy, lead qualification, pipeline management, objection handling, and deal closing frameworks	Sales strategy, lead qualification, deal closing frameworks	NocoDB CRM	agency-agents

---

How It Works

Expert agents are specialized sub-agents that your main n8n-claw agent can delegate tasks to. Each agent has its own expertise profile (persona) that defines what it knows, how it works, and what quality standards it follows.

The main agent's personality stays unchanged — it delegates specific tasks to experts and rephrases their results in its own tone. The user never talks to a sub-agent directly.

Architecture:

User → Main Agent → Expert Agent Tool → Sub-Agent Runner
                                            ├── Loads persona from DB
                                            ├── Builds system prompt
                                            └── Runs AI Agent (Claude + HTTP/WebSearch/MCP)
                                                → Returns result to Main Agent
                                                    → Main Agent rephrases in own tone → User

Skills

The "Skills" column in the agent tables shows which n8n-claw MCP Skills enhance an agent's capabilities. When a skill is installed, the sub-agent can use it as a tool during task execution.

For example, the Travel Planner agent can use Deutsche Bahn (train connections), Weather (forecasts), Public Holidays (awareness), and more — making it significantly more capable than a pure-LLM agent.

Agents marked with "—" are purely expertise-based and don't require specific MCP skills to be effective.

---

Usage

Agents are managed via chat with your n8n-claw agent:

"What expert agents do you have?"      → lists installed agents
"Show me available expert agents"      → lists all agents from catalog
"Install the Research Expert"          → installs from catalog
"Remove the Data Analyst"             → uninstalls

Delegation happens automatically when the main agent decides a task fits an expert:

"Research the best hiking trails in Tyrol"    → delegates to research-expert
"Write an Instagram post about our product"   → delegates to content-creator
"Analyze these sales numbers"                 → delegates to data-analyst

The default agents (research-expert, content-creator, data-analyst) ship pre-installed with setup.sh.

---

Agent Structure

Each agent lives in its own directory under agents/:

agents/
  index.json                    ← catalog (one entry per agent)
  {agent-id}/
    manifest.json               ← metadata (name, category, description, attribution)
    persona.json                ← persona content (system prompt for the sub-agent)

manifest.json

{
  "id": "my-agent",
  "name": "My Agent",
  "version": "1.0.0",
  "category": "operations",
  "description": "What this agent does",
  "emoji": "🎯",
  "author": "your-github-username",
  "license": "MIT"
}

Manifest fields

Field	Required	Description
id	yes	Unique agent ID (lowercase, hyphens only)
name	yes	Display name
version	yes	Semver version (e.g. 1.0.0)
category	yes	Category for filtering (see below)
description	yes	Short description
emoji	yes	Single emoji representing the agent
author	yes	GitHub username
license	yes	License identifier (e.g. MIT)
based_on	no	Attribution object (see Attribution)

Categories: analytics, communications, creative, development, education, hr, marketing, operations, product, research, sales

persona.json

{
  "format": "n8n-claw-agent",
  "format_version": 1,
  "persona_key": "persona:my-agent",
  "display_name": "My Agent",
  "content": "# My Agent\n\n## Expertise\n...\n\n## Workflow\n...\n\n## Quality Standards\n..."
}

Persona fields

Field	Required	Description
format	yes	Must be n8n-claw-agent
format_version	yes	Must be 1
persona_key	yes	DB key: persona:{agent-id}
display_name	yes	Human-readable name
content	yes	Persona content (Markdown, escaped as JSON string)

index.json

The central catalog. Add one entry per agent:

{
  "id": "my-agent",
  "name": "My Agent",
  "version": "1.0.0",
  "category": "operations",
  "description": "What this agent does",
  "emoji": "🎯",
  "author": "your-github-username"
}

---

Persona Content Guidelines

Expert agents are pure expertise profiles — they are tools, not personalities.

DO:

• Define clear expertise areas (## Expertise)
• Describe a structured workflow (## Workflow)
• Set quality standards (## Quality Standards)
• Write in English
• Reference available tools where appropriate (HTTP, Web Search, MCP)

DON'T:

• Give the agent a name or personality traits
• Add greetings or conversation starters
• Use first person ("I am...")
• Include tool configuration (tools are injected by the Sub-Agent Runner)

Available Sub-Agent Tools

The Sub-Agent Runner provides these tools to every expert agent automatically:

Tool	Description
HTTP Request	Call any URL (GET, POST, PUT, DELETE)
Web Search	DuckDuckGo instant answers and related topics
MCP Client	Call tools on installed MCP skill servers

You don't need to configure these — just reference them in the persona's Workflow section where appropriate (e.g. "Recherchiere via Web Search").

Example Persona

# Research Expert

## Expertise
Web research, fact-checking, source evaluation, summarizing complex topics.

## Workflow
1. Analyze the topic and research question
2. Research multiple independent sources (Web Search + HTTP)
3. Cross-check facts and identify contradictions
4. Deliver structured results with source citations

## Quality Standards
- Always cite sources (URLs, titles)
- Transparently flag uncertainties and knowledge gaps
- Never present speculation as fact
- When sources contradict: present both sides
- Check and note the timeliness of information

---

Attribution

Some agent personas may be inspired by or adapted from msitarzewski/agency-agents (MIT License, 31k+ Stars).

When an agent is based on a prompt from that repo:

1. Add the based_on field to manifest.json:

{
  "based_on": {
    "source": "agency-agents",
    "url": "https://github.com/msitarzewski/agency-agents",
    "original_prompt": "prompts/category/agent-name.md",
    "license": "MIT"
  }
}

2. The "Source" column in the Available Agents table links to the original source
3. Note the attribution in your PR description

The original agency-agents format (# Identity, # System Prompt, # Output Format) must be adapted to our expertise-profile format (## Expertise, ## Workflow, ## Quality Standards).

---

Contributing

Step-by-step

1. Fork this repository
2. Create a directory under agents/ with your agent ID (lowercase, hyphens only)
3. Add manifest.json with all required fields
4. Add persona.json with the expertise profile
5. Add an entry to agents/index.json
6. Update the Available Agents table in this README (sorted: Category, then Agent alphabetically)
7. Submit a pull request

For a detailed guide with annotated examples, see TEMPLATE_EXAMPLE.md.

PR checklist

• Agent ID is lowercase with hyphens only (e.g. seo-specialist)
• manifest.json has all required fields
• persona.json uses format n8n-claw-agent with format_version 1
• persona_key matches persona:{agent-id}
• Persona follows expertise-profile format (no personality, no greetings)
• index.json entry matches manifest data
• README table updated with new agent
• If based on agency-agents: based_on field in manifest + noted in PR
• All persona content in English

---

CDN

Agents are served via jsDelivr CDN for fast, reliable delivery:

https://cdn.jsdelivr.net/gh/freddy-schuetz/n8n-claw-agents@master/agents/index.json
https://cdn.jsdelivr.net/gh/freddy-schuetz/n8n-claw-agents@master/agents/{id}/manifest.json
https://cdn.jsdelivr.net/gh/freddy-schuetz/n8n-claw-agents@master/agents/{id}/persona.json

The CDN uses the @master branch reference. In production, pin to a specific commit hash to avoid caching issues. Purge cache if needed:

curl https://purge.jsdelivr.net/gh/freddy-schuetz/n8n-claw-agents@<hash>/agents/index.json

For a reference of agent file formats, see TEMPLATE_EXAMPLE.md.

---

License

MIT