Skip to main content

​
Overview

Skills are domain-specific plugins that enhance how AI understands and interacts with certain types of pages. When activated, a skill replaces the standard page snapshot with a domain-optimized representation and adds specialized instructions to the AI prompt.
Skills require Pro or higher. Skills are an experimental feature — the API and available skills may change.

​
How skills work

When a skill is enabled, it automatically activates on pages it recognizes (e.g., the Google Sheets skill activates on Google Sheets URLs). On those pages, the skill:
  • Optimizes the page representation — Replaces the standard view with a domain-specific format that AI understands better (e.g., structured table data instead of raw page elements)
  • Adds specialized instructions — Gives AI domain-specific guidance (e.g., how to reference cells or interact with spreadsheet controls)
On pages where the skill doesn’t apply, standard processing is used automatically.

​
Available skills

SkillDomainDescription
google-sheetsGoogle SheetsExtracts spreadsheet data as structured tables for AI. Enables precise cell targeting and data operations.

​
Usage

​
CLI

npx @refrainai/cli generate -- \
  --url "https://docs.google.com/spreadsheets/d/..." \
  --goal "Copy data from Sheet1 to Sheet2" \
  --output ./sheets-flow.yaml \
  --skill google-sheets
Multiple skills can be comma-separated: 
--skill google-sheets,another-skill

​
SDK

const report = await client.execute(runbook, {
  skills: ["google-sheets"],
});

​
What’s next

Generate a runbook

Generate with skill-enhanced exploration.

Execute a runbook

Execute with skill-enhanced resolution.