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

# Skill Cluster Framework

### Adding Skill Clusters

The essential first step of any flow with the Skill Engine API is creating the
Entities within the system.

For example, to create a Skill Cluster you can simply submit a `POST` request
to `/taxonomy/skill_clusters`:

```JSON theme={null}
{
  "external_id": "CP-001",
  "skill_cluster_name": "Data Science Modelling",
  "skill_cluster_description": "The ability to use machine learning algorithms to extract value from data"
}
```

The sequence diagram below shows the communication steps:

```mermaid theme={null}
sequenceDiagram
    participant Your System
    participant Skill Engine API
    Your System->>Skill Engine API: POST /taxonomy/skill_cluster
    activate Your System
    alt Creation Successful
        rect rgba(0, 255, 0, .15)
            Skill Engine API->>Skill Engine API: Skill Extraction
            Skill Engine API-->>Your System: ✅ HTTP 204 No Content
        end
    else Creation Failed
        rect rgba(255, 0, 0, .15)
            Skill Engine API->>Skill Engine API: Skill Extraction Failed
            Skill Engine API-->>Your System: ❌ HTTP 422 Unprocessable Entity
        end
    else Entity Already Exists
        rect rgba(255, 0, 0, .15)
            Skill Engine API-->>Your System: ❌ HTTP 409 Conflict
        end
    end
```

After the initial creation, the Skill Clusters can be updated by sending a `PATCH`
request to  `/taxonomy/skill_clusters/CP-001`. More information can be found at
the [endpoint specification](/reference/latest/Taxonomy/TaxonomySkillClusters/patch-taxonomy-skill-clusters-skill-cluster-external-id)
.

<div class="warning">
  The lifecycle of each Entity is managed explicitly, meaning that you cannot
  overwrite an existing Entity with a POST message. To update an Entity, you can
  execute a PATCH call at its specific endpoint.
</div>