Skip to main content

Skills

Skills are reusable instruction sets that teach AI agents how to use XainFlow for specific creative tasks. Instead of explaining your workflow from scratch every time, you load a skill and the AI agent follows the recipe — asking for inputs, building the workflow, and executing it.

Skills follow the open Agent Skills standard and work with Claude Code, Cursor, Windsurf, and any MCP-compatible IDE.

How Skills Work​

A skill is a markdown document (SKILL.md format) with structured instructions. When you ask your AI assistant to use a skill, it:

  1. Fetches the skill instructions from XainFlow.
  2. Asks you for the required inputs (images, prompts, preferences).
  3. Uses XainFlow's MCP tools to build and configure a workflow.
  4. Shows a cost estimate and asks for confirmation.
  5. Executes the workflow and delivers the results.

The AI assistant already knows HOW to use each XainFlow tool from the MCP tool descriptions. Skills add the what and why — the specific recipe for a creative task.

Skill Types​

TypeCreated ByVisibilityEditable
OfficialXainFlow teamAll workspacesNo (read-only)
GlobalYou or your teamAll projects in your workspaceYes
ProjectYou or your teamSingle project onlyYes

Official Skills​

Curated by the XainFlow team for common use cases like product photography, social media kits, and brand asset generation. These are available in every workspace and cannot be modified.

Global Skills​

Created by your team and shared across all projects in the workspace. Useful for company-wide workflows and brand guidelines.

Project Skills​

Scoped to a single project. Useful for project-specific recipes that don't apply to other work.

Using a Skill​

From Your IDE​

Ask your AI assistant to list available skills or describe what you want to do:

You: "I want to generate product photos"

The assistant calls xainflow_list_skills, finds "product-shots", fetches its instructions, and walks you through the workflow.

You can also request a skill by name:

You: "Use the product-shots skill for this shoe image"

Example Walkthrough​

Here's what happens when you use the product-shots skill:

  1. The assistant fetches the skill and reads its instructions.
  2. It asks for your product image (file, URL, or existing asset).
  3. It lists your projects and asks where to create the workflow.
  4. It builds a workflow with multiple shot types:
    • Clean product on white background (1:1)
    • Lifestyle/environmental shot (4:3)
    • Detail/macro shot (1:1)
  5. It calculates the credit cost and asks for confirmation.
  6. It executes the workflow and shows you the results.

Creating Custom Skills​

You can create your own skills using the MCP tool or through your AI assistant.

From Your IDE​

Ask your AI assistant to create a skill:

You: "Create a XainFlow skill for generating social media banners"

The assistant will:

  1. Ask whether the skill should be global or project-scoped.
  2. Build the SKILL.md content with proper structure.
  3. Save it using xainflow_create_skill.

Skill Structure​

A skill document contains YAML frontmatter and markdown instructions:

---
name: my-custom-skill
description: What this skill does in one or two sentences.
argument-hint: [input-description]
---

# Skill Title

Brief description of what this skill creates.

## Inputs

What to ask the user for.

## Workflow Structure

How to build the workflow — node types, models, settings.

## Before Executing

Show cost estimate and ask for confirmation.

Best Practices​

  • Keep instructions concise. The AI already knows how each MCP tool works.
  • Focus on the what (shot types, models, ratios) not the how (API parameters).
  • Include default model recommendations with credit costs.
  • Always ask for user confirmation before executing.

Skill Categories​

Skills are organized into categories for easy discovery:

CategoryExamples
PhotographyProduct shots, lifestyle photos, flat lays
SocialSocial media kits, story templates, ad creatives
BrandingBrand assets, logo variations, style guides
VideoVideo promos, animated product showcases
ToolsBatch processing, format conversion, cleanup