Pouches and items
The web app at app.skillpouch.net shows your pouches and everything in them. It decrypts them in your browser after you unlock it.
Pouches
Section titled “Pouches”A pouch is one encrypted set of items. Pouches (the start page of the app) lists them with what they hold, how many computers sync each one and whether any have conflicts.
- New pouch creates one with a name and an optional description. How many you can have depends on your plan.
- Pouch settings renames a pouch, changes its description or deletes it. Deleting asks first; your computers stop syncing it and remove its items. You can’t delete your only pouch: create another one first.
Each computer syncs one pouch. Which one is chosen on the computer: in the
dashboard (skillpouch) on its Pouches tab.
Inside a pouch
Section titled “Inside a pouch”The sidebar has the pouch’s Overview (computers, last sync, recently added), one page per kind (Instructions, Skills, Agents, Commands, MCP Servers, Hooks, Plugins), Conflicts, Shared links and Pouch settings.
Adding an item
Section titled “Adding an item”On a kind’s page, add an item:
- Write it yourself: starts from a template for that kind (a
SKILL.mdwithnameanddescriptionfor a skill, front matter for an agent or command, a JSON definition for an MCP server, hook or plugin). - From a marketplace: browse available items in the app.
- From GitHub: a repository that is one item is added straight away; a repository that holds several is offered as a marketplace to browse.
Editing
Section titled “Editing”Open an item to see its files. Edit opens an editor where you can
change files, add new ones (use / for folders, like scripts/run.sh),
rename and delete them. Saving encrypts the item in your browser; your
computers get it on their next sync, usually within seconds.
An edit in an assistant on a computer ends up in the same place: the assistants’ folders link to the pouch, so a change there is synced like one made here.
Delete removes the item from the pouch and from every computer that syncs it, on their next sync.
Sharing an item
Section titled “Sharing an item”Share on an item creates a link to a snapshot of its current version;
later edits aren’t shared. The item is encrypted in your browser with a new
key that exists only in the link itself (after the #, which browsers don’t
send to servers), so SkillPouch can’t read what you share. Secret values in
MCP server and hook configs (env and headers) are left out; whoever
imports it fills them in.
A link expires after 1, 7 or 30 days, or never, and can be limited to one import. Copy it when it’s made: it can’t be shown again later. Whoever opens it signs in, unlocks, and picks the pouch to add the item to.
Shared links lists the links made from a pouch. Revoking one stops it working and deletes its encrypted copy; people who already imported it keep their copy.