Skip to content

Dianel555/DSkills / skills/agent-wiki

agent-wiki

Unverified

Incremental 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'.

FileKindSize
.env.exampleother408 B
README.mdmarkdown15.3 KB
SKILL.mdskill md23.3 KB
pyproject.tomlmanifest2.1 KB
references/cli-matrix.mdmarkdown5.9 KB
references/homepage.mdmarkdown6.1 KB
references/index-schema.mdmarkdown6.9 KB
references/site-export.mdmarkdown3.1 KB
references/topic-authoring.mdmarkdown5.1 KB
scripts/agent_wiki/__init__.pyscript103 B
scripts/agent_wiki/authors.pyscript3.9 KB
scripts/agent_wiki/bases.pyscript4.0 KB
scripts/agent_wiki/batch.pyscript3.7 KB
scripts/agent_wiki/boundary.pyscript55.8 KB
scripts/agent_wiki/cache.pyscript5.5 KB
scripts/agent_wiki/canvas.pyscript8.0 KB
scripts/agent_wiki/cleanup.pyscript2.4 KB
scripts/agent_wiki/cli.pyscript97 B
scripts/agent_wiki/commands.pyscript28.3 KB
scripts/agent_wiki/config.pyscript4.2 KB
scripts/agent_wiki/coverage.pyscript2.1 KB
scripts/agent_wiki/frontmatter.pyscript1.6 KB
scripts/agent_wiki/home.pyscript7.9 KB
scripts/agent_wiki/keywords.pyscript2.0 KB
scripts/agent_wiki/links.pyscript14.7 KB
scripts/agent_wiki/plugins.pyscript2.1 KB
scripts/agent_wiki/quality.pyscript7.6 KB
scripts/agent_wiki/scanner.pyscript6.7 KB
scripts/agent_wiki/site.pyscript39.2 KB
scripts/agent_wiki/source_type.pyscript3.2 KB
scripts/agent_wiki/wiki_index.pyscript17.4 KB
scripts/agent_wiki/worklist.pyscript5.7 KB
scripts/agent_wiki_cli.pyscript5.5 KB
templates/home/academic.mdmarkdown2.9 KB
templates/home/dashboard.mdmarkdown2.7 KB
templates/home/magazine.mdmarkdown2.5 KB
templates/query/research.mdmarkdown787 B
tests/conftest.pyscript177 B
tests/fixtures/sample_vault/attachments/image.pngbinary26 B
tests/fixtures/sample_vault/课程/双缝实验.mdmarkdown47 B
tests/fixtures/sample_vault/课程/量子力学.mdmarkdown75 B
tests/test_alias_resolution.pyscript7.5 KB
tests/test_authors.pyscript2.2 KB
tests/test_backlinks.pyscript7.0 KB
tests/test_bases.pyscript4.7 KB
tests/test_batch.pyscript3.0 KB
tests/test_benchmark_index.pyscript2.1 KB
tests/test_boundary_platform.pyscript695 B
tests/test_cache.pyscript2.1 KB
tests/test_cache_strict.pyscript2.1 KB
tests/test_canvas.pyscript8.3 KB
tests/test_capture.pyscript5.5 KB
tests/test_cleanup.pyscript1.2 KB
tests/test_cleanup_init_strict.pyscript2.1 KB
tests/test_cli.pyscript6.2 KB
tests/test_config.pyscript2.0 KB
tests/test_coverage.pyscript7.2 KB
tests/test_e2e.pyscript2.5 KB
tests/test_evaluate_enhancements.pyscript14.7 KB
tests/test_featured_base.pyscript4.3 KB
tests/test_final_security_review.pyscript6.6 KB
tests/test_frontmatter.pyscript1.1 KB
tests/test_gen_home.pyscript4.9 KB
tests/test_gen_site_cli.pyscript3.9 KB
tests/test_home.pyscript7.7 KB
tests/test_immutability.pyscript1.4 KB
tests/test_immutability_capture.pyscript2.4 KB
tests/test_index_capture.pyscript4.5 KB
tests/test_index_cli.pyscript5.4 KB
tests/test_index_extension.pyscript17.0 KB
tests/test_index_source_count.pyscript3.0 KB
tests/test_package_structure.pyscript3.4 KB
tests/test_plugins.pyscript3.1 KB
tests/test_quality.pyscript21.3 KB
tests/test_quality_cli.pyscript5.5 KB
tests/test_quality_prose_weight.pyscript3.8 KB
tests/test_quality_script_fairness.pyscript4.7 KB
tests/test_quality_tier_refactor.pyscript4.0 KB
tests/test_scanner.pyscript2.6 KB
tests/test_scanner_fast_path.pyscript3.5 KB
tests/test_scanner_strict.pyscript2.1 KB
tests/test_secure_temporary_writes.pyscript978 B
tests/test_site.pyscript20.2 KB
tests/test_site_import_isolation.pyscript3.9 KB
tests/test_site_slug_refactor.pyscript3.6 KB
tests/test_source_type.pyscript3.5 KB
tests/test_status_metrics.pyscript4.1 KB
tests/test_status_quality.pyscript5.3 KB
tests/test_status_worklist.pyscript3.0 KB
tests/test_structure.pyscript501 B
tests/test_topic_category.pyscript4.2 KB
tests/test_topic_path_boundary.pyscript2.2 KB
tests/test_vault_boundary.pyscript24.3 KB
tests/test_wiki_index.pyscript13.3 KB
tests/test_worklist.pyscript12.3 KB
tests/test_worklist_cli.pyscript1.9 KB

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())
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall