ar-theory

Rank theoretical frameworks by fit and output theory_proposals.json.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ShinyGua/AutoArtsResearch --skill ar-theory
Or copy as Structured Prompt for Agent
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.