A skill for keeping the structure of an Obsidian knowledge base up to date. It regenerates marked sections such as the home page tree, directory lists, and index pages.

Checking, initializing, or applying updates to wiki navigation and directory listings, then producing a structure report.

It replaces repetitive manual maintenance while leaving the notes' unmarked text unchanged.

wiki-struct — Skill for Claude Code by qxbyte/pluginhub

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 qxbyte/pluginhub --skill wiki-struct

Clone the repo

git clone --depth 1 https://github.com/qxbyte/pluginhub

Made for: Claude Code.

Or install obsidian-wiki, the plugin that ships this one along with the rest of its 3 skills.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/qxbyte/pluginhub/wiki-struct/github.svg)](https://agentmods.dev/skills/qxbyte/pluginhub/wiki-struct)

Your own site

<a href="https://agentmods.dev/skills/qxbyte/pluginhub/wiki-struct"><img src="https://agentmods.dev/badge/skills/qxbyte/pluginhub/wiki-struct/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/qxbyte/pluginhub/wiki-struct"><img src="https://agentmods.dev/badge/skills/qxbyte/pluginhub/wiki-struct.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 111 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,710 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.

Model	Per session	Once invoked
Fable 5.1	$0.00111	$0.01710
Opus 5.5	$0.00044	$0.00684
Sonnet 5.5	$0.00022	$0.00342
Haiku 4.5	$0.00011	$0.00171

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

Security

Grade A, and why

wiki-struct 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 1mo ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/struct_gen.py, scripts/test_struct_gen.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

plugins/obsidian-wiki/skills/wiki-struct/SKILL.md · 87 lines

How it starts

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

Wiki Struct

Host-tool convention 🔧: tool names in this skill — AskUserQuestion (structured multiple-choice question) — are written for Claude-family hosts (Claude Code / CodeBuddy), where naming them directly is the most reliable. On a host that lacks one, use its nearest equivalent (a structured-question tool); with no equivalent, fall back to a plain-text question. The described behavior is what matters, not the exact tool name.

配置说明：vault 的结构配置存在家目录注册表 ~/.config/obsidian-wiki/configs/<库名>.json（按 active 库解析；未注册则回退库内 <vault>/.wiki/config.json）。schema 见本插件根 config.example.json。脚本仍通过 --vault "<vault 根路径>" 指定 vault，结构由注册表/回退提供。

脚本定位：脚本装在本 skill 的 scripts/ 目录下。用本 skill 的 base directory 把相对路径 scripts/<脚本名>.py 拼成绝对路径来跑（不解析环境变量、不 find 缓存）。

把"结构层"从手工维护变成可重跑、确定性、内容安全的再生成。设计与约定见本插件根 DESIGN.md（位于 skills/wiki-orchestrate/ 旁的套件文档）。

受管块

结构文件里自动内容放在 marker 之间，本 skill 只重写 marker 之间，marker 外人工内容一字不动：

<!-- wiki-struct:tree start -->
…（自动生成的树 / 文件清单）…
<!-- wiki-struct:tree end -->

三类结构文件：00-Index/Home.md（全库 callout 树）、15 个一级目录 README.md（本目录文件清单）、15 个 00-Index/<目录>.md 分区页（本目录文档清单树）。详见 references/managed-blocks.md。

命令

命令	行为
`/wiki-struct`（= check）	跑 `python3 scripts/struct_gen.py check`，读 `00-Index/_system/struct-report.md`，汇报概览 + 最该处理项。不写结构文件
`/wiki-struct apply [--scope home\|readmes\|partitions\|all]`	备份 → `struct_gen.py apply` → 坏链复核 → 写 wiki-log。改前确认
`/wiki-struct init`	为缺 marker 的结构文件插入受管区（逐文件 AskUserQuestion 确认位置），见下
`/wiki-struct help`	显示本表

未给子命令按 check 处理。

执行流程

check

运行 python3 scripts/struct_gen.py check --vault "<vault>".
Read 00-Index/_system/struct-report.md。
汇报：需更新数 / 缺 marker 数 / 缺文件数 / 坏链数 + 最该处理的 3 项。等用户指令。

init（首次接入，逐文件）

原则：受管块只新插入、绝不包裹/替换人工策展清单。

对报告里"缺 marker"的每个结构文件：

Read 该文件。判定两种情况：
- Home.md：现有 ## 目录树 下的 callout 树本就是上轮自动生成、无人工策展 → 可就地包裹这段（marker 包到 callout 树两端）。
- README / 分区页：现有清单可能是人工策展的主题分组/项目表（如 07-Ideas/README 的项目表、01-Concepts 分区页的 ### 架构设计 分组）→ 不碰它们，改为新插入一个受管块小节 ## 目录树（自动维护），位置默认在文件末尾的"关联"段之前、或 ## 用途 之后。
AskUserQuestion 逐文件确认：「就地包裹现有自动树（仅 Home）/ 在〈位置〉新插入受管块 / 跳过本文件」。
用 Edit 插入  空行 （新插入时块内先留空，由 apply 填充；就地包裹时不改段内内容）。
全部插完后跑一次 apply 填充。

Read the full file on GitHub · 87 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

1mo ago First seen · 87 lines · 111 tokens per session scan A 2cca09c1ee9d

Subscribe to this mod's changes

wiki-struct is a skill published in the GitHub repository qxbyte/pluginhub (3 stars, last pushed 25d ago), licensed MIT. It adds 111 tokens to every session and 1,710 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.

Claude Code Documents Python ai-agents claude-code-plugin codebuddy obsidian

gather

A document-collection guide for Japanese tax filing that lists the documents needed for the filing type and explains where and how to obtain them.

kazukinagata/shinkoku · 105 tokens

submit

A final tax-return review and submission workflow for Japan, covering checks before filing and submission by e-Tax, mail, or in person.

kazukinagata/shinkoku · 107 tokens

reading-deduction-cert

An image-reading workflow for extracting structured information from Japanese insurance and social-insurance deduction certificates. It can read image files and PDFs, including scanned PDFs.

kazukinagata/shinkoku · 63 tokens

reading-receipt

An image-reading workflow for extracting structured information from receipts, invoices, and hometown-tax donation certificates. It can first extract text from PDFs and otherwise read their images.

kazukinagata/shinkoku · 64 tokens

kb-ingest

Ingest documents from the workhub vault inbox into the knowledge base. Classifies notes into projects/knowledge/archive, proposes tasks for actionable items, links, and indexes. Use when new notes land in inbox/ or a path needs filing.

atman-33/workhub · 52 tokens

strategy-decompose

Decompose a strategy handed down from above into a hierarchy of aspects and states, audit it for necessity, sufficiency and overlap, and output it as an xlsx. Use before writing your own team's or unit's policy from a company/department/team strategy, when the user wants to break a strategy down into "what state we…

atman-33/workhub · 85 tokens