Skip to content

GodModeAI2025/SkillSafeWerkstatt / maintain-llm-wiki

maintain-llm-wiki

Unverified

Create, maintain, inventory, migrate, recover, quality-review, optionally clean, release, or export an evidence-linked SkillSafeWerkstatt Markdown wiki. Use whenever the user wants to initialize or extend this wiki, ingest documents as Markdown, curate claims, clusters or concepts, clean metadata, restore files, record who reviewed which pages, resolve a OneDrive or SharePoint conflict copy, publish a release, or export a frozen read-only knowledge skill or an Open Knowledge Format bundle in Claude Code, Claude Cowork, or Codex.

FileKindSize
SKILL.mdskill md57.2 KB
assets/graph-template.htmlother27.8 KB
assets/knowledge-skill/SKILL.template.mdmarkdown35.6 KB
assets/knowledge-skill/assess_quality.pyscript1.5 KB
assets/knowledge-skill/identity_status.pyscript5.9 KB
assets/knowledge-skill/search_knowledge.pyscript4.5 KB
assets/knowledge-skill/verify_knowledge.pyscript4.8 KB
assets/page-template.htmlother7.4 KB
evals/evals.jsonconfig32.6 KB
references/adapted-vault-standards.mdmarkdown3.3 KB
references/frontmatter-operations.mdmarkdown9.8 KB
references/wiki-contract.mdmarkdown73.0 KB
scripts/adopt_directory.pyscript13.2 KB
scripts/apply_identity.pyscript3.1 KB
scripts/bm25.pyscript8.2 KB
scripts/build_graph.pyscript27.0 KB
scripts/claim_id.pyscript1.9 KB
scripts/describe_actions.pyscript13.2 KB
scripts/design_contract.pyscript217 B
scripts/export_okf_bundle.pyscript17.9 KB
scripts/export_wiki_skill.pyscript23.7 KB
scripts/findability_questions.pyscript17.6 KB
scripts/freshness.pyscript3.6 KB
scripts/frontmatter_actions.pyscript26.1 KB
scripts/frontmatter_contract.pyscript10.0 KB
scripts/identity_contract.pyscript15.2 KB
scripts/init_wiki.pyscript18.2 KB
scripts/initialize_wiki.pyscript12.2 KB
scripts/inventory_wiki.pyscript6.7 KB
scripts/lint_wiki.pyscript56.0 KB
scripts/move_wiki_page.pyscript6.7 KB
scripts/navigation.pyscript11.0 KB
scripts/okf_contract.pyscript14.3 KB
scripts/page_batch.pyscript11.4 KB
scripts/plan_identity.pyscript2.2 KB
scripts/plan_language_migration.pyscript4.9 KB
scripts/portable_io.pyscript3.3 KB
scripts/quality_core.pyscript15.9 KB
scripts/record_quality_review.pyscript3.4 KB
scripts/register_source.pyscript12.2 KB
scripts/release_wiki.pyscript15.9 KB
scripts/report_okf.pyscript3.8 KB
scripts/resolve_conflict_copy.pyscript11.0 KB
scripts/restore_wiki.pyscript16.1 KB
scripts/run_locked.pyscript2.2 KB
scripts/search_core.pyscript221.1 KB
scripts/secret_screen.pyscript4.1 KB
scripts/snapshot_wiki.pyscript6.7 KB
scripts/source_coverage.pyscript22.8 KB
scripts/sync_artifacts.pyscript14.2 KB
scripts/trust_contract.pyscript5.2 KB
scripts/validate_extraction.pyscript5.0 KB
scripts/verify_pages.pyscript9.1 KB
scripts/verify_release.pyscript12.1 KB
scripts/wiki_filters.pyscript6.6 KB
scripts/wiki_lock.pyscript59.2 KB
scripts/wordforms.pyscript56.0 KB

assets/knowledge-skill/search_knowledge.py

