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/config.py

View on GitHub
"""Configuration and vault path resolution."""

from __future__ import annotations

import json
import os
import sys
import unicodedata
from pathlib import Path
from typing import Any

from . import boundary


def nfc(value: Any) -> str:
    return unicodedata.normalize("NFC", str(value))


def atomic_write_text(path: Path, data: str | bytes) -> None:
    """Write inside the vault through a verified directory handle.

    The parent directory is opened without following links (see :mod:`boundary`), the
    payload goes to an exclusively created temporary file inside it, and the temporary
    file replaces the destination relative to that same directory. A link planted on
    the destination therefore never redirects the write, and neither does swapping the
    directory between the check and the write."""
    boundary.write_text(path, data)


def _json_stderr(payload: dict[str, Any]) -> None:
    print(json.dumps(payload, ensure_ascii=False), file=sys.stderr)


def resolve_vault(args_vault: str | None) -> Path:
    raw = args_vault or os.getenv("AGENT_WIKI_VAULT", "")
    if not raw:
        _json_stderr({"error": "vault path required", "hint": "pass --vault PATH or set AGENT_WIKI_VAULT"})
        sys.exit(2)

    vault = Path(nfc(raw)).expanduser().resolve()
    if not vault.is_dir():
        _json_stderr({"error": "vault not found", "path": str(vault)})
        sys.exit(2)
    return vault


def wiki_root(vault: str | Path) -> Path:
    # Every derived path flows through here, so this is the single place where the vault
    # is registered as the authorized root for the boundary checks.
    boundary.bind(vault)
    return Path(vault).expanduser().resolve() / "wiki"


def cache_path(vault: str | Path) -> Path:
    return wiki_root(vault) / ".wiki-cache.json"


def index_path(vault: str | Path) -> Path:
    return wiki_root(vault) / ".wiki-index.json"


def batch_path(vault: str | Path) -> Path:
    return wiki_root(vault) / ".wiki-batch.json"


def topics_dir(vault: str | Path) -> Path:
    return wiki_root(vault) / "topics"


def queries_dir(vault: str | Path) -> Path:
    return wiki_root(vault) / "queries"


def graphs_dir(vault: str | Path) -> Path:
    return wiki_root(vault) / "graphs"


def archive_dir(vault: str | Path) -> Path:
    return wiki_root(vault) / "_archived"


def normalize_relpath(path: str | Path) -> str:
    value = str(path).replace("\\", "/").strip()
    while value.startswith("./"):
        value = value[2:]
    if len(value) >= 2 and value[0].isalpha() and value[1] == ":":
        raise ValueError(f"absolute drive path not allowed: {path!r}")
    return nfc(value)


def to_rel_posix(abs_path: str | Path, vault: str | Path) -> str:
    """Express ``abs_path`` relative to ``vault``.

    The path is normalized lexically rather than resolved: resolving would follow a
    link and turn a path that is lexically inside the vault into one that is not, which
    makes the check depend on what the link points at instead of on the path itself.
    Link safety is the boundary module's job, at open time.
    """
    path = Path(os.path.normpath(Path(abs_path).expanduser()))
    root = Path(os.path.normpath(Path(vault).expanduser()))
    try:
        return normalize_relpath(path.relative_to(root).as_posix())
    except ValueError as exc:
        raise ValueError(f"{abs_path!r} is not inside the vault {vault!r}") from exc


def source_path(vault: str | Path, relpath: str | Path) -> Path:
    """A source path inside ``vault``; rejects traversal, not links."""
    rel = normalize_relpath(relpath)
    root = Path(os.path.normpath(Path(vault).expanduser()))
    path = Path(os.path.normpath(root / Path(rel)))
    try:
        path.relative_to(root)
    except ValueError as exc:
        raise ValueError(f"{relpath!r} escapes the vault {vault!r}") from exc
    return path


def topic_path(vault: str | Path, relpath: str | Path) -> Path:
    """Resolve a derived-topic relpath, constrained to wiki/topics (raises ValueError outside)."""
    rel = normalize_relpath(relpath)
    root = Path(os.path.normpath(topics_dir(vault)))
    path = Path(os.path.normpath(root / Path(rel)))
    try:
        path.relative_to(root)
    except ValueError as exc:
        raise ValueError(f"{relpath!r} is not inside wiki/topics") from exc
    return path
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