> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom skills

> Teach the agent repeatable workflows, methods, and decision rules.

Context files teach Superscale what is true. Custom skills teach it how to do a repeatable job.

## Context file or skill?

<CardGroup cols={2}>
  <Card title="Use context files for facts">
    Brand voice, ICPs, claims, product info, competitor lists, legal rules, testimonials, and past learnings.
  </Card>

  <Card title="Use skills for workflows">
    Step-by-step methods, recurring analyses, report formats, creative formulas, approval rules, or campaign playbooks.
  </Card>
</CardGroup>

## Good skill examples

* "Run our weekly Meta health check and return pause/scale/test actions."
* "Analyze competitor ads using our hook taxonomy."
* "Create native-ad concepts using our copywriting method."
* "Review every output for healthcare claim compliance before generation."
* "Turn a customer review into five UGC hooks using this structure."

## How to write a skill

<Steps>
  <Step title="Name the outcome" icon="target">
    Say what the skill should produce: report, concepts, QA checklist, briefs, or decisions.
  </Step>

  <Step title="Define the steps" icon="list-ordered">
    Write the process the agent should follow every time.
  </Step>

  <Step title="Attach the source context" icon="paperclip">
    Link the brand, product, reports, examples, or rules the skill depends on.
  </Step>

  <Step title="Save and reuse" icon="save">
    Use the skill whenever the same workflow comes up again.
  </Step>
</Steps>

## How skills are used

| Capability                             | How it works                                                                              |
| -------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Kebab-case name**                    | Skills use names like `brand-voice-review` or `weekly-meta-health-check`.                 |
| **Slash attach**                       | After creation, attach a skill to a chat with `/skill-name`.                              |
| **Markdown instructions**              | The skill body is written as structured markdown instructions the agent should follow.    |
| **Workspace, brand, or product scope** | Skills can be organization-wide or scoped to the brands/products where they apply.        |
| **Markdown import**                    | Existing playbooks can be uploaded/imported as skills when they are already written down. |
| **Scheduled reuse**                    | A scheduled run can carry selected skills so the same method repeats every time.          |

<Note>
  If the information is a durable fact, put it in context. If it is a repeatable way of working, make it a skill.
</Note>

<Card title="Context vs skills" href="/context/context-vs-skills" horizontal>
  The full comparison, and when to use each.
</Card>