architecture-health

Diagnose cognitive architecture health by analyzing synapse integrity, connection density, memory balance, and drift.

1|1|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/fabioc-aloha/AIRS_Data_Analysis --skill architecture-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-health
Source: https://github.com/fabioc-aloha/AIRS_Data_Analysis/tree/main/.github/skills/architecture-health
Command: npx skills add https://github.com/fabioc-aloha/AIRS_Data_Analysis --skill architecture-health

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill diagnoses the health of a cognitive architecture by assessing key metrics like synapse integrity, connection density, and memory balance, identifying potential issues before they impact performance.

Core Features & Use Cases

  • Synapse Integrity Check: Verifies that all connections point to existing files, flagging broken links due to renames or restructuring.
  • Connection Density Analysis: Identifies "orphan" skills (no connections) or "hub" skills (too many connections) that may indicate integration problems or bottlenecks.
  • Memory Balance Assessment: Evaluates the ratio of declarative, procedural, and episodic memory files to ensure a balanced knowledge base.
  • Drift Detection: Catches inconsistencies in versioning, terminology, or inheritance across different skill components.

Quick Start

Run an architecture health check to diagnose synapse integrity and connection density.

Frequently Asked Questions about architecture-health

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

FAQPage Schema
How do I check cognitive architecture health for broken links and connection bottlenecks?

To check cognitive architecture health, run a diagnostic that validates synapse integrity by flagging broken links from renames, and analyzes connection density to identify orphan or hub skills causing network bottlenecks.

What is synapse integrity and why does it matter for architecture drift detection?

Synapse integrity verifies that all connections point to existing files within the cognitive architecture. It matters for drift detection because broken links from restructuring cause inconsistencies in versioning, terminology, and inheritance across skill components.

How do I assess memory balance in a knowledge base?

Assess memory balance by evaluating the ratio of declarative, procedural, and episodic memory files in the knowledge base. This ensures a balanced distribution and identifies potential issues before they impact cognitive architecture performance.

Can I validate schema compliance and inheritance consistency against catalog labels?

Yes, you can validate schema compliance and inheritance consistency against catalog labels. The architecture health check evaluates these constraints to catch terminology and versioning drift across different skill components.

What's the best way to identify orphan or hub skills causing integration problems?

The best way to identify orphan or hub skills is through connection density analysis. This evaluates the cognitive architecture to find skills with no connections or too many connections, flagging potential integration bottlenecks.

Does this architecture health check require any external dependencies?

No, this architecture health check requires no external dependencies. It operates using internal scripts and references to diagnose synapse integrity, connection density, memory balance, and drift without needing additional setup.