Skip to content

28 eval-informed mental models and critical-thinking skills for Claude Code, GitHub Copilot, Codex, Cursor, and other Agent Skills-compatible tools

Convert to Claude Code plugin marketplace

Travis Boudreauxa31e22d4445a
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..3e04165
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,28 @@
+{
+ "name": "thinking-skills-marketplace",
+ "owner": {
+ "name": "TJ Boudreaux",
+ "email": "[email protected]"
+ },
+ "metadata": {
+ "description": "Mental Models and Thinking Frameworks for Claude Code - 39 battle-tested frameworks for better decision-making",
+ "version": "1.0.0"
+ },
+ "plugins": [
+ {
+ "name": "thinking-skills",
+ "source": "./",
+ "description": "39 Mental Models and Frameworks for Critical Thinking including first-principles, Bayesian reasoning, systems thinking, TRIZ, OODA, pre-mortem analysis, and more",
+ "version": "1.0.0",
+ "category": "productivity",
+ "tags": [
+ "thinking",
+ "mental-models",
+ "decision-making",
+ "systems-thinking",
+ "problem-solving",
+ "cognitive-frameworks"
+ ]
+ }
+ ]
+}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 0000000..1c0bc47
--- /dev/null
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,23 @@
+{
+ "name": "thinking-skills",
+ "description": "39 Mental Models and Frameworks for Critical Thinking in Claude Code",
+ "version": "1.0.0",
+ "author": {
+ "name": "TJ Boudreaux",
+ "url": "https://github.com/tjboudreaux"
+ },
+ "homepage": "https://github.com/tjboudreaux/cc-thinking-skills",
+ "repository": "https://github.com/tjboudreaux/cc-thinking-skills",
+ "license": "MIT",
+ "keywords": [
+ "mental-models",
+ "thinking",
+ "decision-making",
+ "systems-thinking",
+ "first-principles",
+ "bayesian-reasoning",
+ "cognitive-bias",
+ "strategic-thinking",
+ "problem-solving"
+ ]
+}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2426432..19032af 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -23,8 +23,8 @@ Avoid:
#### 2. Create the Skill Structure
```bash
-mkdir .claude/skills/thinking-{your-skill-name}
-touch .claude/skills/thinking-{your-skill-name}/SKILL.md
+mkdir skills/thinking-{your-skill-name}
+touch skills/thinking-{your-skill-name}/SKILL.md
```
#### 3. Write the SKILL.md File
diff --git a/README.md b/README.md
index 3bab68f..c27ffbc 100644
--- a/README.md
+++ b/README.md
@@ -18,19 +18,39 @@ A comprehensive collection of thinking skills for [Claude Code](https://claude.a
## Quick Start
-### Installation
+### Installation via Plugin Marketplace (Recommended)
-Clone this repository and copy the skills to your Claude Code configuration:
+Install directly in Claude Code using the plugin system:
+
+```bash
+# Add the marketplace
+/plugin marketplace add tjboudreaux/cc-thinking-skills
+
+# Install the plugin
+/plugin install thinking-skills@thinking-skills-marketplace
+```
+
+### Alternative: Manual Installation
+
+Clone and copy skills directly:
```bash
# Clone the repository
git clone https://github.com/tjboudreaux/cc-thinking-skills.git
# Copy skills to your global Claude Code config
-cp -r cc-thinking-skills/.claude/skills/* ~/.claude/skills/
+cp -r cc-thinking-skills/skills/* ~/.claude/skills/
# Or copy to a specific project
-cp -r cc-thinking-skills/.claude/skills/* /path/to/your/project/.claude/skills/
+cp -r cc-thinking-skills/skills/* /path/to/your/project/.claude/skills/
+```
+
+### Development: Load as Local Plugin
+
+For testing or development:
+
+```bash
+claude --plugin-dir ./cc-thinking-skills
```
### Usage
@@ -225,7 +245,7 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
### Adding New Skills
-1. Create a new directory under `.claude/skills/` with the format `thinking-{name}`
+1. Create a new directory under `skills/` with the format `thinking-{name}`
2. Add a `SKILL.md` file with YAML frontmatter:
```yaml
---
diff --git a/scripts/enhance-skill.js b/scripts/enhance-skill.js
index f1aa7c8..fed94bd 100644
--- a/scripts/enhance-skill.js
+++ b/scripts/enhance-skill.js
@@ -12,7 +12,7 @@
const fs = require('fs');
const path = require('path');
-const SKILLS_DIR = path.join(__dirname, '..', '.claude', 'skills');
+const SKILLS_DIR = path.join(__dirname, '..', 'skills');
// Enhancement patterns with templates
const ENHANCEMENTS = {
diff --git a/scripts/generate-improvement-prompt.js b/scripts/generate-improvement-prompt.js
index 2635d49..4d63421 100644
--- a/scripts/generate-improvement-prompt.js
+++ b/scripts/generate-improvement-prompt.js
@@ -12,7 +12,7 @@
const fs = require('fs');
const path = require('path');
-const SKILLS_DIR = path.join(__dirname, '..', '.claude', 'skills');
+const SKILLS_DIR = path.join(__dirname, '..', 'skills');
// Quality criteria for the prompt
const QUALITY_CRITERIA = `
diff --git a/scripts/validate-skills.js b/scripts/validate-skills.js
index da65ea7..e0bc4f8 100644
--- a/scripts/validate-skills.js
+++ b/scripts/validate-skills.js
@@ -10,7 +10,7 @@
const fs = require('fs');
const path = require('path');
-const SKILLS_DIR = path.join(__dirname, '..', '.claude', 'skills');
+const SKILLS_DIR = path.join(__dirname, '..', 'skills');
// Required sections and their markers
const REQUIRED_SECTIONS = [
diff --git a/.claude/skills/thinking-archetypes/SKILL.md b/skills/thinking-archetypes/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-archetypes/SKILL.md
rename to skills/thinking-archetypes/SKILL.md
diff --git a/.claude/skills/thinking-bayesian/SKILL.md b/skills/thinking-bayesian/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-bayesian/SKILL.md
rename to skills/thinking-bayesian/SKILL.md
diff --git a/.claude/skills/thinking-bounded-rationality/SKILL.md b/skills/thinking-bounded-rationality/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-bounded-rationality/SKILL.md
rename to skills/thinking-bounded-rationality/SKILL.md
diff --git a/.claude/skills/thinking-circle-of-competence/SKILL.md b/skills/thinking-circle-of-competence/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-circle-of-competence/SKILL.md
rename to skills/thinking-circle-of-competence/SKILL.md
diff --git a/.claude/skills/thinking-cynefin/SKILL.md b/skills/thinking-cynefin/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-cynefin/SKILL.md
rename to skills/thinking-cynefin/SKILL.md
diff --git a/.claude/skills/thinking-debiasing/SKILL.md b/skills/thinking-debiasing/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-debiasing/SKILL.md
rename to skills/thinking-debiasing/SKILL.md
diff --git a/.claude/skills/thinking-dual-process/SKILL.md b/skills/thinking-dual-process/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-dual-process/SKILL.md
rename to skills/thinking-dual-process/SKILL.md
diff --git a/.claude/skills/thinking-effectuation/SKILL.md b/skills/thinking-effectuation/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-effectuation/SKILL.md
rename to skills/thinking-effectuation/SKILL.md
diff --git a/.claude/skills/thinking-feedback-loops/SKILL.md b/skills/thinking-feedback-loops/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-feedback-loops/SKILL.md
rename to skills/thinking-feedback-loops/SKILL.md
diff --git a/.claude/skills/thinking-fermi-estimation/SKILL.md b/skills/thinking-fermi-estimation/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-fermi-estimation/SKILL.md
rename to skills/thinking-fermi-estimation/SKILL.md
diff --git a/.claude/skills/thinking-first-principles/SKILL.md b/skills/thinking-first-principles/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-first-principles/SKILL.md
rename to skills/thinking-first-principles/SKILL.md
diff --git a/.claude/skills/thinking-five-whys-plus/SKILL.md b/skills/thinking-five-whys-plus/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-five-whys-plus/SKILL.md
rename to skills/thinking-five-whys-plus/SKILL.md
diff --git a/.claude/skills/thinking-inversion/SKILL.md b/skills/thinking-inversion/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-inversion/SKILL.md
rename to skills/thinking-inversion/SKILL.md
diff --git a/.claude/skills/thinking-jobs-to-be-done/SKILL.md b/skills/thinking-jobs-to-be-done/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-jobs-to-be-done/SKILL.md
rename to skills/thinking-jobs-to-be-done/SKILL.md
diff --git a/.claude/skills/thinking-kepner-tregoe/SKILL.md b/skills/thinking-kepner-tregoe/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-kepner-tregoe/SKILL.md
rename to skills/thinking-kepner-tregoe/SKILL.md
diff --git a/.claude/skills/thinking-leverage-points/SKILL.md b/skills/thinking-leverage-points/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-leverage-points/SKILL.md
rename to skills/thinking-leverage-points/SKILL.md
diff --git a/.claude/skills/thinking-lindy-effect/SKILL.md b/skills/thinking-lindy-effect/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-lindy-effect/SKILL.md
rename to skills/thinking-lindy-effect/SKILL.md
diff --git a/.claude/skills/thinking-map-territory/SKILL.md b/skills/thinking-map-territory/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-map-territory/SKILL.md
rename to skills/thinking-map-territory/SKILL.md
diff --git a/.claude/skills/thinking-margin-of-safety/SKILL.md b/skills/thinking-margin-of-safety/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-margin-of-safety/SKILL.md
rename to skills/thinking-margin-of-safety/SKILL.md
diff --git a/.claude/skills/thinking-model-combination/SKILL.md b/skills/thinking-model-combination/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-model-combination/SKILL.md
rename to skills/thinking-model-combination/SKILL.md
diff --git a/.claude/skills/thinking-model-router/SKILL.md b/skills/thinking-model-router/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-model-router/SKILL.md
rename to skills/thinking-model-router/SKILL.md
diff --git a/.claude/skills/thinking-model-selection/SKILL.md b/skills/thinking-model-selection/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-model-selection/SKILL.md
rename to skills/thinking-model-selection/SKILL.md
diff --git a/.claude/skills/thinking-occams-razor/SKILL.md b/skills/thinking-occams-razor/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-occams-razor/SKILL.md
rename to skills/thinking-occams-razor/SKILL.md
diff --git a/.claude/skills/thinking-ooda/SKILL.md b/skills/thinking-ooda/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-ooda/SKILL.md
rename to skills/thinking-ooda/SKILL.md
diff --git a/.claude/skills/thinking-opportunity-cost/SKILL.md b/skills/thinking-opportunity-cost/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-opportunity-cost/SKILL.md
rename to skills/thinking-opportunity-cost/SKILL.md
diff --git a/.claude/skills/thinking-pre-mortem/SKILL.md b/skills/thinking-pre-mortem/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-pre-mortem/SKILL.md
rename to skills/thinking-pre-mortem/SKILL.md
diff --git a/.claude/skills/thinking-probabilistic/SKILL.md b/skills/thinking-probabilistic/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-probabilistic/SKILL.md
rename to skills/thinking-probabilistic/SKILL.md
diff --git a/.claude/skills/thinking-red-team/SKILL.md b/skills/thinking-red-team/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-red-team/SKILL.md
rename to skills/thinking-red-team/SKILL.md
diff --git a/.claude/skills/thinking-regret-minimization/SKILL.md b/skills/thinking-regret-minimization/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-regret-minimization/SKILL.md
rename to skills/thinking-regret-minimization/SKILL.md
diff --git a/.claude/skills/thinking-reversibility/SKILL.md b/skills/thinking-reversibility/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-reversibility/SKILL.md
rename to skills/thinking-reversibility/SKILL.md
diff --git a/.claude/skills/thinking-scientific-method/SKILL.md b/skills/thinking-scientific-method/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-scientific-method/SKILL.md
rename to skills/thinking-scientific-method/SKILL.md
diff --git a/.claude/skills/thinking-second-order/SKILL.md b/skills/thinking-second-order/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-second-order/SKILL.md
rename to skills/thinking-second-order/SKILL.md
diff --git a/.claude/skills/thinking-socratic/SKILL.md b/skills/thinking-socratic/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-socratic/SKILL.md
rename to skills/thinking-socratic/SKILL.md
diff --git a/.claude/skills/thinking-steel-manning/SKILL.md b/skills/thinking-steel-manning/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-steel-manning/SKILL.md
rename to skills/thinking-steel-manning/SKILL.md
diff --git a/.claude/skills/thinking-systems/SKILL.md b/skills/thinking-systems/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-systems/SKILL.md
rename to skills/thinking-systems/SKILL.md
diff --git a/.claude/skills/thinking-theory-of-constraints/SKILL.md b/skills/thinking-theory-of-constraints/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-theory-of-constraints/SKILL.md
rename to skills/thinking-theory-of-constraints/SKILL.md
diff --git a/.claude/skills/thinking-thought-experiment/SKILL.md b/skills/thinking-thought-experiment/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-thought-experiment/SKILL.md
rename to skills/thinking-thought-experiment/SKILL.md
diff --git a/.claude/skills/thinking-triz/SKILL.md b/skills/thinking-triz/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-triz/SKILL.md
rename to skills/thinking-triz/SKILL.md
diff --git a/.claude/skills/thinking-via-negativa/SKILL.md b/skills/thinking-via-negativa/SKILL.md
similarity index 100%
rename from .claude/skills/thinking-via-negativa/SKILL.md
rename to skills/thinking-via-negativa/SKILL.md