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

# Creating Skills

> Distill workflows from successful tasks or co-create custom Skills with QoderWork.

Beyond using ready-made Skills, you can create your own to capture personal expertise and best practices.

## Distill from a successful task

When QoderWork nails a task, ask it to save the workflow right in the conversation:

> That turned out great — please save this workflow as a skill so I can reuse it

QoderWork reviews the conversation, extracts the key steps, format requirements, and decision criteria, then generates a structured Skill file. After you confirm, it's saved and ready for the next similar task. No need to plan ahead — just capture what works when you see it.

## Co-create with QoderWork

Have a clear workflow you want to automate? Start a co-creation session from the settings panel:

1. In the left sidebar, open **Extensions** → **Skills**, then click **Create with QoderWork**.
2. Describe your needs in plain language, e.g., "Every week I need to compile Slack project discussions into a report with three sections: progress, risks, and next week's plan."
3. QoderWork generates a structured Skill file based on your description. Review, tweak if needed, and confirm — it's saved locally and ready to use.

This approach is ideal if you'd rather not touch any technical details — just describe what you want, and QoderWork writes the file.

## Skill file format

Each Skill is essentially a `SKILL.md` file using YAML frontmatter + Markdown body format:

```markdown theme={null}
---
name: my-skill
description: One-line description of what this skill does and when to trigger it
version: 1.0.0
---

# Skill Name

## Steps
1. First step
2. Second step

## Pitfalls
- Common mistakes to avoid

## Verification
How to confirm the skill executed successfully.
```

Key field reference:

| Field         | Required | Description                                                                                   |
| :------------ | :------- | :-------------------------------------------------------------------------------------------- |
| `name`        | Yes      | Skill name — lowercase letters, digits, and hyphens                                           |
| `description` | Yes      | Trigger description — QoderWork uses this to determine when to automatically invoke the skill |
| `version`     | No       | Semantic version number                                                                       |

<Tip>
  The `description` field is critical — it determines whether QoderWork can accurately recognize when to use your skill. The more specific it is and the more trigger keywords it includes, the higher the accuracy of automatic triggering.
</Tip>

## Testing your Skill

After creating a Skill, verify it with these steps:

1. **Start a new conversation** and describe a task that should trigger the Skill.
2. **Check automatic triggering** — if it doesn't fire, refine the keywords in your `description`.
3. **Review the output format** — make sure the output follows the expected steps and formatting.
4. **Try edge cases** — describe the same type of task in different ways to confirm consistent triggering.

## Next Steps

<CardGroup cols={3}>
  <Card title="Skill Marketplace" icon="store" href="/qoderwork/skill-marketplace">
    Browse, install, and share skills
  </Card>

  <Card title="Best Skills" icon="star" href="/qoderwork/best-skills">
    Curated skills from official and community
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/qoderwork/skills">
    Extend QoderWork capabilities with Skills
  </Card>
</CardGroup>