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

View on GitHub
"""Quality tier scoring for wiki topics.

Computes deterministic structural metrics and assigns a five-tier rating
(stub/basic/standard/rich/premium) based on content richness. No LLM calls,
no network access, no I/O side effects.
"""

from __future__ import annotations

import re
import unicodedata
from typing import Any

from .config import nfc as _nfc

_LIST_RE = re.compile(r"^(?:[-*+]|\d+[.)\]])\s")


def _is_markdown_image_only(stripped: str) -> bool:
    """``![alt](url)`` with nothing but punctuation after the closing paren."""
    if not (stripped.startswith("![") and ")" in stripped):
        return False
    _, _, tail = stripped.partition(")")
    return not any(c.isalnum() for c in tail)


def _is_non_prose(stripped: str) -> bool:
    """Heading, list, quote, table, comment, or embed-only line."""
    return (
        stripped.startswith(("#", ">", "|", "<!--"))
        or bool(_LIST_RE.match(stripped))
        or (stripped.startswith("![[") and stripped.endswith("]]"))
        or _is_markdown_image_only(stripped)
    )


def _count_cjk_and_latin(text: str) -> tuple[int, int]:
    r"""Count CJK characters and Latin words in NFC-normalized text.

    CJK characters: EAW in {W, F} AND category starts with L or N.
    Excludes wide/fullwidth punctuation, symbols, emoji.
    Halfwidth katakana (EAW=H) is normalized to fullwidth via NFKC first.

    Latin words: after replacing wide/fullwidth chars with spaces,
    count word runs via [^\W_]+ pattern.

    Returns (cjk_chars, latin_words).
    """
    # Apply NFC normalization
    text = _nfc(text)

    # Apply NFKC to normalize halfwidth katakana to fullwidth
    text = unicodedata.normalize("NFKC", text)

    cjk_count = 0
    for ch in text:
        eaw = unicodedata.east_asian_width(ch)
        cat = unicodedata.category(ch)
        # CJK: wide/fullwidth AND letter/number category
        if eaw in ('W', 'F') and cat[0] in ('L', 'N'):
            cjk_count += 1

    # Replace wide/fullwidth chars with spaces to prevent merge
    latin_text = ""
    for ch in text:
        eaw = unicodedata.east_asian_width(ch)
        if eaw in ('W', 'F'):
            latin_text += " "
        else:
            latin_text += ch

    # Count word runs (letters/digits, excluding underscores)
    words = re.findall(r'[^\W_]+', latin_text, re.UNICODE)
    latin_count = len(words)

    return cjk_count, latin_count


