Skip to content

Skills: Add latest API updates#1

Merged
zygintas merged 1 commit into
mainfrom
feature/add-missing-skills
Jun 12, 2026
Merged

Skills: Add latest API updates#1
zygintas merged 1 commit into
mainfrom
feature/add-missing-skills

Conversation

@zygintas

@zygintas zygintas commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Updated skills to match the newest API version

Summary by CodeRabbit

Release Notes

  • New Features

    • Added Ecommerce API support for managing online stores and sales channels
    • Added Horizons API for AI-powered website creation and management
    • Introduced domain access verification capabilities
  • Documentation

    • Expanded Hosting API guide with detailed database, subdomain, Node.js, and WordPress management examples
    • Updated Domains API documentation with verification endpoint guidance
    • Refined Billing API documentation and order creation workflows
    • Enhanced Reach API documentation with improved contact management guidance

@zygintas zygintas requested a review from a team as a code owner June 12, 2026 07:27
@coderabbitai

coderabbitai Bot commented Jun 12, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

This PR adds ecommerce and horizons as new supported skills to the Hostinger Agent Skills platform. It includes marketplace and routing configuration, complete documentation for both new skills, and expansions to existing domains, billing, hosting, and reach skill guides.

Changes

New Skills Platform Expansion

Layer / File(s) Summary
Infrastructure for new skills: marketplace, references, and routing
.claude-plugin/marketplace.json, REFERENCES.md, scripts/check-api-updates.py
Ecommerce and horizons skills are registered in the Claude plugin marketplace, added to the service endpoint reference table, and the API changelog detection script is extended to recognize domain verification, ecommerce, and horizons keywords and route them to the appropriate skill modules.
Ecommerce skill documentation
skills/ecommerce/SKILL.md
Complete documentation for the Hostinger Ecommerce API covering stores, sales channels, pagination patterns, REST creation workflows, multi-language examples (Bash, Python, TypeScript, PHP), API reference tables, best practices, and troubleshooting for common errors.
Horizons skill documentation
skills/horizons/SKILL.md
Complete documentation for the Hostinger Horizons website builder API describing prompt-driven async site creation, message schema, editor link retrieval for existing sites, SDK examples, API reference, best practices for async workflows, and troubleshooting for HTTP errors and readiness states.
Domains skill: domain verification support
skills/domains/SKILL.md
Expand domains documentation with a new Domain Access Verification subsection, a "Check Domain Verifications" pattern example using the /api/v2/direct/verifications/active endpoint, and corresponding API reference documentation.
Billing skill: remove generic orders endpoint
skills/billing/SKILL.md
Update billing documentation to reflect removal of the generic POST /api/billing/v1/orders endpoint, redirect users to resource-specific order creation endpoints, clarify auto-renewal and verification behaviors, and update best practices language from "deprecated" to "removed."
Hosting skill: comprehensive operational patterns
skills/hosting/SKILL.md
Significantly expand hosting documentation with account-scoped operation details in Core Concepts, add Common Patterns for databases, subdomains/parked domains, Node.js deployment, and WordPress installation with SDK snippets and curl examples, extend API Reference with endpoint tables for each resource type, add operation-specific Best Practices, and include Troubleshooting guidance for database lookups, build failures, and WordPress readiness checks.
Reach skill: contact creation endpoints
skills/reach/SKILL.md
Restructure reach documentation to prioritize direct contact creation (POST /contacts), retain profile-scoped creation for sender-profile-linked contacts, add contact groups listing example, update API reference with all three endpoints, and refine Best Practices to guide endpoint selection by use case.

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Skills: Add latest API updates' is vague and generic, using non-descriptive terms that don't convey meaningful information about the specific changeset. Make the title more specific by highlighting key changes, such as: 'Skills: Add ecommerce and horizons skills with API updates' or 'Skills: Expand marketplace with new ecommerce and horizons modules'.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/add-missing-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick comments (4)
skills/hosting/SKILL.md (4)

62-64: 💤 Low value

Clarify WordPress polling filters in Core Concepts.

Line 64 mentions polling to "confirm readiness" but the actual endpoint at line 357 shows required filters (username, domain). Explicitly mention these in the Core Concepts section so readers know upfront what parameters to filter by.

Suggested revision for line 64:

Installation is asynchronous; poll `GET /api/hosting/v1/wordpress/installations` (filtering by `username` and `domain`) to confirm readiness.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/hosting/SKILL.md` around lines 62 - 64, Update the Core Concepts
WordPress paragraph to explicitly state the required polling filters: change the
sentence about polling `GET /api/hosting/v1/wordpress/installations` to note
that you must filter by `username` and `domain` (matching the endpoint's
required parameters) so readers know which query params to supply when
confirming readiness of an installation.

511-514: 💤 Low value

Clarify the WordPress overwrite parameter.

Line 514 mentions setting overwrite: true when replacing existing files, but this parameter is not shown in the WordPress installation example (lines 340-354). Readers may wonder if this parameter is optional, required, or available.

Consider either:

  1. Adding "overwrite": false to the install example to show it's an available option, or
  2. Clarifying in the Troubleshooting note that this is an optional parameter for advanced scenarios.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/hosting/SKILL.md` around lines 511 - 514, The documentation mentions
