Agent skill

Shopify Admin Cogs Completeness Audit

by 40RTY-ai in 40RTY-ai/shopify-admin-skills

Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate.

MITAuto-check passedBusiness, Finance & HR

Install Shopify Admin Cogs Completeness Audit

skills CLI
$ npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-cogs-completeness-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 40RTY-ai/shopify-admin-skills shopify-admin-cogs-completeness-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/40RTY-ai/shopify-admin-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/merchandising/shopify-admin-cogs-completeness-audit .claude/skills/shopify-admin-cogs-completeness-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shopify-admin-cogs-completeness-audit
GitHub stars
194
Token cost
~1.6k tokens
SKILL.md length
502 words
Files
1
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate.

  • Works in 4 steps: OPERATION: productVariants — query → OPERATION: inventoryItems — query → Filter to variants where unitCost ==… → …
  • Business, Finance & HR work in your project
  • SKILL.md covers Purpose, Prerequisites, Parameters and Safety, plus 6 more sections
  • Calls shopify

What it does

Shopify Admin Cogs Completeness Audit is an agent skill from 40RTY-ai/shopify-admin-skills. Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Claude Code, Cursor, Codex, Gemini CLI

It sits in Business, Finance & HR. It works with Shopify. The repository describes itself as: Community-maintained AI agent skills for operating Shopify stores — workflows, optimization, reports and more. The licence is MIT.

When your agent uses it

  • Business, Finance & HR work in your project

Example prompts

  • “/shopify-admin-cogs-completeness-audit”

