{
  "schemaVersion": "1.0",
  "item": {
    "slug": "workspace-analyzer",
    "name": "Workspace Analyzer",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/zendenho7/workspace-analyzer",
    "canonicalUrl": "https://clawhub.ai/zendenho7/workspace-analyzer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/workspace-analyzer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=workspace-analyzer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "run.sh",
      "scripts/analyzer.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/workspace-analyzer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/workspace-analyzer",
    "agentPageUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Workspace Analyzer",
        "body": "\"Scans, analyzes, and reports. The agent decides.\""
      },
      {
        "title": "Overview",
        "body": "A self-improving agent needs a clean workspace. This skill analyzes any OpenClaw workspace to:\n\nDetect core files dynamically (adapts to workspace changes)\nAnalyze content for issues (bloat, duplicates, broken links)\nValidate single source of truth (content in multiple places)\nReport actionable insights for the agent to act upon\n\nKey Principle: The script analyzes → the agent decides → the agent acts."
      },
      {
        "title": "Installation",
        "body": "# Clone or copy to your skills folder\ncp -r workspace-analyzer/ ~/.openclaw/workspace/skills/"
      },
      {
        "title": "Run Analysis",
        "body": "# Full analysis (default)\npython3 skills/workspace-analyzer/scripts/analyzer.py\n\n# Quick scan (structure only, no content analysis)\npython3 skills/workspace-analyzer/scripts/analyzer.py --quick\n\n# Specific workspace\npython3 skills/workspace-analyzer/scripts/analyzer.py --root /path/to/workspace\n\n# Output to file\npython3 skills/workspace-analyzer/scripts/analyzer.py --output report.json"
      },
      {
        "title": "Output Format",
        "body": "{\n  \"scan_info\": {\n    \"root\": \"/home/user/.openclaw/workspace\",\n    \"timestamp\": \"2026-02-21T18:00:00Z\",\n    \"files_scanned\": 291\n  },\n  \"core_files_detected\": {\n    \"kai_core\": {\n      \"files\": [\"SOUL.md\", \"OPERATING.md\", ...],\n      \"count\": 11\n    },\n    \"mission_control\": {...},\n    \"agent_cores\": {...},\n    \"skills\": {...}\n  },\n  \"analysis\": {\n    \"SOUL.md\": {\n      \"category\": \"kai_core\",\n      \"line_count\": 450,\n      \"sections\": [...],\n      \"wiki_links\": [...],\n      \"issues\": [...]\n    }\n  },\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"PASS/FAIL\",\n      \"locations\": [\"AGENTS.md\", \"OPERATING.md\", \"SOUL.md\"],\n      \"recommendation\": \"Reference all to SUB_CONSCIOUS.md\"\n    },\n    \"memory_architecture\": {...},\n    \"image_handling\": {...}\n  },\n  \"recommendations\": [\n    {\"action\": \"FIX_DUPLICATE_CONTENT\", \"topic\": \"skill_graph\", \"files\": [\"AGENTS.md\", \"OPERATING.md\"], \"severity\": \"CRITICAL\"},\n    {\"action\": \"REVIEW_BLOAT\", \"file\": \"OPERATING.md\", \"severity\": \"WARN\"},\n    {\"action\": \"CHECK_DUPLICATE\", \"severity\": \"WARN\"},\n    {\"action\": \"CHECK_BROKEN_LINK\", \"severity\": \"INFO\"}\n  ],\n  \"summary\": {\n    \"total_files\": 291,\n    \"total_issues\": 17,\n    \"total_recommendations\": 25\n  }\n}"
      },
      {
        "title": "What It Checks",
        "body": "The analyzer validates that each topic exists in exactly ONE place:\n\nTopicExpected Single SourceSkill GraphSUB_CONSCIOUS.mdMemory ArchitectureOPERATING.md or SUB_CONSCIOUS.mdMessage ReactionsSUB_CONSCIOUS.mdImage HandlingOPERATING.mdSession BootstrapAGENTS.md"
      },
      {
        "title": "Detection Logic",
        "body": "Scan all core files for key section headings\nBuild content map of where each topic appears\nFlag violations where topic appears in 2+ places\nRecommend fix by pointing to single source"
      },
      {
        "title": "Example Output",
        "body": "{\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"FAIL\",\n      \"locations\": [\"AGENTS.md:285\", \"OPERATING.md:56\", \"SOUL.md:52\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Consolidate to SUB_CONSCIOUS.md, reference from others\"\n    },\n    \"memory_architecture\": {\n      \"status\": \"FAIL\", \n      \"locations\": [\"AGENTS.md:157\", \"OPERATING.md:74\", \"OPERATING.md:193\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Remove duplicate section at OPERATING.md:193\"\n    }\n  }\n}"
      },
      {
        "title": "Dynamic Core File Detection",
        "body": "Automatically detects core files based on location patterns:\n\nCategoryPatternExampleKAI CoreRoot *.mdSOUL.md, OPERATING.mdMission Controlmission_control/*GUIDELINES.mdMISSION_CONTROL_GUIDELINES.mdAgent Coresmission_control/agents//.mddesigner/SOUL.mdSkillsskills/*/SKILL.mdreact-expert/SKILL.mdSUB_CONSCIOUSRoot SUB_CONSCIOUS.mdSUB_CONSCIOUS.md"
      },
      {
        "title": "Category-Specific Thresholds",
        "body": "Bloat thresholds vary by category:\n\nCategoryWarningCriticalkai_core400600mission_control500800agent_cores300500skills6001000memory500800docs400600SUB_CONSCIOUS100200"
      },
      {
        "title": "Issue Detection",
        "body": "BLOAT_WARNING: File exceeds warning threshold\nBLOAT_CRITICAL: File exceeds critical threshold\nORPHAN_WARNING: File not modified in 30+ days\nDUPLICATE_CONTENT: Same topic in multiple files\nBROKEN_WIKI_LINK: Wiki-link may not match any file"
      },
      {
        "title": "Recommendations",
        "body": "The analyzer generates actionable recommendations:\n\nActionSeverityDescriptionWhat To DoFIX_DUPLICATE_CONTENTCRITICALSame content in 2+ filesConsolidate to single sourceREVIEW_BLOATWARN/CRITICALFile is too largeReview if legitimate or splitREVIEW_ORPHANINFOFile hasn't been modifiedArchive if no longer neededCHECK_DUPLICATEWARNPotential duplicate filesVerify if intentional or mergeCHECK_BROKEN_LINKINFOWiki-link may be brokenVerify if skill existsCHECK_MISSINGWARNExpected core files not foundCreate if needed"
      },
      {
        "title": "Fix Instructions for Agents",
        "body": "When duplicate content is detected, follow these steps:"
      },
      {
        "title": "Step 1: Identify the True Source",
        "body": "Determine which file should be the single source:\n\nTopicShould Be InReflex behaviorsSUB_CONSCIOUS.mdSession bootstrapAGENTS.mdProceduresOPERATING.mdIdentity principlesSOUL.mdKnowledge indexKNOWLEDGE_GRAPH.md"
      },
      {
        "title": "Step 2: Update Non-Source Files",
        "body": "Replace duplicate content with references:\n\n**Topic:** See [[SUB_CONSCIOUS.md]] for procedures."
      },
      {
        "title": "Step 3: Verify Bootstrap Injection",
        "body": "Ensure new files are injected at session start:\n\nCheck ~/.openclaw/openclaw.json:\n\n{\n  \"hooks\": {\n    \"internal\": {\n      \"entries\": {\n        \"bootstrap-extra-files\": {\n          \"enabled\": true,\n          \"paths\": [\"SUB_CONSCIOUS.md\", \"self-improving/memory.md\"]\n        }\n      }\n    }\n  }\n}"
      },
      {
        "title": "Step 4: Commit Changes",
        "body": "git add -A\ngit commit -m \"Fix duplicate content - consolidate to single source\""
      },
      {
        "title": "How to Use Results",
        "body": "Step 1: Prioritize by Severity\n\nCRITICAL → Review immediately\nWARN → Review during next maintenance\nINFO → Review during weekly cleanup\n\nStep 2: Check Single Source Validation\n\nFAIL → Fix duplicate content first (most important)\nPASS → Move to other issues\n\nStep 3: Understand Context\n\nBLOAT = Informational, not all need fixing\n\nReference docs (skills//references/.md) can be legitimately large\nResearch logs are consolidations - consider splitting by date\nSession logs - archive old ones\n\n\n\nDUPLICATES = Check if intentional\n\nIDENTITY files = Expected (agent templates)\nREVIEW files = May need consolidation\nLESSONS files = OK (different skills)\n\n\n\nBROKEN LINKS = Usually false positives\n\nLinks to skills like [[blogwatcher]] ARE valid\nSkills have SKILL.md suffix - analyzer doesn't detect this\nOnly flag if link to core file is truly broken\n\nStep 4: Take Action\n\nDon't auto-fix - review first\nArchive old session logs monthly\nSplit large research logs by topic\nKeep reference docs as-is (legitimate)\nFix duplicate content by consolidating to single source"
      },
      {
        "title": "With Heartbeat",
        "body": "Add to your HEARTBEAT.md maintenance section:\n\n## 7. Memory + Workspace Maintenance\n\n### Run Workspace Analyzer\npython3 skills/workspace-analyzer/scripts/analyzer.py --output /tmp/analysis.json\n\n### Review Single Source Validation\n- Check for DUPLICATE_CONTENT issues\n- Fix by consolidating to single source\n\n### Review Recommendations\n- Check recommendations in output\n- Prioritize by severity\n- Fix issues manually"
      },
      {
        "title": "Output to Memory",
        "body": "Save analysis results for later review:\n\npython3 skills/workspace-analyzer/scripts/analyzer.py \\\n  --output memory/$(date +%Y-%m-%d)-workspace-analysis.json"
      },
      {
        "title": "Read-Only",
        "body": "Never modifies files\nOnly reads and analyzes"
      },
      {
        "title": "No Secrets",
        "body": "Never reads API keys\nNever accesses credentials\nOnly analyzes file metadata and content structure"
      },
      {
        "title": "Safe Output",
        "body": "Only contains: file paths, sizes, line counts, recommendations\nNo sensitive data exposed"
      },
      {
        "title": "Limitations",
        "body": "No auto-fix: Script reports, agent must decide and act\nWiki-link false positives: Links to external skills may appear broken\nDate-based duplicate detection: May miss non-date-based duplicates"
      },
      {
        "title": "Sample Output - Single Source Validation",
        "body": "{\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"FAIL\",\n      \"files\": [\"AGENTS.md\", \"OPERATING.md\", \"SOUL.md\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Reference all to SUB_CONSCIOUS.md\"\n    },\n    \"memory_architecture\": {\n      \"status\": \"FAIL\",\n      \"files\": [\"AGENTS.md\", \"OPERATING.md\"],\n      \"severity\": \"CRITICAL\", \n      \"recommendation\": \"Remove duplicate in OPERATING.md\"\n    },\n    \"message_reactions\": {\n      \"status\": \"PASS\",\n      \"files\": [\"SUB_CONSCIOUS.md\"],\n      \"severity\": \"OK\"\n    }\n  }\n}"
      },
      {
        "title": "Sample Output - Recommendations",
        "body": "[\n  {\n    \"action\": \"FIX_DUPLICATE_CONTENT\",\n    \"topic\": \"skill_graph\",\n    \"files\": [\"AGENTS.md:285\", \"OPERATING.md:56\", \"SOUL.md:52\"],\n    \"severity\": \"CRITICAL\",\n    \"recommendation\": \"Replace with reference to SUB_CONSCIOUS.md\"\n  },\n  {\n    \"action\": \"REVIEW_BLOAT\",\n    \"file\": \"OPERATING.md\",\n    \"category\": \"kai_core\",\n    \"reason\": \"503 lines - consider splitting (threshold: 400)\",\n    \"severity\": \"WARN\"\n  }\n]"
      },
      {
        "title": "Skill Graph",
        "body": "This skill is related to:\n\n[[mcporter]] - For MCP server analysis\n[[clean-workspace]] - For actual cleanup tasks\n[[qmd]] - For memory organization"
      },
      {
        "title": "v1.1.0 (2026-02-24)",
        "body": "Added single source of truth validation\nAdded duplicate content detection (same topics in multiple files)\nAdded FIX_DUPLICATE_CONTENT recommendation type\nAdded SUB_CONSCIOUS category\nAdded fix instructions for agents"
      },
      {
        "title": "v1.0 (2026-02-21)",
        "body": "Initial release\nBasic file analysis\nCore file detection\nBloat detection\n\nLast updated: 2026-02-24"
      }
    ],
    "body": "Workspace Analyzer\n\n\"Scans, analyzes, and reports. The agent decides.\"\n\nOverview\n\nA self-improving agent needs a clean workspace. This skill analyzes any OpenClaw workspace to:\n\nDetect core files dynamically (adapts to workspace changes)\nAnalyze content for issues (bloat, duplicates, broken links)\nValidate single source of truth (content in multiple places)\nReport actionable insights for the agent to act upon\n\nKey Principle: The script analyzes → the agent decides → the agent acts.\n\nInstallation\n# Clone or copy to your skills folder\ncp -r workspace-analyzer/ ~/.openclaw/workspace/skills/\n\nUsage\nRun Analysis\n# Full analysis (default)\npython3 skills/workspace-analyzer/scripts/analyzer.py\n\n# Quick scan (structure only, no content analysis)\npython3 skills/workspace-analyzer/scripts/analyzer.py --quick\n\n# Specific workspace\npython3 skills/workspace-analyzer/scripts/analyzer.py --root /path/to/workspace\n\n# Output to file\npython3 skills/workspace-analyzer/scripts/analyzer.py --output report.json\n\nOutput Format\n{\n  \"scan_info\": {\n    \"root\": \"/home/user/.openclaw/workspace\",\n    \"timestamp\": \"2026-02-21T18:00:00Z\",\n    \"files_scanned\": 291\n  },\n  \"core_files_detected\": {\n    \"kai_core\": {\n      \"files\": [\"SOUL.md\", \"OPERATING.md\", ...],\n      \"count\": 11\n    },\n    \"mission_control\": {...},\n    \"agent_cores\": {...},\n    \"skills\": {...}\n  },\n  \"analysis\": {\n    \"SOUL.md\": {\n      \"category\": \"kai_core\",\n      \"line_count\": 450,\n      \"sections\": [...],\n      \"wiki_links\": [...],\n      \"issues\": [...]\n    }\n  },\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"PASS/FAIL\",\n      \"locations\": [\"AGENTS.md\", \"OPERATING.md\", \"SOUL.md\"],\n      \"recommendation\": \"Reference all to SUB_CONSCIOUS.md\"\n    },\n    \"memory_architecture\": {...},\n    \"image_handling\": {...}\n  },\n  \"recommendations\": [\n    {\"action\": \"FIX_DUPLICATE_CONTENT\", \"topic\": \"skill_graph\", \"files\": [\"AGENTS.md\", \"OPERATING.md\"], \"severity\": \"CRITICAL\"},\n    {\"action\": \"REVIEW_BLOAT\", \"file\": \"OPERATING.md\", \"severity\": \"WARN\"},\n    {\"action\": \"CHECK_DUPLICATE\", \"severity\": \"WARN\"},\n    {\"action\": \"CHECK_BROKEN_LINK\", \"severity\": \"INFO\"}\n  ],\n  \"summary\": {\n    \"total_files\": 291,\n    \"total_issues\": 17,\n    \"total_recommendations\": 25\n  }\n}\n\nSingle Source of Truth Validation\nWhat It Checks\n\nThe analyzer validates that each topic exists in exactly ONE place:\n\nTopic\tExpected Single Source\nSkill Graph\tSUB_CONSCIOUS.md\nMemory Architecture\tOPERATING.md or SUB_CONSCIOUS.md\nMessage Reactions\tSUB_CONSCIOUS.md\nImage Handling\tOPERATING.md\nSession Bootstrap\tAGENTS.md\nDetection Logic\nScan all core files for key section headings\nBuild content map of where each topic appears\nFlag violations where topic appears in 2+ places\nRecommend fix by pointing to single source\nExample Output\n{\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"FAIL\",\n      \"locations\": [\"AGENTS.md:285\", \"OPERATING.md:56\", \"SOUL.md:52\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Consolidate to SUB_CONSCIOUS.md, reference from others\"\n    },\n    \"memory_architecture\": {\n      \"status\": \"FAIL\", \n      \"locations\": [\"AGENTS.md:157\", \"OPERATING.md:74\", \"OPERATING.md:193\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Remove duplicate section at OPERATING.md:193\"\n    }\n  }\n}\n\nFeatures\nDynamic Core File Detection\n\nAutomatically detects core files based on location patterns:\n\nCategory\tPattern\tExample\nKAI Core\tRoot *.md\tSOUL.md, OPERATING.md\nMission Control\tmission_control/*GUIDELINES.md\tMISSION_CONTROL_GUIDELINES.md\nAgent Cores\tmission_control/agents//.md\tdesigner/SOUL.md\nSkills\tskills/*/SKILL.md\treact-expert/SKILL.md\nSUB_CONSCIOUS\tRoot SUB_CONSCIOUS.md\tSUB_CONSCIOUS.md\nCategory-Specific Thresholds\n\nBloat thresholds vary by category:\n\nCategory\tWarning\tCritical\nkai_core\t400\t600\nmission_control\t500\t800\nagent_cores\t300\t500\nskills\t600\t1000\nmemory\t500\t800\ndocs\t400\t600\nSUB_CONSCIOUS\t100\t200\nIssue Detection\nBLOAT_WARNING: File exceeds warning threshold\nBLOAT_CRITICAL: File exceeds critical threshold\nORPHAN_WARNING: File not modified in 30+ days\nDUPLICATE_CONTENT: Same topic in multiple files\nBROKEN_WIKI_LINK: Wiki-link may not match any file\nRecommendations\n\nThe analyzer generates actionable recommendations:\n\nAction\tSeverity\tDescription\tWhat To Do\nFIX_DUPLICATE_CONTENT\tCRITICAL\tSame content in 2+ files\tConsolidate to single source\nREVIEW_BLOAT\tWARN/CRITICAL\tFile is too large\tReview if legitimate or split\nREVIEW_ORPHAN\tINFO\tFile hasn't been modified\tArchive if no longer needed\nCHECK_DUPLICATE\tWARN\tPotential duplicate files\tVerify if intentional or merge\nCHECK_BROKEN_LINK\tINFO\tWiki-link may be broken\tVerify if skill exists\nCHECK_MISSING\tWARN\tExpected core files not found\tCreate if needed\nFix Instructions for Agents\n\nWhen duplicate content is detected, follow these steps:\n\nStep 1: Identify the True Source\n\nDetermine which file should be the single source:\n\nTopic\tShould Be In\nReflex behaviors\tSUB_CONSCIOUS.md\nSession bootstrap\tAGENTS.md\nProcedures\tOPERATING.md\nIdentity principles\tSOUL.md\nKnowledge index\tKNOWLEDGE_GRAPH.md\nStep 2: Update Non-Source Files\n\nReplace duplicate content with references:\n\n**Topic:** See [[SUB_CONSCIOUS.md]] for procedures.\n\nStep 3: Verify Bootstrap Injection\n\nEnsure new files are injected at session start:\n\nCheck ~/.openclaw/openclaw.json:\n\n{\n  \"hooks\": {\n    \"internal\": {\n      \"entries\": {\n        \"bootstrap-extra-files\": {\n          \"enabled\": true,\n          \"paths\": [\"SUB_CONSCIOUS.md\", \"self-improving/memory.md\"]\n        }\n      }\n    }\n  }\n}\n\nStep 4: Commit Changes\ngit add -A\ngit commit -m \"Fix duplicate content - consolidate to single source\"\n\nInterpretation Guide\nHow to Use Results\n\nStep 1: Prioritize by Severity\n\nCRITICAL → Review immediately\nWARN → Review during next maintenance\nINFO → Review during weekly cleanup\n\n\nStep 2: Check Single Source Validation\n\nFAIL → Fix duplicate content first (most important)\nPASS → Move to other issues\n\n\nStep 3: Understand Context\n\nBLOAT = Informational, not all need fixing\n\nReference docs (skills//references/.md) can be legitimately large\nResearch logs are consolidations - consider splitting by date\nSession logs - archive old ones\n\nDUPLICATES = Check if intentional\n\nIDENTITY files = Expected (agent templates)\nREVIEW files = May need consolidation\nLESSONS files = OK (different skills)\n\nBROKEN LINKS = Usually false positives\n\nLinks to skills like [[blogwatcher]] ARE valid\nSkills have SKILL.md suffix - analyzer doesn't detect this\nOnly flag if link to core file is truly broken\n\nStep 4: Take Action\n\nDon't auto-fix - review first\nArchive old session logs monthly\nSplit large research logs by topic\nKeep reference docs as-is (legitimate)\nFix duplicate content by consolidating to single source\nIntegration\nWith Heartbeat\n\nAdd to your HEARTBEAT.md maintenance section:\n\n## 7. Memory + Workspace Maintenance\n\n### Run Workspace Analyzer\npython3 skills/workspace-analyzer/scripts/analyzer.py --output /tmp/analysis.json\n\n### Review Single Source Validation\n- Check for DUPLICATE_CONTENT issues\n- Fix by consolidating to single source\n\n### Review Recommendations\n- Check recommendations in output\n- Prioritize by severity\n- Fix issues manually\n\nOutput to Memory\n\nSave analysis results for later review:\n\npython3 skills/workspace-analyzer/scripts/analyzer.py \\\n  --output memory/$(date +%Y-%m-%d)-workspace-analysis.json\n\nSafety & Security\nRead-Only\nNever modifies files\nOnly reads and analyzes\nNo Secrets\nNever reads API keys\nNever accesses credentials\nOnly analyzes file metadata and content structure\nSafe Output\nOnly contains: file paths, sizes, line counts, recommendations\nNo sensitive data exposed\nLimitations\nNo auto-fix: Script reports, agent must decide and act\nWiki-link false positives: Links to external skills may appear broken\nDate-based duplicate detection: May miss non-date-based duplicates\nExamples\nSample Output - Single Source Validation\n{\n  \"single_source_validation\": {\n    \"skill_graph\": {\n      \"status\": \"FAIL\",\n      \"files\": [\"AGENTS.md\", \"OPERATING.md\", \"SOUL.md\"],\n      \"severity\": \"CRITICAL\",\n      \"recommendation\": \"Reference all to SUB_CONSCIOUS.md\"\n    },\n    \"memory_architecture\": {\n      \"status\": \"FAIL\",\n      \"files\": [\"AGENTS.md\", \"OPERATING.md\"],\n      \"severity\": \"CRITICAL\", \n      \"recommendation\": \"Remove duplicate in OPERATING.md\"\n    },\n    \"message_reactions\": {\n      \"status\": \"PASS\",\n      \"files\": [\"SUB_CONSCIOUS.md\"],\n      \"severity\": \"OK\"\n    }\n  }\n}\n\nSample Output - Recommendations\n[\n  {\n    \"action\": \"FIX_DUPLICATE_CONTENT\",\n    \"topic\": \"skill_graph\",\n    \"files\": [\"AGENTS.md:285\", \"OPERATING.md:56\", \"SOUL.md:52\"],\n    \"severity\": \"CRITICAL\",\n    \"recommendation\": \"Replace with reference to SUB_CONSCIOUS.md\"\n  },\n  {\n    \"action\": \"REVIEW_BLOAT\",\n    \"file\": \"OPERATING.md\",\n    \"category\": \"kai_core\",\n    \"reason\": \"503 lines - consider splitting (threshold: 400)\",\n    \"severity\": \"WARN\"\n  }\n]\n\nSkill Graph\n\nThis skill is related to:\n\n[[mcporter]] - For MCP server analysis\n[[clean-workspace]] - For actual cleanup tasks\n[[qmd]] - For memory organization\nChangelog\nv1.1.0 (2026-02-24)\nAdded single source of truth validation\nAdded duplicate content detection (same topics in multiple files)\nAdded FIX_DUPLICATE_CONTENT recommendation type\nAdded SUB_CONSCIOUS category\nAdded fix instructions for agents\nv1.0 (2026-02-21)\nInitial release\nBasic file analysis\nCore file detection\nBloat detection\n\nLast updated: 2026-02-24"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/zendenho7/workspace-analyzer",
    "publisherUrl": "https://clawhub.ai/zendenho7/workspace-analyzer",
    "owner": "zendenho7",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/workspace-analyzer",
    "downloadUrl": "https://openagent3.xyz/downloads/workspace-analyzer",
    "agentUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/workspace-analyzer/agent.md"
  }
}