the "overwrite" parameter but the WordPress installation example (the JSON
payload used in the install example and the section referencing GET
/wordpress/installations) doesn't show it; add "overwrite": false to the example
install payload to demonstrate the option is available (and optional), and
update the troubleshooting note to state "overwrite" is optional and should be
set to true only for intentional replacements of existing site files.

419-425: ⚡ Quick win

Fix inconsistent endpoint placeholder in Parked Domains API reference.

Line 425 shows the delete endpoint with /parkedDomain as the path parameter placeholder, but the actual example at line 306 shows /example.net (the actual domain). This inconsistency creates ambiguity about what to substitute.

Suggested revision for line 425:

| `DELETE` | `/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parked_domain}` | Delete a parked domain |

(Use {parked_domain} to match the pattern shown in the example at line 306 where example.net is substituted.)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/hosting/SKILL.md` around lines 419 - 425, The DELETE endpoint
placeholder in the Parked Domains section is inconsistent; update the path
parameter in the table row for the DELETE method from
`/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parkedDomain}`
to use the snake_case placeholder
`/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parked_domain}`
so it matches the example usage (`example.net`) and the project's placeholder
naming convention.

330-333: 💤 Low value

Clarify UUID placeholder in Node.js logs example.

Line 331 shows the build UUID as 3f9a... with an ellipsis, which could mislead readers about the actual format. Explicitly label this as a placeholder to avoid confusion.

Suggested revision:

# Stream build logs while running (poll with from_line = previously returned line count)
# Replace {uuid} with the actual build UUID from the creation response
curl -X GET "https://developers.hostinger.com/api/hosting/v1/accounts/u123456789/websites/example.com/nodejs/builds/{uuid}/logs?from_line=0" \
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/hosting/SKILL.md` around lines 330 - 333, Replace the ambiguous
"3f9a..." build identifier in the Node.js logs curl example with an explicit
placeholder and a short inline note; update the URL segment
"builds/3f9a.../logs" to "builds/{uuid}/logs" and add a preceding comment like
"Replace {uuid} with the actual build UUID from the creation response" so
readers know it's a placeholder (update the example in SKILL.md where the logs
curl request appears).
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@skills/hosting/SKILL.md`:
- Around line 62-64: Update the Core Concepts WordPress paragraph to explicitly
state the required polling filters: change the sentence about polling `GET
/api/hosting/v1/wordpress/installations` to note that you must filter by
`username` and `domain` (matching the endpoint's required parameters) so readers
know which query params to supply when confirming readiness of an installation.
- Around line 511-514: The documentation mentions the "overwrite" parameter but
the WordPress installation example (the JSON payload used in the install example
and the section referencing GET /wordpress/installations) doesn't show it; add
"overwrite": false to the example install payload to demonstrate the option is
available (and optional), and update the troubleshooting note to state
"overwrite" is optional and should be set to true only for intentional
replacements of existing site files.
- Around line 419-425: The DELETE endpoint placeholder in the Parked Domains
section is inconsistent; update the path parameter in the table row for the
DELETE method from
`/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parkedDomain}`
to use the snake_case placeholder
`/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parked_domain}`
so it matches the example usage (`example.net`) and the project's placeholder
naming convention.
- Around line 330-333: Replace the ambiguous "3f9a..." build identifier in the
Node.js logs curl example with an explicit placeholder and a short inline note;
update the URL segment "builds/3f9a.../logs" to "builds/{uuid}/logs" and add a
preceding comment like "Replace {uuid} with the actual build UUID from the
creation response" so readers know it's a placeholder (update the example in
SKILL.md where the logs curl request appears).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3e0e1cb1-c5a0-4550-9491-7c93494ab2d2

📥 Commits

Reviewing files that changed from the base of the PR and between a6fed06 and 49eb314.

📒 Files selected for processing (9)
  • .claude-plugin/marketplace.json
  • REFERENCES.md
  • scripts/check-api-updates.py
  • skills/billing/SKILL.md
  • skills/domains/SKILL.md
  • skills/ecommerce/SKILL.md
  • skills/horizons/SKILL.md
  • skills/hosting/SKILL.md
  • skills/reach/SKILL.md

@zygintas zygintas merged commit 7ff2d13 into main Jun 12, 2026
1 check passed
@zygintas zygintas deleted the feature/add-missing-skills branch June 12, 2026 07:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants