twill-cloud-coding-agent — Claude Code skill: setup and usage
Controls Twill cloud coding runs through the v1 REST endpoints. It tracks jobs, inspects repositories, reads live event streams, and pulls session tars directly from your CLI.
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a claude-codeWhat twill-cloud-coding-agent does
This skill sends authenticated curl requests to https://twill.ai/api/v1. It triggers remote software engineering jobs, fetches pull request metadata, and fetches real-time logs through SSE connections. When you send a clarification to an ongoing task, the system halts the running execution and triggers a fresh attempt.
Setup requires a valid TWILL_API_KEY. Personal workspace tokens fail immediately. The API talks strictly to cloud workspace resources, which means local conversations in Twill Desktop remain completely hidden. Limits sit at 100 calls per minute and 1,000 calls per hour.
You cannot swap runtime harnesses inside an active thread. Switching an ongoing task from claude-code to codex yields a 400 status. Exporting Claude session tars also demands that the task sandbox remains online.
What it helps with
- trigger cloud coding tasks via the Twill v1 API
- stream live execution output using server-sent events
- archive Claude Code session files into a tar bundle
- pause or resume scheduled automation jobs
Example prompts for the agent
- Start a new Twill task to refactor the payment router using claude-code/sonnet
- List recent Twill tasks and display the status of open pull requests
- Export the Claude Code session tarball for task_123
How to install twill-cloud-coding-agent
1Skills CLI (Vercel)
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a claude-code2Manually: put the files in place
~/.claude/skills/twill-cloud-coding-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/twill-cloud-coding-agent/
1Skills CLI (Vercel)
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a codex2Manually: put the files in place
.agents/skills/twill-cloud-coding-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a cursor2Manually: put the files in place
.cursor/skills/twill-cloud-coding-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TwillAI/skills twill-cloud-coding-agent2Manually: put the files in place
.github/skills/twill-cloud-coding-agent/SKILL.md1Skills CLI (Vercel)
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/TwillAI/skills --path twill-cloud-coding-agentManually: put the files in place
.devin/skills/twill-cloud-coding-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TwillAI/skills --skill twill-cloud-coding-agent -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 twill-cloud-coding-agent
How do I install twill-cloud-coding-agent in Claude Code?
Run npx skills add TwillAI/skills --skill twill-cloud-coding-agent -a claude-code. The command places configuration into ~/.claude/skills/twill-cloud-coding-agent/SKILL.md.
What does twill-cloud-coding-agent do?
It lets your coding assistant interact with the Twill cloud platform. It creates programming tasks, tracks job status, and handles scheduled agent runs.
Why does the API reject personal workspace tokens?
The service accepts keys only from cloud workspaces. Chats hosted inside Twill Desktop stay invisible to external API calls.