Requirements

  • Compatibility (from SKILL.md): Claude Code, Cursor, Codex, Gemini CLI

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. OPERATION: productVariants — query
  2. OPERATION: inventoryItems — query
  3. Filter to variants where unitCost == null or unitCost.amount == 0 (when include_zero_cost: true). Compute potential margin gap as price…
  4. Summarize: count missing, % of catalog, total stock-value impact (sum of inventoryQuantity * price across missing rows since you cannot…

What it can do on your machine

Read from SKILL.md and the folder at commit 6765cb4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • shopify

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code, Cursor, Codex, Gemini CLI

    From compatibility in the SKILL.md frontmatter.

Context cost

Shopify Admin Cogs Completeness Audit loads about 1.6k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 502 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 40RTY-ai/shopify-admin-skills at commit 6765cb4, republished under its MIT licence (© 40RTY-ai). 502 words, ~1,600 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-admin-cogs-completeness-audit/SKILL.md (or your agent's skills folder).
name
shopify-admin-cogs-completeness-audit
description
Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate.
compatibility
Claude Code, Cursor, Codex, Gemini CLI
role
merchandising
toolkit
shopify-admin, shopify-admin-execution
api_version
2025-01
graphql_operations
productVariants:query, inventoryItems:query
status
stable

Purpose

Scans every variant in the catalog and surfaces those whose inventoryItem.unitCost is missing or zero. Cost of goods sold (COGS) is the foundation for margin reporting, profit-based pricing decisions, and inventory valuation — a single missing cost silently corrupts every downstream calculation. Read-only — no mutations.

Prerequisites

  • Authenticated Shopify CLI session: shopify store auth --store <domain> --scopes read_products,read_inventory
  • API scopes: read_products, read_inventory

Parameters

ParameterTypeRequiredDefaultDescription
storestringyes—Store domain (e.g., mystore.myshopify.com)
status_filterstringnoACTIVEVariant product status to audit: ACTIVE, DRAFT, ARCHIVED, or ALL
vendor_filterstringno—Optional vendor to scope the audit
include_zero_costboolnotrueTreat unitCost = 0 as missing (recommended; zero cost is rarely intentional)
only_stockedboolnotrueLimit to variants with inventoryQuantity > 0
formatstringnohumanOutput format: human or json

Safety

ℹ️ Read-only skill — no mutations are executed. Safe to run at any time. The skill flags missing data; remediation should happen through a follow-up workflow that you control.

Workflow Steps

  1. OPERATION: productVariants — query Inputs: first: 250, query: <built from status_filter and vendor_filter>, select sku, price, inventoryQuantity, inventoryItem { id }, product { title, vendor, status, productType }, pagination cursor Expected output: All matching variants; paginate until hasNextPage: false

  2. OPERATION: inventoryItems — query Inputs: Batched inventoryItemIds (≤100 per request) Expected output: unitCost { amount, currencyCode }, tracked

  3. Filter to variants where unitCost == null or unitCost.amount == 0 (when include_zero_cost: true). Compute potential margin gap as price - 0 = price for the missing-cost variants — this is the fictional margin downstream reports will show.

  4. Summarize: count missing, % of catalog, total stock-value impact (sum of inventoryQuantity * price across missing rows since you cannot value them on cost).

GraphQL Operations

graphql
# productVariants:query — validated against api_version 2025-01
query VariantsForCogsAudit($query: String, $after: String) {
  productVariants(first: 250, after: $after, query: $query) {
    edges {
      node {
        id
        sku
        title
        price
        inventoryQuantity
        product {
          id
          title
          vendor
          status
          productType
        }
        inventoryItem {
          id
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
graphql
# inventoryItems:query — validated against api_version 2025-01
query InventoryItemCosts($ids: [ID!]!) {
  nodes(ids: $ids) {
    ... on InventoryItem {
      id
      tracked
      sku
      unitCost {
        amount
        currencyCode
      }
    }
  }
}

Session Tracking

Claude MUST emit the following output at each stage. This is mandatory.

On start, emit:

╔══════════════════════════════════════════════╗
║  SKILL: COGS Completeness Audit              ║
║  Store: <store domain>                       ║
║  Started: <YYYY-MM-DD HH:MM UTC>             ║
╚══════════════════════════════════════════════╝

After each step, emit:

[N/TOTAL] <QUERY|MUTATION>  <OperationName>
          → Params: <brief summary of key inputs>
          → Result: <count or outcome>

On completion, emit:

For format: human (default):

══════════════════════════════════════════════
COGS COMPLETENESS AUDIT
  Variants audited:        <n>
  Missing unit cost:       <n>  (<pct>%)
  Stocked + missing cost:  <n>
  Catalog value at risk:   $<amount> (priced, not costed)

  Top vendors by missing variants:
    <vendor>  Missing: <n>  Stocked: <n>
  Output: cogs_audit_<date>.csv
══════════════════════════════════════════════

For format: json, emit:

json
{
  "skill": "cogs-completeness-audit",
  "store": "<domain>",
  "variants_audited": 0,
  "missing_cost": 0,
  "missing_cost_pct": 0,
  "stocked_missing": 0,
  "value_at_risk": 0,
  "currency": "USD",
  "output_file": "cogs_audit_<date>.csv"
}
Show full SKILL.md (198 more words)Show less

Output Format

CSV file cogs_audit_<YYYY-MM-DD>.csv with columns: variant_id, inventory_item_id, sku, product_title, vendor, product_status, price, unit_cost, inventory_quantity, value_at_price, currency

Error Handling

ErrorCauseRecovery
THROTTLEDAPI rate limit exceededWait 2 seconds, retry up to 3 times
inventoryItem is nullVariant has no inventory item (rare)Skip, note in error count
unitCost.currencyCode differs from store currencyMulti-currency cost captureTreat as present; do not flag, surface currency mismatch separately
All variants have costsHealthy catalogExit with summary: 0 missing, 100% complete

Best Practices

  • Run monthly; whenever new vendors or product lines are onboarded, run on day one of activation to catch missing costs before margin reports are trusted.
  • Filter by vendor_filter to assign remediation work to the buyer responsible for that vendor's data.
  • Pair with inventory-valuation-report — that report will silently treat missing-cost SKUs as worthless inventory unless this audit is clean.
  • Treat unitCost = 0 as missing by default. Genuine zero-cost SKUs (free samples, GWP) are rare; tag those with a zero-cost-intentional product tag and exclude them from the audit via vendor_filter or downstream filtering.
  • Use the CSV as a worklist: hand it to the merchandising team for cost capture, then re-run weekly until the missing count is zero.

© 40RTY-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/merchandising/shopify-admin-cogs-completeness-audit of 40RTY-ai/shopify-admin-skills.

Open the folder on GitHubat commit 6765cb4

Compare with similar skills

Shopify Admin Cogs Completeness Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shopify Admin Cogs Completeness Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify Admin Cogs Completeness Audit this skill40RTY-ai/shopify-admin-skills194—~1.6kAutomated safety check: PassMIT
Price Optimization Toolnexscope-ai/eCommerce-Skills1.1k—~3.3kAutomated safety check: PassMIT
Shopify Tax Compliancenexscope-ai/eCommerce-Skills1.1k—~463Automated safety check: PassMIT
Ecommerce Advisorborghei/Claude-Skills886—~1.2kAutomated safety check: PassMIT
Apify Ecommerceapify/awesome-skills265—~4.6kAutomated safety check: NotesApache-2.0
Checkout Purchasekeypo-us/keypo-cli182—~880Automated safety check: NotesNone

Similar skills

  • Price Optimization Tool

    nexscope-ai/eCommerce-Skills

    Evaluate ecommerce price candidates using unit economics, historical observations, elasticity analysis, scenario modeling, and controlled experiments.

    1.1k GitHub stars~3.3k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Shopify Tax Compliance

    nexscope-ai/eCommerce-Skills

    Tax setup and compliance — sales tax, VAT, duty collection, tax-exempt customers, reporting

    1.1k GitHub stars~463 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Ecommerce Advisor

    borghei/Claude-Skills

    Strategic advisory for e-commerce founders on unit economics, fulfillment models, payments, and channel strategy.

    886 GitHub stars~1.2k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed
  • Apify Ecommerce

    apify/awesome-skills

    Official

    Scrape e-commerce data for pricing, reviews, bestsellers, and seller discovery across 30+ platforms including Amazon, Walmart, eBay, Shopify, WooCommerce, and more.

    265 GitHub stars~4.6k tokensUpdated 16 days ago
    Sales & SupportAuto-check: notes
  • Checkout Purchase

    keypo-us/keypo-cli

    A skill your agent uses when the user asks to buy a product from the Shopify store.

    182 GitHub stars~880 tokensUpdated 6 mo ago
    Sales & SupportAuto-check: notes
  • Shopify Automation

    davepoon/buildwithclaude

    Automate Shopify tasks via Rube MCP (Composio): products, orders, customers, inventory, collections.

    3.6k GitHub starsUsed in 7 repos~1.5k tokens
    Productivity & AutomationAuto-check passed

More from 40RTY-ai/shopify-admin-skills

All 116 skills in this repo
  • Shopify Admin Abandoned Cart Recovery

    40RTY-ai/shopify-admin-skills

    Query checkouts abandoned in the last N days, generate unique discount codes per customer, and tag them for re-engagement.

    194 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Shopify Admin Address Correction

    40RTY-ai/shopify-admin-skills

    Update the shipping address on an unfulfilled order before it ships.

    194 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Shopify Admin Agentic Crawler Access

    40RTY-ai/shopify-admin-skills

    Edit the theme's robots.txt.liquid to explicitly allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, Amazonbot) so AI assistants are permitted to read the catalog.

    194 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Rewrite thin product descriptions into structured, fact-rich copy (materials, fit, use-cases, the words shoppers actually type) so AI agents have something concrete to quote and match.

    194 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Shopify Admin Agentic Image Alt Text

    40RTY-ai/shopify-admin-skills

    Generate and set descriptive alt text on product images so AI agents (which can't 'see' pixels) can understand and recommend what each product looks like.

    194 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Shopify Admin Agentic LLMs Txt

    40RTY-ai/shopify-admin-skills

    Generate and publish an /llms.txt guide (brand summary, flagship products, key policies, contact) via a theme template so AI assistants get a curated, machine-readable map of the store.

    194 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Shopify Admin Cogs Completeness Audit

What does Shopify Admin Cogs Completeness Audit do?

Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate. Shopify Admin Cogs Completeness Audit is an agent skill from 40RTY-ai/shopify-admin-skills.unitCost so margin and inventory valuation reports stay accurate.

When should I use Shopify Admin Cogs Completeness Audit?

Shopify Admin Cogs Completeness Audit fits situations like: business, Finance & HR work in your project.

How do I install Shopify Admin Cogs Completeness Audit in Claude Code?

Run `npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-cogs-completeness-audit -a claude-code`. Or copy the skill folder (skills/merchandising/shopify-admin-cogs-completeness-audit in 40RTY-ai/shopify-admin-skills) into .claude/skills/shopify-admin-cogs-completeness-audit in your project. Claude Code loads it when a task matches its description.

How do I install Shopify Admin Cogs Completeness Audit in Codex?

Run `npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-cogs-completeness-audit -a codex`. Or copy the skill folder (skills/merchandising/shopify-admin-cogs-completeness-audit in 40RTY-ai/shopify-admin-skills) into .agents/skills/shopify-admin-cogs-completeness-audit in your project. Codex loads it when a task matches its description.

Can I use Shopify Admin Cogs Completeness Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-cogs-completeness-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shopify-admin-cogs-completeness-audit, .gemini/skills/shopify-admin-cogs-completeness-audit, .github/skills/shopify-admin-cogs-completeness-audit and .opencode/skills/shopify-admin-cogs-completeness-audit in your project.

What does Shopify Admin Cogs Completeness Audit need to run?

Going by SKILL.md and its folder, Shopify Admin Cogs Completeness Audit needs the command-line tools its instructions call (shopify). Compatibility (from SKILL.md): Claude Code, Cursor, Codex, Gemini CLI.

Does Shopify Admin Cogs Completeness Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shopify Admin Cogs Completeness Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shopify Admin Cogs Completeness Audit use?

Shopify Admin Cogs Completeness Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shopify Admin Cogs Completeness Audit use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shopify Admin Cogs Completeness Audit?

Skills that share tags, products or a category with Shopify Admin Cogs Completeness Audit: Price Optimization Tool (nexscope-ai/eCommerce-Skills, 1.1k stars), Shopify Tax Compliance (nexscope-ai/eCommerce-Skills, 1.1k stars), Ecommerce Advisor (borghei/Claude-Skills, 886 stars) and Apify Ecommerce (apify/awesome-skills, 265 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify Admin Cogs Completeness Audit?

40RTY-ai (a GitHub organization) maintains it in 40RTY-ai/shopify-admin-skills, which has 194 GitHub stars. The repository holds 116 skills in this directory. The repository was last updated on August 14, 2026.

Source: 40RTY-ai/shopify-admin-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.