docs: Improve Build with AI page clarity and structure by patrikbraborec · Pull Request #2256 · apify/apify-docs

patrikbraborec · 2026-02-17T11:37:42Z

Summary

Restructured Quick Start as a top-level section with two tabbed paths: starting with a prompt vs starting with a template (apify create)
Added intro paragraph explaining that the methods on the page are complementary and where to start
Added Agent Skills section with installation command and explanation of what happens after install
Removed redundant tool lists (previously repeated 3 times with inconsistencies)
Removed bold intro line that duplicated the front matter description
Replaced Claude (web) MCP tab with Claude Code CLI command
Removed all Antigravity references
Fixed terminology: "actor" → "Actor", "MCP Server" → "MCP server"
Added missing Oxford commas
Made vague VS Code MCP instructions specific (Cline, Roo Code)

- Add Quick Start as top-level section with two paths (prompt vs template) - Add intro paragraph explaining how methods complement each other - Add Agent Skills section with installation and usage context - Remove redundant tool lists and bold intro line - Replace Claude web tab with Claude Code CLI command for MCP setup - Remove Antigravity references - Fix terminology (Actor, MCP server) and add missing Oxford commas Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

apify-service-account · 2026-02-17T11:40:39Z

Preview for this PR was built for commit ea3e9be and is ready at https://pr-2256.preview.docs.apify.com!

apify-service-account · 2026-02-17T11:43:29Z

Preview for this PR was built for commit 4b7b9bd and is ready at https://pr-2256.preview.docs.apify.com!

marcel-rbro · 2026-02-18T10:23:24Z

sources/platform/actors/development/quick-start/build_with_ai.md

 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';

-This guide provides best practices for building new Actors or improving existing ones using AI code generation and vibe coding tools such as Antigravity, Cursor, Claude Code, or Visual Studio Code, by providing the AI agents with the right instructions and context.


You've removed all mentions of "vibe coding tools" from the body, but the description in the frontmatter still mentions them

Yeah, we want to keep vibe coding mainly due to SEO. But if you think that it should be removed, let's remove it.

Yeah, I think that is how it was originally. We ahd it in description but not in body since back then it was considered not a favourable term. Then sentiment chagned and we've added after discussions. I feel indifferent I think the article now states it's goal clearly and reads well

marcel-rbro · 2026-02-18T10:31:23Z

sources/platform/actors/development/quick-start/build_with_ai.md

-</TabItem>
-<TabItem value="antigravity" label="Antigravity">
-
-To add Apify MCP server to Antigravity:
-
-1. Click on the **Chat tab**.
-2. Click the three dots (**Additional options**) menu.
-3. Select **Manage MCP Servers**.
-4. Click **View raw config** to open the configuration file.
-5. Add the following to the configuration file:
-
-    ```json
-    {
-      "mcpServers": {
-        "apify": {
-          "command": "npx",
-          "args": [
-            "-y",
-            "@apify/actors-mcp-server",
-            "--tools",
-            "docs"
-          ]
-        }
-      }
-    }
-    ```


Why completely delete Antigravity?

It's just observation from market. A lot of people is talking about Cursor, Claude Code, potentially Codex, but Antigravity does not have such adoption. That's my motivation behind it.

I instead added Claude Code.

Good on adding Claude Code, this is correct approach IMO. And I concur with removal of Antigravity, it seems pretty dead (this is subject to change but we can always add it back) we used similar reasoning to remove Windsurf I believe

TC-MO

Nice work, few minor tweaks:

"The methods below" > "The methods on this page". We try to avoid directional language for accessibility.
~46 words-long intro, split into shorter sentences for better flow.
Remove the vague sentences ("Agents are increasingly capable..." / "Skills solve this..." / "Agents with access to..."). They read like marketing copy. Better to explain what Agent Skills are and move onto installation.
Add trailing periods to Quick Start tab steps to match the rest of the page.

sources/platform/actors/development/quick-start/build_with_ai.md

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2026-02-18T15:02:43Z

Preview for this PR was built for commit 4c60b087 and is ready at https://pr-2256.preview.docs.apify.com!

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

apify-service-account · 2026-02-18T15:10:31Z

Preview for this PR was built for commit 1b564aa5 and is ready at https://pr-2256.preview.docs.apify.com!

patrikbraborec · 2026-02-18T15:59:47Z

@TC-MO , @marcel-rbro thanks both of you for the review. I approved the suggestions, and comment the threads. Let me know, if you need something else. Thanks!

TC-MO

LGTM

patrikbraborec requested a review from TC-MO as a code owner February 17, 2026 11:37

github-actions bot assigned patrikbraborec Feb 17, 2026

github-actions bot added this to the 134th sprint - Cash & Community team milestone Feb 17, 2026

github-actions bot added the t-c&c Team covering store and finance matters. label Feb 17, 2026

patrikbraborec requested a review from lukas-bekr February 17, 2026 11:38

fix: Remove trailing space in build_with_ai.md

4b7b9bd

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

marcel-rbro reviewed Feb 18, 2026

View reviewed changes

TC-MO requested changes Feb 18, 2026

View reviewed changes

Apply suggestions from code review

4c60b08

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

fix: Remove hard tabs from code block in build_with_ai.md

1b564aa

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

TC-MO approved these changes Feb 18, 2026

View reviewed changes

patrikbraborec merged commit cf6759e into master Feb 18, 2026
13 checks passed

patrikbraborec deleted the update-build-with-ai branch February 18, 2026 16:28

Conversation

patrikbraborec commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

apify-service-account commented Feb 17, 2026

Uh oh!

apify-service-account commented Feb 17, 2026

Uh oh!

marcel-rbro Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

patrikbraborec Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

TC-MO Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

marcel-rbro Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

patrikbraborec Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

patrikbraborec Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

TC-MO Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Feb 18, 2026

Uh oh!

apify-service-account commented Feb 18, 2026

Uh oh!

patrikbraborec commented Feb 18, 2026

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Comments

patrikbraborec commented Feb 17, 2026 •

edited

Loading