Skill
A Skill is a capacity a Worker has at a level, such as negotiation or programming, that Roles require.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
level | integer | How well the Worker performs it. |
Object
{
"$id": "https: //api.sb/ shiftnote.app/ skills/ skill_1",
"$type": "Skill",
"level": 1
}Relationships
- A Skill is practiced by many Workers: the Skills a Worker has, each at a level, matched against what Roles require.
practicedBy, inversepractices. - A Skill is required by many Roles: the Skills, each at a level, a Worker needs to fill the Role.
requiredBy, inverserequires.
Verbs
createCreates a Skill.POST /{namespace}/skillsgetReturns one Skill by id.GET /{namespace}/skills/{id}listReturns Skills, newest first, one page at a time.GET /{namespace}/skillsupdateChanges the given properties of a Skill.PATCH /{namespace}/skills/{id}deleteDeletes a Skill; its history is kept.DELETE /{namespace}/skills/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Skill.create | Yes | Yes | Yes | No |
Skill.get | Yes | Yes | Yes | Yes |
Skill.list | Yes | Yes | Yes | Yes |
Skill.update | Yes | Yes | Yes | No |
Skill.delete | Yes | Yes | Yes | No |
Call it
Add a skill to RouteWise.Example
The Sales Lead Role requires negotiation at level 3. Sally, the Agent filling it, holds negotiation at level 4.