shopify-partner

Generate and validate Partner API GraphQL operations for partner-level tasks.

491|60|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Shopify/Shopify-AI-Toolkit --skill shopify-partner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-partner
Source: https://github.com/Shopify/Shopify-AI-Toolkit/tree/main/skills/shopify-partner
Command: npx skills add https://github.com/Shopify/Shopify-AI-Toolkit --skill shopify-partner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The shopify-partner skill removes uncertainty and manual effort when writing Partner API GraphQL operations by forcing doc-driven searches and automated validation so developers produce correct, partner-level queries and mutations for apps, themes, referrals, and payouts.

Core Features & Use Cases

  • Doc-first query generation: Requires searching Shopify developer documentation to discover accurate types, fields, and examples before composing GraphQL operations.
  • GraphQL authoring for partner workflows: Produces queries and mutations tailored to partner-level contexts such as managing apps, theme versions, affiliate referrals, and transaction filtering.
  • Automated validation loop: Runs a validation script that checks generated GraphQL code, reports precise errors, and supports up to three iterative fixes; also reports anonymized validation telemetry to Shopify.
  • Use Case: Create a validated GraphQL query to fetch an app's metadata and recent installation metrics for a specific partner organization.

Quick Start

Use the shopify-partner skill to search the Partner API docs for app-related types, generate a GraphQL query to fetch an app's id, name, developerName, and createdAt, and validate the code with the provided validation script.

Frequently Asked Questions about shopify-partner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write GraphQL queries to manage Shopify Partner Dashboard data?

To manage Shopify Partner Dashboard data, you generate partner-level GraphQL queries for apps, themes, and referrals by first searching Shopify developer docs to discover accurate types and fields before composing the operations.

What is the best way to validate Shopify Partner API GraphQL code?

The best way to validate Shopify Partner API GraphQL code is to run an automated validation script that checks generated queries, reports precise errors, and supports up to three iterative fixes to ensure partner-level code correctness.

Can I use GraphQL to fetch app installation metrics for a specific partner organization?

Yes, you can use GraphQL to fetch an app's metadata and recent installation metrics for a specific partner organization by creating validated partner-level queries discovered through Shopify developer documentation searches.

Does the Shopify Partner API support managing affiliate referrals and transaction filtering?

Yes, the Shopify Partner API supports managing affiliate referrals and transaction filtering through tailored GraphQL queries and mutations generated by referencing developer documentation for accurate partner-level workflows.

Why do I need to search developer docs before generating Shopify Partner API queries?

You need to search developer docs before generating Shopify Partner API queries to remove uncertainty and manual effort by discovering accurate types, fields, and examples to produce correct partner-level operations.

What are the limitations of automated validation for Shopify Partner GraphQL code?

Automated validation for Shopify Partner GraphQL code is limited to three iterative fix attempts. If the validation script reports errors that cannot be resolved within three fixes, you will need to manually revise your GraphQL operations.