Skill: Create Theory Document

dialogue-create-theory

Create Theory (THY) documents that capture integrated understanding. Triggers on "capture theory", "document understanding", "write theory", "explain why this works", "record the mental model".

majiayu000/claude-skill-registry·0installs663starsProductivity & Planning

SKILL.md

Full skill instructions

Skill: Create Theory Document

Create THY (Theory) documents that capture integrated understanding—the "why" that enables coherent system modification.

When to Use

Activate this skill when:

User wants to capture understanding about why something works the way it does
Documenting the mental model that enables modification
Recording integrated understanding (not just individual decisions)
Creating a scaffold for future theory rebuilding

Trigger phrases: "capture theory", "document understanding", "write theory", "explain why this works", "record the mental model", "capture the why"

Implementation

Read and follow the /create-theory command at ${CLAUDE_PLUGIN_ROOT}/commands/create-theory.md for:

Document type explanation and characteristics
Step-by-step workflow
Full document template with frontmatter and body
Logging integration

The command contains the authoritative implementation details.

Elicitation Guidance

When helping users complete theory document sections, use these prompts:

For Problem Mapping: "What problem were you trying to solve? What constraints shaped your thinking?"

For Design Rationale: "Why this structure and not alternatives? What's the integrated picture?"

For Modification Patterns: "If someone needed to extend this, what should they understand first?"

For Invalidation Conditions: "What assumptions would have to change for this approach to be wrong?"

Relationship to Command

Invocation	Trigger
`/create-theory`	User explicitly requests
This skill	Claude recognises context (trigger phrases above)

Both use the same implementation. The skill adds autonomous activation based on conversation context.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/majiayu000/claude-skill-registry --skill dialogue-create-theory

View on GitHub

skills/data/dialogue-create-theory/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View