akne-maintenance

Diagnose and repair AKNE knowledge graphs with a 16-metric comprehensive health audit.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill akne-maintenance-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: akne-maintenance
Source: https://github.com/yakeworld/Synthos/tree/main/skills/private/extended/research-tools/synthos-akne-bridge/akne-maintenance
Command: npx skills add https://github.com/yakeworld/Synthos --skill akne-maintenance-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Maintaining a personal knowledge management system (AKNE) requires checking many health indicators—connectivity, orphan nodes, duplicate names, self-loops, source file coverage, vectors, edge formats, and more. Running scattered one-off checks produces inconsistent, non-cross-validatable evidence. This Skill consolidates the full operations lifecycle into a single comprehensive audit with a structured five-stage report. ## Core Features & Use Cases - 16-Metric Comprehensive Audit: Run scripts/akne-comprehensive-audit.py once to cover connectivity, isolated nodes, duplicate names, self-loops, source file coverage, vector counts, edge format, metadata quality, Wiki pollution, entity namespaces, and path prefixes. - Five-Stage Audit Report: Generate reports in the strict order of health diagnosis, content contradictions, research gaps, hypotheses, and fixes—contradictions must be resolved before hypotheses are generated. - Path Redundancy Resolution: Detect and normalize symbolic links pointing to the same inode (e.g., /home vs /media paths) to eliminate duplicate names and namespace confusion. - Use Case: Run a daily health check on your AKNE graph directory and source files; the Skill validates inputs first, executes the audit script once, and produces a traceable report with concrete metrics and recovery suggestions for any failures. ## Quick Start Run a comprehensive health audit on my AKNE knowledge graph and produce the five-stage audit report.

Frequently Asked Questions about akne-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a health check on a knowledge graph?

Run the akne-comprehensive-audit.py script once against your graph.json and source directory. It covers 16 metrics in a single pass, including connectivity, isolated nodes, duplicate names, self-loops, and source file coverage, and saves results to audit-report-latest.json.

What metrics does a knowledge graph audit check?

The audit checks node and edge type distribution, connectivity percentage, isolated nodes, duplicate names, source file coverage between disk and graph, vector record counts, self-loop edges, edge format consistency, path prefixes, metadata presence, Wiki pollution, and entity namespace correctness.

How do I fix duplicate nodes caused by symbolic links?

Identify symbolic links pointing to the same inode, such as /home and /media paths referencing one directory, then normalize them to a single path prefix. Re-run the comprehensive audit afterward to confirm duplicate name and path prefix metrics return to zero.

Why does the audit fail when the graph directory does not exist?

Input validation runs before any audit execution and checks that the graph directory and source files exist and are readable. On failure, the Skill refuses to run the script and returns an error with the failing path, the failed check, and a recovery suggestion.

What order should a knowledge base audit report follow?

The report follows five stages in strict order: health diagnosis, content contradictions, research gaps, hypotheses, and fixes. Content contradictions must be confirmed and resolved before any hypotheses are generated, preventing unsupported conclusions.