Skip to main content

branchly Skills

Skills give any AI coding assistant (OpenCode, Claude Code, Cursor) structured, step-by-step workflows for setting up, optimizing, or creating content for a branchly application — without you having to guide it manually.

Each skill encodes the correct workflow for its task and uses the branchly MCP Server under the hood to read and analyze your application directly.

Requirements​

The branchly MCP Server must be connected in your AI coding tool. See the MCP Server page for setup instructions.

Installation​

All skills live in the public GitHub repository branchly-io/branchly-skills, where you can also browse each skill's full source.

Install all available skills at once (recommended):

npx skills add branchly-io/branchly-skills --all

Or to install one skill only:

npx skills add branchly-io/branchly-skills --skill optimize-application
npx skills add branchly-io/branchly-skills --skill content-ideas

Available Skills​

optimize-application​

Systematically debug and optimize a branchly application. Covers session triage, retrieval quality, prompt/tool alignment, and data source health.

Debugging a branchly application involves multiple layers — content, retrieval, routing, prompts — and it's important to fix the right one. This skill encodes the correct decision tree so the AI diagnoses before it acts.

Triggers when you mention:

  • "Optimize my branchly application"
  • "Debug why my AI Action never fires"

The skill activates automatically and guides the AI through the full diagnostic workflow.

content-ideas​

Analyze branchly analytics to generate prioritized website content recommendations: page updates, targeted FAQ question lists, and new article/blog topics. It helps you optimize your website content for AI search and user clarity.

The skill is read-only and strategic: it identifies and prioritizes content opportunities — it does not write the content itself. Output is a prioritized report of (1) ready-to-use FAQ question sets, (2) updates for existing pages, and (3) topics for new articles or guides, each backed by evidence from your real user interactions, search queries, and knowledge gaps.

Triggers when you mention:

  • "What content should we create?" / "Content ideas"
  • "Which pages/topics should we prioritize on our website?"
  • "What questions should we add as FAQs?"
  • "Find content gaps on our website"
  • "Improve AI search content" / "What should we write about next?"

setup-application​

Guide an AI agent end-to-end through the setup, configuration, and validation of an existing branchly application: it researches your website's context, interviews you on use case, audience, tone, and guardrails, then configures data sources, prompts, and AI Actions via the branchly MCP Server, and validates the result programmatically.

The application must already exist (created during signup) and be connected via MCP. During setup the agent follows a structured workflow — discovery interview, data source ingestion (crawling best practices, WordPress, OpenAPI, PDFs, HelpSpace, webhooks), prompt and tool configuration, embed placement — and finishes with a validation loop that tests common customer questions against your knowledge base before you go live.

Triggers when you mention:

  • "Set up my branchly application" / "Setup branchly app"
  • "Configure a new branchly chatbot" / "Onboard my website to branchly"
  • "Create initial prompts and tools for branchly"
  • "Help me configure branchly for my domain"
  • "Configure and test my branchly chatbot"