Bundled skills

Skills are the unit of capability in TouchPilot. A skill is a Markdown file under app/src/main/assets/skills/<id>/SKILL.md with a YAML front-matter block that declares its identity, risk, allowed tools, and success criteria. Skills are picked up at runtime by a directory scan — drop a new SKILL.md folder in and it is available.

See Authoring skills for the full contract and the authoring conventions.

What ships in 1.0

Skill	Risk	What it does
browser	low	Open pages, search the web, and inspect visible browser results.
settings	medium	Navigate and inspect Android Settings screens safely.
messages	high	Draft and review SMS or messaging actions with explicit user approval before sending.
app-launch	low	Open an installed app by package or by friendly name.
device-help	medium	Answer common device questions using only read-only settings screens.
wifi	medium	Open Wi-Fi settings, list visible networks, and guide the user to connect or disconnect.
media-volume	low	Open Android sound settings and adjust media, ringtone, or notification volume sliders.
launcher	low	Return to the home screen or open an installed app from the launcher / app drawer.
clipboard	low	Copy text to or paste from the system clipboard by driving the clipboard UI of another app.
share	medium	Open the system share sheet so the user can pick where to send the current content.

How to add a new skill

1. Create app/src/main/assets/skills/<your-skill-id>/SKILL.md.
2. Use only lowercase letters, digits, and hyphens in the directory name and in the id: field.
3. Fill out the required front-matter fields: id, title, description, risk, allowed_tools.
4. Choose the smallest useful allowed_tools list — narrower is safer.
5. Add a BundledSkillsTest case to app/src/test/java/dev/touchpilot/app/memory/BundledSkillsTest.kt that parses your skill and asserts the v2 metadata.
6. Run ./gradlew testDebugUnitTest to confirm both your skill and the parser are happy.

How to disable a skill

Skills can be toggled off in the Settings screen. Disabled skills remain on disk but the agent will not select them.