skills.rest
SteveGJones
SteveGJonesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

kb-stats

Analyze shelf-index and log.md to generate a markdown health metrics report.

41|6|Updated Jul 12, 2025
Search Tags:#metrics#statistics#inventory#report#knowledge-base
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-stats
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kb-stats
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-knowledge-base/skills/kb-stats
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Lack of visibility into knowledge-base health metrics and aging content.

Core Features & Use Cases

  • Reads shelf-index and log.md to assemble inventory, layer distribution, domain distribution, recent activity, and staleness.
  • Outputs a single markdown report suitable for quick health checks.
  • Read-only; does not dispatch agents.

Quick Start

Execute kb-stats with --library-path <library_path> --shelf-index-path <shelf_index_path> --log-path <log_path> to generate the health report.

Frequently Asked Questions about kb-stats

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

FAQPage Schema
How do I generate a knowledge-base health metrics report for inventory and staleness?▼

Generate a knowledge-base health metrics report by reading shelf-index and log.md files to assemble inventory counts, layer distribution, domain distribution, recent activity, and content staleness into a single markdown report.

What is the best way to check knowledge-base content distribution across layers and domains?▼

Checking knowledge-base content distribution is done by analyzing shelf-index metadata to aggregate and report layer distribution and domain distribution without dispatching any agents.

Can I analyze knowledge-base aging content without dispatching agents?▼

Analyze knowledge-base aging content without dispatching agents by running a read-only script that parses shelf-index and log.md paths to calculate staleness and recent activity metrics.

Does this knowledge-base statistics tool require specific file paths to run?▼

Running this knowledge-base statistics tool requires specifying file paths via --library-path, --shelf-index-path, and --log-path arguments to locate the necessary metadata files.

What format does the knowledge-base health check output use?▼

The knowledge-base health check outputs a single markdown report file, providing a consolidated view of inventory, distribution, and staleness metrics suitable for quick reviews.

Are there limitations to using a read-only knowledge-base analysis approach?▼

A read-only knowledge-base analysis approach is limited to generating reports and cannot modify, update, or dispatch agents to fix identified staleness or distribution issues.

Related Skills

Explore More Data & Analytics Skills→
SteveGJonesSteveGJones
41

kb-staleness-check

Compare knowledge base shelf-index hashes against library files to detect drift.

Community
Intermediate
Habitat-ThinkingHabitat-Thinking
44

governance-observability

Generate governance health dashboards and JSON audit snapshots for repositories.

Official
Intermediate
SteveGJonesSteveGJones
41

kb-rebuild-indexes

Rebuild knowledge base shelf-indexes by detecting modified library files with content hashes.

Community
Intermediate
MLMarioMLMario
8

kb-ingest

Orchestrate a multi-agent pipeline to ingest raw knowledge base materials into structured wiki pages.

Community
Advanced