maoxuan-skill-cognitive-framework — Claude Code skill: strategy models
A skill that hands your agent a set of thinking models drawn from Mao Zedong's writings: find the principal contradiction, plan from the weaker side, gather allies.
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a claude-codeWhat maoxuan-skill-cognitive-framework does
The skill loads SKILL.md into the agent's context. Inside are seven mental models and ten decision heuristics. The models cover contradiction analysis, the practice-cognition loop, protracted war, rural encirclement, the united front, the mass line and paper tiger theory. The agent does not act as Mao; it runs your problem through his analytical frames.
Alongside SKILL.md the repository keeps research notes under references/research/: distilled core texts, strategic thinking, expression style, outside views, key decisions and a timeline. Handy when you want to see where a heuristic comes from.
It installs into Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. The install command runs through npx, so Node.js has to be available. After that you trigger the skill with phrases like 毛选 or 用毛选框架; if a trigger does not fire, ask the agent outright to work through the models from the skill.
What it helps with
- spot the one issue that unblocks the rest when everything looks urgent
- pick a strategy for the smaller side against a bigger competitor
- reframe a team conflict around a shared target
- decide when to conserve resources and when to push
- gather evidence before committing to a decision
Example prompts for the agent
- Work through our situation with the models from the skill: we're a small team and a competitor just shipped something similar
- Run contradiction analysis on this task list and tell me which item is the principal one
- Plan our market entry along protracted war lines: where do we build strength, where do we attack
How to install maoxuan-skill-cognitive-framework
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a claude-code2Manually: put the files in place
~/.claude/skills/maoxuan-skill-cognitive-framework/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/maoxuan-skill-cognitive-framework/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a codex2Manually: put the files in place
.agents/skills/maoxuan-skill-cognitive-framework/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a cursor2Manually: put the files in place
.cursor/skills/maoxuan-skill-cognitive-framework/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills maoxuan-skill-cognitive-framework2Manually: put the files in place
.github/skills/maoxuan-skill-cognitive-framework/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/maoxuan-skill-cognitive-frameworkManually: put the files in place
.devin/skills/maoxuan-skill-cognitive-framework/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about maoxuan-skill-cognitive-framework
How do I install maoxuan-skill-cognitive-framework in Claude Code?
Run npx skills add reason-machines/trending-skills --skill maoxuan-skill-cognitive-framework -a claude-code. The skill file then lands at ~/.claude/skills/maoxuan-skill-cognitive-framework/SKILL.md.
What does maoxuan-skill-cognitive-framework do?
It gives the agent seven mental models and ten heuristics for working through a problem: locating the principal contradiction, planning from a weak position, handling allies. The agent applies those frames to your question instead of quoting texts.
Which platforms does the skill support?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each platform takes its own -a flag in the install command.