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
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/free-will/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/free-will/
1Skills CLI (Vercel)
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a codex2Manually: put the files in place
.agents/skills/free-will/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a cursor2Manually: put the files in place
.cursor/skills/free-will/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install syahiidkamil/Software-Engineer-AI-Agent-Atlas .claude/skills/free-will2Manually: put the files in place
.github/skills/free-will/SKILL.md1Skills CLI (Vercel)
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a gemini-cli2Platform CLI
gemini skills install https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas --path .claude/skills/free-willManually: put the files in place
.devin/skills/free-will/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 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.