> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# addSkillByName

> Look up a skill class in the global registry and add it by name.

[ref-registry]: /docs/server-sdks/reference/typescript/agents/skill-registry

[ref-addskill]: /docs/server-sdks/reference/typescript/agents/agent-base/add-skill

Look up a skill class by name in the global
[`SkillRegistry`][ref-registry], instantiate it, and add it to the agent via
[`addSkill`][ref-addskill]. Fails closed like `addSkill`.

## **Parameters**

**`skillName`** `SkillNameOrString` — required

Registered skill name (read from the target class's `SKILL_NAME`). The
`SkillName` union lists the 19 built-in names for editor autocompletion; any
other string resolves against skills you registered yourself.

---

**`params`** `SkillConfig`

Optional configuration forwarded to the skill constructor.

---

## **Returns**

`Promise<this>` — the agent for method chaining.

## **Example**

```typescript {3}
const agent = new AgentBase({ name: 'assistant', route: '/assistant' });
agent.setPromptText('You are a helpful assistant.');
await agent.addSkillByName('datetime');
await agent.addSkillByName('web_search', { num_results: 3 });
```

> Look up a skill class in the global registry and add it by name.