reasoning

SKILL.md

Reasoning Skill

Structured reasoning frameworks with mandatory documentation lookup for systematic problem solving.

Overview

This skill wraps two complementary capabilities:

  1. Complex Reasoning (complex-reasoning.md) — Multiple reasoning frameworks (Chain-of-Thought, Tree-of-Thought, Hypothesis-Driven Debugging, Root Cause Analysis) that always query documentation before reasoning and store insights in memory.

  2. Documentation Lookup (documentation-lookup.md) — Systematic documentation retrieval using Context7 MCP to ground all decisions in accurate, version-specific library documentation.

When to Use

  • Debugging complex issues where root cause is unclear → use Hypothesis-Driven Debugging
  • Making architectural decisions with multiple valid approaches → use Tree-of-Thought
  • Linear problem-solving with sequential steps → use Chain-of-Thought
  • Systemic incidents or repeated failures → use Root Cause Analysis
  • Any task involving external libraries or APIs → use Documentation Lookup first

Framework Selection

Problem Type Framework Agent
Linear, sequential Chain-of-Thought hypothesis-debugger
Multiple valid approaches Tree-of-Thought requirements-analyzer
Complex bug, unclear root cause Hypothesis-Driven Debugging hypothesis-debugger
Incident, systemic issue Root Cause Analysis root-cause-analyzer
Any technology decision Documentation Lookup requirements-analyzer

Core Protocol

MANDATORY before any reasoning about technology:

  1. Identify technologies involved in the task
  2. Resolve library IDs via Context7 MCP
  3. Query relevant documentation
  4. Ground all reasoning steps in retrieved documentation

See complex-reasoning.md for full reasoning framework details. See documentation-lookup.md for documentation retrieval protocol.

Integration

Works with: hypothesis-debugger (debugging workflows), root-cause-analyzer (incident analysis), requirements-analyzer (architecture decisions), task-enricher (technical planning).

Weekly Installs
4
GitHub Stars
6
First Seen
Feb 27, 2026
Installed on
opencode4
gemini-cli4
codebuddy4
github-copilot4
codex4
kimi-cli4