kun — Claude Code skill: what it does, how to install
Loads author instructions, opinions, and problem-solving styles into Claude Code and other agents via the /kun command.
npx skills add kunchenguid/kun --skill kun -a claude-codeWhat kun does
The skill adds Kun's reasoning guidelines and personal rules to your coding assistant. When invoked with /kun, the agent retrieves a public helper script called pull-kun.mjs and runs it with Node to sync the documentation without calling an LLM. Files go directly into ~/.cache/kun or the directory specified in $KUN_PULL_DIR.
Synchronization stays lightweight thanks to content/MANIFEST.json. The script syncs foundational files like ENTRY.md, TOOLS.md, OPINIONS.md, and VOICE.md, pulling only new or updated items from the content/ folder. It avoids dumping entire directories into context. You need Node available on your machine, and if the network request fails, execution halts immediately instead of guessing file contents.
What it helps with
- adopt Kun's problem-solving style during system design and reviews
- keep agent guidance files up to date using a local Node script
- reference tool guidelines documented inside TOOLS.md
- load external documentation files on demand without cluttering the prompt
Example prompts for the agent
- /kun how would you approach this system design?
- /kun review this problem using your principles
How to install kun
1Skills CLI (Vercel)
npx skills add kunchenguid/kun --skill kun -a claude-code2Manually: put the files in place
~/.claude/skills/kun/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kun/
1Skills CLI (Vercel)
npx skills add kunchenguid/kun --skill kun -a codex2Manually: put the files in place
.agents/skills/kun/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kunchenguid/kun --skill kun -a cursor2Manually: put the files in place
.cursor/skills/kun/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kunchenguid/kun kun2Manually: put the files in place
.github/skills/kun/SKILL.md1Skills CLI (Vercel)
npx skills add kunchenguid/kun --skill kun -a gemini-cli2Platform CLI
gemini skills install https://github.com/kunchenguid/kun --path skills/kunManually: put the files in place
.devin/skills/kun/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kunchenguid/kun --skill kun -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 kun
How do I install kun in Claude Code?
Run npx skills add kunchenguid/kun --skill kun -a claude-code in your terminal.
What does kun do?
It fetches author instructions from the kunchenguid/kun repository into your local cache and guides agent answers according to ENTRY.md.
What is required to run the sync script?
You must have Node installed to run pull-kun.mjs. If the script fails to download files, the agent stops instead of hallucinating instructions.