View on GitHub
#!/usr/bin/env python3
"""Search only this skill's bundled frozen wiki and return ranked JSON evidence.

This is the command-line wrapper of an exported knowledge skill. It verifies the
bundled snapshot before and after the search; ranking, claims, snippets,
reformulations and the coverage block come from `search_core.py`, the same core
the query skill uses. The query and up to four reformulations come from
`--query` and `--also`, or as one JSON object on standard input with
`--request -`. With `--exhaustive` the same call also ranks the sources and
scans every passage for all words of all searches before an absence statement;
every report carries `search_record` and `absence_check`.
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

# Siblings are imported from this folder even where the interpreter leaves it
# off sys.path: python -I, python -P, PYTHONSAFEPATH=1.
_SCRIPT_DIR = str(Path(__file__).resolve().parent)
if _SCRIPT_DIR not in sys.path:
    sys.path.insert(0, _SCRIPT_DIR)

import search_core
from verify_knowledge import knowledge_root, verify


#: Result paths are relative to this skill's folder, where the agent opens them.
PATH_PREFIX = "references/knowledge/"


def snapshot_changed(expected: str = "", actual: str = "") -> int:
    release: dict = {"state": "snapshot_changed"}
    if expected:
        release.update({"expected_manifest_sha256": expected, "manifest_sha256": actual})
    print(search_core.report_json({"release": release, "results": []}))
    return 4


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    search_core.add_search_arguments(
        parser,
        history=False,
        limit_help="Maximum result count (1-100)",
        exhaustive_help="Also rank sources and scan every passage of the wiki pages, meta/questions.md and the source "
        "Markdown for all words of all searches; "
        "returns at most 100,000 printed characters of matching passages under exhaustive_hits; "
        "required before stating that the snapshot holds nothing on a question",
        manifest_help="Manifest hash retained from verify_knowledge.py; a different snapshot reports snapshot_changed",
    )
    args = search_core.parse_search_arguments(parser)
    # The request is read and checked before the snapshot is touched.
    try:
        query, also, request_filter = search_core.query_from_arguments(args, sys.stdin)
    except search_core.RequestError as exc:
        raise SystemExit(str(exc)) from exc
    if args.limit < 1 or args.limit > 100:
        raise SystemExit("limit must be between 1 and 100")
    try:
        selector = search_core.selector_from(request_filter, args.filter_json)
    except search_core.RequestError as exc:
        raise SystemExit(str(exc)) from exc

    release = verify()
    if release.get("state") != "ready":
        print(search_core.report_json({"release": release, "results": []}))
        return 4
    if args.expect_manifest_sha256 and release.get("manifest_sha256") != args.expect_manifest_sha256:
        return snapshot_changed(args.expect_manifest_sha256, str(release.get("manifest_sha256") or ""))
    # The exhaustive scan ranks the sources too; the report prints the effective value.
    include_sources = args.include_sources or args.exhaustive
    try:
        found = search_core.search(
            knowledge_root(),
            query,
            also=also,
            limit=args.limit,
            include_sources=include_sources,
            selector=selector,
            history_shipped=False,
            path_prefix=PATH_PREFIX,
            exhaustive=args.exhaustive,
        )
    except (search_core.QueryError, search_core.RequestError) as exc:
        raise SystemExit(str(exc)) from exc

    final_release = verify()
    if final_release.get("state") != "ready" or final_release.get("manifest_sha256") != release.get("manifest_sha256"):
        return snapshot_changed()
    if found["parser_errors"]:
        print(search_core.report_json({"state": "invalid_frontmatter", "release": release, "parser_errors": found["parser_errors"], "results": []}))
        return 5
    print(search_core.report_json(search_core.report_body(found, release, selector, {"include_sources": include_sources})))
    return 0


if __name__ == "__main__":
    # Windows pipes default to the ANSI code page; output is UTF-8 everywhere.
    for _stream in (sys.stdout, sys.stderr):
        if hasattr(_stream, "reconfigure"):
            _stream.reconfigure(encoding="utf-8", errors=_stream.errors)
    raise SystemExit(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: 472kUpdated 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