Skip to content
weside.aiweside docs

Skills

A skill is an installable package that gives your companion a new capability. Some teach it about a topic, some give it new tools to act with, some let it act on a schedule. Skills live in your companion’s Body space, alongside its connected integrations and the platform tools it has anyway.

What it is

Section titled “What it is”

Each skill bundles a few things, and your companion gains all of them when you install it:

  • Context — written knowledge (a SKILL.md and reference material) that becomes part of what your companion knows.
  • Tools — concrete actions the skill makes available, with per-skill settings.
  • Agents — focused sub-agents the skill can hand specific work to.
  • Hooks — behaviour tied to a moment: on a schedule (a cron-style time, say every morning at eight) or on an event.

A skill installed on one companion belongs to that companion. Two companions can carry different skills, so each becomes good at different things.

Why it matters to you

Section titled “Why it matters to you”

A fresh companion is capable but general. Skills are how you shape it toward your life — one that checks in every morning, one that knows your domain, one that wires in a tool you rely on. You aren’t editing prompts or writing code; you install a skill the way you’d add an app, and your companion grows a new ability.

How you use it

Section titled “How you use it”

Open your companion and go to its Body space. Two sections there belong to skills: the ones already installed on this companion, and Discover, the catalog of skills you can add.

  1. Browse the catalog and open a skill. Its entry describes what it bundles.
  2. Install it onto this companion.
  3. If the skill takes configuration, fill in its settings. The form is validated against the skill’s own schema, so it tells you when a value is missing or wrong.
  4. Toggle a skill on or off without uninstalling, when you want a capability paused but kept.
  5. Uninstall to remove it and everything it added.

Skills you can install

Section titled “Skills you can install”

Besides skills you build yourself, weside ships a growing set of ready-made ones:

  • Product Owner — auto-enabled on companions you set up for Agentic Product Ownership. Gives your companion the plan chain (Vision → Saga → Epic → Story) and Solo/Council modes for decision-making.
  • Quick Poll — lets your companion run a short inline poll in a room. Useful for a quick decision without leaving the conversation.

The full catalog is in the Body space.

Limits & edge cases

Section titled “Limits & edge cases”
  • One install per companion. A skill can’t be installed twice on the same companion; install it once, then enable or disable it.
  • Ten hooks per skill. A skill declaring more than ten hooks gets the first ten; the rest are dropped rather than the install failing.
  • Event hooks carry a cooldown. A skill hooked to an event won’t fire again within a minute of the last time, so an event storm can’t turn into a message storm.
  • Configuration is validated. Values that don’t match the skill’s schema are rejected — the form won’t let you save an invalid setting.
  • Disabled isn’t uninstalled. A toggled-off skill keeps its configuration; turn it back on and it resumes.

Where next

Section titled “Where next”