src/intelligent_analysis/SKILL.md
GNN AI-powered pipeline analysis and executive reports. Use when generating AI-driven executive summaries, performing intelligent pipeline health assessments, or creating comprehensive AI-enhanced analysis of GNN processing results.
npx skillsauth add activeinferenceinstitute/generalizednotationnotation gnn-intelligent-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Provides AI-powered analysis of the entire pipeline execution, generating executive summaries, health assessments, intelligent recommendations, and comprehensive AI-enhanced reports.
# Run intelligent analysis
python src/24_intelligent_analysis.py --target-dir input/gnn_files --output-dir output --verbose
# As part of pipeline (final step)
python src/main.py --only-steps 24 --verbose
from intelligent_analysis import (
process_intelligent_analysis, IntelligentAnalyzer,
analyze_pipeline_summary, analyze_individual_steps,
generate_executive_report, identify_bottlenecks,
generate_recommendations, calculate_pipeline_health_score,
classify_failure_severity, detect_performance_patterns,
generate_optimization_suggestions
)
# Process intelligent analysis step (used by pipeline)
process_intelligent_analysis(target_dir, output_dir, verbose=True)
# Use the IntelligentAnalyzer class
analyzer = IntelligentAnalyzer()
# Analyze pipeline summary
summary = analyze_pipeline_summary(pipeline_data)
# Generate executive report
report = generate_executive_report(analysis_results)
# Health scoring
score = calculate_pipeline_health_score(pipeline_data)
# Identify bottlenecks and generate recommendations
bottlenecks = identify_bottlenecks(step_data)
recs = generate_recommendations(analysis_results)
# Performance pattern detection
patterns = detect_performance_patterns(metrics)
suggestions = generate_optimization_suggestions(patterns)
process_intelligent_analysis — main pipeline processing functionIntelligentAnalyzer / AnalysisContext / StepAnalysis — analysis classesanalyze_pipeline_summary, analyze_individual_steps — analysis functionsgenerate_executive_report — executive summary generationcalculate_pipeline_health_score, classify_failure_severitydetect_performance_patterns, generate_optimization_suggestionsidentify_bottlenecks, generate_recommendationsThis is the final step (Step 24). It has access to all outputs from Steps 0–23 and provides the capstone analysis.
output/24_intelligent_analysis_output/This module registers tools with the GNN MCP server (see mcp.py):
process_intelligent_analysisget_analysis_capabilitiesget_intelligent_analysis_module_infodevelopment
GNN static HTML website generation from pipeline artifacts. Use when generating browsable documentation websites, creating HTML galleries of model visualizations, or publishing pipeline results as a static site.
data-ai
GNN graph and matrix visualization generation. Use when creating network graph plots, matrix heatmaps, state space diagrams, or other visual representations of GNN models.
testing
GNN advanced validation and consistency checking. Use when performing deep validation of GNN models, checking cross-model consistency, verifying structural integrity, or running validation reports.
tools
GNN shared utility functions and helper modules. Use when working with common pipeline utilities, logging helpers, file I/O wrappers, path management, or pipeline template infrastructure.