Skills are structured prompt files that extend what tota can do. Each skill is a directory containing a SKILL.md file — tota injects the skill's instructions into its context when the skill is invoked.

#SKILL.md format

---
name: my-skill
description: One-line description of what this skill does
version: 0.1.0
allowed-tools:
  - read_file
  - run_command
disable-model-invocation: false
---

# My Skill

The body of the skill — instructions, context, prompts, or templates.
Include anything you want the agent to follow when this skill is active.

#Frontmatter fields

#Install a skill

#From a URL

Ask tota to install any skill from a public HTTPS URL:

Install the skill from https://example.com/skills/code-review/SKILL.md

tota fetches the file, validates the frontmatter, and saves it to ~/.tota/skills/<name>/SKILL.md. Only HTTPS URLs are accepted.

#Write one manually

#From a URL

Ask tota to install any skill from a public HTTPS URL:

Install the skill from https://example.com/skills/code-review/SKILL.md

tota fetches the file, validates the frontmatter, and saves it to ~/.tota/skills/<name>/SKILL.md. Only HTTPS URLs are accepted.

#Write one manually

Place the skill directory in ~/.tota/skills/:

mkdir -p ~/.tota/skills/my-skill
nano ~/.tota/skills/my-skill/SKILL.md

Or ask tota to create it:

Create a skill that always uses conventional commit format

#Optional directories

Directories starting with _ (e.g. _template) are ignored during discovery.

#Optional directories

Directories starting with _ (e.g. _template) are ignored during discovery.

#View installed skills

/skills

Lists all skills with their name, trigger phrases, and status.

#Invoke a skill

Skills are not triggered by keywords automatically. To use a skill, ask tota explicitly:

Use the code-review skill to check this file
Use the daily-brief skill to summarize my GitHub issues

tota uses the use_skill tool internally, which loads the skill's instructions and injects them into the current context.

#Schedule with a skill

Skills can be scheduled as recurring tasks:

Every morning at 9am, use the daily-brief skill to summarize my GitHub issues