Skip to content

docs: add integration development skill reference - #2987

Open
protoss70 wants to merge 2 commits into
masterfrom
feat/integration-skill-documentation
Open

protoss70 wants to merge 2 commits into
masterfrom
feat/integration-skill-documentation

Conversation

@protoss70

Copy link
Copy Markdown
Contributor

Document the new integration development skill

@protoss70
protoss70 requested a review from drobnikj September 17, 2026 10:56
@protoss70 protoss70 self-assigned this Sep 17, 2026
@protoss70 protoss70 added adhoc Ad-hoc unplanned task added during the sprint. t-integrations Issues with this label are in the ownership of the integrations team. labels Sep 17, 2026
@apify-service-account

apify-service-account commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit 4f513389) is ready at https://pr-2987.preview.docs.apify.com (see action run).

@protoss70 protoss70 changed the title docs: add integration development skill refference docs: add integration development skill reference Sep 17, 2026

@drobnikj drobnikj left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few notes

If you are building a service and your users could benefit from integrating with Apify or vice versa, we would love to hear from you! Contact us at [integrations@apify.com](mailto:integrations@apify.com) to discuss potential collaboration. We are always looking for ways to make the Apify platform more useful and powerful for users.

:::tip Build with an AI coding agent
If your team uses an AI coding agent such as Cursor, Claude Code, GitHub Copilot, or OpenCode, install the [apify-integration-development](https://github.com/apify/agent-skills/tree/main/skills/apify-integration-development) skill. It guides your agent through designing and building an official Apify integration for your product, with reference files for every integration shape Apify supports. See [Build with the integration skill](#build-with-the-integration-skill) below.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: the agent list does not match what the skill repo supports — its README documents Claude Code, Cursor, Windsurf, Codex and Gemini CLI via a /plugin install flow, and mentions neither GitHub Copilot nor OpenCode. A reader on one of those two follows the link and finds no install path.


If you're building a service or platform and want your users to be able to connect it with Apify, [create a new integration](/integrations/integrate). The page walks through both routes - building an integration-ready Actor that other Apify users can plug into their workflows, or connecting your service to Apify externally via the API.

If your team uses an AI coding agent, the [apify-integration-development](https://github.com/apify/agent-skills/tree/main/skills/apify-integration-development) skill guides it through building an official Apify integration for your product. See [Integrate with Apify](/integrations/integrate) for details.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: the paragraph directly above already links /integrations/integrate, so the closing "See Integrate with Apify for details" is a second link to the same page one line later — dropping it keeps the pointer to the skill as the only new thing here.


If you're building a service or platform and want your users to be able to connect it with Apify, [create a new integration](/integrations/integrate). The page walks through both routes - building an integration-ready Actor that other Apify users can plug into their workflows, or connecting your service to Apify externally via the API.

If your team uses an AI coding agent, the [apify-integration-development](https://github.com/apify/agent-skills/tree/main/skills/apify-integration-development) skill guides it through building an official Apify integration for your product. See [Integrate with Apify](/integrations/integrate) for details.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: Should we instead link to the " how to install the skill page? https://github.com/apify/agent-skills/tree/main#installation
Could be more helpful than actual skill, WDYT?

@marcel-rbro marcel-rbro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since the skill is available here: https://skills.sh/apify/agent-skills
Can we just link to agent skills docs and add the skill there? https://docs.apify.com/get-started/agent-onboarding#agent-skills

The agent skills docs also include the installation instructions. This current PR only links to a raw md file. There's no real "installation" instructions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. t-integrations Issues with this label are in the ownership of the integrations team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants