ar-theory

Rank theoretical frameworks by fit and output theory_proposals.json.

Updated Mar 22, 2026

Search Tags:#frameworks #debate #theory #research-design #humanities #literature-map

Ready to run

npx skills add https://github.com/ShinyGua/AutoArtsResearch --skill ar-theory

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ar-theory
Source: https://github.com/ShinyGua/AutoArtsResearch/tree/main/.claude/skills/ar-theory
Command: npx skills add https://github.com/ShinyGua/AutoArtsResearch --skill ar-theory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Theory Agent helps researchers identify relevant theoretical frameworks for a given research question, assess their fit, and surface rival theories to inform theoretical framing.

Core Features & Use Cases

Proposes 2-4 candidate frameworks based on the literature map and scoping report.
Ranks candidates by multiple criteria (evidence fit, question alignment, methodological compatibility, and novelty).
Outputs a ready-to-run theory_proposals.json with proposals, a debate_proposal if needed, and clear justification for selection.

Quick Start

Provide your workspace with a literature_map and scoping report, then run the ar-theory skill to generate theory proposals.

Frequently Asked Questions about ar-theory

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

FAQPage Schema

How do I identify relevant theoretical frameworks for my research question?▼

To identify relevant theoretical frameworks, you can use an agent that analyzes your literature map and scoping report to propose 2-4 candidate frameworks ranked by evidence fit, question alignment, methodological compatibility, and novelty.

What is the best way to rank candidate theoretical frameworks for a humanities research design?▼

Ranking candidate theoretical frameworks involves assessing them across multiple criteria including evidence fit, question alignment, methodological compatibility, and novelty to produce a structured JSON file with ranked proposals.

How do I generate theory proposals from a literature map?▼

Generating theory proposals from a literature map requires loading the map and scoping data into a workspace, then running an automated agent to extract and rank 2-4 candidate theoretical frameworks.

Can I surface rival theories to inform my theoretical framing?▼

Yes, surfacing rival theories to inform theoretical framing is possible by analyzing scoping data, which outputs a debate_proposal flag in the generated JSON file when rival theories need to be considered.

Does proposing theoretical frameworks require a scoping report?▼

Yes, proposing theoretical frameworks requires a scoping report and a literature map in the workspace to accurately assess framework fit and generate a structured justification for selection.