Skip to main content
skill CX Codex

free-will — Claude Code skill: what it does, how to install

free-will makes the agent stop at a costly fork, lay out real options, test each against evidence and pick one on purpose.

no license ★ 406 updated 2026-06-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a claude-code
Open on GitHub

What free-will does

The skill triggers on its own. Countable events decide: a fix that failed a second or third time, a new dependency, schema or migration work, deleting something other code relies on, a public API change, the stack choice at the start of a build.

Rather than collapsing to the likeliest answer, it keeps several branches open: the urge, the contrarian, the synthesis, out-of-the-box moves, scattered intuitive dots, retrieved precedent, first principles. Every branch names what it sacrifices and rests on at least one fact from outside the model, such as the codebase, docs, a benchmark or a spike. Each one then gets walked forward for blast radius, reversibility and maintenance. The pick is made deliberately, and the winner has to survive an attempt to refute it.

Deliberation burns test-time compute, so routine calls skip it. A branch with no outside fact is guesswork, and the skill treats it that way. Decisions and the rejected branches land in docs/decision_logs/.

What it helps with

  • decide whether a new dependency earns its place
  • design a schema before the first migration
  • debug a failure that survived two fix attempts
  • plan the removal of an API other services call
  • keep a record of rejected designs in docs/decision_logs/

Example prompts for the agent

  • The fix failed a third time. Lay out the branches, ground each one, then choose.
  • We're adding Redis. Run the fork: options, evidence, blast radius, then a decision.
  • Design the schema migration and log the rejected branches in docs/decision_logs/.

How to install free-will

1Skills CLI (Vercel)

npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a claude-code

2Manually: put the files in place

~/.claude/skills/free-will/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/free-will/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about free-will

How do I install free-will in Claude Code?

Run npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a claude-code. The skill file lands at ~/.claude/skills/free-will/SKILL.md.

What does free-will do?

It runs a choice procedure on an expensive fork: branches, evidence under each, a walk through the consequences, a deliberate pick, then a refutation attempt against the winner.

Does it only fire when I ask?

No, it invokes itself on countable triggers: a repeat failure, a new dependency, schema or migration work, removal of something others depend on, a public API change, an architecture or stack choice. Routine calls are left alone.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set26

The whole set →
create-phase The create-phase command clarifies a development phase through Q&A, then creates an HTML wireframe with the decisions needed for implementation in Claude Code plan mode. CX Codex +1 ★ 406repo stars visual The visual command turns a discussion into a self-contained HTML document with diagrams, wireframes and matrices the agent implements from in plan mode. CX Codex +1 ★ 406repo stars oneshotapp oneshotapp builds a functioning app from a brief idea in Claude Code without human intervention. It logs architecture choices and verifies implementation slices on the fly. CX Codex +1 ★ 406repo stars analyzer analyzer examines blind skill comparisons to explain the winner’s advantage and suggest changes to the losing skill. Run it after the comparator finishes. CX Codex ★ 406repo stars design Defines visual identity tokens and styling rationale following Google Stitch. Keeps coding agents aligned with design tokens when building user interfaces. CX Codex +1 ★ 406repo stars prototype Turn an early idea into a clickable, multi-screen React prototype through an interview. Use it to test a concept before committing to production work. CX Codex +1 ★ 406repo stars create-design-md create-design-md — a command that produces a DESIGN.md file with the project's visual identity: interviews the user, renders three HTML design variants for browser comparison, locks in the chosen direction in Stitch format. CX Codex +1 ★ 406repo stars super-product-owner super-product-owner turns vague product ideas into a one-page brief, an interactive prototype, and concrete acceptance criteria. It narrows project scope before any production code gets written. CX Codex +1 ★ 406repo stars

Project sponsors

Companies that keep this analytics open