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

# Convert to Overcut

> Add the convert-to-overcut skill to your AI coding agent to migrate an existing automation framework into Overcut Skills, Agents, and Workflows.

The `convert-to-overcut` skill takes your existing agent or automation framework files and produces Overcut-native artifacts: Skills, Agent specs, and Workflow definitions that import cleanly into an Overcut project. It carries over your SDLC business logic and drops the source framework's orchestration plumbing.

It is the companion to the [Overcut API Skill](/docs/quick-starts/overcut-skills/overcut-api): the converter writes the artifacts, and the API skill imports them into a live project when you are ready.

## What it converts

The skill recognizes and maps several source frameworks, and falls back to reading intent directly for anything it does not recognize:

* **Argo Workflows** and CronWorkflow
* **kagents**
* **LangGraph**
* **CrewAI**
* **AutoGen**
* **n8n**
* **GitHub Actions**
* Any arbitrary skills or prompts folder

<Note>
  The skill converts business logic, not infrastructure. It keeps what an agent should do, when it should run, in what order, and which capabilities it needs. It drops framework plumbing that Overcut handles for you, such as pod and resource specs, retries and timeouts, state machines, and memory backends.
</Note>

## How it works

This is a one-shot batch conversion. You point the skill at your source files, and it produces a reviewable output folder plus a `MANIFEST.md` that explains every decision.

<Steps>
  <Step title="Inventory the inputs" icon="magnifying-glass">
    The skill scans your source directory, detects which framework or frameworks are present, and maps each construct to the Overcut artifact it will become (a Skill, an Agent, a Workflow step, a trigger, or dropped as plumbing).
  </Step>

  <Step title="Distill the business logic" icon="filter">
    For each construct, it captures the intent in plain language: instructions, roles, quality bars, and step order, separated from the framework that expressed them.
  </Step>

  <Step title="Map to Overcut artifacts" icon="wand-magic-sparkles">
    It writes one `SKILL.md` per skill, one agent spec per persona, and one workflow definition per pipeline. External tool calls (Slack, GitHub, Jira, and others) are mapped to Overcut built-in tools or MCP servers where possible. Anything it cannot map with confidence becomes a flagged TODO rather than a guess.
  </Step>

  <Step title="Emit and validate the output" icon="circle-check">
    It writes an `out/` folder and runs a validator that checks the JSON parses, every `SKILL.md` has valid frontmatter, agents carry the required fields, and workflow steps reference real step ids. The output stays importable even where it contains placeholders.
  </Step>

  <Step title="Review, then optionally import" icon="upload">
    You review the `MANIFEST.md`: the source-to-target mapping, everything dropped as plumbing, and every open TODO. Nothing is imported automatically.
  </Step>
</Steps>

<Warning>
  Required-but-missing fields become explicit placeholders and TODOs, never silent guesses. Review the `MANIFEST.md` and resolve TODOs (such as unmapped integrations and secrets to create) before you import.
</Warning>

## Add the skill

You add this skill the same way you add any skill to your agent. The exact steps vary by agent, so check your agent's documentation. There are two common paths:

<Steps>
  <Step title="Install from the plugin marketplace" icon="download">
    If your agent supports plugin marketplaces, add the marketplace repository `overcut-ai/overcut-skills` and install the `overcut-importer` plugin.
  </Step>

  <Step title="Or copy the skill folder" icon="folder-tree">
    Otherwise, clone the [overcut-ai/overcut-skills](https://github.com/overcut-ai/overcut-skills) repository and copy the `convert-to-overcut` skill folder (at `plugins/overcut-importer/skills/convert-to-overcut/`, including its `references/`, `scripts/`, and `assets/`) into the directory your agent loads `SKILL.md` skills from.
  </Step>
</Steps>

For example, in Claude Code:

```sh theme={null}
# 1. Add this marketplace
/plugin marketplace add overcut-ai/overcut-skills

# 2. Install the plugin
/plugin install overcut-importer@overcut-skills
```

Once installed, ask your agent to convert your framework to Overcut and the skill runs.

## Import the result

When you are ready to push the converted artifacts into a live project, install the [Overcut API Skill](/docs/quick-starts/overcut-skills/overcut-api) as well. The converter hands off to it in this order:

1. Commit the `out/skills/` folders into a repository connected to the project, then create the Skills from those paths.
2. Create an Agent per generated agent spec, then assign its Skills, MCP servers, and secrets.
3. Create a Workflow per generated definition. This edits the draft. You review it in the workflow builder and commit it live yourself.

<Warning>
  The converter produces artifacts and a plan; it does not design SDLC strategy. Deep product-design questions belong to the built-in Overcut assistant in the web app.
</Warning>

## Related

* [Overcut API Skill](/docs/quick-starts/overcut-skills/overcut-api): import the converted artifacts into a live project.
* [Create and edit workflows](/docs/quick-starts/create-workflows-from-playbooks): work with playbooks and your preferred AI coding agent.
* [Skills](/docs/reference/skills): add `SKILL.md`-based skills to your Overcut agents.