Shopify / Shopify/Shopify-AI-Toolkit

Add fx to the install instructions

Open Beginner friendly
#52 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
553
Forks
74
Avg merge
37m
Merged PRs (30d)
6

Description

Add fx to the install instructions

fx (https://fx.sh, vercel-labs/fx) discovers skills from .agents/skills and
.claude/skills, both in the workspace and in the home directory. The toolkit
already works there with no changes on either side, so this is a docs request
rather than a feature request.

Verified with fx 0.0.8. After dropping the toolkit's skills/ into a skills
root, fx lists all 21 skills, and shopify-dev runs end to end: it searched the
docs, called shopify-admin/scripts/validate.mjs, and validated a
productCreate mutation against the 2026-07 schema, reporting the required
write_products scope.

Suggested entry for the Install section, in the same shape as the others:

  • For fx: In your terminal, copy the skills into the shared agents directory:

    git clone --depth 1 https://github.com/Shopify/shopify-ai-toolkit /tmp/shopify-ai-toolkit
    mkdir -p ~/.agents/skills && cp -R /tmp/shopify-ai-toolkit/skills/* ~/.agents/skills/
    

    fx picks them up on the next start. For a single project, use .agents/skills/
    in the repository root instead.

Opening this as an issue since the README says pull requests are closed
automatically. Happy to provide the wording in whatever form is easiest.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open the README and locate the Install section, then compare the existing entries to the suggested fx wording. Add an fx entry covering the shared and project-local skills directories, and verify that the instructions match the tested git, mkdir, and cp commands.

Written by the indexing model from the issue text.

Assessment

Tech stack
git
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
92/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.