Community skills for Shell:B, the local-first AI workspace. Part of the family with Shell-B-Themes, Shell-B-Screensavers and Shell-B-Agents.
A skill is a playbook an agent loads on demand: a SKILL.md with YAML front matter (name, description) and
Markdown instructions, plus optional scripts, templates and references in the same folder. The format is Claude's
Agent Skills, so skills written for Claude Code or claude.ai work in Shell:B too, and the ones here work there.
Agents see each enabled skill's name and description in their system prompt and load the full text with use_skill
when a request matches.
In Shell:B open Tools & Connectors → Community (the Community Hub). This repository is one of its sources, so its skills are listed; Install copies one into your library, switched off until you have read it and turned it on in Tools & Connectors → Skills. Updates show in the Hub when a skill here changes.
The table below and index.json are generated by scripts/validate.py; don't edit them by hand.
verify-chat and audit-code come with Shell:B (server/verify.py, server/codemap.py), so every install already
has them and the Hub shows them as installed. The copies here are the same text, kept so they can be read, shared and
improved; a change merged here is copied into the app.
| Skill | What it does | Credit |
|---|---|---|
| audit-code | Review or audit Shell:B's own code (or a Code workspace) and write findings that hold up: map it, read it, prove every claim with file:line. Use when asked to review, audit, scrutinize or find bugs or security problems in the code, or to recommend fixes and features from it. | Shell:B · MIT |
| email-drafting | Draft emails and replies that sound like the user and get to the point: answers to messages in their inbox, follow-ups, requests, difficult or delicate messages, and versions in another language. Use when the user asks you to write, draft, answer, reply to, rephrase, soften or translate an email or message, or to go through their inbox and say what needs an answer. | Shell:B · MIT |
| job-application | Help with a job hunt: find openings that fit, tailor a CV and cover letter to one posting, keep track of applications and prepare for interviews. Use when the user asks for help finding a job, applying for a position, writing or updating a CV, résumé or cover letter, or getting ready for an interview. | Shell:B · MIT |
| research-with-sources | Research a question properly and answer with sources the user can check: search, read the sources themselves, separate what is established from what is debated, and cite every claim. Use when the user asks to research, look into, dig up or fact-check a topic, wants sources or references, or asks about history, archaeology, science or anything where being right matters more than being quick. | Shell:B · MIT |
| shellb-screensaver | Build a Shell:B screensaver (a full-window Canvas 2D animation in a Studio Screensaver project) when the user asks for a screensaver, idle screen or ambient animation for Shell:B; covers the rules it must follow to run for hours, the project files, previewing, and packaging it for the Shell-B-Screensavers community repository. | Shell:B · MIT |
| shellb-theme-design | Design a custom Shell:B interface theme with the design_theme tool when the user asks for a new look, colours, mood or style for Shell:B itself (not for a website or project), then refine it from feedback and, if they want to share it, package it for the Shell-B-Themes community repository. | Shell:B · MIT |
| summarize-documents | Summarize documents, meeting recordings, long email threads or web pages into what the reader needs: the gist, the decisions, the numbers and who has to do what by when. Use when the user asks to summarize, sum up, recap, condense or get the key points or action items from a file, a recording, a meeting, an email thread or a link. | Shell:B · MIT |
| verify-chat | Audit this chat when something may have gone wrong: a failed or stopped turn, a tool error, a wrong or made-up answer, a claim that a file was saved or a search was run when it wasn't. Use when the user says /verify-chat or asks you to check, verify, review or debug the conversation. | Shell:B · MIT |
| writing-feedback | Give a writer useful feedback on their own work (a chapter, story, essay, article, poem or letter) and help them revise it without losing their voice. Use when the user shares a draft and asks what you think, asks for notes, critique, editing or proofreading, or wants help with a scene, structure, dialogue or style. | Shell:B · MIT |
skills/<name>/
SKILL.md front matter + the playbook
references/ optional: long reference material the playbook points to
scripts/ optional: helpers an agent can run in its sandbox (read-only under /skills/<name>/)
template/ optional: files to start from
Front matter:
---
name: shellb-theme-design # = the folder name: lowercase letters, digits, dashes
description: >- # what it does AND when to use it; this is what triggers the skill
Design a custom Shell:B interface theme with the design_theme tool when the user asks for a new look …
author: Your name
authorUrl: https://github.com/you # optional
license: MIT # an SPDX id
version: "1.0"
tags: [shell-b, theme]
---What makes a skill good:
- The description decides whether an agent reaches for it. Say the situation ("when the user asks for …"), not just the topic.
- The body is a playbook: steps in order, decisions with the rule for each, the tools to call by name, what to
check before saying it's done. Move long reference material to
references/and point to it. - Name Shell:B's tools where they matter (
design_theme,project_save_file,run_code,create_artifact…), and say what to do when a tool isn't there. Skills written for other assistants are welcome; note their origin. - No credentials, no calls to private services, nothing destructive.
Then check it:
python3 -I scripts/validate.pySee CONTRIBUTING.md for the pull request checklist.
Every skill names its author in the front matter, linked when authorUrl is given; the name shows in the table
above and in index.json, and the git history keeps the pull request under your account. Ported skills credit the
original author in credits or in the body.
The scripts and this repository are MIT. Each skill names its own license in its front matter.
- Shell-B-Themes: interface themes (Settings → Appearance)
- Shell-B-Screensavers: screensavers (Settings → Appearance)
- Shell-B-Agents: agent personas
- Shell-B-Studio-Templates: starting points for Studio projects
- Shell-B-Translations: interface languages