Agent skill

Shopify Admin Gift Message Extraction

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

Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips.

MITAuto-check passed

Install Shopify Admin Gift Message Extraction

skills CLI
$ npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-gift-message-extraction -a claude-code

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

GitHub CLI
$ gh skill install 40RTY-ai/shopify-admin-skills shopify-admin-gift-message-extraction --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/conversion-optimization/shopify-admin-gift-message-extraction .claude/skills/shopify-admin-gift-message-extraction && 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-gift-message-extraction
GitHub stars
194
Token cost
~1.8k tokens
SKILL.md length
568 words
Files
1
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips.

  • Works in 3 steps: Custom attributes — for each… → Order note — if include_order_note: true… → An order qualifies for the report if…
  • Tasks that involve Conversion rate optimization
  • SKILL.md covers Purpose, Prerequisites, Parameters and Safety, plus 7 more sections
  • Calls shopify

What it does

Shopify Admin Gift Message Extraction is an agent skill from 40RTY-ai/shopify-admin-skills. Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips.

Its SKILL.md is about 1.8k 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 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

  • Tasks that involve Conversion rate optimization

Example prompts

  • “/shopify-admin-gift-message-extraction”

Requirements

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

Workflow steps

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

  1. Custom attributes — for each lineItem.customAttributes and order.customAttributes
  2. Order note — if include_order_note: true and order.note matches /gift|recipient|deliver to|message:/i, capture the note as a note_hint
  3. An order qualifies for the report if is_gift: true OR gift_message was captured OR gift_recipient was captured

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 Gift Message Extraction loads about 1.8k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 568 words of instructions outside code blocks.

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

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). 568 words, ~1,838 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-admin-gift-message-extraction/SKILL.md (or your agent's skills folder).
name
shopify-admin-gift-message-extraction
description
Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips.
compatibility
Claude Code, Cursor, Codex, Gemini CLI
role
conversion-optimization
toolkit
shopify-admin, shopify-admin-execution
api_version
2025-01
graphql_operations
orders:query
status
stable

Purpose

Pulls gift messages, gift-recipient names, and "is_gift" flags from order custom attributes and order notes for orders that are pending or in-progress fulfillment. Produces a single sheet that the fulfillment team can use to print gift cards / inserts and route gift orders correctly. Read-only — no mutations.

Prerequisites

  • Authenticated Shopify CLI session: shopify store auth --store <domain> --scopes read_orders
  • API scopes: read_orders

Parameters

ParameterTypeRequiredDefaultDescription
storestringyes—Store domain (e.g., mystore.myshopify.com)
days_backintegerno7Lookback window of orders to scan
statusstringnounfulfilledOrder status filter: unfulfilled, partial, any
message_keysarrayno["gift_message","gift_note","Gift Message","Gift Note","message","note_to_recipient"]Custom attribute keys (any case) that may contain a gift message
recipient_keysarrayno["gift_recipient","recipient_name","Gift Recipient","To"]Custom attribute keys that may contain a recipient name
flag_keysarrayno["is_gift","gift","Gift Wrap","gift_wrap"]Custom attribute keys whose presence/value marks an order as a gift
include_order_noteboolnotrueAlso scan the order-level note field for free-text gift messages
formatstringnohumanOutput format: human or json

Safety

ℹ️ Read-only skill — no mutations are executed. Output may contain personal text written by customers — handle the resulting CSV with the same care as any customer data export.

Detection Rules

For each order:

  1. Custom attributes — for each lineItem.customAttributes and order.customAttributes:
    • If key (case-insensitive) ∈ message_keys → capture as gift_message
    • If key ∈ recipient_keys → capture as gift_recipient
    • If key ∈ flag_keys AND value is truthy (true, yes, 1, non-empty string) → set is_gift: true
  2. Order note — if include_order_note: true and order.note matches /gift|recipient|deliver to|message:/i, capture the note as a note_hint
  3. An order qualifies for the report if is_gift: true OR gift_message was captured OR gift_recipient was captured

Workflow Steps

  1. Compute filter: created_at:>='<NOW - days_back days>' and translate status → fulfillment_status:unfulfilled / :partial / no filter

  2. OPERATION: orders — query Inputs: query: <filter>, first: 250, select name, note, customAttributes { key, value }, lineItems { name, quantity, customAttributes { key, value } }, shippingAddress, customer { displayName, defaultEmailAddress { emailAddress } }, pagination cursor Expected output: Candidate orders

  3. Apply detection rules to each order

  4. Build report rows — one per qualifying order, including line items so packers know what to wrap

Show full SKILL.md (227 more words)Show less

GraphQL Operations

graphql
# orders:query — validated against api_version 2025-01
query OrdersForGiftExtraction($query: String!, $after: String) {
  orders(first: 250, after: $after, query: $query) {
    edges {
      node {
        id
        name
        createdAt
        note
        displayFulfillmentStatus
        customAttributes {
          key
          value
        }
        shippingAddress {
          firstName
          lastName
          address1
          address2
          city
          provinceCode
          countryCodeV2
          zip
          phone
        }
        customer {
          id
          displayName
          defaultEmailAddress {
            emailAddress
          }
        }
        lineItems(first: 50) {
          edges {
            node {
              id
              name
              quantity
              sku
              customAttributes {
                key
                value
              }
            }
          }
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Session Tracking

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

On start, emit:

╔══════════════════════════════════════════════╗
║  SKILL: Gift Message Extraction              ║
║  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):

══════════════════════════════════════════════
GIFT MESSAGE EXTRACTION  (<days_back> days, status: <status>)
  Orders scanned:        <n>
  Gift orders:           <n>
   ↳ With message:       <n>
   ↳ With recipient:     <n>
   ↳ Flag only:          <n>
  Found in order note:   <n>

  Output: gift_messages_<date>.csv
══════════════════════════════════════════════

For format: json, emit:

json
{
  "skill": "gift-message-extraction",
  "store": "<domain>",
  "period_days": 7,
  "orders_scanned": 0,
  "gift_orders": 0,
  "with_message": 0,
  "with_recipient": 0,
  "flag_only": 0,
  "from_order_note": 0,
  "output_file": "gift_messages_<date>.csv"
}

Output Format

CSV file gift_messages_<YYYY-MM-DD>.csv with columns: order_name, created_at, is_gift, gift_recipient, gift_message, note_hint, ship_to_name, ship_to_address, line_items_summary, customer_email

line_items_summary is a qty × title list joined with ; .

Error Handling

ErrorCauseRecovery
THROTTLEDAPI rate limit exceededWait 2 seconds, retry up to 3 times
Custom attribute key naming inconsistent across themesDifferent storefront templates write different keysCaller can extend message_keys / recipient_keys / flag_keys
Encoded HTML in messagesStorefront stored HTML entitiesDecode &amp;, &#39;, &quot; before printing
Multi-line messagesCustomer pressed Enter inside the inputCSV cells can contain newlines — quote properly when exporting

Best Practices

  • Run twice a day on the morning and afternoon pick wave — gift messages are time-sensitive and missing one ruins the experience.
  • Check custom-attribute key naming against your theme's gift-message implementation; extend message_keys / recipient_keys if your theme uses non-default keys.
  • For peak gifting seasons (Mother's Day, Valentine's, December), expand days_back to 14 and switch status: any to capture orders already in fulfillment.
  • Treat the CSV as PII — gift messages can contain personal sentiments. Restrict access to fulfillment staff who need it.
  • Sort the output by ship_to_address so packers can pull all gift orders going to the same address together.

© 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/conversion-optimization/shopify-admin-gift-message-extraction of 40RTY-ai/shopify-admin-skills.

Open the folder on GitHubat commit 6765cb4

Compare with similar skills

Shopify Admin Gift Message Extraction 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 Gift Message Extraction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify Admin Gift Message Extraction this skill40RTY-ai/shopify-admin-skills194—~1.8kAutomated safety check: PassMIT
E-commerce Visual Copywritingfeichanggege/ecommerce-visual-copywriting-skill867—~1.3kAutomated safety check: PassMIT
Google Analytics 4 Setupooiyeefei/ccc495—~2.2kAutomated safety check: PassMIT
Shopifythatrebeccarae/claude-marketing161—~2.4kAutomated safety check: NotesMIT
Shopify Marketingnexscope-ai/eCommerce-Skills1.1k—~3.8kAutomated safety check: PassMIT
XurlLeoYeAI/openclaw-master-skills2.2k—~766Automated safety check: PassMIT

Similar skills

  • E-commerce Visual Copywriting

    feichanggege/ecommerce-visual-copywriting-skill

    Turns product details, packaging, target platform and audience into an executable e-commerce image plan with copy, storyboards, image prompts and a compliance review.

    867 GitHub stars~1.3k tokensUpdated 23 days ago
    Writing & ContentAuto-check passed
  • Sets up GA4 on a website and wires one real conversion event end to end, verified in DebugView before any money goes into ads.

    495 GitHub stars~2.2k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Shopify

    thatrebeccarae/claude-marketing

    Shopify e-commerce platform marketing expertise. An agent skill from thatrebeccarae/claude-marketing.

    161 GitHub stars~2.4k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check: notes
  • Shopify Marketing

    nexscope-ai/eCommerce-Skills

    Comprehensive Shopify marketing strategy and execution. An agent skill from nexscope-ai/eCommerce-Skills.

    1.1k GitHub stars~3.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Xurl

    LeoYeAI/openclaw-master-skills

    A Twitter research and content intelligence skill focused on attracting WordPress and Shopify clients.

    2.2k GitHub stars~766 tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Marketing & SEOAuto-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 Gift Message Extraction

What does Shopify Admin Gift Message Extraction do?

Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips. Shopify Admin Gift Message Extraction is an agent skill from 40RTY-ai/shopify-admin-skills. Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips.

When should I use Shopify Admin Gift Message Extraction?

Shopify Admin Gift Message Extraction fits situations like: tasks that involve Conversion rate optimization.

How do I install Shopify Admin Gift Message Extraction in Claude Code?

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

How do I install Shopify Admin Gift Message Extraction in Codex?

Run `npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-gift-message-extraction -a codex`. Or copy the skill folder (skills/conversion-optimization/shopify-admin-gift-message-extraction in 40RTY-ai/shopify-admin-skills) into .agents/skills/shopify-admin-gift-message-extraction in your project. Codex loads it when a task matches its description.

Can I use Shopify Admin Gift Message Extraction 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-gift-message-extraction -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-gift-message-extraction, .gemini/skills/shopify-admin-gift-message-extraction, .github/skills/shopify-admin-gift-message-extraction and .opencode/skills/shopify-admin-gift-message-extraction in your project.

What does Shopify Admin Gift Message Extraction need to run?

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

Does Shopify Admin Gift Message Extraction 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 Gift Message Extraction 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 Gift Message Extraction use?

Shopify Admin Gift Message Extraction 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 Gift Message Extraction use?

About 1.8k tokens (SKILL.md is roughly 7.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 Gift Message Extraction?

Skills that share tags, products or a category with Shopify Admin Gift Message Extraction: E-commerce Visual Copywriting (feichanggege/ecommerce-visual-copywriting-skill, 867 stars), Google Analytics 4 Setup (ooiyeefei/ccc, 495 stars), Shopify (thatrebeccarae/claude-marketing, 161 stars) and Shopify Marketing (nexscope-ai/eCommerce-Skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify Admin Gift Message Extraction?

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.