Open the Skills Manager from the ribbon (puzzle icon) or command palette to browse, install, and edit Claude Code skills. New views open in the right sidebar under Conversation first placement (creating the sidebar if it isn’t open yet), or in a main document tab under Classic placement — matching where the Agents List opens. If Skills Manager is already open, it is focused without moving it or discarding edits. The list and detail panels are split by a draggable divider — drag it to resize, double-click to reset to the default width; your chosen width is remembered next time you open the view.
Narrow panes
In a narrow pane — a sidebar, a split view, or on mobile — there isn’t room for both panels side by side, so the Skills Manager shows one at a time. You see the list until you pick something, then that item’s detail panel with a ← back button to return to the list. The draggable divider is hidden in this mode.
The layout responds to the panel’s own width rather than the window’s, so widening the sidebar past roughly 480px restores the two-panel view on the spot — no reopening required. If you have unsaved edits to a SKILL.md, going back asks before discarding them.

Installed tab
Shows everything installed as a collapsible source tree.
The top-right corner of the tab bar has two icon buttons (Installed tab only):
- Add (+) — opens a menu with Folder… and File (.skill)… to install a skill directly from a local folder or a packaged
.skill/.ziparchive, plus GitHub repo… and Local folder source… to register a skill source. Each item is enabled on its own; one that isn’t available on your host shows a notice with the reason, and the button is disabled only when none work. - Check for updates (↻) — shown once you have at least one GitHub plugin source; re-fetches staleness for all GitHub plugin sources in parallel. Its icon spins while running, and a toast reports the result when it finishes, including which sources failed to check (e.g. if you’re offline). An indicator dot appears on the button afterward if any plugin has updates. Hover either button for its full status/tooltip.
GitHub plugin sources appear as top-level nodes with a badge (•N) when updates are available; clicking one expands it to reveal its skills and opens a detail panel with:
- Update — git pull, highlighted when updates are available
- Reload — re-scan from disk
- Reinstall — delete and re-clone for broken installs
- Remove Source
Click a GitHub source’s chevron to expand or collapse its skills while staying in the list. Click the rest of the source row to open its details. In narrow panes, this lets you browse the expanded skills without switching screens.
Two more nodes sit at the bottom:
- Vault — the skills this plugin installed into your vault. Click one to view and edit it, with Save, Reload, Reveal in Finder, and Uninstall.
- Claude Code — everything in
~/.claude/(skills and agent profiles), markedread-only. The plugin shows them because the Claude CLI genuinely loads them into every session, but it never writes to that directory, so those panes offer only Reload and Reveal in Finder. Edit or remove them with theclaudeCLI, or by hand.
Where installs go. Everything the Skills Manager installs or imports lands in
<vault>/.obsidian/plugins/claude-threads/skills/, beside the plugin’sskill-sources/clones — never in~/.claude/. That folder shares the plugin folder’s fate: community-plugin updates leave unknown subdirectories alone, but manually uninstalling and reinstalling the plugin will delete your installed skills along with it.
Authoring local skills
Choose New skill, enter a lowercase identifier such as meeting-notes, and edit the starter SKILL.md. Authored packages appear under Local skills and live in <vault>/Skills/<identifier>/. Settings → Skills → Local skills folder selects another vault-relative folder; changing it does not move files. Installs, imports, and GitHub clones retain their current paths. There is no migration.
Agents can create complete packages with skills_create_local({ skillId, skillMd, files? }) and patch them with skills_update_local({ skillId, files?, deleteFiles? }). File entries contain a package-relative path, encoding (utf8 or base64), and content. Updates preserve omitted files and remove only explicitly listed paths. SKILL.md requires a frontmatter name matching the identifier and a nonempty description; it cannot be deleted. Supporting files are managed through these tools or the filesystem.
Authored skills are available as /local:<identifier> in newly started Claude and Codex sessions. Active sessions are not restarted. Use qualified identifiers returned by skills_list_installed, such as local:meeting-notes, for inspection or removal when names overlap. skills_update continues to pull GitHub sources.
Browse tab
Search the skills.sh registry. Results show the skill name, GitHub source, and install count. Click a result to see details and an Install button that clones the skill from GitHub into <vault>/.obsidian/plugins/claude-threads/skills/. Installed skills are invoked as /vault:<name>.
Skill sources
Skill sources are collections you browse and install from inside the Skills Manager, independent of the Browse tab’s registry search. Add them from the + menu (GitHub repo… or Local folder source…). The new source is expanded for you: a GitHub source preloads its skills, and a local one opens in Browse. Each source is either:
- GitHub — a repo URL that’s cloned into the vault’s plugin folder, with an optional display name override. Staleness (
behindCount) is tracked per source and drives the update badges described above. Its detail panel has Update, Reload, Reinstall, and Remove Source. - Local — a path to an existing skills folder on disk, with an optional separate git repo path if the skills folder lives inside a larger repo (so Update pulls the right repo). Open it in Browse and use Remove source to drop it.
Settings → Skills → Skill sources now shows how many sources you have and an Open Skills Manager button; adding, updating, and removing happen in the Skills Manager. Local skills folder stays in Settings.
Auto-update
Settings → Skills → Auto-update GitHub skill sources (on by default) fetches and fast-forwards your GitHub sources in the background on launch and every 6 hours. A notice tells you when sources changed, and updated skills apply to new threads. Sources pinned to a ref are skipped, and a clone that has diverged from its remote is left alone with a console warning. Skills are instructions your agents follow, so turn this off if you source skills from repos you don’t trust.
Private repositories
Skill sources use a built-in git client. Public repos are fetched anonymously. For a private repo, Agent Threads uses Geode’s GitHub connection: the Geode GitHub App must be installed on that repo, and if access is refused the error includes the App install link. The token is requested only after GitHub rejects the anonymous request, and is sent only to github.com. SSH keys and keychain git credentials are not used, and on Obsidian, older Geode, or mobile (no GitHub connection) private repos fail with a hint to connect GitHub.
Once a skill is installed, it’s automatically available in the / slash command dropdown in every thread — there’s no separate step to wire a newly installed skill into the chat input. Vault-installed skills appear as /vault:<name>; skills from your read-only ~/.claude/skills/ library are invoked bare as /<name>.