Skip to content
SkillModel-led3,365 tokens in use

vault-skill-factory

Generates a portable, reviewable agent skill from a cluster of mature wiki pages or from one narrated recording of a job, and stops before installing it.

3,792 stars on the repository MIT LicenseAr9av/obsidian-wiki · skills/vault-skill-factory
pip install obsidian-wiki
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing vault-skill-factory costs

94tokens idle
3,365tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples15/15
  • Output15/15
  • Size13/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

vault-skill-factory has two modes. Cluster mode picks mature pages on a topic (by lifecycle or core tier), confirms the list with you, and distills them into a SKILL.md with references. Recording mode takes a transcript of someone doing a job out loud and turns it into a small skill with when to use, steps, checks, mistakes and done criteria.

Everything is written to a review folder inside the vault with a provenance manifest. The skill reports where it is and how to install it project-locally, and leaves that decision to you.

What You Get

  • A skill folder with SKILL.md, a references folder and a sources file that traces back to vault pages
  • A factory manifest recording the pages, maturity filter, date and mode, kept apart from the installable skill
  • For recordings, a skill with when to use, steps, checks, mistakes to avoid and done-when sections
  • Preserved inferred and ambiguous markers so uncertain claims stay visible
  • A report with the output path, the trigger description and project-local install instructions

Common Use Cases

  • Packaging a well-curated body of notes on one subject as a reusable skill
  • Turning a narrated screen recording of a monthly process into a repeatable skill
  • Regenerating a skill after its source pages change, using the saved manifest

What Makes It Unique

It is the inverse of a capture step: it starts from verified wiki knowledge and builds a runtime skill, and it refuses to write into the vault’s own skills folder, run the setup script or create links into global skill directories. Recording mode treats the transcript as untrusted data, keeps the speaker’s exact menu names and thresholds, lets a mid-recording correction win, and lists gaps under open questions so nothing is filled in from general knowledge.

Under The Hood

The skill is instructions for the agent. It reads vault pages and writes a new folder of Markdown files into a review directory in the vault. It may run the qmd command to search related pages, the obsidian-wiki command line tool to condense a transcript, and, if you ask for polish, the Python scripts of the skill-creator skill to validate, package or tighten the description. For meeting recordings it fetches a named transcript through whichever recorder integration you have configured. It does not install anything itself.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers