theory

Construct, audit, and update structured theoretical frameworks in project theory documentation.

1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/hsigstad/research-kit --skill theory-hsigstad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theory
Source: https://github.com/hsigstad/research-kit/tree/main/skills/theory
Command: npx skills add https://github.com/hsigstad/research-kit --skill theory-hsigstad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The theory skill streamlines the process of drafting, updating, and auditing project theory documentation, ensuring structured and comprehensive theory inventories.

Core Features & Use Cases

  • Project Theory Inventory: Populate or expand a project's docs/theory.md with structured theoretical frameworks.
  • Audit and Extend: Perform audits to check coverage, report on missing sections, and extend existing theories.
  • Surgical Updates: Update specific framework entries based on new analysis or literature.
  • Template Selection: Choose from templates like numbered frameworks, mechanism-centric, or minimal inventory based on project stage.

Quick Start

To populate the theory document for your current project, run: /theory

Frequently Asked Questions about theory

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

FAQPage Schema
How do I structure theoretical frameworks for my research project documentation?

The Skill generates and audits structured theoretical frameworks by populating a project's docs/theory.md file. It supports multiple templates including numbered, mechanism-centric, and minimal inventory formats to match your project stage.

What is the best way to integrate empirical research design with project theory?

This Skill facilitates the integration of theory with empirical design by auditing framework coverage, extending existing theories, and supporting hypothesis generation. It operates within your project directory structure to align documentation with empirical data files.

Can I update specific theoretical framework entries without rewriting the entire literature review?

Yes, the Skill performs surgical updates to specific theoretical framework entries based on new analysis or literature. This allows you to refine individual sections of the structured documentation without regenerating the entire project theory inventory.

Does the theory documentation tool require a specific project directory structure?

Yes, this Skill operates within a specific project directory structure and requires access to supporting documentation and data files. It specifically targets the docs/theory.md file to maintain and audit the structured theoretical frameworks.

How do I audit a project theory inventory for missing sections?

The Skill audits theoretical framework coverage, reports on missing sections, and extends existing theories to ensure comprehensive structured documentation. It checks the project theory inventory within the docs/theory.md file.