def compute_metrics(body: str) -> dict[str, Any]:
    """Compute structural quality metrics from topic body.

    Metrics:
    - sections: count of ## to ###### ATX headings (excluding level-1)
    - evidence_lines: count of lines starting with "> "
    - prose_chars: NFC character length of paragraph lines (retained for transparency)
    - prose_weight: script-aware prose measure (10 × cjk_chars + 16 × latin_words)
    - cjk_chars: count of CJK ideographs (EAW W/F + category L/N)
    - latin_words: count of Latin/other word runs
    - has_image: bool, body contains image embed
    - has_lead: bool, first non-blank line is a paragraph

    Returns dict with all metrics.
    """
    lines = body.splitlines()

    sections = 0
    evidence_lines = 0
    prose_chars = 0
    cjk_total = 0
    latin_total = 0
    has_image = False
    has_lead = False

    in_fence = False
    first_content_line_checked = False
    seen_h1 = False

    for line in lines:
        stripped = line.strip()

        # Toggle fence state
        if stripped.startswith("```") or stripped.startswith("~~~"):
            in_fence = not in_fence
            continue

        # Skip fenced content
        if in_fence:
            continue

        # Skip blank lines
        if not stripped:
            continue

        # Skip the first level-1 heading (topic title)
        if not seen_h1 and re.match(r"^#\s+\S", stripped):
            seen_h1 = True
            continue

        # Check for has_lead (first non-blank, non-fenced line after optional h1)
        if not first_content_line_checked:
            first_content_line_checked = True
            # It's a paragraph if it's NOT a heading, list, quote, table, comment, or image
            is_heading = stripped.startswith("#")
            is_list = re.match(r"^[-*+]\s", stripped) or re.match(r"^\d+[.)\]]\s", stripped)
            is_quote_or_table = stripped.startswith(">") or stripped.startswith("|")
            is_comment = stripped.startswith("<!--")
            is_wikilink_image = stripped.startswith("![[") and stripped.endswith("]]")
            is_markdown_image = stripped.startswith("![") and ")" in stripped

            if not (is_heading or is_list or is_quote_or_table or is_comment or
                    is_wikilink_image or is_markdown_image):
                has_lead = True

        # Count sections (## to ######)
        if re.match(r"^#{2,6}\s+\S", stripped):
            sections += 1
            continue

        # Count evidence lines
        if stripped.startswith("> "):
            evidence_lines += 1
            continue

        # Check for images
        if not has_image:
            # Obsidian embed: ![[filename.ext]]
            obsidian_embed_match = re.search(r"!\[\[.+?\.(png|jpg|jpeg|gif|webp|svg|bmp)\]\]", stripped, re.IGNORECASE)
            if obsidian_embed_match:
                has_image = True
            # Markdown image: ![alt](url)
            markdown_image_match = re.match(r"!\[.*?\]\(.+?\)", stripped)
            if markdown_image_match:
                has_image = True

        # Count prose characters and compute prose_weight
        if not _is_non_prose(stripped):
            prose_chars += len(_nfc(stripped))
            cjk, latin = _count_cjk_and_latin(stripped)
            cjk_total += cjk
            latin_total += latin

    prose_weight = 10 * cjk_total + 16 * latin_total

    return {
        "sections": sections,
        "evidence_lines": evidence_lines,
        "prose_chars": prose_chars,
        "prose_weight": prose_weight,
        "cjk_chars": cjk_total,
        "latin_words": latin_total,
        "has_image": has_image,
        "has_lead": has_lead,
    }


def compute_tier(body: str, source_count: int = 0, *, metrics: dict[str, Any] | None = None) -> str:
    """Assign quality tier based on metrics and source grounding.

    Uses effective_prose = prose_weight + 500*source_count for tier gates.
    Tiers (top-down first-match):
    - premium: sections >= 6 AND effective_prose >= 3000 AND evidence_lines >= 3
    - rich: sections >= 4 AND effective_prose >= 1500 AND (evidence_lines >= 1 OR has_image)
    - standard: sections >= 2 AND effective_prose >= 600
    - basic: effective_prose >= 200 OR sections >= 1
    - stub: otherwise

    Args:
        body: Topic body markdown
        source_count: Number of deduplicated sources (default 0)
        metrics: Precomputed ``compute_metrics(body)`` to avoid a second pass

    Returns tier string.
    """
    if metrics is None:
        metrics = compute_metrics(body)

    sections = metrics["sections"]
    prose_weight = metrics["prose_weight"]
    evidence_lines = metrics["evidence_lines"]
    has_image = metrics["has_image"]

    # Compute effective prose with source grounding bonus
    effective_prose = prose_weight + 500 * source_count

    # Premium
    if sections >= 6 and effective_prose >= 3000 and evidence_lines >= 3:
        return "premium"

    # Rich
    if sections >= 4 and effective_prose >= 1500 and (evidence_lines >= 1 or has_image):
        return "rich"

    # Standard
    if sections >= 2 and effective_prose >= 600:
        return "standard"

    # Basic (requires some prose OR structure; sources alone insufficient)
    if (effective_prose >= 200 and prose_weight > 0) or sections >= 1:
        return "basic"

    # Stub
    return "stub"
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