publish-vault

publish-vault is a skill for Claude Code from abstractwebunit/markdown-publish-plugin. It costs 91 tokens per session (1,666 once invoked), scanned A, original, MIT.

A workflow for turning an Obsidian vault or folder of Markdown notes into a searchable website hosted on GitHub Pages. GitHub Pages is a GitHub service for publishing websites from a repository.

In plain words
What is it for?
Publishing Markdown notes online, creating a public GitHub repository and build workflow, and deploying the result to GitHub Pages.
Why use it?
It removes the need to build and host a notes website by hand, while keeping the files and deployment in the user's GitHub account.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the markdown-publish plugin — 1 skill shipped together

Good fit Publishing Markdown notes online, creating a public GitHub repository and build workflow, and deploying the result to GitHub Pages.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/abstractwebunit/markdown-publish-plugin/publish-vault
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add abstractwebunit/markdown-publish-plugin --skill publish-vault
Clone the repo
git clone --depth 1 https://github.com/abstractwebunit/markdown-publish-plugin

Made for: Claude Code.

Or install markdown-publish, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for publish-vault

README.md
[![agentmods](https://agentmods.dev/badge/skills/abstractwebunit/markdown-publish-plugin/publish-vault/github.svg)](https://agentmods.dev/skills/abstractwebunit/markdown-publish-plugin/publish-vault)
Your own site
<a href="https://agentmods.dev/skills/abstractwebunit/markdown-publish-plugin/publish-vault"><img src="https://agentmods.dev/badge/skills/abstractwebunit/markdown-publish-plugin/publish-vault/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for publish-vault

Your own site · 80×15
<a href="https://agentmods.dev/skills/abstractwebunit/markdown-publish-plugin/publish-vault"><img src="https://agentmods.dev/badge/skills/abstractwebunit/markdown-publish-plugin/publish-vault.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 91 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,666 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00091 $0.01666
Opus 5.5 $0.00036 $0.00666
Sonnet 5.5 $0.00018 $0.00333
Haiku 4.5 $0.00009 $0.00167

Measured 2mo ago against content hash 9ef6b5e477fd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

publish-vault scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/publish-vault/SKILL.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Publish a Markdown / Obsidian vault to GitHub Pages

Turn a folder of Markdown notes (an Obsidian vault) into a live, searchable website. The whole thing runs in the user's own GitHub account — a new public repo, a GitHub Actions workflow that builds with the published markdown-publish engine, and GitHub Pages hosting. No backend, no cost.

Golden rules

  • Never create a repo or push anything before the user explicitly confirms the plain-language config summary in step 3.
  • Use smart defaults; only ask the user when something can't be inferred.
  • Verify each step before moving on. If a step fails, stop and surface the real error — don't paper over it.

Preconditions

The skill drives the gh CLI and git. Before anything else:

  1. Check gh is installed and authenticated: run gh auth status.
    • If not authenticated, tell the user to run ! gh auth login themselves (the ! prefix runs it in the session), then re-check. The token needs repo and workflow scopes.
  2. Capture their GitHub login for URLs: gh api user -q .login.

Flow

1. Locate the vault

Find the folder of Markdown notes. If the user didn't say where it is, ask once. Confirm it looks like a vault (contains .md files; an Obsidian vault may also have .canvas files and a .obsidian/ folder). Resolve its absolute path.

2. Resolve config (smart defaults, no questions yet)

Field Default
repo the vault folder name, slugified (lowercase, dashes)
siteName the vault folder name, human-cased
lang autodetect; fall back to en
home leave empty (engine auto-detects a welcome/index note)
baseHref /<repo>/ ← load-bearing, see note below

base-href is load-bearing. GitHub Pages project sites serve under https://<login>.github.io/<repo>/. The build must use base href /<repo>/ or every asset and link 404s. Always set it.

Read the full file on GitHub · 198 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 198 lines · 91 tokens per session scan A 9ef6b5e477fd

Subscribe to this mod's changes

publish-vault is a skill published in the GitHub repository abstractwebunit/markdown-publish-plugin (0 stars, last pushed 4mo ago), licensed MIT. It adds 91 tokens to every session and 1,666 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

publish-vault compared with skills from other repositories

publish-vault next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
publish-vaultabstractwebunit/markdown-publish-pluginSkill04mo agoMITA91Claude Code
llmwikiatomicstrata/llm-wiki-compilerSkill2.2k8d agoMITA66Claude Code, Codex
api-workerscyanheads/obsidian-mcp-serverSkill7028d agoApache-2.0A51Claude Code
paper-glossary917Dhj/DeepPaperNoteSkill1.3ktodayMITA46Claude Code, Codex
cloud-administrationcbrock84/headcountSkill2.6k20d agoMITA100Claude Code
telephony-and-conferencingcbrock84/headcountSkill2.6k20d agoMITA85Claude Code
business-continuity-and-resiliencecbrock84/headcountSkill2.6k20d agoMITA69Claude Code