gioia-methodology

Validate Gioia three-level data structures and export them to Markdown, TSV, or LaTeX.

14|1|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/linxule/interpretive-orchestration --skill gioia-methodology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gioia-methodology
Source: https://github.com/linxule/interpretive-orchestration/tree/main/skills/gioia-methodology
Command: npx skills add https://github.com/linxule/interpretive-orchestration --skill gioia-methodology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the complex process of building and validating a three-level data hierarchy (1st-order concepts, 2nd-order themes, aggregate dimensions) according to the rigorous Gioia methodology. It ensures methodological consistency and prepares your framework for publication.

Core Features & Use Cases

  • Structure Validation: Automatically checks your Gioia data structure JSON for required fields, hierarchy, and ID conventions.
  • Hierarchy Quality Analysis: Analyzes concept and theme distribution, quote coverage, and abstraction levels, providing recommendations for refinement.
  • Publication Export: Exports your data structure into publication-ready formats like Markdown, TSV tables, or LaTeX.
  • Use Case: After initial coding, use this skill to validate your emerging Gioia framework, ensuring your 1st-order concepts are grounded in participant language and your 2nd-order themes are coherent.

Quick Start

Use the gioia-methodology skill to validate your data structure. Provide the path to your data-structure.json file: node skills/gioia-methodology/scripts/validate-structure.js --structure-path /path/to/data-structure.json

Frequently Asked Questions about gioia-methodology

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

FAQPage Schema
How do I validate a Gioia data structure for qualitative research?

Gioia methodology validation checks your three-level hierarchy (1st-order concepts, 2nd-order themes, aggregate dimensions) for required fields, ID format compliance, and quote coverage. Run `validate-structure.js` on your JSON file to ensure methodological consistency and identify gaps before publication.

What is the Gioia method and why use it for thematic analysis?

The Gioia method is a grounded theory approach that structures qualitative research into three abstraction levels: first-order concepts grounded in participant language, second-order themes that group related concepts, and aggregate dimensions representing core patterns. It ensures rigor and transparency in thematic analysis.

Can I export my Gioia framework to publication-ready formats?

Yes. The Skill exports validated Gioia structures to Markdown, TSV tables, and LaTeX formats via `export-structure.js`, making it straightforward to prepare figures and tables for research papers and journals without manual reformatting.

How do I check if my 1st-order concepts and themes are properly distributed?

Use the hierarchy quality analysis feature to examine concept and theme distribution across your aggregate dimensions. It flags uneven coverage, orphaned concepts, and missing quote citations, helping you refine abstraction levels and ensure every concept is grounded in data.

Do I need JSON-based data to use this Skill?

Yes. Your Gioia data structure must be formatted as JSON with properly structured hierarchy and ID conventions. The Skill validates this format and enforces compliance with Gioia methodology standards before proceeding with analysis or export.

What should I prepare before validating my data structure?

Organize your coded qualitative data into a JSON file with three levels: first-order concepts (labeled with participant quotes), second-order themes (grouping related concepts), and aggregate dimensions (highest abstraction). Include consistent ID fields and quote citations for coverage validation.