apify-integration-development — Claude Code skill: how to install
Guides the design of Apify integrations for workflow automation, AI agent harnesses, and SDK clients with proper polling and budget limits.
npx skills add apify/agent-skills --skill apify-integration-development -a claude-codeWhat apify-integration-development does
This skill guides developers through creating official Apify integrations across workflow platforms like n8n or Zapier, AI framework packages, and custom agent harnesses. It aligns the agent on core Apify concepts: Actors, runs, datasets, and key-value stores, starting from the official model at https://apify.com/agents.md.
It enforces standard integration patterns: asynchronous execution via POST /v2/actors/{actorId}/runs, bounded polling with strict timeouts, and attribution headers like x-apify-integration-platform. If the Apify MCP server is available, the agent uses search-actors and fetch-actor-details to inspect live schemas without needing token credentials.
Passing cost limits such as maxTotalChargeUsd or maxItems inside the Actor input payload breaks execution: they must always be supplied as query parameters or execution options.
What it helps with
- design an official Apify integration for automation tools or AI agents
- implement asynchronous Actor runs with bounded polling loops
- configure cost controls using
maxTotalChargeUsdandmaxItems - attach required attribution headers to outgoing platform requests
Example prompts for the agent
- Design an n8n integration that triggers an Apify Actor and reads its dataset
- Review my Apify client code for bounded polling and attribution headers
- Create a LangChain tool package that runs Actors with spending limits
How to install apify-integration-development
1Skills CLI (Vercel)
npx skills add apify/agent-skills --skill apify-integration-development -a claude-code2Manually: put the files in place
~/.claude/skills/apify-integration-development/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apify-integration-development/
1Skills CLI (Vercel)
npx skills add apify/agent-skills --skill apify-integration-development -a codex2Manually: put the files in place
.agents/skills/apify-integration-development/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add apify/agent-skills --skill apify-integration-development -a cursor2Manually: put the files in place
.cursor/skills/apify-integration-development/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install apify/agent-skills apify-integration-development2Manually: put the files in place
.github/skills/apify-integration-development/SKILL.md1Skills CLI (Vercel)
npx skills add apify/agent-skills --skill apify-integration-development -a gemini-cli2Platform CLI
gemini skills install https://github.com/apify/agent-skills --path skills/apify-integration-developmentManually: put the files in place
.devin/skills/apify-integration-development/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add apify/agent-skills --skill apify-integration-development -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 apify-integration-development
How do I install apify-integration-development in Claude Code?
Run npx skills add apify/agent-skills --skill apify-integration-development -a claude-code.
What does apify-integration-development do?
It directs coding agents to follow Apify architecture rules, covering asynchronous polling, resource naming, and expense safeguards.
Where should maxTotalChargeUsd and maxItems be passed?
Pass them strictly as query parameters or run options. Placing them inside the Actor JSON input causes validation errors.
