vault-skill-factory

Generates portable Agent Skills from mature Obsidian wiki pages into a review directory.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill vault-skill-factory-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-skill-factory
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/vault-skill-factory
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill vault-skill-factory-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a cluster of mature, curated Obsidian wiki pages into a reusable, self-contained Agent Skill (SKILL.md plus references/) without manual restructuring, while keeping generated output strictly in a review directory so nothing is auto-installed. ## Core Features & Use Cases - Cluster Selection: Expands a topic, tag, or seed page into a full page cluster via QMD semantic search or wikilink neighborhoods, then filters by lifecycle maturity (reviewed, verified, or tier: core). - Skill Generation: Writes a lean SKILL.md with a pushy trigger description, a references/ folder of distilled depth material, a sources.md provenance file, and a SKILL_FACTORY.md manifest recording generation metadata. - Safety Guardrails: Never writes into .skills/ or global skill directories and never auto-installs; it ends by reporting the output path and a manual, project-local install command. - Use Case: You have a dozen verified wiki pages on peptide protocols and want a shareable domain-expert skill; the factory distills them into a reviewable skill bundle under _generated-skills/. ## Quick Start Ask the agent to make a skill from your wiki pages on a chosen topic and review the generated bundle in the vault's _generated-skills directory.

Frequently Asked Questions about vault-skill-factory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn my Obsidian wiki pages into an AI agent skill?

Invoke the factory with a topic, tag, or seed page; it expands the cluster via QMD semantic search or wikilinks, filters for mature pages, and writes a SKILL.md plus references/ bundle to the vault's _generated-skills directory for your review.

What makes a wiki page eligible for skill generation?

Pages qualify when their lifecycle frontmatter matches the SKILL_FACTORY_MATURITY list (default: reviewed, verified) or when they carry tier: core. Draft pages are excluded unless you explicitly include them.

Does the vault skill factory install the generated skill automatically?

No. It only writes to the review directory (default $OBSIDIAN_VAULT_PATH/_generated-skills) and never touches .skills/ or global skill directories. Installation is a separate manual step using a project-local symlink.

Can I generate a skill from just one or two wiki pages?

The factory warns when fewer than about three mature pages match, since a thin cluster produces a weak skill. You can proceed anyway or widen the search to include more related pages.

How does the generated skill stay traceable to its sources?

Each bundle includes references/sources.md listing every vault page used and their upstream sources, plus a SKILL_FACTORY.md manifest recording the cluster, maturity filter, generation date, and vault commit.