BuilderSkill

BuilderSkill: the skills NoClick's workflow builder loads before it builds, apart from the Agent Skills an agent attaches (noclick.Skill).

class BuilderSkill

A skill NoClick's builder loads: a description the builder reads to decide whether it needs it, plus text and, optionally, a workflow to follow. scope says whose: owned (your account's, or a workspace it's in) or shared (shared with it to read). It loads while it's enabled and not muted for your account. They're what Settings → Skills in the NoClick app shows. Any of your account's own keys reads and changes them; one held to one of your users raises noclick.PermissionDenied.

Attributes
idstr
namestr
descriptionstr
scopestr
owner_idstr | None
enabledbool
mutedbool
has_textbool
has_workflowbool
body_textstr | None
body_workflowdict[str, Any] | None
created_atdatetime | None
updated_atdatetime | None
rawdict[str, Any]

The response JSON exactly as the API sent it.

listclassmethodasync

noclick.BuilderSkill.list(*, client=None) -> list[BuilderSkill]

Your account's builder skills (owned), newest first, then those shared with it (shared).

Parameters
clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)
Returns
list[BuilderSkill]

Each skill, without its text and workflow (get reads one whole).

Usage
for skill in noclick.BuilderSkill.list():
    print(skill.name, skill.enabled and not skill.muted)

createclassmethodasync

noclick.BuilderSkill.create(
    name, *, description=None, body_text=None, body_workflow=None, enabled=None,
    client=None
) -> BuilderSkill

Make a builder skill in your account's active workspace: description is when the builder should use it, body_text what it tells the builder, body_workflow a workflow it may follow.

Parameters
namestrrequired
descriptionstr | Nonedefault None
body_textstr | Nonedefault None
body_workflowdict[str, Any] | Nonedefault None
enabledbool | Nonedefault None
clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)
Returns
BuilderSkill

The skill, whole.

Usage
noclick.BuilderSkill.create("Brand voice", description="How we write.", body_text="Short sentences.")

getclassmethodasync

noclick.BuilderSkill.get(skill_id, *, client=None) -> BuilderSkill

One builder skill, with its text and workflow.

Parameters
skill_idstrrequired
clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)
Returns
BuilderSkill

The skill, whole.

Usage
skill = noclick.BuilderSkill.get(skill_id)
print(skill.body_text)

updateasync

builder_skill.update(
    *, name=None, description=None, body_text=None, body_workflow=None, enabled=None,
    muted=None, client=None
) -> BuilderSkill

Change it: what it says or whether it's enabled (its owner, or a share that may edit it; others raise noclick.PermissionDenied), and whether it's muted for your account (anyone it reaches). Arguments left out stay as they are.

Parameters
namestr | Nonedefault None
descriptionstr | Nonedefault None
body_textstr | Nonedefault None
body_workflowdict[str, Any] | Nonedefault None
enabledbool | Nonedefault None
mutedbool | Nonedefault None
clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)
Returns
BuilderSkill

It, as it stands after the change.

Usage
skill.update(muted=True)

deleteasync

builder_skill.delete(*, client=None) -> None

Delete it for good: only the account that made it may.

Parameters
clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)
Usage
skill.delete()