Skip to content

docs: add integration development skill reference - #2987

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

protoss70 wants to merge 12 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 e57b98d1) 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

Comment thread sources/platform/integrations/integrate-with-apify.md Outdated
Comment thread sources/platform/integrations/index.mdx Outdated
Comment thread sources/platform/integrations/index.mdx Outdated

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.

@protoss70

Copy link
Copy Markdown
Contributor Author

@apify-factory can you please implement the review comments made here pls

@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.

Could you also link the new section from the apify-integration-development row on Agent Skills, so readers coming from the agents side find what the skill covers?

Comment thread sources/platform/integrations/integrate-with-apify.md

![Keboola Apify component](./images/keboola-components.png)

### Build with the integration skill

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.

Here, this section separates "Build an external integration" from the authentication and API details it depends on, and it mentions OAuth2, polling, and attribution headers before the page explains them. Could you move it to the end of "Integrate with Apify", after "Monitor and track", so the skill reads as a shortcut over details the reader has already seen?

Comment thread sources/platform/integrations/integrate-with-apify.md Outdated
Comment thread sources/platform/integrations/integrate-with-apify.md Outdated
Comment thread sources/platform/integrations/integrate-with-apify.md Outdated
Comment thread sources/platform/integrations/index.mdx Outdated
protoss70 and others added 5 commits October 16, 2026 11:17
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
@protoss70

Copy link
Copy Markdown
Contributor Author

@apify-factory please implement the following review fix

Here, this section separates "Build an external integration" from the authentication and API details it depends on, and it mentions OAuth2, polling, and attribution headers before the page explains them. Could you move it to the end of "Integrate with Apify", after "Monitor and track", so the skill reads as a shortcut over details the reader has already seen?

@protoss70
protoss70 requested a review from marcel-rbro October 19, 2026 14:37

@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.

Just the link from https://docs.apify.com/agents/skills to the new section is missing. Could we add that?

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.

5 participants