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

# Skills

> Skills give Experts domain-specific capabilities

Skills are instruction sets that give Experts **domain-specific capabilities**. A general AI model combined with a set of carefully crafted skills can become an expert in any field — writing, programming, design, data analysis, and more.

## What Is a Skill

A skill is essentially a structured Markdown document containing:

* **Task description**: The scenarios in which the Expert should use this skill
* **Execution instructions**: How the Expert should accomplish the task
* **Examples**: Sample inputs and expected outputs
* **Constraints**: Rules and boundaries to follow

When the Expert receives a user request, it automatically selects the appropriate skill based on context. You don't need to manually specify which skill to use — the Expert decides on its own.

## Three Scopes of Skills

Profy's skill system is divided into three scopes, each with different sources and visibility:

<Tabs>
  <Tab title="Built-in Skills">
    **Scope**: Platform-level

    Built-in skills provided by the Profy platform, available to all Experts. Built-in skills are attached to their corresponding plugins and cover the platform's foundational capabilities:

    | Plugin         | Built-in Skill Examples                               |
    | -------------- | ----------------------------------------------------- |
    | Creative Media | Best practices for image generation, video production |
    | PPTX           | Native PPT creation and web-based presentations       |
    | PDF            | PDF processing and typesetting                        |
    | Sites          | Website building workflow                             |
    | Evolution      | Skill improvement evaluation criteria                 |

    Built-in skills take effect automatically with platform updates — no manual installation required.
  </Tab>

  <Tab title="User Global Skills">
    **Scope**: User-level

    Skills you install from the skill marketplace belong to your personal global skill library. They take effect in conversations with **any** Expert.

    Ideal for installing cross-domain skills you frequently use — such as "code review standards" or "English writing style."
  </Tab>

  <Tab title="Expert-Specific Skills">
    **Scope**: Expert-level

    Skills belonging to a specific Expert that only take effect in that Expert's conversations. These skills are created through:

    * **Creator configuration**: Creators install or write them in the Studio
    * **Agent creation**: Skills automatically discovered and created by the Expert during conversations (requires Expert context)
    * **Evolution improvements**: Skill improvement suggestions from the Darwin system, taking effect after creator review

    Expert-specific skills define the core differentiating capabilities of that Expert.
  </Tab>
</Tabs>

## Skill Merging in a Conversation

When you start a conversation with an Expert, skills from all three scopes are merged:

```
Available Skills = Built-in Skills ∪ Your Global Skills ∪ That Expert's Specific Skills
```

If skills with the same name exist across different scopes, they're distinguished by scope prefixes (e.g., `builtin/writing`, `user/writing`, `expert/writing`) and won't override each other.

## Installing Skills from the Marketplace

The Profy skill marketplace offers a rich collection of community-contributed skills. You can browse, search, and install them:

<Steps>
  <Step title="Browse the Marketplace">
    On the "Marketplace" page, switch to the "Skills" category to browse or search for skills you need. Each skill card displays its name, description, install count, and rating.
  </Step>

  <Step title="View Details">
    Click a skill card to view detailed information, including feature descriptions, applicable scenarios, and user reviews.
  </Step>

  <Step title="Install the Skill">
    Click the "Install" button, and the skill will be added to your global skill library, taking effect in all Expert conversations.
  </Step>
</Steps>

<Tip>
  Installed skills can be uninstalled at any time in settings. Skills do not affect your historical conversation records.
</Tip>

## Automatic Skill Discovery

During conversations, the Expert can automatically discover and use installed skills:

1. You send a request
2. The Expert analyzes the intent of the request
3. The Expert finds a matching skill from the available skill list
4. The Expert executes the task following the skill's instructions

This process is transparent to you — just have a normal conversation, and the Expert will select the most appropriate skill in the background.

## Expert Creator Perspective

If you're an Expert creator, skills are your key tool for shaping Expert capabilities:

### Installing Skills for Your Expert

In the Studio's Expert editing page, you can:

* Install community skills from the marketplace to your Expert
* Write custom skills manually (in Markdown format)

### Skills and Evolution

Profy's Darwin evolution system automatically analyzes skill performance based on usage data and produces improvement suggestions. As a creator, you'll receive evolution suggestion notifications:

1. The system evaluates the quality of existing skills
2. It produces improvement suggestions (including improved skill content and score comparisons)
3. You review and decide whether to accept

Accepted improvements take effect immediately, enhancing the Expert's performance.

<Note>
  Evolution has a quality ratchet safeguard — improved skills must score higher than before, ensuring Experts only get better over time.
</Note>

### Skill Format

Skills are written in Markdown format with the following basic structure:

```markdown theme={null}
# Skill Name

## Description
The purpose and applicable scenarios for this skill.

## Instructions
1. What to do first
2. What to do second
3. ...

## Examples
Input: ...
Output: ...

## Constraints
- Rules that must be followed
- Things that cannot be done
```

The more specific the skill and the clearer the examples, the better the Expert's execution quality.

## Skill Control

Creators can control which built-in plugins and skills the Expert uses:

* **Enable/disable built-in plugins**: Toggle built-in plugin switches in the Studio's Expert editing page
* **Skill blocklist**: Disable specific built-in skills to keep the Expert focused on its core domain

<Warning>
  Disabling certain built-in plugins may limit the Expert's capabilities. Make sure you understand what each plugin provides before making your decision.
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/en/documentation/concepts/plugins">
    Learn how plugins provide tool capabilities to Experts
  </Card>

  <Card title="Memory" icon="brain" href="/en/documentation/concepts/memory">
    Learn how the Expert's memory system enables personalization
  </Card>
</CardGroup>