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.

This branch has not been deployed

No deployments
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