Skip to main content
Skills are self-contained bundles of instructions and configuration that extend what an assistant can do. Think of a skill as a plug-in you install once and then enable on any assistant you like. A skill might teach an assistant how to write in a specific style, follow a domain-specific reasoning process, or call a particular set of tools — all defined in a single portable package that you can share, import from GitHub, or author yourself.

​
Browsing and Managing Skills

Open Settings → Extensions → Skills to see all the skills installed on your device. Each card shows the skill’s name, a short description, and — if the author included one — a compatibility note indicating which models or providers it works best with.

Import from GitHub

Tap + and choose Import from GitHub. Paste a repository URL such as https://github.com/owner/repo. Rikka downloads the skill files directly from the repository’s default branch.

Import from File

Tap + and choose Import from File. Select a .zip archive or a plain text file from your device. Rikka extracts the skill and adds it to the list.

Create Manually

Tap + and choose Add Manually. Paste in the skill content directly — Rikka reads the YAML frontmatter to extract the skill’s name and description automatically.

Delete a Skill

Tap the ⋮ menu on any skill card and choose Delete. Rikka removes the skill from every assistant that had it enabled.

​
Skill File Format

Every skill is built around a SKILL.md file that Rikka reads when loading the skill. The file starts with a YAML frontmatter block followed by the instruction body. 
---
name: code-reviewer
description: "Performs thorough code review with style and security feedback"
compatibility: "Works best with GPT-4o, Claude 3.5+"
allowed-tools: read_file, search
---

You are an expert code reviewer. When given a code snippet or file, you:
1. Check for logic errors and edge cases
2. Identify security vulnerabilities
3. Suggest style improvements aligned with the project's conventions
...
FieldRequiredDescription
name✅Unique identifier for the skill. Must be non-empty and URL-safe.
description✅One-line summary shown on the skill card.
compatibility✗Free-text hint about which models or providers work best.
allowed-tools✗Space-separated list of tool names this skill is designed to use.

​
Viewing and Editing a Skill’s Files

Tap any skill card to open the Skill Detail page. You’ll see a collapsible file tree showing every file inside the skill directory.
  • Tap the pencil icon next to a file to edit its contents in a built-in text editor.
  • Tap the trash icon to delete a file (you cannot delete SKILL.md).
  • Tap the + FAB to add a new file, optionally nested in a subfolder using a path like examples/basic.md.
Editing SKILL.md directly changes the skill’s instructions. If you imported the skill from GitHub, your edits will not sync back to the upstream repository — keep a backup if you plan to make significant changes.

​
Enabling a Skill on an Assistant

Installing a skill globally does not activate it for any assistant automatically. You choose which assistants benefit from each skill.
1

Open assistant settings

Long-press an assistant on the home screen, or tap the assistant name and then the Edit icon to open its settings page.
2

Find the Enabled Skills section

Scroll down to Enabled Skills. All currently installed skills appear here as toggles.
3

Toggle on the skills you want

Enable any skills that should be active for this assistant. The assistant’s system prompt will be augmented with the skill’s instruction body at inference time.
4

Test the assistant

Start a new chat with the assistant and verify it behaves according to the skill’s instructions.
You can enable multiple skills on a single assistant. Keep in mind that each active skill’s instructions are injected into the system prompt, so very large or numerous skills may consume a meaningful portion of the model’s context window.

​
Sharing Skills

Because each skill is just a directory of plain text files, sharing is straightforward:
  • ZIP and send: Compress the skill folder and share the .zip file via any messaging app or file transfer method. The recipient imports it with Import from File.
  • GitHub repository: Publish the skill directory as a public GitHub repo. Anyone with the URL can import it directly into Rikka.