Skip to content

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 run something on a schedule. You install skills, configure them, and toggle them on or off in the Skill Circle, your companion’s space for what it can do.

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: before or after the companion thinks, when an agent finishes, on an event, or on a schedule (a cron-style time, e.g. every morning at eight).

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

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

Open the Skills space in chat. You’ll see two things: the skills already installed on this companion, and a catalog of skills you can add.

  1. Browse the catalog and pick a skill. Its entry describes what it bundles.
  2. Install it onto the current companion.
  3. If the skill takes configuration, fill in its settings panel — 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.

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

  • 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 chat. Useful for quick decisions or gathering feedback without leaving the conversation.

The full catalog is inside the Skills space in chat.

  • One install per companion. A skill can’t be installed twice on the same companion; install it once, then enable or disable it.
  • Scheduled and model hooks have caps. There’s a limit on how many before-/after-model hooks a single companion can carry, so installing a skill whose hooks would exceed it is refused at install time.
  • Configuration is validated. Values that don’t match the skill’s schema are rejected — the panel 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.