An automated maintenance skill designed to compile, validate, and update high-level overview wiki pages in a Gitea-backed team knowledge base.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kb-maintenance
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install kb-maintenance using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is KB Maintenance?
The KB Maintenance skill is a technical automation tool tailored for team knowledge management in Gitea repositories. Operating as a background task, it helps team members digest ongoing updates without manual synthesis. Instead of modifying raw documentation pages, the skill analyzes recent changes, evaluates structure, and generates exactly six core overview files. These files provide clear summaries of research tracks, open questions, and overall roadmaps.\n\nBy leveraging this tool, teams ensure that project documentation remains coherent and up-to-date. It compiles directories, maps active resources, and highlights information gaps, offering a reliable entry point to the team's collective intelligence. Because it is optimized for scheduled runs, it handles the compilation of metadata quietly and logs states natively to hidden tracking files for interface display.
KB Maintenance Use Cases
- Summarizing active research directions and project maps from a growing wiki database.\n- Aggregating recent modifications to present to the team during scheduled check-ins.\n- Highlighting data gaps, unresolved risks, or missing source materials directly within designated markdown pages.\n- Generating automated, machine-readable maintenance status summaries for external frontend applications.
How KB Maintenance Works
- Inspection: The skill triggers an inspection task to read metadata, page logs, and existing entry summaries from Gitea.\n2. Evidence gathering: It identifies changed paths and reads underlying evidence documents to find updates.\n3. Drafting: It writes markdown draft versions of the six designated overview files to a local temp directory.\n4. Validation: The skill evaluates the draft structures to ensure no content files or configurations are corrupted.\n5. Application: It applies the drafts back to Gitea, updates catalog mappings, and registers operation logs.
KB Maintenance Setup
Configure the runtime environment by setting the required variables:\n\nbash\nexport GITEA_URL="https://your-gitea-instance.com"\nexport GITEA_BOT_TOKEN="your_bot_token"\nexport GITEA_BOT_USERNAME="your_bot_username"\nexport TEAM_KB_REPO="your_kb_repository"\n\n\nRun the inspection step:\nbash\npython3 scripts/run_task.py inspect --output maintenance-inspection.json --quiet\n\n\nApply updates using drafts:\nbash\npython3 scripts/run_task.py apply --draft-dir overview-drafts --summary "Weekly KB compilation" --quiet\n
KB Maintenance Data Schema & Taxonomy
The skill works within a Gitea repository structure, producing structured outputs and updating catalog definitions.\n\n### Core Target Documents\n| Path | Purpose |\n|---|---|\n| overview/team-overview.md | Primary entry point and team knowledge scope definition |\n| overview/research-map.md | Map of active themes, project linkages, and methodologies |\n| overview/recent-updates.md | Consolidated recent changes based on modification metadata |\n| overview/source-summary.md | Tracking coverage of external information sources |\n| overview/open-questions.md | Open-ended inquiries, project risks, and documented uncertainties |\n| overview/roadmap.md | Actionable timeline for documentation cleanup and synthesis tasks |\n\n### Tracking Files\n- .kb/maintenance/kb_maintenance_status.json: Captures the execution status, timestamp, affected pages, and failures.\n- .kb/maintenance/kb_maintenance_runs.json: Stores historical run statistics and commits.\n- catalog.json & index.md: Standard structural catalog indexes used by Openclaw Skills.
KB Maintenance Advanced Features
- No-Overwrite Safeguards: Prevents writing over raw source documentation or altering underlying user research files.\n- Status State Logging: Automatically records failures via a structured record step, allowing client dashboards to track broken executions even if process outputs are silenced.\n- Change-Detection Filtering: Compares content hashes and avoids Gitea commits if no substantial updates are detected in drafts.
SKILL.md
Loading
Related Openclaw Skills
SVG to PPT Skill
Convert SVG content, geographic maps, and Chinese character stroke orders into fully editable PowerPoint presentations.
File-Count Threshold Probe
A diagnostic utility that binary-searches multipart part-count limits to identify upload thresholds and prevent HTTP 413 errors.
e2e-delivery
A continuous delivery orchestration skill that automates PingCode work item resolution, branching, merge requests, code reviews, and reporting.
scrapfly-cli
A comprehensive command-line interface and MCP server to orchestrate Scrapfly scraping, automated rendering, screenshots, and remote CDP browser sessions.
Multi-Cloud Resource Lister
A unified CLI skill that discovers and lists resources across AWS, Azure, GCP, and Aliyun in one fast, exportable view.
goto-codedev-manager
A unified dispatch skill for coordinating multiple AI coding agents and IDEs while safely managing project structures, Git diffs, and EF Core migrations.
Featured*
