# 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](publishing-and-installing-skills-troubleshooting.md).

## 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](settings-file-locations.md) 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](security-settings.md#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](plugins.md#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.