Add fx to the install instructions
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 92/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- git
- Domain
- documentation
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.
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.
- Dominant language
- JavaScript
- Stars
- 554
- Forks
- 74
- Avg merge
- 37m
- Merged PRs (30d)
- 6
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Shopify/Shopify-AI-Toolkit
-
Hermes install: join the download and run with && so a failed fetch cannot run a stale installer Open
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
opencode support Open
Difficulty 1/5 Under an hour Newbie friendliness 75/100
Shopify/Shopify-AI-Toolkit#24 · 1 comment ·
-
Difficulty 1/5 Under an hour Newbie friendliness 80/100
Shopify/Shopify-AI-Toolkit#16 · 1 comment · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Shopify/Shopify-AI-Toolkit#14 · 1 comment ·
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
Shopify/Shopify-AI-Toolkit#10 · 2 comments ·
All issues in Shopify/Shopify-AI-Toolkit
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
sugarlabs/musicblocks#8847 ·
-
client-controller-update ta-bot-triage team-money-movement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
MetaMask/metamask-mobile#36594 ·