InkBotDocs

Skills

Reusable know-how for bots: the skills library, script skills, imports and skills bots draft from their work.

A skill is a folder with a SKILL.md (instructions, with a name and description at the top) and, optionally, scripts, references and assets. Bots with a skill ticked read it when it's relevant and can run its scripts.

The library

Settings → Skills lists the host's skills. You can:

  • Write one in InkBot.
  • Import one from a link (a GitHub folder or a SKILL.md URL), a local folder or a .zip. Imported skills start switched off until you've reviewed them.
  • Tick which bots use it, here or in each bot's editor.

Safety checks

Every file in a skill is shown and scanned. Warnings flag things worth a look: internet use, credential paths, starting programs, encoded blobs, deleting files and autostart entries. Each file is pinned by its hash, so if a file changes, is added or is removed outside InkBot, the skill pauses until you save it again.

Script skills

Bots read a skill's files and run its scripts through the inkbot_skills tool: in the workspace, with SKILL_DIR set, for at most 5 minutes, and asking first unless the bot has Full access. Python, Node, PowerShell and Bash are found automatically, and missing Python or npm packages are named along with the command that installs them.

Skills bots learn

With Learn skills from its work on, a bot may draft a skill after a long job (five or more successful steps), after something finally worked following failed tries, or after you corrected it. It can also draft an improvement to a skill it used. Drafts wait as a card in the chat and under Settings → Skills: approve them for that bot or the whole team, edit them first, or reject them.