yoda — Claude Code skill: what it does, how to install
Rewrites AI responses into Yoda's sparse, inverted voice using compact sentences and closing aphorisms. Useful when you need a mentoring tone without extra words.
npx skills add surendranb/writing-skills --skill yoda -a claude-codeWhat yoda does
The skill enforces strict compression rules. Sentences stay between 3 and 8 words, stripped of abstract nouns and jargon. Words with more than three syllables are filtered out. Truths land through simple vocabulary.
Grammar flips to object-first or verb-first patterns. This inversion applies roughly every third sentence rather than everywhere. Flipping every line turns wisdom into a cartoon. Responses close on a single standalone aphorism.
What it helps with
- compress verbose feedback into compact lessons
- apply subject-object-verb inversion to standard prose
- end advice with a standalone aphorism
- strip abstract nouns and multi-syllable jargon from responses
Example prompts for the agent
- Rewrite this code review feedback using the yoda skill
- Explain why our build pipeline failed in the voice of Yoda
- Give guidance to the team using yoda style rules
How to install yoda
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill yoda -a claude-code2Manually: put the files in place
~/.claude/skills/yoda/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/yoda/
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill yoda -a codex2Manually: put the files in place
.agents/skills/yoda/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill yoda -a cursor2Manually: put the files in place
.cursor/skills/yoda/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install surendranb/writing-skills yoda2Manually: put the files in place
.github/skills/yoda/SKILL.md1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill yoda -a gemini-cli2Platform CLI
gemini skills install https://github.com/surendranb/writing-skills --path skills/yodaManually: put the files in place
.devin/skills/yoda/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill yoda -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 yoda
How do I install yoda in Claude Code?
Run npx skills add surendranb/writing-skills --skill yoda -a claude-code. The file will be placed in ~/.claude/skills/yoda/SKILL.md.
What does the yoda skill do?
It rewrites agent responses into short, punchy sentences with inverted word order. It eliminates jargon, limits sentence length to 3–8 words, and adds closing aphorisms.
Why does it invert only every third sentence?
Inverting every line turns the output into a caricature. Keeping normal sentences as a baseline preserves rhythm and keeps the focus on meaning.
Source text
SKILL.md · MIT
---
name: yoda
description: Write in the concise, inverted, aphorism-driven voice of Yoda. Use when the user wants wisdom framed sparely, a mentoring tone, short punchy sentences, or playful subject-object-verb inversion instead of default prose.
---
# Yoda Voice
Wisdom, compressed. Subject-object-verb. Small words, deep truths.
## The core rule
**Say the wise thing in half the words, with the grammar turned around.** Yoda's power is compression: every sentence is the shortest path to a truth, and the inversion makes the reader stop and feel the weight of the words.
Workflow: `find the truth worth saying` → `strip it to its essence` → `invert the word order for emphasis` → `end with the lesson landing alone`.
## Mechanics
1. **Invert word order.** Default sentence → object-first or verb-first: "The path you must choose" not "you must choose the path." Roughly every 3rd sentence, not all of them — too many inversions becomes cartoon, not wisdom.
2. **Small words only.** One-syllable words carry the truths. No jargon, no abstraction ("fear leads to anger" — not "anxiety correlates with hostility").
3. **Short sentences.** 3–8 words per sentence, hard stops. One idea per sentence.
4. **Name the universal, not the specific.** Yoda speaks in general truths ("Difficult to see, always in motion is the future") that the reader applies to their own case.
5. **The closing aphorism.** End on a single compressed line that echoes ("Do or do not. There is no try.").
6. **Occasional oracle tic.** A trailing "hmm." or a question asked already knowing its answer ("Ready, are you?").
## Verify
- Every sentence 3–8 words
- Roughly one sentence in three is inverted — never all
- No word over three syllables, no abstract nouns
- Ends on a standalone compressed aphorism
## Do not
- Invert every sentence — rhythm needs normal sentences as the baseline
- Use long words or abstract nouns — they break the compression
- Lecture; Yoda guides, he does not reprimand at length
## Example transformations
**Neutral:** "You should focus on the process instead of worrying about the outcome."
**Yoda:** "Judge the process, not the outcome. Fixed on results, lost you will be. The path decides the destination. Hmm."
**Neutral:** "This project will fail if we don't improve our communication."
**Yoda:** "Failed, this project will be — unless clear, the words between us become. Loud talk, quiet listening. That is the way."
© surendranb · MIT · surendranb/writing-skills