gnn-parsing

Parse GNN Markdown files and serialize structured model data to JSON, YAML, and XML.

30|3|Updated Apr 2, 2023
One-click install
npx skills add https://github.com/ActiveInferenceInstitute/GeneralizedNotationNotation --skill gnn-parsing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gnn-parsing
Source: https://github.com/ActiveInferenceInstitute/GeneralizedNotationNotation/tree/main/src/gnn
Command: npx skills add https://github.com/ActiveInferenceInstitute/GeneralizedNotationNotation --skill gnn-parsing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates discovery and parsing of Generalized Notation Notation (GNN) model files, extracting state-space blocks, connections, parameterizations, and ontology annotations, then enabling multi-format serialization for downstream tooling.

Core Features & Use Cases

  • Discovers GNN Markdown files and extracts structured model data such as variables, connections, and parameterizations.
  • Validates GNN syntax and consistency across formats, supporting JSON, YAML, XML, and other representations.
  • Use Case: Convert a repository of GNN models to JSON for type checking, or to YAML for documentation, ensuring consistent semantics.

Quick Start

Parse GNN Markdown files in a directory to generate a structured representation and validation results.

Frequently Asked Questions about gnn-parsing

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

FAQPage Schema
How do I parse GNN Markdown files to extract StateSpaceBlock definitions and connections?

To parse GNN Markdown files, this Skill discovers your repository files and extracts structured model data, including StateSpaceBlock definitions, variables, parameters, and Connections. It then serializes this extracted data into multiple formats like JSON, YAML, and XML for downstream tooling.

Can I validate GNN syntax and convert models to JSON and YAML simultaneously?

Yes, you can validate GNN syntax and convert models simultaneously. The parsing workflow integrates lightweight discovery, validation, and cross-format serialization, ensuring consistent semantics across JSON, YAML, XML, and other representations during extraction.

What is the best way to automate extraction of ontology annotations from Generalized Notation Notation files?

The best way to extract ontology annotations from Generalized Notation Notation files is applying an automated parsing workflow. This Skill identifies GNN Markdown specifications, parses variables and ontology annotations, and serializes them into structured multi-format outputs.

Does this GNN parsing workflow require external dependencies to serialize XML and YAML outputs?

No external dependencies are required to serialize XML and YAML outputs. The Skill operates independently with an empty dependency list, running lightweight discovery, validation, and cross-format serialization directly within the internal GNN parsing workflow.

How do I convert a repository of GNN models to YAML for documentation and type checking?

You can convert a GNN model repository to YAML by running the Skill's parsing workflow on your directory. It discovers Markdown GNN specifications, extracts state-space blocks and parameterizations, and serializes the structured representation into YAML or JSON for type checking and documentation.

What are the limitations of cross-format serialization for active-inference GNN specifications?

Cross-format serialization for active-inference GNN specifications is limited to extracting variables, parameters, and ontology annotations defined in Markdown files. It applies lightweight validation to ensure consistent semantics across JSON, YAML, and XML representations.