afk — Claude Code skill: what it does, how to install
Handles programming tasks independently up to a commit or merged PR, pausing only if scope creeps or tests fail repeatedly.
npx skills add timschoch/skilly --skill afk -a claude-codeWhat afk does
The skill handles tasks while you step away from the terminal. At launch via /afk, it asks for the target outcome: local committed changes, an opened pull request, or a merged PR. A background researcher inspects relevant files, glossary notes, and architectural records to produce a brief listing touched areas. Execution begins strictly after user approval.
Once running, the agent asks zero mid-flight questions. It halts immediately if changes exceed the agreed file boundary, add dependencies, alter database schemas, or if the same check fails three times consecutively. Any unexpected blocker leaves code uncommitted.
When stopped, it produces a status summary under a designated section so you can resume control. Reaching a merged PR state relies on .agents/skills/babysit-pr/SKILL.md with the --merge option.
What it helps with
- hand off an isolated coding task before stepping away from the computer
- deliver changes directly to a clean pull request with passing CI runs
- freeze project scope upfront to prevent uncontrolled file edits
- stop agent execution when checks fail across three sequential attempts
Example prompts for the agent
- /afk Remove deprecated session authentication middleware
- /afk Migrate database query logging to structured format
- /afk <task|issue-url>
How to install afk
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill afk -a claude-code2Manually: put the files in place
~/.claude/skills/afk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/afk/
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill afk -a codex2Manually: put the files in place
.agents/skills/afk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill afk -a cursor2Manually: put the files in place
.cursor/skills/afk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install timschoch/skilly afk2Manually: put the files in place
.github/skills/afk/SKILL.md1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill afk -a gemini-cli2Platform CLI
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/afkManually: put the files in place
.devin/skills/afk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add timschoch/skilly --skill afk -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 afk
How do I install afk in Claude Code?
Run npx skills add timschoch/skilly --skill afk -a claude-code in your terminal. Alternatively, place the skill definition at ~/.claude/skills/afk/SKILL.md.
What causes afk to pause or abort?
It stops when confidence drops, unauthorized files get touched, dependencies or schemas change, or a test fails three times consecutively.
Which completion targets does the skill support?
You select one of three goals at launch: local committed changes, an open PR waiting on CI checks, or an automatically merged PR.