Dianel555/DSkills / skills/agent-wiki
agent-wiki
UnverifiedIncremental LLM-friendly wiki generator for Obsidian note vaults. Use when: (1) Building wiki from notes, (2) Ingesting notes to wiki, (3) Obsidian LLM wiki, (4) Incremental knowledge base management. Triggers: 'build wiki from notes', 'ingest notes to wiki', 'Obsidian LLM wiki', 'incremental knowledge base'.
scripts/agent_wiki_cli.py
View on GitHub"""Agent Wiki CLI entry point."""
from __future__ import annotations
import argparse
import json
import os
import sys
import traceback
from pathlib import Path
from agent_wiki import __version__, batch, commands
from dotenv import load_dotenv
def _configure_stdio() -> None:
for stream_name in ("stdout", "stderr"):
stream = getattr(sys, stream_name)
if hasattr(stream, "reconfigure"):
stream.reconfigure(encoding="utf-8")
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(prog="agent_wiki")
parser.add_argument("--version", action="version", version=f"agent-wiki {__version__}")
parser.add_argument("--verbose", "-v", action="store_true", help="Show progress messages to stderr")
sub = parser.add_subparsers(dest="command", required=True)
def add_vault(p: argparse.ArgumentParser) -> None:
p.add_argument("--vault", help="agent-wiki source scope (vault root or child directory)")
init = sub.add_parser("init")
add_vault(init)
init.set_defaults(func=commands.cmd_init)
scan = sub.add_parser("scan")
add_vault(scan)
scan.set_defaults(func=commands.cmd_scan)
plan = sub.add_parser("plan")
plan.add_argument("--batch-size", type=int, default=batch.DEFAULT_BATCH_SIZE, help="Documents per ingest round")
plan.add_argument("--resume", action="store_true", help="Resume existing batch plan instead of creating new one")
add_vault(plan)
plan.set_defaults(func=commands.cmd_plan)
batch_done = sub.add_parser("batch-done")
batch_done.add_argument("--batch", type=int, required=True, help="Batch id to mark complete")
add_vault(batch_done)
batch_done.set_defaults(func=commands.cmd_batch_done)
extract_authors = sub.add_parser("extract-authors")
add_vault(extract_authors)
extract_authors.set_defaults(func=commands.cmd_extract_authors)
aggregate_authors = sub.add_parser("aggregate-authors")
add_vault(aggregate_authors)
aggregate_authors.set_defaults(func=commands.cmd_aggregate_authors)
cache_get = sub.add_parser("cache-get")
cache_get.add_argument("path")
add_vault(cache_get)
cache_get.set_defaults(func=commands.cmd_cache_get)
cache_put = sub.add_parser("cache-put")
cache_put.add_argument("path")
cache_put.add_argument("--topics", default="")
add_vault(cache_put)
cache_put.set_defaults(func=commands.cmd_cache_put)
cleanup = sub.add_parser("cleanup")
add_vault(cleanup)
cleanup.set_defaults(func=commands.cmd_cleanup)
save_report = sub.add_parser("save-report")
save_report.add_argument("name")
add_vault(save_report)
save_report.set_defaults(func=commands.cmd_save_report)
status = sub.add_parser("status")
add_vault(status)
status.set_defaults(func=commands.cmd_status)
index = sub.add_parser("index")
add_vault(index)
index.add_argument("--incremental", action="store_true", help="Reuse existing index for unchanged topics (experimental)")
index.set_defaults(func=commands.cmd_index)
normalize_source_type = sub.add_parser("normalize-source-type")
add_vault(normalize_source_type)
normalize_source_type.set_defaults(func=commands.cmd_normalize_source_type)
gen_base = sub.add_parser("gen-base")
gen_base.add_argument("--name", default="sources", help="Master table base filename (without .base)")
add_vault(gen_base)
gen_base.set_defaults(func=commands.cmd_gen_base)
gen_canvas = sub.add_parser("gen-canvas")
scope = gen_canvas.add_mutually_exclusive_group(required=True)
scope.add_argument("--topic", help="Topic page name (one canvas)")
scope.add_argument("--all", action="store_true", help="One canvas per topic")
add_vault(gen_canvas)
gen_canvas.set_defaults(func=commands.cmd_gen_canvas)
gen_home = sub.add_parser("gen-home")
gen_home.add_argument("--cards", choices=["auto", "on", "off"], default="auto",
help="Workspace cards: auto-detect Dataview (default), force dataviewjs (on), or static list (off)")
gen_home.add_argument("--emit-only", action="store_true",
help="Render index.md to stdout without writing, for an MCP-side conditional write")
add_vault(gen_home)
gen_home.set_defaults(func=commands.cmd_gen_home)
quality = sub.add_parser("quality")
add_vault(quality)
quality.set_defaults(func=commands.cmd_quality)
coverage = sub.add_parser("coverage")
add_vault(coverage)
coverage.set_defaults(func=commands.cmd_coverage)
keywords_cmd = sub.add_parser("keywords")
add_vault(keywords_cmd)
keywords_cmd.set_defaults(func=commands.cmd_keywords)
worklist = sub.add_parser("worklist")
add_vault(worklist)
worklist.set_defaults(func=commands.cmd_worklist)
gen_site = sub.add_parser("gen-site")
add_vault(gen_site)
gen_site.set_defaults(func=commands.cmd_gen_site)
return parser
def main(argv: list[str] | None = None) -> int:
# Load .env files (skill dir, current dir, then cwd) unless disabled for testing
if not os.getenv("DOTENV_DISABLE"):
skill_dir = Path(__file__).resolve().parent.parent
load_dotenv(skill_dir / ".env")
load_dotenv(Path.cwd() / ".env")
_configure_stdio()
parser = build_parser()
args = parser.parse_args(argv)
try:
args.func(args)
except SystemExit:
raise
except Exception as exc:
print(json.dumps({"error": str(exc), "traceback": traceback.format_exc()}, ensure_ascii=False), file=sys.stderr)
return 1
return 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |