Skills and add-ons troubleshooting

Diagnose and fix Delegate skill and add-on issues: failed installs, skills that don't appear, skills that fail at runtime, and unreachable repositories or shared feeds.

For publish, install, and review-specific issues, see Publishing and installing skills troubleshooting.

A skill won't install

Cause 1: No internet connection, or not enough disk space.
Solution 1:

• Check your connection.
• Free up disk space.
• Try again.

Cause 2: Delegate is out of date.
Solution 2: Update Delegate.

Cause 3: It still fails.
Solution 3: Contact the publisher.

An installed skill doesn't appear

Cause 1: It's disabled.
Solution 1: Check its state under Add-ons & Integrations → Skills.

Cause 2: Delegate hasn't picked it up yet.
Solution 2: Restart Delegate.

Cause 3: Its files didn't land where expected.
Solution 3: Check Settings file locations for the local skills folder.

A skill fails when I try to use it

Cause 1: It's missing a connection it depends on.
Solution 1: Create it from Add-ons & Integrations → Connections.

Cause 2: It's missing a tool permission it depends on.
Solution 2: Enable the tool category under Tool permissions.

Cause 3: You're on an outdated version of the skill.
Solution 3: Update it to the latest version.

A repository or shared feed won't load

Cause 1: The source is unreachable, or misconfigured.
Solution 1: Verify it's correct and reachable — see Repository sources.

Cause 2: A firewall is blocking the connection.
Solution 2: Check firewall settings.

Cause 3: The source itself is down.
Solution 3: Contact whoever administers it.