julianobarbosa/knowledge-base-health-check
skills/knowledge-base-health-check/SKILL.md
Audits a local Claude-managed knowledge base in Simon's '/Users/simon/Claude CoWork/Knowledge Base/' system. Surfaces contradictions between articles, broken backlinks, unsourced claims, stale articles, writing-rules violations, and three suggested new articles. Files a full report into the KB's 'Outputs/' folder, appends a one-line CHANGELOG entry, and (in interactive sessions) walks through which findings to action. Use this skill whenever the user says "run a health check", "audit the [name] KB", "audit my knowledge base", "check the wiki", "let's go through the health check report", or "action the latest health check". Also use when the monthly scheduled task 'knowledge-base-monthly-health-check' fires. Use this skill for any audit-style request against a folder under 'Knowledge Base/' even if the user doesn't say the word "health check" - the protocol is the same.
$ install --global
skillsauthnpx skillsauth add julianobarbosa/claude-code-skills knowledge-base-health-checkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 30, 2026, 7:40 AM102.1s1 file scanned
SKILL.md
- name:
- knowledge-base-health-check
- description:
- >-
Knowledge Base Health Check Skill
This skill is the source of truth for the monthly knowledge base health check. The librarian reads it and follows it whenever a health check is invoked, on demand or via the scheduled task. The protocol is deliberately the same for both trigger paths so the output format is stable across runs.
When to invoke
Run this skill when any of the following happens: • The user says "run a health check", "audit the [name] KB", "check the wiki", or similar. or writes "/healthcheck" • The user says "action the latest health check" or "let's go through the health check report" - in that case, jump straight to Phase 2 using the most recent health-check report in the relevant KB's Outputs/ folder. • The monthly scheduled task fires it (taskld: knowledge-base-monthly-health-check ). If the user doesn't specify which KB, askl Don't run on every KB unless explicitly asked.
The two phases
The skill runs in two phases. Phase 1 always runs. Phase 2 runs only in interactive sessions - the scheduled task stops at the end of Phase 1.
Phase 1 — Audit and file (always)
- Read the rules. Open About me/writing-rules. md and the per-KB CLAUDE.md for the KB being audited. The writing rules govern the writing-rules check; the per-KB rules govern Wiki structure and source provenance.
- Read state files. <KB>/CHANGELOG.md (last health check date and what's happened since), <KB>/Wiki/QUESTIONS.md (already-flagged gaps so they aren't double-flagged), <KB>/RAW/_INGESTED. md (registry of what's in RAW).
- Read everything in scope. Every article in <KB>/Wiki/, every file in <KB>/RAW/ (at least the frontmatter and titles — full read only when verifying a specific claim), every output in <KB>/Outputs/ filed since the last health check.
- Run the seven audits. Detailed below.
- Write the full report to <KB>/Outputs/YYYY-MM-DD_health-check.md
- Append a one-line summary to <KB>/CHANGELOG.md at the top, format as in Logging below.
- Surface the chat summary. Print a tight summary into chat — counts only, plus the top three findings worth the user's attention, and a link to the full report. Do not dump the whole report.
Phase 2 - Ask and action (interactive only)
- Ask which findings to action. Use AskUserQuestion with multi-select options drawn from the categories that actually have findings. Skip categories that came up clean.
Related Skills
julianobarbosa/ship
development
VerifiedTrustedCommunity
End-to-end branch delivery: commit (no AI attribution) → push → open a pull request → ensure a Board work item exists (create one per task, assigned to the configured user, if none) and link it → after merge, clean up branch and worktree. Auto-detects the platform from the remote — Azure Repos + Boards (azure-devops-node-api SDK; OAuth Bearer push fallback via `az`) or GitHub (Octokit; `gh` for auth). Scripts are TypeScript, run via `bun`. Use whenever asked to "ship", "ship it", "ship this branch", "open a PR", "push and open a PR", "raise a PR", "deliver this", "send this for review", or "create a PR and link the work item" — and when a direct push to main is blocked and the change needs to go through a PR instead.
78SKILL.mdUpdated May 30, 2026
julianobarbosa/your-skill-name
testing
VerifiedTrustedCommunity
Brief description of what this skill does. Include specific triggers - when should Claude use this skill? Example triggers, file types, or keywords that indicate this skill applies.
76SKILL.mdUpdated May 30, 2026
julianobarbosa/zsh-path
tools
VerifiedTrustedCommunity
Manage and troubleshoot PATH configuration in zsh. Use when adding tools to PATH (bun, nvm, Python venv, cargo, go), diagnosing "command not found" errors, validating PATH entries, or organizing shell configuration in .zshrc and .zshrc.local files.
76SKILL.mdUpdated May 30, 2026
julianobarbosa/zabbix-api
tools
VerifiedTrustedCommunity
Zabbix monitoring system automation via API and Python. Use when: (1) Managing hosts, templates, items, triggers, or host groups, (2) Automating monitoring configuration, (3) Sending data via Zabbix trapper/sender, (4) Querying historical data or events, (5) Bulk operations on Zabbix objects, (6) Maintenance window management, (7) User/permission management
76SKILL.mdUpdated May 30, 2026