GodModeAI2025/SkillSafeWerkstatt / maintain-llm-wiki
maintain-llm-wiki
UnverifiedCreate, 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.
scripts/describe_actions.py
View on GitHub#!/usr/bin/env python3
"""Return the machine-readable action catalog of the maintenance skill."""
from __future__ import annotations
import json
import sys
SELECTOR = {
"type": "all | paths | filter",
"operators": ["exists", "not_exists", "equals", "not_equals", "contains", "not_contains", "starts_with", "ends_with", "is_empty", "is_not_empty", "is_list", "is_string", "in_path"],
"virtual_properties": ["__path", "__folder", "__filename", "__extension"],
"combinators": ["AND", "OR"],
}
def action(action_id: str, helper: str, description: str, parameters: list[dict[str, object]], *, writes: bool, preview: bool = False, snapshot: bool = False, confirmation: bool = False) -> dict[str, object]:
return {"id": action_id, "helper": helper, "description": description, "parameters": parameters, "writes": writes, "destructive": confirmation, "preview": preview, "snapshot": snapshot, "confirmation_required": confirmation, "lock_required": writes or helper not in {"plan_identity.py", "verify_release.py", "export_wiki_skill.py"}}
CATALOG = {
"format": "lmwiki-action-catalog/1",
"skill": "maintain-llm-wiki",
"selector": SELECTOR,
"actions": [
action("plan-identity", "plan_identity.py", "Render a hash-bound SOUL and content-policy proposal without touching a wiki.", [{"name": "input", "type": "identity JSON", "required": True}, {"name": "wiki_language", "type": "BCP-47 string", "required": True}], writes=False, preview=True, confirmation=True),
action("apply-identity", "apply_identity.py", "Apply only a confirmed identity proposal and snapshot prior identity files.", [{"name": "plan_file", "type": "path", "required": True}, {"name": "expect_proposal_sha256", "type": "sha256", "required": True}], writes=True, snapshot=True, confirmation=True),
action("initialize", "initialize_wiki.py", "Build and release a new wiki in staging, then commit it without exposing a lock token.", [{"name": "target", "type": "path", "required": True}, {"name": "title", "type": "string", "required": True}, {"name": "topic", "type": "string", "required": True}, {"name": "wiki_language", "type": "BCP-47 string", "required": True}, {"name": "identity_plan", "type": "confirmed plan path", "required": True}, {"name": "expect_identity_sha256", "type": "sha256", "required": True}], writes=True, snapshot=False, confirmation=True),
action("validate-extraction", "validate_extraction.py", "Assess UTF-8, flattening, own-line page and slide markers, headings, table structure, and credential-shaped content before registration.", [{"name": "markdown_file", "type": "runtime path", "required": True}, {"name": "source_type", "type": "string", "required": False}], writes=False),
action("register-source", "register_source.py", "Register faithful Markdown source evidence without storing an absolute source path.", [{"name": "markdown_file", "type": "runtime path", "required": True}, {"name": "title", "type": "string", "required": True}, {"name": "original_ref", "type": "portable reference", "required": True}], writes=True),
action("inventory-frontmatter", "inventory_wiki.py", "Return property counts, observed types, samples, and schema drift.", [], writes=False),
action("plan-frontmatter", "frontmatter_actions.py plan", "Resolve a selector and create an immutable before/after plan with file hashes.", [{"name": "selector", "type": "selector", "required": True}, {"name": "action", "type": "frontmatter action", "required": True}, {"name": "output", "type": "temporary plan path", "required": True}], writes=False, preview=True),
action("apply-frontmatter", "frontmatter_actions.py apply", "Apply exactly a confirmed plan when every file still matches its precondition hash.", [{"name": "plan_file", "type": "path", "required": True}, {"name": "expect_plan_sha256", "type": "sha256", "required": True}], writes=True, snapshot=True, confirmation=True),
action("snapshot", "snapshot_wiki.py", "Create a portable pre-change snapshot with its own file manifest.", [{"name": "operation", "type": "string", "required": False}], writes=True),
action("list-snapshots", "restore_wiki.py list", "List valid and invalid recovery snapshots.", [], writes=False),
action("plan-restore", "restore_wiki.py plan", "Preview a targeted restore with current and snapshot hashes.", [{"name": "snapshot_id", "type": "string", "required": True}, {"name": "paths", "type": "string[]", "required": False}], writes=False, preview=True),
action("apply-restore", "restore_wiki.py apply", "Restore only a confirmed hash-bound plan and create a recovery snapshot first.", [{"name": "plan_file", "type": "path", "required": True}, {"name": "expect_plan_sha256", "type": "sha256", "required": True}], writes=True, snapshot=True, confirmation=True),
action("move-page", "move_wiki_page.py", "Preview or apply a page move while rewriting internal wikilinks.", [{"name": "from_path", "type": "wiki path", "required": True}, {"name": "to_path", "type": "wiki path", "required": True}], writes=True, preview=True, snapshot=True, confirmation=True),
action("plan-language-migration", "plan_language_migration.py", "Report complete impact of a maintained-language migration.", [{"name": "to_language", "type": "BCP-47 string", "required": True}], writes=False, preview=True),
action("plan-page-batch", "page_batch.py plan", "Hash a staged wiki-page batch and target preconditions outside the canonical wiki.", [{"name": "staging_dir", "type": "runtime path", "required": True}, {"name": "paths", "type": "wiki path[]", "required": True}], writes=False, preview=True),
action("apply-page-batch", "page_batch.py apply", "Validate a complete temporary mirror, then commit the batch with atomic per-file replacement and snapshot recovery.", [{"name": "staging_dir", "type": "runtime path", "required": True}, {"name": "plan_file", "type": "path", "required": True}, {"name": "expect_plan_sha256", "type": "sha256", "required": True}], writes=True, snapshot=True),
action("lint", "lint_wiki.py", "Validate deterministic structure; check-only is no-write and fix-safe permits only deterministic repairs; warns on claim locators that do not resolve in their source; reports an alias review statistic (common alias words, shared aliases) for confirmation and source coverage (uncited sources, pages, sections) as a statistic, never as a failure.", [{"name": "fix_safe", "type": "boolean", "required": False}, {"name": "check_only", "type": "boolean", "required": False}], writes=True),
action("build-graph", "build_graph.py", "Regenerate the offline graph and relative HTML reading views.", [], writes=True),
action("quality-review-record", "record_quality_review.py", "Record a review only after it actually occurred.", [{"name": "kind", "type": "quality | cleaning", "required": True}, {"name": "outcome", "type": "passed | attention-needed | not-applicable", "required": True}], writes=True),
action("release", "release_wiki.py", "Idempotently lint, version, record quality status, hash controlled files, and publish the manifest last.", [{"name": "bump", "type": "patch | minor | major", "required": True}, {"name": "operation_id", "type": "portable idempotency key", "required": True}, {"name": "expect_current_version", "type": "semantic version", "required": True}], writes=True),
action("verify-release", "verify_release.py", "Verify a released snapshot read-only.", [{"name": "expect_manifest_sha256", "type": "sha256", "required": False}], writes=False),
action("export-frozen-skill", "export_wiki_skill.py", "Export one verified release as an immutable knowledge-only skill.", [{"name": "skill_name", "type": "lowercase-hyphenated", "required": True}], writes=False),
action(
"resolve-conflict-copy-plan",
"resolve_conflict_copy.py plan",
"Report synchronization conflict copies with both sides, without changing anything.",
[],
writes=False,
),
action(
"resolve-conflict-copy-apply",
"resolve_conflict_copy.py apply",
"Apply one confirmed, hash-bound conflict resolution after an automatic snapshot.",
[
{"name": "plan_file", "type": "string", "required": True},
{"name": "expect_plan_sha256", "type": "string", "required": True},
{"name": "decision", "type": "string[]", "required": True},
],
writes=True,
),
action(
"verify-pages-plan",
"verify_pages.py plan",
"Show which pages a confirmation would cover and the tier it would record.",
[
{"name": "actor", "type": "string", "required": True},
{"name": "page", "type": "string[]", "required": True},
],
writes=False,
),
action(
"verify-pages-apply",
"verify_pages.py apply",
"Record a confirmed page review after an automatic snapshot; a human actor "
"additionally requires explicit user confirmation.",
[
{"name": "plan_file", "type": "string", "required": True},
{"name": "expect_plan_sha256", "type": "string", "required": True},
{"name": "user_confirmed_human_review", "type": "boolean", "required": False},
],
writes=True,
),
action(
"export-okf-bundle",
"export_okf_bundle.py",
"Write one verified release as an OKF v0.2 bundle into a separate destination; "
"lossy by construction and never modifies the wiki.",
[
{"name": "destination", "type": "string", "required": True},
{"name": "allow_hydration", "type": "boolean", "required": False},
],
writes=False,
),
action(
"adopt-directory-plan",
"adopt_directory.py plan",
"Report which files of an existing Markdown collection could be registered as "
"sources, with blockers and storage notes, without changing anything.",
[
{"name": "source_dir", "type": "runtime path", "required": True},
{"name": "content_language", "type": "BCP-47 string", "required": False},
{"name": "output", "type": "temporary plan path", "required": False},
],
writes=False,
preview=True,
),
action(
"adopt-directory-apply",
"adopt_directory.py apply",
"Register exactly the confirmed files of a hash-bound adoption plan as sources "
"after an automatic snapshot; creates no wiki page.",
[
{"name": "source_dir", "type": "runtime path", "required": True},
{"name": "plan_file", "type": "string", "required": True},
{"name": "expect_plan_sha256", "type": "sha256", "required": True},
{"name": "accept", "type": "string[]", "required": True},
],
writes=True,
snapshot=True,
confirmation=True,
),
action("report-okf", "report_okf.py", "Report optional OKF required/recommended field compatibility without mutation.", [{"name": "include_sources", "type": "boolean", "required": False}], writes=False),
action(
"findability-add",
"findability_questions.py add",
"Record one findability question in the owner's or a user's own words with its confirmed target claim, "
"outside the release; never a question the agent wrote.",
[
{"name": "question", "type": "verbatim string, at most 500 characters, or '-' for {\"query\": ...} on standard input", "required": True},
{"name": "claim_id", "type": "clm-<16 hex>", "required": True},
{"name": "author", "type": "owner | user", "required": True},
{"name": "user_supplied_wording", "type": "boolean; only for wording the owner or a user supplied", "required": True},
{"name": "note", "type": "string, at most 200 characters", "required": False},
],
writes=True,
),
action(
"findability-remove",
"findability_questions.py remove",
"Remove one findability question after the user confirmed it; snapshots the file first.",
[{"name": "question_id", "type": "fq-<16 hex>", "required": True}],
writes=True,
snapshot=True,
confirmation=True,
),
action(
"findability-check",
"findability_questions.py check",
"Rank every findability question with the query skill's search core on the working files and report "
"which no longer find their target claim; never blocks a release.",
[{"name": "limit", "type": "integer 1-100 (default 12)", "required": False}],
writes=False,
),
],
}
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)
print(json.dumps(CATALOG, ensure_ascii=False, indent=2))
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: 472k | 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 |