knowlery

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.

Use when creating or modifying notes in a Knowlery-structured vault (formerly BYOAO). Enforces frontmatter requirements, wikilinks, and naming conventions.

Open-ended Q&A against the knowledge base. Locates candidate pages with one call to the deterministic retrieval script (.knowlery/bin/query.mjs), then reads the promising ones with Obsidian CLI and synthesizes an evidence-based answer with citations. Use when the user asks questions about vault content like "what is X", "why did we decide Y", "explain Z", "what do my notes say about", "summarize what I know about", or any question that should be answered from accumulated knowledge rather than general training data.

Manage a Knowlery knowledge base from the command line with the standalone knowlery CLI — initialize and sync workspaces, run health checks, query knowledge, detect stale pages, and install, export, and review knowledge bundles. Use when the user asks to operate their knowledge base headlessly (without Obsidian), share knowledge as a bundle, install a bundle someone shared, or verify the workspace after bulk changes.

Work a Knowlery knowledge base through its MCP tools — choose the right tool for the job, run the capture-to-cook loop, and behave well while doing it. Use when Knowlery MCP tools (query, capture, stale, health, init_kb, register_kb, sync, list_kbs, list_bundles) are available in the session, especially in clients without a shell.

The core knowledge compilation skill. Reads raw notes and external sources, then distills them into structured, cross-referenced knowledge pages in entities/, concepts/, comparisons/, and queries/. Keeps SCHEMA.md tag and domain taxonomy in sync when new tags or domains appear. Use this skill whenever the user mentions compiling notes, digesting material, updating the knowledge base, running a cook cycle, or says anything like "process my notes", "compile this", "add this to the wiki", "what's new in my notes", or "update knowledge pages". Also activate when the user pastes external content and wants it integrated into the knowledge base.

Pressure-tests beliefs against vault evidence. Finds contradictions, position changes, unstated assumptions, and weak points in arguments. Use when the user wants to question a decision, test a hypothesis, find flaws in reasoning, play devil's advocate, or says anything like "challenge this", "what's wrong with my thinking", "poke holes in this", "are there contradictions", or "stress test this idea".

Chronological timeline of an idea across notes. Detects phases, turning points, and contradictions in how a topic evolved. Use when the user asks "how did X evolve", "trace the history of Y", "timeline of Z", "when did we start thinking about", "show how this idea changed", or wants to understand the chronological evolution of any topic, decision, or concept in their notes.

Deep vault scan to generate actionable ideas by combining insights across domains, finding gaps, and proposing concrete next steps. Uses INDEX.base (Bases wiki index) and agent directories (`entities/`, `concepts/`, `comparisons/`, `queries/`) for compiled knowledge. Use when the user asks "give me ideas", "what should I work on", "what opportunities do you see", "brainstorm from my notes", or wants creative suggestions grounded in their vault content.

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

Directory organization based on frontmatter metadata. Suggests and applies file moves to keep the vault structured. Use when the user wants to reorganize notes, fix directory placement, clean up the vault structure, or says anything like "organize my notes", "clean up the vault", "move files to the right folders", "tidy up", or "restructure my notes".

Scan agent-maintained directories for health issues: orphan pages, broken wikilinks, stale content, frontmatter violations, tag taxonomy drift, oversized pages. Use this skill whenever the user wants to audit knowledge base quality, check for broken links, find stale or orphan pages, or says anything like "check my wiki", "are there any issues", "audit the knowledge base", "find broken links", or "what needs fixing".

JSON Canvas format

Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.